Constructs

Constructs are predefined orchestration building blocks that control flow behavior on the symphony canvas. Constructs are placed on the canvas as states, similar to activities, and are used to model decision points and routing logic in a symphony. Constructs are found under the Design panel. Two constructs are currently available: switch and filter. Others will be added in the future.

Switch construct

A switch construct is a decision-making state in a symphony that conditionally controls the flow of the orchestration. During execution, it evaluates a defined condition and, depending on the result of that evaluation, directs the flow to one of the configured branches.

Switch constructs support up to three conditional branches and a default branch. The default branch is executed when no other branch conditions evaluate to true.

The Switch icon is available under the Constructs section. Select New Symphony > Design > Constructs. If you want to introduce conditional branching, drag and drop the Switch construct onto the Symphony canvas. Then, connect it within the flow to route execution based on the configured condition, see Setting a branch condition.

You can remove a switch construct from the canvas at any time. When you delete a switch construct, a confirmation warning is displayed stating that all branch configurations and contained activities will be removed.

You can also delete individual branches from a switch construct. When you delete a branch that contains activities, a confirmation prompt is displayed to prevent accidental loss of design elements. The default branch cannot be deleted.

For more information, see: Setting a branch condition.

Filter construct

A filter construct is a conditional validation state in a symphony. It evaluates a defined condition at runtime and controls whether the symphony flow continues or stops. If the condition evaluates to true, the flow continues to the next activity. The filter status is displayed as Condition success. If the condition evaluates to false, the symphony execution stops at the filter construct and the execution is marked as completed with a status of Condition failed.

The Filter icon is available under the Constructs section. Select New Symphony > Design > Constructs.

To introduce conditional validation, drag and drop the Filter construct onto the Symphony canvas. The filter construct includes an end node that is displayed on the canvas. You can remove a filter construct from the canvas at any time.

Note: The filter name must be unique within the symphony. If a duplicate name is used, the system displays the validation error Name is already in use. Please choose a different one.

For more information, see: Setting a filter condition.