--- schema_version: "1" id: 60ac55055fc9951ac0bed769fa18bff515e596e5a4e323726291d415bf8bfa30 title: Run a Data Processing Engine Definition in Flows collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/ind/264-0-0/dpe_run.md canonical_url: https://help.salesforce.com/s/articleView?id=ind.dpe_run.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: 258ad82b837db3e3f13a54677c826592edbb8e1883bf6e3504079f3751e0cde5 description: After you activate a Data Processing Engine definition, run it as part of a business flow or create a flow to run only a definition. You can also run a definition in a scheduled flow. products: - Cross Cloud release: "264" --- # Run a Data Processing Engine Definition in Flows After you activate a Data Processing Engine definition, run it as part of a business flow or create a flow to run only a definition. You can also run a definition in a scheduled flow. ### Required Editions
View supported editions.
User Permissions Needed
To create a business flow: View permissions information.
To run a Data Processing Engine definition: View permissions information.
You can’t start two runs of a definition with the same input variable values simultaneously. If your definition doesn’t contain input variables, you can't start two simultaneous runs. ![Warning](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-data_processing_engine-264-0-0-production-enus/80e06924-e6c0-4b82-81cf-e99ccd77d857/images/icon_warning.png) Warning When you start multiple simultaneous runs, ensure that the runs don't process the same data multiple times and write back duplicate results, or overwrite another run's results. #### See Also - [Flow Builder](https://help.salesforce.com/s/articleView?id=platform.flow.htm&type=5&language=en_US) ## Learn About User Context for Running Definitions as Part of Automated Processes When a definition is run using the custom Data Processing Engine invocable action from a flow or from resources such as Connect APIs and Apex, permissions to run the definition and the permissions to write back results come from two distinct users.
Run Method User Context to Run Definition User Context to Write Back Results
Flow
  • If a default workflow user is selected for the org, the definition is run with the permissions of the selected user.
  • When you don't select a default workflow user for your org, Data Processing Engine automatically selects a qualifying user. The selected user must have either the System Administrator profile or an equivalent profile with Customize Application, Modify All Data, and Manage Flows permissions. The user must also be assigned to Data Pipelines Base User or Data Cloud Architect permission sets depending on the definition's runtime.

    If multiple users meet these criteria, Data Processing Engine selects the first eligible user after sorting them by username.

To change a default workflow user, see Identify Your Salesforce Org’s Default Workflow User.
  • If a writeback user is selected for a Writeback Object node, the node's results are written back with the permissions of the selected user.
  • If a writeback user isn't selected for a Writeback Object node, the definition automatically selects the user who ran the definition as the writeback user of the node.
Invocable action The definition is run with the permissions of the user that invoked the action.
  • If a writeback user is selected for a Writeback Object node, the node's results are written back with the permissions of the selected user.
  • If a writeback user isn't selected for a Writeback Object node, the definition automatically selects the user who ran the definition as the writeback user of the node.
When running a definition, Data Processing Engine doesn't verify whether the users have the required access to the data source objects or the writeback objects of the definition. For both users, make sure that the users have the required access to the data sources and the writeback objects. To learn about the permissions required to run definitions and write back results, see [Data Processing Engine Setup](https://help.salesforce.com/s/articleView?id=ind.dpe_setup.htm&release=264.0.0&type=5 "Assign users system permissions, object access, and permission sets that they require to manage, run, and monitor Data Processing Engine (DPE) definitions. User permissions for Data Processing Engine vary based on the runtime platform your company uses to run definitions."). ## Add Data Processing Engine Action in Flows 1. From Setup, in the Quick Find box, enter Flows, and then select **Flows**. 2. Click **New**. 3. In the New Flow window, select a flow type. 4. Select a layout. 5. Drag the **Action** element onto the canvas. 6. In the New Action window: 1. In the Category section, select **Data Processing Engine**. 2. Enter the Data Processing Engine definition that you want to run, and then select it. The name of each definition is appended with the name of the process type selected when creating a definition. The process type determines how the definition processes data. The license associated with each process type decides how Data Processing Engine must process data in your definition. 3. Specify the value of the input variables that you defined in the Data Processing Engine definition. 4. Click **Done**. ![Flow action to run a Data Processing Engine definition.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-data_processing_engine-264-0-0-production-enus/80e06924-e6c0-4b82-81cf-e99ccd77d857/data_processing_engine/images/data_processing_engine_flow_schedule.png) 7. Save your work, and name your flow. 8. Activate your flow. 9. If your flow isn’t scheduled, run the flow by clicking **Run**. If your flow is scheduled, the definition runs based on the schedule you set. After the definition runs, use Monitor Workflow Services to track its progress and status.