Script shape

Introduction

If you have defined custom scripts for use in process flows, use the script shape to select a script to apply at a given point in a process flow. You can use any version of a script which has been saved and deployed.

A single incoming payload for any process flow shape should not exceed 500MB.

We recommend processing multiple, smaller payloads rather than one single payload (1000 x 0.5MB payloads are more efficient than 1 x 500MB payload!).

For payloads up to 500MB, consider adding a flow control shape to batch data into multiple, smaller payloads. Payloads exceeding 500MB should be batched at source.

Need to know

• If a script fails it is retried three times (automatically) before a failure is given.

• A script will time out if it runs for more than 120 seconds.

Adding a script shape

Show me

Step 1 In your process flow, add the script shape in the usual way:

Step 2 You're prompted to select an existing script:

Step 3 Select the script that you want to use at this point in the process flow:

The list of available scripts only includes scripts which are currently deployed for use.

Step 4 The latest deployed version of the script is added to the shape - for example:

Code is displayed in view-mode. If you need to change the script, save your shape now and then use the left-hand navigation bar to access process flows > custom scripts.

Step 5 Unless you have a specific reason to do otherwise, we advise using the latest version of scripts. However, if you do need to use a previous version of the script, select the 'versions' dropdown field to make your selection - for example:

Step 6 Save the shape:

Accessing script shape settings

To view/change the selected script for an existing script shape, click the associated 'cog' icon:

From here, the existing script is displayed - you can either select a different script, or a different version of the existing script:

Remember that the script code can't be changed here. If you need to change the script, save your shape now and then use the left-hand navigation bar to access process flows > custom scripts.