Flow Step Trigger (After, Before, Error) Flow Behavior
  • 01 Oct 2021
  • 2 Minutes to read
  • Dark
    Light
  This documentation version is deprecated, please click here for the latest version.

Flow Step Trigger (After, Before, Error) Flow Behavior

  • Dark
    Light

Overview

This tutorial demonstrates how to use the Flow Step Trigger Flow Behavior. This Flow Behavior is commonly used for Flow debugging purposes. There are three types of this Flow Behavior: After, Before, and Error. A Flow is created using one of these behaviors and applied to specified steps in another Flow; it can be triggered Before/After step execution or if the step throws an Error.

Example

This example will walk through the process of creating a simple Step Trigger Flow that applies to a step in another Flow. Begin in a Designer Folder and select the Create Flow button in the bottom Action Bar. Select the Default template and name this Flow Trigger Flow, then click Create.

  1. From a Designer Project, select CREATE FLOW from the Global Action Bar.
  2. Select Flow, provide a Name, and click CREATE.

  3. Connect the Start step to the End step.
  4. Navigate to the Properties tab on the right; under SETTINGS > Behavior Type, select Flow Step Trigger (After)


  5. From the FAVORITE STEPS category of the Toolbox tab, add a Log Step between the Start and End steps.

  6. Select the Log Step to navigate to Properties > Setup Log > Type, select Warn from the dropdown, then change the Category to "Step Trigger".
  7. Under the Inputs section for this step, change Value to use a mapping type of Merge HTML Text. Click Show Editor and when the Merge Text Editor appears, expand the Step Run Data on the left side. Hover over a piece of data in this list and use the plus icon to insert it into a message on the right. Configure the message with the following parameters, then save and close the Trigger Flow.
    Configure the Value as:

    [StepRunData.StepName] Data

    Input Values [StepRunData.InputValuesData]

    Output Values [StepRunData.OutputValuesData] 

    The configuration of the Log step in this example is explored in the GIF below.  


  8. Save the Flow, then close via the at the top right.
  9. From the Designer Project, CREATE another Flow. Select the Default template and name this Flow Main Flow, then click Create.
  10. From the Flow Designer, attach a Create Data step from Toolbox > FAVORITE STEPS, to the Start and End steps. 
  11. Navigate to the Create Data step's Properties; under DATA > Data To Create, click SHOW EDITOR.
  12. Define a String [Text] type with Name "Test". Then, Constant map the Input as "DemoTest." Click CLOSE. 
  13. From the Create Data step's Properties, expand TESTING AND SIMULATION, then expand Triggers.
  14. Expand the After Trigger Type drop-down list and select RunFlow. When the After Trigger Flow box appears, select Pick and choose the Trigger Flow created earlier.

    Using the Store option in the Before/After/Error drop-down list saves the step execution details.

  15. The Main Flow is now complete. Save and close the Flow. 



Debug 

  1. From the Designer Project, right-click the Main Flow that has the Flow Trigger assigned to it.
  2. Click Run Flow.
     
  3. Navigate to System > Administration > System Tools > Logging in the Decisions Studio to view the most recent logged data.
  4. Select the line item that corresponds to the Flow Step Trigger Flow to view the full Log Message as exemplified in the below screenshot. The details include the message that was configured with the Log Step in our Flow that uses the Flow Step Trigger behavior type.




Was this article helpful?