This action is used to perform a particular task, which depends on the provided input. An unlimited number of inputs, each with their own output paths, can be configured. Only the matched output path is executed. You can define a default path to execute if no match is found.
The properties for this action are listed in the following table:
Property | Data Type | Access | Use |
MatchValue 1 to MatchValue N | String | In and out | Stores values that are matched to the InputValue property. The number of MatchValuelinks depends on the number of inputs specified on the configuration screen. For example, if the Switch action is configured with three inputs, there are three MatchValue inputs, MatchValue1 through MatchValue3. Each MatchValue statement must be configured using the Link Editorscreen. |
InputValue | Integer | In and out | Determines which MatchValue path is taken. Set this property through the Link Editorscreen. The path of the MatchValue property with the same value as the InputValue property is followed. If the Input Valuedoes not match any of the MatchValues, the Default path is taken. The Else path is taken after the Switchaction has completed, regardless of the output. |
MatchCount | Integer | In and out | The number of MatchValue links specified for the Switch action. |
SelectedMatchIndex | Integer | Out | Returns the index of the MatchValue property. For example, if the InputValue matches MatchValue1, 1is returned. If the InputValue matches MatchValue2, 2 is returned, and so on. If no match is found, the index of the Default path which is equal to the number of inputs plus one is returned. |
Success | Boolean | In and out | Indicates whether the action succeeded or failed. If it failed, errors are displayed in the server trace log. |