Adding Result Steps to a Flow

There are two options for Failure response ports:

• If you don't connect a step’s Failure response port to a step, the response icon will remain with grounding and will end the flow with a default failure step.

  The default failure step can be configured to run a specific step/flow before failing.

  Use this option if there are a lot of fail points in a flow and you want the same action to occur on each failure.

  You can also use this option if you want the flow to be readable and clean, as it removes the failures from the graph and promotes the successful path of the flow.

  

• If you connect a step’s Failure response port to any step, the grounding disappears, the flow depends on what it is connected to, and does not run the default failure step.

  Use this option if you want to configure the action for a specific fail point separately.

  

Example of multiple option of how to handle failure in a flow.

1. To add Success and Custom result points to the flow, drag result steps from the Results toolbar, and place them next to the step connected to it.

   

2. Click the icon that represents one of the response ports, and drag a line to the result step for that response.

   

3. To copy, cut, paste, and rename a result step, select it and use appropriate buttons from the authoring pane toolbar .

   1. To copy a result step, click the Copy button in the authoring pane toolbar or press CTRL+C keys, then Click or press CTRL+V keys to paste.
   2. To cut a result step, click the Cut button in the authoring pane toolbar or press CTRL+X, then Click or press CTRL+V keys to paste.

   Note  

   • You can copy and paste result steps on the canvas multiple times as per your requirement.

   

4. To rename a result step, select it and click the Edit button in the authoring pane toolbar.

   Note  

   • If you rename a Success/Failure step, the new name must start with the prefix Success/Failure.
   • A Custom step can have any name.
   • A renamed step must be unique in the flow. This applies to names with different case—for example, you cannot name one step to "Success_All" and another to "success_all".
   • A renamed step cannot have a blank name.
   • You cannot change the type of a response step by renaming.
   • A Failure step cannot be named "on_failure".

You can set up a default failure step, to run by default for steps that go to the default failure. For example, you might want an email to be sent to the administrator for every failed step.

Every step whose Failure response is grounding will run the default failure step before the flows ends in failure.

1. Open the flow for which you want to create a default failure step.

2. If the Default Failure pane on the canvas is contracted, click the arrow to expand it.

   

3. Drag an operation or flow from the Projects pane or Dependencies pane into the Default Failure pane.

   

4. Bind the step inputs for this new step (and outputs if needed).

5. Save the flow.

   Note If all the Failure response ports are connected to a step, the default failure step is inactive and the icon in the top right corner of the Default Failure pane appears in gray.

   

6. To change the default failure step, drag a different operation or flow from the Projects pane or Dependencies pane into the Default Failure pane.
7. To remove the default failure step, select it and click the Delete button from the authoring pane toolbar.

8. To rename the default failure step, select it and click the Edit button in the authoring pane toolbar.

   The FAILURE results in the default error cannot be renamed.