Skip to content

Data Storage

Reference


Using the Data Storage component, you can easily manage and operate on lists and objects by setting or retrieving any desired data. This process employs a key-value store mechanism, where the key represents the field’s name and the value corresponds to the particular data’s actual value.

Categories: [helpers]

Version: 1


Actions

Append Value to List

Append value to the end of a list. If the list does not exist, it will be created.

Properties

NameTypeControl TypeDescription
ScopeSTRINGSELECTThe namespace for appending a value.
KeySTRINGTEXTThe identifier of a list must be unique within the chosen scope, or a new value will overwrite the existing one.
TypeINTEGERSELECTThe value type.
Value[]ARRAY_BUILDERThe value to set under given key.
ValueBOOLEANSELECTThe value to set under given key.
ValueDATEDATEThe value to set under given key.
ValueDATE_TIMEDATE_TIMEThe value to set under given key.
ValueINTEGERINTEGERThe value to set under given key.
ValueNULLNULLThe value to set under given key.
ValueNUMBERNUMBERThe value to set under given key.
Value{}OBJECT_BUILDERThe value to set under given key.
ValueSTRINGTEXTThe value to set under given key.
ValueTIMETIMEThe value to set under given key.
Append a list as a single itemBOOLEANSELECTWhen set to true, and the value is a list, it will be added as a single value rather than concatenating the lists.

Atomic Increment

The numeric value can be incremented atomically, and the action can be used concurrently from multiple executions.

Properties

NameTypeControl TypeDescription
KeySTRINGTEXTThe identifier of a value to increment.
ScopeSTRINGSELECTThe namespace to obtain a value from.
Value to addINTEGERINTEGERThe value that can be added to the existing numeric value, which may have a negative value.

Output

Type: INTEGER

Await Get Value

Wait for a value under a specified key, until it’s available.

Properties

NameTypeControl TypeDescription
KeySTRINGTEXTThe identifier of a value to wait for.
ScopeSTRINGSELECTThe namespace to obtain a value from.
TypeINTEGERSELECTThe value type.
Default value[]ARRAY_BUILDERThe default value to return if no value exists under the given key.
Default valueBOOLEANSELECTThe default value to return if no value exists under the given key.
Default valueDATEDATEThe default value to return if no value exists under the given key.
Default valueDATE_TIMEDATE_TIMEThe default value to return if no value exists under the given key.
Default valueINTEGERINTEGERThe default value to return if no value exists under the given key.
Default valueNULLNULLThe default value to return if no value exists under the given key.
Default valueNUMBERNUMBERThe default value to return if no value exists under the given key.
Default value{}OBJECT_BUILDERThe default value to return if no value exists under the given key.
Default valueSTRINGTEXTThe default value to return if no value exists under the given key.
Default valueTIMETIMEThe default value to return if no value exists under the given key.
Timeout (1 to 300 sec)INTEGERINTEGERIf a value is not found within the specified time, the action returns a null value. Therefore, the maximum wait time should be set accordingly.

Delete Value

Remove a value associated with a key in the specified scope.

Properties

NameTypeControl TypeDescription
KeySTRINGTEXTThe identifier of a value to delete, stored earlier in the selected scope.
ScopeSTRINGSELECTThe namespace to delete a value from. The value should have been previously accessible, either in the present workflow execution, or the workflow itself for all the executions, or the user account for all the workflows the user has.

Delete Value from List

Delete a value from the given index in a list.

Properties

NameTypeControl TypeDescription
KeySTRINGTEXTThe identifier of a list to delete value from, stored earlier in the selected scope.
ScopeSTRINGSELECTThe namespace to delete a value from. The value should have been previously accessible, either in the present workflow execution, or the workflow itself for all the executions, or the user account for all the workflows the user has.
IndexINTEGERINTEGERThe specified index in the list will be removed, and if it doesn’t exist, the list will remain unaltered.

Get All Entries(Keys and Values)

