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.

For example:

  • Use button label values from the Strings table: "1, sYes, 0, sNo"
  • Use expressions to designate return values: FGC(YesValue) + ",sYes," + FGC(NoValue) + ",sNo"
Note: 
  • You must have an even number of items in the list for the parser to correctly evaluate the value/label pairs.
  • The default choices, if you do not specify other choices in this field, are Approve (return = 1) and Disapprove (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.

When you click OK to return to the Event Actions form, the system "wraps" this content within a CHOICES( ) parameter, which yields this final syntax:

CHOICES( scalarExpr1, scalarExpr2 [, ... ] )

In most cases, the system 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 system 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 the Check Syntax button does not detect the error if you do not.

If you have a mixture of literal values and expressions, connect them in the list with plus (+) signs, as shown in the examples.