Example:

Navigation fields can be build in various ways, using a one of many mechanisms to search for the desired navigation field.  Naturally, of course, it is necessary that the appropriate field already be present in your document.

Potential methods of navigation include:

1.  Using the word processor's "Find" command

2.  Use of a Dragon "HeardWord" command initiating a "Select <text>" command

The Simplest Method (all fields identical):

If you simply want to move sequentially through a document, your navigation field can be any character combination not likely to occur naturally (i.e. [] or ** or $$).

The Advanced Scripting command could look as follows:

Sub main

    Sendkeys "^f"  'initiates a ctrl + f to open the find menu

    Sendkeys "[]"  'sends the keys to search for - you can substitute something else here

    Sendkeys "{enter}"  'selects the enter key

    Wait .5  'creates a half second wait for the find command to execute (optional)

    Sendkeys "{esc}"  'closes the find dialog box

    Heardword "\Cap"  'optional line to assure your subsequent dictation is capitalized

End sub

The structure for such a command using "Legacy" or DVC format would be as follows:

    Sendkeys "{ctrl+f}"  'initiates a ctrl + f to open the find menu

    Sendkeys "[]"  'sends the keys to search for

    Sendkeys "{enter}"  'selects the enter key

    Wait 500  'creates a half second wait for the find command to execute (optional)

    Sendkeys "{esc}"  'closes the find dialog box

    Heardword "\Cap"  'optional line to assure your subsequent dictation is capitalized

Such a command could reasonably be named "Next" or "Next Bracket" or anything else which is unique and which you will remember.  Creating the command using the DVC method will tend to make it a bit faster, but in something so simple as this, the difference in execution time may not be noticeable.

A More Elaborate Navigation Field Method (Each Field Unique):

For this method each field will be individually named, i.e. [01],[02],[03], etc.  The advantage of this method is the ability to navigate to any specific pre-identified location in a document template, without the need to move sequentially through field in a specific order (as with the "simple" method above).

With this command it is necessary to create a command with an associated list variable.  For more information of use of a list variables, the reader is referred to Larry Allen's book "Scripting for NaturallySpeaking 8" or the soon to be released"Scripting for NaturallySpeaking 9".  The method is also shown in the appendix below.   In this method a variable to be used in the script is determined by the naming of this variable as the command is initiated.  In this case if we say "Field 4", the result will be the command looking for "[04]" and if we say "Field 5", then the text "[05]" is searched for.  If you are not familiar with creating lists, see the appendix below.  Otherwise create or use a list <1-99> and then use the following script for the content after selecting "Advanced Scripting" as the command type:

Sub Main

if ListVar1 = "1" then HeardWord "select","[","zero","one","]"

if ListVar1 = "2" then HeardWord "select","[","zero","two","]"

if ListVar1 = "3" then HeardWord "select","[","zero","three","]"

if ListVar1 = "4" then HeardWord "select","[","zero","four","]"

if ListVar1 = "5" then HeardWord "select","[","zero","five","]"

if ListVar1 = "6" then HeardWord "select","[","zero","six","]"

if ListVar1 = "7" then HeardWord "select","[","zero","seven","]"

if ListVar1 = "8" then HeardWord "select","[","zero","eight","]"

if ListVar1 = "9" then HeardWord "select","[","zero","nine","]"

if ListVar1 = "10" then HeardWord "select","[","ten","]"

if ListVar1 = "11" then HeardWord "select","[","eleven","]"

if ListVar1 = "12" then HeardWord "select","[","twelve","]"

if ListVar1 = "13" then HeardWord "select","[","thirteen","]"

if ListVar1 = "14" then HeardWord "select","[","fourteen","]"

if ListVar1 = "15" then HeardWord "select","[","fifteen","]"

if ListVar1 = "16" then HeardWord "select","[","sixteen","]"

if ListVar1 = "17" then HeardWord "select","[","seventeen","]"

if ListVar1 = "18" then HeardWord "select","[","eighteen","]"

if ListVar1 = "19" then HeardWord "select","[","nineteen","]"

if ListVar1 = "20" then HeardWord "select","[","twenty","]"

if ListVar1 = "21" then HeardWord "select","[","twenty","one","]"

if ListVar1 = "22" then HeardWord "select","[","twenty","two","]"

if ListVar1 = "23" then HeardWord "select","[","twenty","three","]"

if ListVar1 = "24" then HeardWord "select","[","twenty","four","]"

if ListVar1 = "25" then HeardWord "select","[","twenty","five","]"

if ListVar1 = "26" then HeardWord "select","[","twenty","six","]"

if ListVar1 = "27" then HeardWord "select","[","twenty","seven","]"

if ListVar1 = "28" then HeardWord "select","[","twenty","eight","]"

if ListVar1 = "29" then HeardWord "select","[","twenty","nine","]"

if ListVar1 = "30" then HeardWord "select","[","thirty","]"

if ListVar1 = "31" then HeardWord "select","[","thirty","one","]"

if ListVar1 = "32" then HeardWord "select","[","thirty","two","]"

if ListVar1 = "33" then HeardWord "select","[","thirty","three","]"

if ListVar1 = "34" then HeardWord "select","[","thirty","four","]"

if ListVar1 = "35" then HeardWord "select","[","thirty","five","]"

if ListVar1 = "36" then HeardWord "select","[","thirty","six","]"

if ListVar1 = "37" then HeardWord "select","[","thirty","seven","]"

