Select Action—Setting Properties

The Select action is used in conjunction with several Case actions. You use the Select action to set up an expression that can be evaluated to any of several results. You then set up a Case action for each possible result.

The block begins with the Select step containing the expression. This is followed by a Case step, then the steps to be executed if the result of the expression matches the case, and then an End Case step. Following that is another Case block containing Case, steps, and End Case. You create one Case block for each possible result of the expression.

The optional final case block is the default case, which contains the steps to be executed if the expression result does not match any of the cases. At the end of the whole block, is an End Select step.

The default Case step, its End Case step, and the End Select step are all created automatically when you create a Select step. As you create the other steps, place them into their positions within the Case blocks and the Select block.

After the steps are created, they should be indented for visual clarity.

To set Select action properties

  1. From the Task Builder Available Actions pane, open the Flow folder and double-click the Select action or drag it into the Steps pane.

  2. In the Go to case matching result of box, click the Insert Expression/Variable button and use the Expression Builder to enter the expression to evaluate.

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

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

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

To auto-indent after all steps are added

  1. In the Task Builder Steps pane, hold down SHIFT and click the first and last steps in the block so that the complete block of steps is selected.

  2. Click the Format button .

 

Select/Case example

Create a Choice step where a user can enter input, and the input populates a variable. Then create a Select step that specifies the user input variable as the expression. Then set up a series of Case blocks where each Case step contains a possible user answer and is followed by steps appropriate to that answer.

Sample Step Descriptions

Create a variable named "choice".

Display a message box containing checkboxes for the items: "one,two,three,four" (corresponding values: "1,2,3,A").  Display the text "please select one of the following".  The title of the message box is "please select one of the following".  The user can select ok without choosing any item.

Select a following case based on the result of expression: %choice%

     Case 1

          Display the message "You have selected one" in a message box.

     End Case

     Case 2

          Display the message "you selected two" in a message box.

     End Case

     Case 3

          Display the message "you selected three" in a message box.

     End Case

     Case A

          Display the message "You selected four" in a message box.

     End Case

     Default Case

          Display the message "you didn't make a selection" in a message box.

     End Case

End Select block

See Also

About Actions

Adding Task Steps

Case Action-Setting Properties

End Select Action-Properties

Select/Case Action