Choice Action—Setting Properties

The Choice action is used to display a message box in which the user can choose from a list of items. The item selected then populates a variable. The variable must be created in an earlier step using the Create Variable action. The list can be displayed in any of four different ways and optionally can allow multiple selections or only one selection.

To set Choice properties

  1. From the Task Builder Available Actions pane, open the Dialog folder and double-click the Choice action or drag it into the Steps pane. The following properties dialog box appears:

  1. In the Message to display box, type the message, or click the Insert Expression/Variable button and use the Expression Builder to enter a variable or expression. Usually the message is a question for the user to answer.

  2. In the List type box, select the list type to use. The Checkbox and List selections allow for multiple user selections. The Dropdown and Option selections allow for only one selection.

  3. In the Populate variable with result box, select the variable to populate.

  4. Enter the items to include on the list as follows:

  5. Click the Advanced tab.

  6. In the Title box, type the text to be displayed in the title bar.

  7. Under On cancel, select the action to be take if the Cancel button is clicked. The options are:

  8. If you want the user to be able to OK the box without making a selection, clear the Force selection check box.

  9. If you want to allow multiple selections, click Allow multiple selections. This is only active if Checkbox or List are selected as the List type.

  10. To set a time-out that automatically selects the OK button after a specified period, select Automatically press the OK button after, and then enter the number of seconds to wait.

  11. To set the Description tab properties, refer to Description Tab Options.

  12. To set the Error Causes and On Error tab properties, refer to Step Error Handling.

  13. When finished, click OK to save settings and close the properties dialog window.

See Also

About Actions

Adding Task Steps

Choice Action