DataStore

Description

The DataStore module is the workflow’s main structured data storage system. It supports multiple actions: add records (add), bulk add (bulk), filter (filter), get a specific field (getField), check existence (exists), delete (delete), modify tags (modifyTags), replace tags (replaceTags), batch tag operations (batchTags) and map keys to values (map). Records are organized in groups, each with a unique key and optional tags. Tags allow categorizing and filtering records with OR, AND or exclusion modes. Supports dynamic variables {{variable}} in fields like key, row and tags.

Configuration

Parameters vary depending on the selected action. Available variants are:

DataStore Add (`action: add`)

Parameter	Type	Required	Description
group	dataStoreGroup	Yes	Group where to store the record.
key	text	Yes	Field to use as unique identifier. Supports `{{variable}}`.
row	text	Yes	Data to store. Use `{{data}}` for the complete input.
tags	dataStoreGroupTags	No	Group tags to assign to the record.

DataStore Bulk Add (`action: bulk`)

Parameter	Type	Required	Description
group	dataStoreGroup	Yes	Group where to store the records.
key	text	Yes	Field of each object to use as unique key.
dataKey	text	Yes	Array of objects to store. Use `{{data}}` if the input is the array.
tags	dataStoreGroupTags	No	Tags to apply to all records.

DataStore Filter (`action: filter`)

Parameter	Type	Required	Description
group	dataStoreGroup	No	Filter by group (empty = all).
key	text	No	Filter by specific key.
tags	dataStoreGroupTags	No	Filter by tags.
tagMode	select	No	Filter mode: any (OR), all (AND), exclude. Default: any.
limit	number	No	Maximum records returned, newest first. Default 50; raise it (up to 5000) if you need the full history of a group.

The filter output is the list of records (each with its row_data already parsed into an object). The node needs action: filter; if you write it by hand in a template, do not forget it.

DataStore Get Field (`action: getField`)

Parameter	Type	Required	Description
group	dataStoreGroup	Yes	Group to search in.
key	text	Yes	Record key to search for.
field	text	Yes	Field name to get from the record.

DataStore Exists (`action: exists`)

Parameter	Type	Required	Description
group	dataStoreGroup	Yes	Group to search in.
key	text	Yes	Key to search for.
tags	dataStoreGroupTags	No	Also filter by tags (optional).
tagMode	select	No	Filter mode: any (OR), all (AND).

DataStore Delete (`action: delete`)

Parameter	Type	Required	Description
id	text	No	Specific record ID to delete.
group	dataStoreGroup	No	Record group (if no ID is specified).
key	text	No	Record key to delete (used with group).

DataStore Modify Tags (`action: modifyTags`)

Parameter	Type	Required	Description
ids	text	No	Record IDs separated by comma.
group	dataStoreGroup	No	Group to filter records (if no IDs).
tags	dataStoreGroupTags	No	Filter tags to find records.
add	dataStoreGroupTags	No	Tags to add to records.
remove	dataStoreGroupTags	No	Tags to remove from records.

DataStore Replace Tags (`action: replaceTags`)

Parameter	Type	Required	Description
group	dataStoreGroup	Yes	Group where to search for records.
filterTags	dataStoreGroupTags	No	Filter records by these tags before replacing. If empty, applies to the entire group.
tagMode	select	No	Filter mode: any (OR), all (AND). Default: any.
oldTag	dataStoreGroupTags	Yes	The tag to replace (select from group list).
newTag	text	Yes	The new tag that will replace the old one. Can be existing or new.
ifNotFound	select	No	If the record doesn’t have the tag to replace: `skip` = do nothing (default), `assign` = assign the new tag anyway.
log	select	No	Log actions to the logs table. Default: No.

DataStore Batch Tags (`action: batchTags`)

Parameter	Type	Required	Description
group	dataStoreGroup	Yes	Group to search in.
filterTags	dataStoreGroupTags	Yes	Tags to filter the records on which the action will be applied.
filterMode	select	No	Filter mode: any (OR), all (AND), exclude. Default: any.
batchAction	select	Yes	Action to apply: `add` (add tags), `remove` (remove tags), `replace` (replace tag).
addTags	dataStoreGroupTags	No	Tags to add (visible when batchAction = add).
removeTags	dataStoreGroupTags	No	Tags to remove (visible when batchAction = remove).
oldTag	dataStoreGroupTags	No	Tag to replace (visible when batchAction = replace).
newTag	text	No	New tag (visible when batchAction = replace).
ifNotFound	select	No	If tag not found: skip or assign (visible when batchAction = replace).
log	select	No	Log actions. Default: No.

DataStore Map (`action: map`)