Retrieve all the currently existing keys from storage, along with their values within the provided scope.

Properties

NameTypeControl TypeDescription
ScopeSTRINGSELECTThe namespace to get keys from.

Output

Type: ARRAY

Properties

TypeControl Type
{}OBJECT_BUILDER

Get Value

Retrieve a previously assigned value within the specified scope using its corresponding key.

Properties

NameTypeControl TypeDescription
KeySTRINGTEXTThe identifier of a value to get, stored earlier in the selected scope.
ScopeSTRINGSELECTThe namespace to get a value from. The value should have been previously accessible, either in the present workflow execution, or the workflow itself for all the executions, or the user account for all the workflows the user has.
TypeINTEGERSELECTThe value type.
Default value[]ARRAY_BUILDERThe default value to return if no value exists under the given key.
Default valueBOOLEANSELECTThe default value to return if no value exists under the given key.
Default valueDATEDATEThe default value to return if no value exists under the given key.
Default valueDATE_TIMEDATE_TIMEThe default value to return if no value exists under the given key.
Default valueINTEGERINTEGERThe default value to return if no value exists under the given key.
Default valueNULLNULLThe default value to return if no value exists under the given key.
Default valueNUMBERNUMBERThe default value to return if no value exists under the given key.
Default value{}OBJECT_BUILDERThe default value to return if no value exists under the given key.
Default valueSTRINGTEXTThe default value to return if no value exists under the given key.
Default valueTIMETIMEThe default value to return if no value exists under the given key.

Set Value

Set a value under a key, in the specified scope.

Properties

NameTypeControl TypeDescription
KeySTRINGTEXTThe identifier of a value. Must be unique across all keys within the chosen scope to prevent overwriting the existing value with a new one. Also, it must be less than 1024 bytes in length.
ScopeSTRINGSELECTThe namespace to set a value in. The value should have been previously accessible, either in the present workflow execution, or the workflow itself for all the executions, or the user account for all the workflows the user has.
TypeINTEGERSELECTThe value type.
Value[]ARRAY_BUILDERThe value to set under the specified key.
ValueBOOLEANSELECTThe value to set under the specified key.
ValueDATEDATEThe value to set under the specified key.
ValueDATE_TIMEDATE_TIMEThe value to set under the specified key.
ValueINTEGERINTEGERThe value to set under the specified key.
ValueNULLNULLThe value to set under the specified key.
ValueNUMBERNUMBERThe value to set under the specified key.
Value{}OBJECT_BUILDERThe value to set under the specified key.
ValueSTRINGTEXTThe value to set under the specified key.
ValueTIMETIMEThe value to set under the specified key.

Set Value in List

Set value under a specified index in a list.

Properties

NameTypeControl TypeDescription
KeySTRINGTEXTThe identifier of a list. Must be unique across all keys within the chosen scope to prevent overwriting the existing value with a new one. Also, it must be less than 1024 bytes in length.
ScopeSTRINGSELECTThe namespace to set a value in. The value should have been previously accessible, either in the present workflow execution, or the workflow itself for all the executions, or the user account for all the workflows the user has.
IndexINTEGERINTEGERThe index in a list to set a value under. The previous value will be overridden.
TypeINTEGERSELECTThe value type.
Value[]ARRAY_BUILDERThe value to set under the specified list’s key.
ValueBOOLEANSELECTThe value to set under the specified list’s key.
ValueDATEDATEThe value to set under the specified list’s key.
ValueDATE_TIMEDATE_TIMEThe value to set under the specified list’s key.
ValueINTEGERINTEGERThe value to set under the specified key.
ValueNULLNULLThe value to set under the specified key.
ValueNUMBERNUMBERThe value to set under the specified list’s key.
Value{}OBJECT_BUILDERThe value to set under the specified list’s key.
ValueSTRINGTEXTThe value to set under the specified list’s key.
ValueTIMETIMEThe value to set under the specified list’s key.