if ListVar1 = "38" then HeardWord "select","[","thirty","eight","]"

if ListVar1 = "31" then HeardWord "select","[","thirty","one","]"

if ListVar1 = "40" then HeardWord "select","[","forty","]"

HeardWord "\Cap"

End Sub

The script can be continued in this fashion all the way through 99, if you desire.  The advantage of this method is that it allows for all two digit field names which comes in handy for the associated "Next Field" command, shown below.

Practically speaking, this command will work slightly faster if you make it a DVC command.  In this case you must use a basic DVC command as the starting point, name it, add the 1-99 list, and then use the identical programming with the exception of the list variable term which is changed from "ListVar1" to "_arg1".  Also the Sub Main and End Sub statements are not included.  The programming will therefore look as follows:

A simpler alternative to using the "Heardword" select command, is to use a simple "Find" command as shown in the simple method at the top.  Assuming once again that you're using it in a command with a <1-99> list, the script would appear as follows:

Advanced Scripting Method:

Sub Main

     SendKeys "^f"

     SendKeys "["& ListVar1 & "]"

     SendKeys "{enter}"

     SendKeys "{esc}"

     HeardWord "\Cap"

End Sub

Legacy (DVC) Method

Sendkeys "{ctrl+f}"

Sendkeys "["+_arg1+"]"

Sendkeys "{enter}"

Sendkeys "{esc}"

Heardword "\Cap"

The advantage of this simple method, whether you do it with Advanced Scripting or DVC format is simplicity of construction.  The disadvantage is that the single digit field numbers (1-9) will have to appear as [1],[2],[3], etc. rather than the [01],[02],[03], etc. format as used with the more complex command using the HeardWord statement.  The only reason this is important is that if you want to combine it with another command such as the following "Next" command, it leaves you with field names of two different length (3 characters for 1-9 and 4 characters for 10-99).

The "Next Field" Command

Once you have the field structure set up, it is also possible to move sequentially from field to field with the following simple command:

Advanced Scripting Format:

Sub Main

    Sendkeys "{right}"

    SendKeys "^f"

    SendKeys "["

    SendKeys "{enter}{esc}"

    SendKeys "+{right 3}"

    Heardword "\Cap"

End Sub

DVC Format

SendKeys "{right}"

Sendkeys "{ctrl+f}"

Sendkeys "["

Sendkeys "{enter}{esc}"

Sendkeys  "{shift+right 3}"

Heardword "\Cap"

This command simply finds the next left bracket and selects it, along with the next 3 characters to the right, which selects the entire 4 character field.  This command will be a problem when you have some loose left brackets in a document, but this tends to be rare in our experience.

Insert Field Command:

Another related command, which can be used to quickly insert numbered fields is one which we call "Insert Field <1-99>" and it is used when constructed a letter or note template that is to contain navigation fields.  Whether it is worth your time to construct this or not is up to you.  

Shown below is a DVC formatted command of this type, which can be continued to as high a number as you desire.  Practically speaking I rarely use more than 20 fields in a given document  Here's the command:

Addendum: 

1.  Modifications to the above field:  One potential modification to each of the above commands is to include a "delete" statement to cause the selected field to be deleted once chosen.  The disadvantage of this is if you inadvertently select the wrong field, you've also deleted it as well.  By leaving it selected, any text you dictate will simply over-right the selected field.  And if you decide to move along by saying "Next" or "Field Twenty-two" it will move along without altering or deleting the field at which you are located.

If you do choose to add the delete line, it should be entered immediately before the HeardWord "\Cap" line, i.e.

Sendkeys "{del}"

HeardWord "\Cap"

2.  Working with lists:  If you're new to this, it's a little tricky at first.  Commands that use list variables define this in the command name which will ultimately show the list name in the format <listname> either before or after the remainder of the command name.  For the above command the command name as it appears in your command browser would be "Field <1-99>". 

To create the list, begin to type the command name and where you want the variable term to appear type a "<" character.  As soon as you type this in a command name, a "MyCommands Name Editor" box pops up as shown below.  For the purposes of the commands used for navigation, we want a field will name it "Field <1-99>".  You will find that as soon as you type the left facing symbol a new dialog box will appear as follows:

If you click on the "Insert list" button you will be presented with the following dialog box in which you can either select the appropriate list (if available) or simply type the name of the list and contents.  For this particular command we want a list called "1-99" or "1-50", or any length you desire. 

Since this list might come in handy in the future, I suggest you do the full 1-99 and simply copy and past the list below into the "List contents" portion of the dialog box. 

Here's the list to be copied and pasted:

1
10
11
12
13
14
15
16
17
18
19
2
20
21
22
23
24
25
26
27
28
29
3
30
31
32
33
34
35
36
37
38
39
4
40
41
42
43
44
45
46
47
48
49
5
50
51
52
53
54
55
56
57
58
59
6
60
61
62
63
64
65
66
67
68
69
7
70
71
71
73
74
75
77
78
79
8
80
81
82
83
84
85
86
86
87
88
89
9
90
91
92
93
94
95
96
97
98
99

Once you've pasted this into the List contents area, click "OK" and click OK again to complete the list portion of the command the completed command.  The above technique is identical whether your operating in a DVC command or a standard MyCommands Editor that is to become an "Advanced Scripting" command.  Once you've created a command with a given list, the list will be available to use in future commands.

There are, of course, other ways, perhaps simpler ways, to accomplish all that has been demonstrated above.  Hopefully this will at least get you started in the process.