Show TOC

Background documentationDefine Switch Dialog Box Locate this document in the navigation structure

 

You use the Define Switch dialog box to define multiple execution flows, by specifying the input from multiple sources (such as a data service and a form view) to be passed by the Switch operator as input to a single model element.

You display the Define Switch dialog box by selecting a Switch operator icon on the Design board and clicking the browse button next to the Configuration field in the Configure Element task panel, or by right-clicking the Switch operator icon on the Design board and choosing Define Operator from the context menu.

The Define Switch dialog box contains the following items:

Item

Description

Add Row

Adds another row to the list. For each row, you define the fields whose data is received as input from the different data sources and passed through the operator. Note that in each row, the data type must be the same for the defined fields.

Delete Row

Removes the highlighted row from the list.

Move Up

Moves the highlighted item one place up in the list.

Move Down

Moves the highlighted item one place down in the list.

<Port Name>

A <Port Name> column is displayed for each data source output port that is connected to the Switch operator. For each connected port, specify the field that contains the data that you want to output from the operator to the target field.

In the dropdown list, you can select a field from the output port connected to the operator, or you can select Define expression to define a field using the Dynamic Expression Editor dialog box.

Note Note

You connect each data source output port that you want to merge (for example, data service, view element, or other operator) to a separate input port on the Switch operator. You add and remove ports on the operator by right-clicking the operator icon on the Design board and choosing Add Port or Remove Port from the context menu. You can add an unlimited number of ports.

End of the note.

Field Name

The name of the new target data field to which to assign the source field values.