Switch

Directs the flow of actions to one of multiple branches based on the value of a single variable.

When the action runs, the value is evaluated for a match to a possible value. If a match exists (or if the "Other" child branch exists), then the related child branch executes. If no match exists (and there is no "Other" child branch), then no child branch executes and the workflow suspends.

What can I do with this workflow action?

You can use this action to define value-dependent paths for the workflow to take.

Action settings

Do one of the following to open the Action configuration window:

  • Double-click the action.
  • Click on the action and then click Configure.

See Action configuration window for more information.

Section Field Description
(none) Select the variable to evaluate

The workflow variable or other valid reference that, when resolved to a value that matches a branch value, determines which child branch to run.

(none) Enter a value for each branch

Values for which to add child branches. Values must be compatible with the data type of the variable being evaluated.

Add switch value: Adds a value and renders an associated child branch in the workflow designer.

: Deletes the indicated value and removes any workflow actions in the associated child branch.

Other Options Include branch for unlisted values ("Other")

When selected, adds a child branch named “Other” to run if the value of the evaluated variable does not match any defined values (under Value for each branch). When cleared and the value of the evaluated variable does not match defined values, the workflow suspends.

The best practice is to select this option to add the "Other" branch and include child actions in the branch to manage this situation appropriate to the workflow intent.

Other Options Log value of "Other" branch

When selected and the "Other" branch is executed, logs the value of the evaluated variable to the workflow history.

For more information about how to use Lookups in configuration fields, see Lookups in action configuration fields.