Flow Management Step Glossary
  • 31 Jan 2022
  • 10 Minutes to read
  • Dark
    Light

Flow Management Step Glossary

  • Dark
    Light

Article Summary

Overview 

The following article details all steps found in the Flow Management category in the Step Toolbox.


Step NameDescriptionLocation Inputs/Outputs
Start StepYou can only have ONE start step in the workflow. This is in the step library in case a start step is deleted and unrevivable.
Flow Management
Inputs:
Depends on the Flow

Outputs:
Depends on the Flow
End Step

A user can have more than one end point in a Flow and this step allows them to define additional outputs to a Flow. A user is expected to have different End Step names and they can define different data outputs at each End Step. If a user uses this Flow as a Subflow, they will see different outcome paths branching as a result.


Flow Management
Inputs:
Depends on the Flow

Outputs:
"Done"
Branch Step

The Branch Step allows for the process of multiple Flow steps in parallel rather than sequentially. Note that all branches must get merged back together using a 'Merge Step.'


Flow Management > Branching
Inputs:
None

Outputs:
None
Merge Step

This step joins back Branched paths of a Flow. When a Branched path reaches this step, it will wait by default, until all branched paths reach this step. To only be used after a Branch step or a Branch ForEach step, the AllowCancelMerge option allows the Flow to determine if the other branches should wait at this step for all to complete, or if there are circumstances where the Flow should continue. The MergeType option allows a user to determine whether this merge should be limited to this Flow, or if should include all subflows that contain branches as well. 


Flow Management > Branching
Inputs:
MergeType [] (MergeType), AllowCancelMerge (Boolean)

Outputs:
None
GoTo Step

Leaps to the step specified in the enumerated list, "GoToStepName." This reduces the clutter of Flow lines that normally criss-cross and make a workflow difficult to follow.


Flow Management
Inputs:
GoToStepName[]

Outputs:
None
Pause Flow

Temporarily halts a Flow for a particular amount of time. An input data field allows the designer to designate when the Flow may resume operation and continue along the outcome path. The "SaveFlowDataOnPause" allows the user to ensure that the Flow data is saved to the database when the step is started.


Flow Management
Inputs:
ResumeWhen (DateTime)

Outputs:
Resume
Step Statistics - Store

The Step Statistics - Store step is used to store statistics pertaining to the steps that proceed the Step Statistics - Store step in a Flow. To store information, users simply place the step after the steps they wish to record statistics. Running the Flow will return a 'Done' result and update the Flow Step Statistics Report with the newly recorded statistics. Note: the Flow Step Statistics Report exists within the System > Designers > Catalog > System Defaults Folder.



Flow Management > Error Handling
Inputs:
None

Outputs:
None
Log Step

The Log step is one of the best ways to record debugging level information in a Flow. The logging system uses a log level system and only logs when necessary which makes it very efficient. Use the LogStep instead of using Popups or Email in the Flow to get information about a Flow's execution.


Flow Management > Debugging
Inputs:
Value (String), Type (LogType), Category (String)

Outputs:
"Done"
Output Data

The Output Data step is a powerful debugging/logging step. When executed, this step will output an array of all of a Flow's data including user defined types and Flow metadata. This step can be used to create logs after an exception is thrown, send emails with Flow details to designers, etc.


Flow Management > Debugging
Inputs:
OutputValue (Boolean), OutputType (Boolean), IncludeTopLevelData (Boolean).

Outputs:
"Done" (Method)

Cancel Current Flow Execution

The Cancel Current Flow Execution step is used to stop the Flow presently running. This step is simply placed after the point in the Flow where the user wishes to cancel the Flow. This can be helpful to users who may want to stop a Flow or cut off a specific section of a Flow.


Flow Management
Inputs:
None

Outputs:
None
Create Flow Parameters

The Create Flow Parameters step is used to establish specific parameters for a Flow. The step works by utilizing a Data Definitions editor to establish the Parameters, similarly to how a Create Data step functions. Users then create the Parameters giving each one a Name, selecting a Data Type and establishing its Input. This step can be helpful to establish information that is associated with the Flow, such as a Task name or Due Date to establish what the Flow does and when its completion is due. Once the step has been set up, these Parameters may be altered and viewed via right-click Action within the Portal. For more info on this step, see linked documentation.


Flow Management
Inputs:
None

Outputs:
None
Delay Next StepThis step allows you the stall or delay a Flow from continuing for a specified amount of time. This will not PREVENT or STOP the Flow from finishing, just add a pause. 
Flow Management
Inputs:
None

Outputs:
None
Go Async
The Go Async component allows subsequent Flow steps to be run asynchronously, returning control immediately to the Flow’s calling Entity (such as a parent Flow, user or process). In other words, any steps placed after the Go Async component will run autonomously. 
Flow Management
Inputs:
None

Outputs:
None
Branch ForEach Step

The Branch ForEach step creates a branch for each of array items passed in as input. It's important to note that a merge step will be needed following the process and that forms included within the branch will need to be encapsulated into a linked flow or sub-flow. 


Flow Management > Branching
Inputs:
None

Outputs:
None
Set Flow Output ValuesThis step allows you to manually specify the output values of the specified Flow.
Flow Management
Inputs:
None

Outputs:
None
Is Flow Complete


The Is Flow Complete step is used to track progress and process logic for Flows.  The step does this by analyzing a Flow via its flow Tracking Id; this can be particularly helpful for tracking an externally ran Flow, or a Sub Flow. The step Outputs three paths based on its evaluation of the tracked Flow's progress; one for if it is 'Done' or complete, one denoting that it is 'In Progress', and one used for 'Error' handling. 


Flow Management
Inputs:
Flow Tracking Id

Outputs:
None
Output StringThe Output String step can be used to merge or define flow data and constants into a new string value.

Flow Management > Debugging
Inputs:
String

Outputs:
String
Output Data To Current Folder


The Output Data to Current Folder step is used to Output an Array of all a Flow's data including User Defined Types, and Flow's Meta Data to the Folder that the Flow resides in. This step can be used to create logs after an exception is thrown, send Emails with flow details to designers, etc. 


Flow Management > Debugging
Inputs:
Include Top Level Data, Name, Output Type, Output Value

Outputs:
None
Flow Data Exists

This step checks for existing Flow Data or System Constants within the current Flow. 


Flow Management > Data
Inputs:
None

Outputs:
None
Add Comment To Sub State


The Add Comment to Sub State step is used in Process tracking to add additional information via a Comment, to a Sub State in a Process Flow. The step includes multiple String Inputs: comment, comment Description, state Name, and sub State Name, which are used to identify which State and Sub State the user-defined Comment is affiliated with.


Flow Management > Data > Sub State
Inputs:
Comment, Comment Description, State Name, Sub State Name

Outputs:
None
Add File To Sub State

The Add File to Sub State is a step used in Process tracking to add file to a Sub State in a Process Flow. The step takes in the file via the data Input; the name Input is used to name the uploaded file. The other two Inputs on the step pertain to the Process itself and allow the user to set a Name for both the State and the Sub State. This particular example utilizes an Approval State and a Sub State called Awaiting Signature denoting that the attached file entitled Sign And Return must be signed. 


Flow Management > Data > Sub State
Inputs:
Data, Name, State Name, Sub State Name

Outputs:
None
Complete Sub State

The Complete Sub State step is used in Process tracking to mark when a Sub State in a Process Flow is completed. The Step takes in both the state and sub State via String Input. Upon completion, the user-defined Sub State will be marked as Complete in the Process Folder. The example utilizes a simple Approval State, with the Sub State being Awaiting Signature. A user would use this step to set the Sub State to Complete, denoting when the signature is obtained.


Flow Management > Data > Sub State
Inputs:
State, Sub State

Outputs:
None
Get Dependencies [From]The Get Dependencies component fetches dependencies for an object. If the "Only Unattached" variable is checked it will result in new dependencies, if not it will result in all dependencies for the object received. The Get Dependencies component fetches dependencies for an object. If the "Only Unattached" variable is checked it will result in new dependencies, if not it will result in all dependencies for the object received.

Flow Management > Dependencies
Inputs:
Id, Type Name

Outputs:
Output
Catch ExceptionThis step allows you to add some handling in the flow for any unexpected errors or situations that occur in the workflow. Instead of defining exceptions at every step this will capture anytime a flow goes awry and is a good practice to use this within all your flows. You can determine what happens when an error occurs by chaining steps preceding the 'On Exception' path. This step will capture the error message and at what step the error occurred for proper handling. 
Flow Management > Error Handling
Inputs:
None

