Flow Templates

You can create a flow template when an integration flow has common steps but requires workspace-specific customization.

While this requirement is best addressed using configuration mapping or a callable flow, flow templates offer integration builders an additional method for mapping a flow’s field differently for each customer. However, before choosing to use a flow template instead of a configuration mapping, it is important to understand the limitations that this method presents.

When you add a flow template to an integration, a copy is automatically created in each new workspace to which the integration is deployed. This copy is different from other integration flows, which will display as Managed. If you make changes to the template copy within a specific workspace, those changes will only apply to that workspace. Similarly, if you edit the original flow template in the integration, it will not change any of the copies that were already created and instead only apply to new integration deployments.

Comparatively, using a flow with either configuration mapping or a called flow allows integration builders to propagate updates across all workspaces where the flow is used.

Add a Flow Template to an Integration

Follow these steps to create a flow template.

  1. In an integration, add a new feature or open the feature you want to add a flow template to.
  2. In the Flow Templates section, select Add Flow Template and choose the type you are creating.
    • Create: Create a template from a flow that already exists.
    • Use Existing: Adds a reference to an existing template in a different feature.
      Note: You can add search criteria in the Search Flows or Workspace fields to filter the flows that display.
  3. If you chose Use Existing, select the checkbox for the flow you want to use.
  4. Select Save.
The flow template is added to the integration feature. If you created a new flow template, App Xchange adds a Template tag and an icon to the template when it is displayed in a list.
When you are ready to deploy the flow template to a workspace, make sure to select its checkbox in the feature management page of that workspace to enable it, as shown in the image below:

App Xchange feature management window

Edit a Flow Template

Integration builders can edit flow templates globally within the integration or locally within a customer workspace.

  • To edit an existing flow template globally, open the flow template in the integration builder. Changes made by the flow author will update the flow across all future workspaces that use it, but not any existing copies.
  • To edit an existing flow template for a specific customer user, navigate to Customers > Selected Workspace > Flows and select the flow. Open the flow template from within the workspace to make your changes. Saving these changes creates a copy with the Template Copy tag. It does not modify the original flow template.

Was this helpful? Give us feedback.