Flow or subflow stages - Product Documentation: Vancouver

Flow or subflow stages

Build workflows > Flow Designer >

Flow or subflow stages

Communicate the current stage of a request, flow, or subflow with an end user.

When configuring stages in Flow Designer , you can:

Create any number of stages. Change stage labels and names. Set the estimated duration for a stage. Import a copy of a pre-defined stage set from the Stage Sets table. To learn more about stage sets, see Workflow stage sets . Any changes made to the copy do not affect the original stage set record.

While you can add stages to a flow that has a scheduled trigger, the stages are never displayed to an end user because there is no associated trigger record for the stage field. Only add stages to flows and subflows that have a trigger or input record.

View the stages of a flow or subflow in the flow execution details.

Displaying stages in a stage field A stage field is a field of type Workflow that displays the stages of a flow to a user. The Service Catalog table uses a Stage field to indicate the progress of a request as it is processed.

Stage fields display:

Stages from flows with record or Service Catalog triggers. Stages from the associated flow or subflow. If the associated flow calls another flow, stages set on the child flow do not display. Stages from flows or subflows that have started.

State icons in stage fields cannot be modified. Limit the number of stages and the length of each stage name to prevent wrapping text and icons onto multiple lines.

Note: Only add one stage field per table. If there is more than one stage field, the system only displays stages from the first stage field defined in the table dictionary entry.

Stage field and trigger types Associating a flow to a stage field depends on the flow trigger type.

Flow trigger type Requirements Record For a stage field to report stages on a record-based flow, a stage field must be present on the same table as the triggering record. When a flow has stages, Flow Designer communicates the status of each stage back to the triggering table and displays the current stage state as an icon. If more than one stage field exists on the table, only the first stage field defined in the table's dictionary definition is used.

Note: Avoid creating stages for multiple flows that trigger from the same table. A stage field only displays the stages of the final flow to run. Add different conditions to each flow to ensure that the stages of one flow do not overwrite another flow. Service Catalog If using the Service Catalog trigger , the flow must be associated with the Service Catalog item through the Flow field. Remove any workflows associated with the item by clearing the Workflow and Execution Plan fields. The Stage field displays the current stage state on any list view of the Requested Items [sc_req_item] table.

Stage states During flow or subflow execution, each stage can be in one of six states.

State Description Pending This stage has not yet started. In progress This stage is executing. Skipped This stage was skipped and did not run. Typically, this state is reached when a conditional flow logic block is not executed. Complete This stage is complete. Cancelled This stage was cancelled. Error This stage has reached an error condition.

When designing a flow or subflow, you can manually set its to report an Error state. To set an Error state: The flow must have at least one stage defined. The Error can only be set within a stage. When an Error condition is reached, the current stage is set to Error. The Error can only be set within a conditional flow logic block.

Each stage can have its own custom state labels. For example, suppose that you have a flow with two stages. Stage 1 could have the Pending state with the label Waiting, and Stage 2 could have a Pending state with a label of Not yet started. Flow Designer provides options to generate either the default states or approval states.

General guidelines Follow these general guidelines when creating flows or subflows with stages. Avoid defining stages that depend on a For Each flow logic

Flow Designer prevents you from adding stages within a For Each block. You can only add stages before or after a For Each block.

Avoid creating stages for the same records in different flows or subflows

A stage field always displays the stage information provided by the last flow or subflow to run on a table's record. If multiple flows or subflows run on the same records, then the stages defined in one flow or subflow can in theory overwrite the stages from another flow or subflow. To avoid multiple flows or subflows overwriting each other's stages, define unique trigger or start conditions for each flow or subflow.

Avoid updating stage fields from outside a flow or subflow

If you manage stages with a flow, avoid directly updating stage fields from outside the flow or subflow. Manually updating the value of a stage field may produce unexpected or undesired results.

Ensure that each flow on a table has unique trigger conditions

Adding unique trigger conditions to each flow ensures the flows only run under those conditions and prevents the stages from one flow overwriting the stages of another flow. Specifying unique trigger conditions makes it easier to troubleshoot flows by limiting the number of flow executions that can produce record changes.

Use error stages to communicate with the user

The flow error state does not affect flow execution. A flow continues running even if it reaches an error stage. Use a conditional flow logic block to set the error stage and communicate to the user that the state of the current stage is Error. For example, if an approval is not approved within the required limit, you may want to communicate an error to the user.

Use the error stage to stop processing a flow

Use a conditional flow logic block to identify when a flow enters the error stage. Use the flow logic to stop processing the flow or take some kind of remediation action. For example, you may want to change the record state or assignment when a flow reaches an error state.

Configure stages and add them to a flow Configure when stages display to a user, define stage state labels, and add stages to a flow within Flow Designer .

Parent Topic: Building flows