Outputs:
Exception Full Trace, Exception Message, Exception Stack, Exception Type Name, Flow Id, Flow Name, Step Id, Step Name
Catch Outcome

This step allows you to add some handling in the flow for paths or scenarios that are not connected to a step. You can even constrain which unconnected outcomes will be captured either by the name of the path and/or by the data output from that step. Catch Outcome step will return any data defined to capture and previous step information. 


Flow Management > Error Handling
Inputs:
None

Outputs:
Previous Step ID, Previous Step Name, Previous Step Path
Step Statistics - Store

The Step Statistics - Store step is used to store statistics pertaining to the steps that proceed the Step Statistics - Store step in a Flow. To store information, users simply place the step after the steps they wish to record statistics. Running the Flow will return a 'Done' result and update the Flow Step Statistics Report with the newly recorded statistics. The Flow Step Statistics Report exists within the System > Designers > Catalog > System Defaults Folder.


Flow Management > Error Handling
Inputs:
None

Outputs:
None
Throw ExceptionThe Throw Exception step allows the Designer to create a custom exception that is triggered when it is reached in the Flow. This step works in tandem with the Catch Exception step. The message configured on the Throw Exception step will reflect in the Catch Exception step stack trace. 
Flow Management > Error Handling
Inputs:
Message

Outputs:
None
ForEach In Group StepSimilar to the ForEach step, this step accepts a list and sends out a list of that same type that share a common field that is selected at design time. This will continue to loop through and iterate on the list, following the Next Group path while there are still Groups to be iterated on. When there are no more items, it will follow the Done path. 
Flow Management > Iteration
Inputs:
Field To Group By, Collection

Outputs:
None
ForEach Step

You can process a list of items with the ForEach Step. The ForEach Step can be used to create a flow loop to perform the same actions on each item within a list from the "Next" outcome. The "Done" outcome is used when all of the items in a list have been processed. The step will attempt to recognize the type of the list passed into the "Collection" input.


Flow Management > Iteration
Inputs:
Collection

Outputs:
Item Index
ForLoop StepThis step loops through a set of steps for a specified number of iterations. In order to continue to each iteration, the resulting pathway(s) need to return to the ForLoop Step. When the quantity of iterations has been reached, the flow will continue along the 'Done' path.

Flow Management > Iteration
Inputs:
No. of Iteration

Outputs:
Item
Branch ForEach Step (Chunking) Breaks a list of objects into smaller lists for easier processing. The size of these smaller lists is controlled by the input to this step. Each smaller list will be run through the steps following this one, and should be brought back to a "Merge" step.
Flow Management
Inputs:
Collection, Type, Fail If Empty, Result Type, OutputListSize.

Outputs:
None.
Wait On Flow EndThis step causes this flow to pause until another flow is completed. The flow that triggers this step to continue should generate a Flow Tracking ID that this step expects as an input.
Flow Management
Inputs:
Flow Tracking Id

Outputs:
None
Save Flow Data In TableThis step allows a user to save all Flow Data (Variables being used within the Flow) in a Table/Defined Data Structure. When using this step in a Flow, the step creates a Data Form Structure that is stored in the same Folder, and with every Flow run, it creates an Entity that will be stored in the Folder that a user specifies.
Flow Management
Inputs:
FolderIsDynamic, AutoTypeName, AutoEntityName, SpecifyDefinitions, SpecifyEntityId, Entity Id, Folder Id

Outputs:
None
Run Contingent StepsThis step allows the execution of Flows that have been queued with the "Queue Contingent Flow" step.
Flow Management > Contingent Steps
Inputs:
On Another Thread

Outputs:
None
Cancel Contingent StepsThis steps cancels steps that have been queued with the "Queue Contingent Flow" step.
Flow Management > Contingent Steps
Inputs:
None

Outputs:
None
Add Expected State With Sub StatesThis step allows users to create the Folder States and the Sub Folder States easily.
Flow Management > Sub State
Inputs:
Color, State Name, Sub States

Outputs:
None
Throw API Exception With HeadersUsers can specify headers that are presented on an API exception, along with a custom error message and specified status code.

Flow Management > Error Handling
Inputs:
Headers, Message, Status Code

Outputs:
None

Was this article helpful?