Placing Orders with a Multi-Select Prompt

In HEO, some prompts are known as "Multiple Choice" prompts. In other contexts, "Multiple Choice" might mean that you have to choose only one from a list of options. In HEO, that's known as a "List of Values" prompt; the "Multiple Choice" type prompt gives the user the option to choose multiple options from the list that is given.
See this example with the "Indication for Behavioral Restraints":

In this example, the user can select from Danger to Self, Danger to others, or Danger to property and has the option to choose more than one option (including the option to choose all three). When dealing with these kinds of prompts when ordering via VGR, you'll often start by trying to order it like this:
@LOAD_ORDER=OIS=232650^^^OOS=0^^^15275=Danger to self
When placing the order this way, it will still stop the user. In order to tell the VGR that you are trying to place an order on a Multiple Choice prompt, you need to add a backslash (\) to the end of the string.
@LOAD_ORDER=OIS=232650^^^OOS=0^^^15275=Danger to self\
Using this same logic, you can place the order with multiple options by placing the backslash between your options:
@LOAD_ORDER=OIS=232650^^^OOS=0^^^15275=Danger to self\Danger to others\Danger to property\
The most important thing to remember is that even when you send more than one choice (and even when you send all available choices), you must always end the string with a backslash.

Note: I have not yet been able to determine a good way to avoid the prompt altogether when it is set up to accept "0" values. In those cases, my best advice is to make sure that the builders include an option set to "..."

TL:DR; Separate the prompt values with a backslash. End with a backslash.


Scott Morris is available for training, mentoring, troubleshooting, and iForms consulting. Find out more at www.thinkiforms.com

0 comments: