Choices
Use this field to specify a comma-delimited list of value/label pairs. In each pair, the first item is the value to be returned if the recipient selects that option. The second item is the label that appears on the selection button. For the button labels, you can use strings defined in the Strings table or literal values.
When a prompt is sent, the recipients are typically expected to select from among two or more choices. On the Inbox form, these choices are presented in the form of voting buttons that are displayed on the Response tab.
To build the list of choices using the Event Action Prompt Choices form, click the button to the left of this field.
Consider these examples:
- To use button label values
from the Strings table:
1, sYes, 0, sNo - To use expressions to
designate return values:
FGC(YesValue) + ",sYes," + FGC(NoValue) + ",sNo"
- For the parser to correctly evaluate the value/label pairs, you must have an even number of items in the list.
- If you do not specify other choices in this field, the default choices are (return = 1) and (return = 0).
The contents of this field must use this syntax:
scalarExpr1, scalarExpr2 [, ... ]
where:
- scalarExpr1 is a literal value or resolves to an expression that can be used as a return value.
- scalarExpr2 is a literal value or resolves to an expression that can be used as text or as a reference to a string in the Strings table.
If you have a mixture of literal values and expressions, connect them in the list with plus (+) signs, as shown in the examples.
When you click to return to the Event Actions form, the application "wraps" this content within a CHOICES( ) parameter, which yields this final syntax:
CHOICES( scalarExpr1, scalarExpr2 [, ... ] )
In most cases, the application automatically places double quotation marks around the list when returning it to the Event Actions form. However, in some cases, for instance, if the first item in the list is an expression, the application does not insert the quotation marks.
When checking the syntax in the Event Actions form, you must make sure that literal values (and comma delimiters) are enclosed in quotation marks, and expressions are not. Be aware that, if you do not do so, clicking the button does not detect the error.