Script shape

To view this content in our official product documentation, click here.

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 a 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

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 includes all scripts, irrespective of whether they are deployed. If you choose a script that isn't deployed, it will be deployed the first time it's needed, when the process flow runs.

If you have lots of scripts, use the `search` field to search by name.

Step 4\ Select which version of the script to use. Unless you have a specific reason to do otherwise, we advise using the latest version of scripts. 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 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`.