The Uniformed Services Academy of Family Physicians web site contains a collection of text files with content that can be used in Dragon Naturally Speaking voice commands.

Voice Commands for Navigating in AHLTA

AHLTA Sample Commands		(4 KB)

The file “AHLTA Sample Commands.dat” contains examples of commands that do simple navigation in AHLTA. The commands are as follows.

Commands that click buttons

• Add Note
• Auto Neg
• Template Management
• Find term (after saying this command, dictate the term you want to find)
• Find selected term (you must highlight a word in your text before saying the command)
• Sign this note

Commands that perform navigation functions similar to clicking in the Folder List

• Go to A/P
• Go to diagnosis
• Go to disposition
• Go to order entry lab
• Go to order entry med
• Go to order entry rad
• Go to S/O
• Go to vital signs entry

NOTE: These commands work only if AHLTA is running on your workstation. They do not work if you are running AHLTA through Windows Terminal Server (Remote Desktop) or Citrix.

Editing the Sample Commands

Some of the sample commands work only in the CHCSII test system (CTS) because they refer to a user called “User, Test.” To get these commands to work properly for yourself:

1. Edit the file “AHLTA sample commands.xml” in Notepad. (Don’t double-click it because that will probably open it in your web browser, which does not enable you to edit it. Instead, right-click the file, click Open With, Notepad.)
2. Replace every instance of “User, Test” with your last name and first name.
3. Close Notepad and allow it to save the file.

Importing the Sample Commands

After editing the command file, import it by following these steps:

1. Start Dragon NaturallySpeaking and open your user file.
2. Click Tools, Command Browser. Wait for the Command Browser window to appear.
3. Click Manage.
4. Click Import.
5. Browse to the file you want to import, then click Open.
6. Optionally, uncheck any commands that you don’t want to import at this time. Click Import.

Testing and Revising the Commands

After you have imported the commands, try using them in AHLTA. You may find that some of them do not work properly. Specifically, a command may be recognized but it may take you to the wrong module of AHLTA. This may be because the commands were developed for a different build of AHLTA than you are running, with different menus.

If a command is recognized but does the wrong thing, try this:

1. In the DragonBar, click Tools, Command Browser.
2. Click Script.
3. Locate the command that doesn’t work and double-click to edit it in the MyCommands Editor.
4. Look at the script. For example, the script for the “Go To AP” command contains the following line:
   
   SendDragonKeys "{Alt+g}{Down 7}{Enter}"
   
   (The purpose of the above line is to send AHLTA the Alt+g key combination, which displays the Go menu. It then sends seven down-arrow keys, which ought to select the A/P menu item, then the Enter key which activates that menu item.)
5. Switch to your AHLTA window and click the Go menu. Then press the down-arrow key on your keyboard until the A/P menu item is highlighted, counting the number of times you pressed the down-arrow key.
6. Switch back to the MyCommands Editor. Change the number after the word Down to equal the number of down-arrow keys you pressed in step 5. For example, if it took eight down-arrows to reach the A/P menu, change the line in step 4 to this:
   
   SendDragonKeys "{Alt+g}{Down 8}{Enter}"
7. Click Save. Now go back to AHLTA and test your modified command.

Well Woman Exam

Example Voice Command for Documenting an Exam		(16 KB)

Here is a voice command that was developed for the internal medicine clinic at William Beaumont Army Medical Center, courtesy of Daniel T. Torzala, MD. It is used to document a well woman exam, and can be modified to create other types of documents. It does the following:

• Displays a window into which you can enter data by voice, using a combination of lists, checkboxes, and free text.
• Generates a free-text note from the data and types it into DragonPad. From there you can copy and paste the text into AHLTA. (It is not feasible to build a command like this that works directly in AHLTA, because AHLTA does not maintain keyboard focus in any of its text fields if another application becomes active.)
  

To import it:

1. Save the file wellwomanexam.dat to your hard drive (right-click the "dat" icon above, and click Save Target As... or Save Link As...)
2. Start Dragon NaturallySpeaking and open your user file.
3. Click Tools, Command Browser. Wait for the Command Browser window to appear
4. Click Manage
5. Click Import
6. Browse to the file you want to import, then click Open
7. Click Import

To use it:

1. Say "start DragonPad"
   
2. Say "well woman exam"
   
3. Fill in the fields and then say OK or click the OK button. The completed exam appears in DragonPad.
   
4. Say "copy all to clipboard" and then minimize or close DragonPad.
5. Manually paste the text into AHLTA.