Initialising a process flow manually with a payload

Introduction

The initialise flow (advanced) option can be used if you want to run a process flow immediately with a given payload in a single operation - it's particularly useful if you are sending data into Patchworks via the Patchworks API or a webhook and need to test a process flow with specific data.

If the virtual environments feature is enabled, you can also use the initialise flow (advanced) option to run the process flow against a given virtual environment - for more information, please refer to Testing a process flow against a virtual environment.

Need to know

  • The maximum number of characters for a single payload is 100k. Anything larger than this may cause the process flow to fail.

  • Your subscription tier determines the number of process flow runs that can be started per minute - please see Core subscription tiers for information.

  • When working with draft process flows, you cannot edit shapes while the flow is being run manually.

The steps

To initialise a process flow manually with a payload, follow the steps below.

Using the initialise flow (advanced) option

1

Access the first process flow that you want to run, so it's displayed on the canvas. If necessary, use the versions panel in process flow settings to switch to the required flow version.

2

Select the initialise flow (advanced)

Select the initialise flow (advanced) option from the actions bar - for example:

The initialise flow (advanced) page is displayed:

Here, the left panel can be used to pass in a specific payload, and the right panel shows whether flow and/or environment values are present.

3

Apply payload

Paste your required payload into the payload panel - for example:

4

Review flow variables (if applicable)

If flow variables are present in the current flow version, a flow variables section is displayed -click the associated arrow to display any flow variables defined for the current version - for example:

If required, you can use the associated toggle option to override the current variable value - for example:

Any value specified here is applied for this run only.

5

Review virtual environment variables (if applicable)

If a virtual environment variables section is displayed, it means that at least one virtual environment is deployed for your company profile. Click in the virtual environment field and select the environment that the current flow should run against - for example:

Any replacement environment variables configured for the selected virtual environment are listed below - for example:

If required, you can use the associated toggle option to override the current variable value - for example:

Any value specified here is applied for this run only. For more information, please see Testing a process flow against a virtual environment.

6

Run the process flow

Click the initialise flow button at the bottom of this page:

7

Check the logs and generated payloads to ensure that results are as expected. When you're satisfied that the process flow is running correctly, you can deploy it to the virtual environment.

Last updated