<<*AskOptions* . . .>> ask the user to choose one or more elements among a list of elements. When creating the <<*AskOptions* . . .>> block, the choices you want to present to the end user are listed after the <<*AskOptions* command, and the !groupname!. Separate each choice with a '/'. Close the list with a '*'.
E.g.,
<<*AskOptions*!shipmethod!FedEx/UPS/USPS*>>
The tie of the AskOptions answer in to the main body of the document is via the !grouipname!. So later in the document you might have:
Your order will be sent by <<*Options*!shipmethod!Federal Express (2 day delivery)/United Parcel Service (ground; allow 4 days for delivery)/US Postal Service (1st class mail).>>
There are several 'options' (termed 'arguments' in programming jargon) that provide you flexibility in how you present the desired interview question to the end user. Arguments appear immediately after the base command, inside of parentheses, and before the '*' that closes the command.
<<*AskOptions(radio)* . . .
The standard <<*AskOption* . . .>> will present to the end user a series of check boxes from which the user can select one or more of the options.
<<*AskOptions(radio)*. . .>> presents a series of radio buttons from which the user can select only one of the options.
<<AskOptions(connector)*. . . >>
The (connector) argument adds to the bottom of the question box a group of connectors: "And", "Or" and "Enter". The items chosen from the listing are presented in a linear fashion with commas and the selected connectors interposed between the selections.
Note: Use "(connector)" only when you want all <<*Options* blocks in the main document (of the same !group!, of course) to follow the designated pattern. If one or more of the <<*Options* blocks will not be following the pattern, use the '(and)' or '(or)' arguments in the body text. See '(and)' and '(or)' arguments.
<<*AskOptions(ChooseAskTable)* . . .
This argument assumes that you have created a series of AskTables for a variety of different situations all of which are in a single document, but not all Tables are applicable to the document(s) being processed. <<*AskOptions(ChooseAskTable)*!Topic!Will/Trust/POA/Deed*>>. Before introduction of this command, you could still accomplish presenting or suppressing various questions, but it required the use (and sometimes the extensive use) of <<*IF* . . .>>equations. This command should make contructing 'top level' results much easier. The various AskTables themselves are separated the ^OR separators.
Since (like all other Ask commands, a groupname is required, that groupname can also be used to select sections of the underlying document(s). Two birds, one stone.