Admin: Add Substitutions

1. Go to the Substitutions page in nVoq.Administrator.  

2. Select the appropriate radio button to add a substitution for an account or an organization: 

   Add a substitution for a specific user account

   1. Select the Account radio button.
   2. Then select an account from the Account menu. Substitutions will be created in the account selected here. 
      • The menu will display a maximum of 250 accounts. If there are more than 250 accounts in the selected organization, the bottom of the menu will say, "Showing 250 out of [#] possible accounts."
      • All accounts within the selected organization may be included in the menu, even those that do not have client access.
      • Use the Find Account field at the top of the menu to find any account that exists in the selected organization, even if it is not one of the 250 displayed in the menu.
        
      • Hover your mouse over the account in the list to see the username in a tooltip if it's cut off on the menu.
        

Add a substitution to an organization

1. Select the appropriate organization from the organization menu at the very top of the screen.  Substitutions will be created in the organization selected here.  
   Navigate this menu by using the Expand All button to open all organizations, by clicking the > arrow next to each organization level to open it, or by typing an organization name in the Filter text field.
2. Under View, select the Organization radio button. 
3. Then select the appropriate Show Organization radio button to view existing substitutions for the selected organization:
   • Choose selected and parents to see substitutions created for the organization selected in the Organization menu and all parent organizations above it.
   • Choose only selected to see substitutions created for only the organization selected in the Organization menu.
   • Choose selected and children to see substitutions created for the organization selected in the Organization menu and all child organizations below it.

3. Click the new icon  at the top of the page (in the blue bar).

4. The Add Substitution page opens. Configure the settings on the page. 
   1. Select a Substitution Type from the drop-down menu: Literal, Regex, or Regex Plus.
   2. Enter what a user will say in the dictation to elicit the substitution in the Spoken field.
   3. Enter the text or pattern that the dictation client is to return when the word, words, or pattern is found in the dictation transcript in the Written field.
      Literal substitutions are case-sensitive.

      If the text in the Written field begins with a lowercase letter, it will always return with a lowercase letter, even at the beginning of a sentence.
   4. Optionally, enter information about what the substitution does in the Description field. (This is especially helpful for Regex and Regex Plus substitutions.)
   5. Optionally, disable the substitution by moving the Enabled toggle to OFF/white.

5. Click the Save button at the bottom of the page to save the substitution and go back to the list.
   • Newly added substitutions are updated asynchronously to the database. Dictation client users can still perform dictations while substitutions are being updated on the server.
     (Adding substitutions does NOT rebuild the user's profile.)
   • Newly added substitutions are available almost immediately after they are submitted.