Data Flows provide a streamlined way to group Data Actions and trigger them using an Action button on a Board. This article explains how to create and configure Data Flows effectively.

Before you begin

Data Flows are sets of Data Actions grouped into a single configuration. Once created, they can be triggered from a Board using an Action button. This allows users to run multiple Data Actions with a single click.

To run a Data Flow from a Board, you must have permission to perform each individual Data Action in the flow.

Supported Data Actions

At this time, Data Flows support only Metric to Metric imports from Pigment.

Data Flow execution order

Data Flows run all Data Actions in parallel. Consider the following when using Data Flows:

• You can’t control the exact order in which actions are run.
• If multiple actions update the same Block, results may be unpredictable.
• If you need actions to run in a specific order like importing data then waiting for formulas to update then triggering another action Data Flows aren’t the right choice.

Create a Data flow

To create a Data Flow:

1. Select the three-dot menu and choose Data Flows, or go to All Settings then Data Flows.
2. Select Create a Data Flow.
3. In the Details section, add a name and description:
   • Use the Name field to identify the Data Flow in the list.
   • Use the Description field to explain what the Data Flow does and the business logic it follows.
4. In the Data Actions section, define the actions the Data Flow should run:
   • Select Add action to add one or more Data Actions.
   • Choose the Target Block and Configuration from the dropdown menus.
5. Select Save.

View or edit a Data Flow

All configurations are stored in the Data Flows overview, and each one is specific to an Application.

To view or edit a Data Flow:

1. Go to an Application.
2. Open the three dot menu and select Data Flows, or go to All Settings then Data Flows.
3. From the list, you can:
   • Select Show details to review a configuration.
   • Select the Edit icon to make changes.
   • Use the three-dot menu, then select Duplicate to create a copy of the configuration.

Trigger a Data Flow from a Board

You can run a Data Flow from a Board using an Action button:

1. Go to a Board.
2. Select Edit, then + Add a widget.
3. Choose Action.
4. Select Trigger Data Flow, then select the configuration from the dropdown.
5. Choose Card or Button for the widget format and add a Title, optional Description, or Button label.
6. Select Add to board.

Once added, any Member with the required permissions can trigger the Data Flow directly from the Board.

View Data Flow History

To view a history of executed Data Flows:

1. Go to an Application.
2. Select History from the sidebar.
3. Under All Actions, select Data Flows from the dropdown to view execution history.