Bridge utilities: Utility Functions

Utility Functions are modules that enhance workflow automation by enabling data manipulation, storage, and interaction with external systems. 

Utility Functions modules 

Add Entity 

This module adds new entities or records within the workflow context. For example, if you have a workflow where status data can be returned as a value in an array or not in an array, and you must reference that value elsewhere in your workflow, you have to reference both. Instead, use only two references in Add Entity and reference the state's output throughout the workflow.

1. Find the Add Entity module in your left navigation panel in Utilities > Utility functions.
2. Drag a new state into the workflow and give it a name, e.g., status. The state must be above any modules that need to use the status returned.
3. Below the module, your workflow gets the value to reference drag in the module Add Entity. The Add Entity utility requires you to fill in the following fields:

• State Name: Name of the state you just added.
• Entity Value: Reference the values you want to set the state to, {{||}}. This sets the value of the state using the reference that isn't empty.
• Name Of Entity: Name of the entity you want to set.

In subsequent modules where you need to reference the status, use the output of the state you created instead. You can find it by selecting the state and copying the value under Output in the panel for the state.

Store data

Stores and retrieves data scoped to a user, workflow run, or globally. Specify these three values when storing data:

• Storage Location: Where to store the data. Valid options are user, request (data tied to a particular workflow run), or global (data accessible across all workflows).
• Name of DataStore: What key to store the data.
• Data To Store: The data to be stored.

If you are looking to store simple key-value pairs, use the Key Management functions. Data Storage is mainly for storing JSON Objects.

Retrieve Data

Access previously stored data within a workflow. Specify these two values when retrieving data:

• Storage location: Where to store the data. Valid options are user, request, or global.
• Name of DataStore: What key to store the data under.

Delete data

Remove stored data from your workflow's data storage. Specify these two values when deleting data:

• Storage location: Where to remove the data from. Valid options are user, request, or global.
• Name of DataStore: What key to remove the data from.

Check data

This module creates a junction in your workflow. It verifies the existence of specific data within your workflow's data storage and redirects to a path depending on whether it exists. Specify these values when checking data:

• Name: Name of the state.
• Storage Location: Where the data is stored, valid options are user, request, or global.
• Name of DataStore: What key the data is stored under.

Delay

Introduces a pause in your workflow's execution. The Delay module requires you to enter one of the following fields:

• Delay: the seconds you want to wait until Bridge executes the next step of your workflow.
• String: a string from which Bridge calculates the delay according to its length.

You can specify a delay in seconds or reference a text, and Bridge automatically calculates a delay based on the string length.

Alternatively, you can leave both options blank and have Bridge pick a random delay between 0 and 60 seconds.

The maximum delay possible is 60 seconds. If a longer time or string is specified, the delay will still be 60 seconds.