Parameter	Type	Required	Description
group	dataStoreGroup	Yes	Group to search in.
keys	text	Yes	Array of keys to map. Supports `{{data.ids}}`.
field	text	Yes	Field to extract from each record.
transform	select	No	Transformation: uppercase, lowercase, trim, or none.

Assignment assistant (Key and Field)

So you don’t have to remember or type names by hand, the key and field fields include an assistant: a magnifier button next to the {} variables button. Clicking it opens a list of what already exists in the selected group.

Field	Nodes	What it lists
`key`	Add, Filter, Get Field, Exists, Delete	The group’s keys (up to 50), with a preview of the record. With more records, type in the search box to filter.
`field`	Get Field, Map	The fields found in the group’s latest records, with their type and an example.

How to use it:

Choose the group first. Without a group, the assistant reminds you.
Click the magnifier on the key or field field.
Search if needed and click a value: it is written into the field.

Good to know:

It is a help, not a requirement. You can still type the value by hand or use a variable such as {{data.order}}.
If the group is a variable (for example {{data.group}}), the assistant cannot know what is inside: type the value by hand.
Fields are inferred from real records. Only top-level fields are offered, which is what these nodes read. If the group has no records yet, there are no fields to show.
Permissions. You need permission to view the DataStore; otherwise the assistant shows a notice instead of the list.
Loaded on demand. Data is requested when you open the assistant, not when you open the node.

Output

Varies by action:

Add

{ "nextModule": "siguiente", "data": { "success": true, "key": "clave_registro" } }

Filter

{ "nextModule": "siguiente", "data": [{ "id": 1, "group_name": "clientes", "record_key": "juan", "row_data": {}, "tags": [] }] }

Exists

{ "nextModule": "siguiente", "data": { "isFound": true, "message": "Found", "row": { "datos": "del_registro" } } }

Delete

{ "nextModule": "next", "data": { "success": true, "deletedCount": 1 } }

Replace Tags

{ "success": true, "replaced": 15, "skipped": 3, "assigned": 0, "total": 18 }

Batch Tags

{ "success": true, "matchedRecords": 50, "action": "replace", "ids": [1, 2, 3], "result": { "replaced": 45, "skipped": 5, "assigned": 0, "total": 50 } }

Usage Example

Basic case

{
  "label": "DataStore Add",
  "action": "add",
  "group": "clientes",
  "key": "{{data.email}}",
  "row": "{{data}}",
  "tags": ["nuevo"]
}

Replace a tag across the entire group

{
  "action": "replaceTags",
  "group": "orders",
  "oldTag": "pending",
  "newTag": "processed",
  "ifNotFound": "skip"
}

Replace tag only on records matching certain tags

{
  "action": "replaceTags",
  "group": "orders",
  "filterTags": ["urgent", "vip"],
  "tagMode": "all",
  "oldTag": "pending",
  "newTag": "priority",
  "ifNotFound": "assign",
  "log": "true"
}

Batch: add tag to all matching records

{
  "action": "batchTags",
  "group": "customers",
  "filterTags": ["new"],
  "filterMode": "any",
  "batchAction": "add",
  "addTags": ["welcome-sent"]
}

Batch: remove tags from filtered records

{
  "action": "batchTags",
  "group": "customers",
  "filterTags": ["temp", "test"],
  "filterMode": "any",
  "batchAction": "remove",
  "removeTags": ["temp", "test"]
}

Batch: replace tag on matching records

{
  "action": "batchTags",
  "group": "products",
  "filterTags": ["active"],
  "filterMode": "any",
  "batchAction": "replace",
  "oldTag": "active",
  "newTag": "discontinued",
  "ifNotFound": "skip",
  "log": "true"
}

Notes

Supports dynamic variables {{variable}} in key, row, dataKey and tags fields.
The key and field fields have an assistant to pick existing values: see Assignment assistant.
If the action is add and a record with the same key already exists in the group, it is updated.
For bulk, the input can be an array or an object that is converted to an array.
The exists action returns isFound: true/false with the record data if it exists.
The delete action can delete by direct ID or by group + key combination.
The modifyTags action allows adding and removing tags simultaneously on multiple records.
The map action allows getting a specific field from multiple records at once, with optional transformations.
The replaceTags action searches for a specific tag on each record and replaces it with another. If the record doesn’t have the tag, you can configure it to assign the new tag anyway (ifNotFound: assign) or do nothing (ifNotFound: skip).
The batchTags action first filters records by tag match and then applies a bulk operation: add tags, remove tags, or replace one tag with another.
Each variant has its own parentNode dataStore and its own icon/color for easy visual identification.

DataStoreTrigger (trigger activated by DataStore changes)
dataframe (legacy version, obsolete)
decision (to evaluate query results)
iterator (to iterate over filtered results)