DataStore

Descripción

El modulo DataStore es el sistema principal de almacenamiento de datos estructurados del workflow. Soporta múltiples acciones: agregar registros (add), agregar en lote (bulk), filtrar (filter), obtener un campo especifico (getField), verificar existencia (exists), eliminar (delete), modificar tags (modifyTags), reemplazar tags (replaceTags), operaciones batch por tags (batchTags) y mapear claves a valores (map). Los registros se organizan en grupos, cada uno con una clave única (key) y etiquetas (tags) opcionales. Las tags permiten categorizar y filtrar registros con modos OR, AND o exclusion. Soporta variables dinámicas {{variable}} en campos como key, row y tags.

Configuración

Los parámetros varian según la acción seleccionada. Las variantes disponibles son:

DataStore Add (`action: add`)

Parámetro	Tipo	Requerido	Descripción
group	dataStoreGroup	Si	Grupo donde almacenar el registro.
key	text	Si	Campo que se usara como identificador único. Soporta `{{variable}}`.
row	text	Si	Datos a almacenar. Usar `{{data}}` para el input completo.
tags	dataStoreGroupTags	No	Etiquetas del grupo a asignar al registro.

DataStore Bulk Add (`action: bulk`)

Parámetro	Tipo	Requerido	Descripción
group	dataStoreGroup	Si	Grupo donde almacenar los registros.
key	text	Si	Campo de cada objeto que se usara como key única.
dataKey	text	Si	Array de objetos a almacenar. Usar `{{data}}` si el input es el array.
tags	dataStoreGroupTags	No	Etiquetas a aplicar a todos los registros.

DataStore Filter (`action: filter`)

Parámetro	Tipo	Requerido	Descripción
group	dataStoreGroup	No	Filtrar por grupo (vacío = todos).
key	text	No	Filtrar por key especifica.
tags	dataStoreGroupTags	No	Filtrar por etiquetas.
tagMode	select	No	Modo de filtrado: any (OR), all (AND), exclude. Por defecto: any.
limit	number	No	Máximo de registros que devuelve, los más recientes primero. Por defecto 50; súbelo (hasta 5000) si necesitas el historial completo de un grupo.

La salida de filter es la lista de registros (cada uno con su row_data ya convertido en objeto). El nodo necesita action: filter; si lo escribes a mano en una plantilla, no lo olvides.

DataStore Get Field (`action: getField`)

Parámetro	Tipo	Requerido	Descripción
group	dataStoreGroup	Si	Grupo donde buscar.
key	text	Si	Key del registro a buscar.
field	text	Si	Nombre del campo a obtener del registro.

DataStore Exists (`action: exists`)

Parámetro	Tipo	Requerido	Descripción
group	dataStoreGroup	Si	Grupo donde buscar.
key	text	Si	Key a buscar.
tags	dataStoreGroupTags	No	Filtrar también por tags (opcional).
tagMode	select	No	Modo de filtrado: any (OR), all (AND).

DataStore Delete (`action: delete`)

Parámetro	Tipo	Requerido	Descripción
id	text	No	ID especifico del registro a eliminar.
group	dataStoreGroup	No	Grupo del registro (si no se especifica ID).
key	text	No	Key del registro a eliminar (usado con group).

DataStore Modify Tags (`action: modifyTags`)

Parámetro	Tipo	Requerido	Descripción
ids	text	No	IDs de registros separados por coma.
group	dataStoreGroup	No	Grupo para filtrar registros (si no hay IDs).
tags	dataStoreGroupTags	No	Tags de filtro para encontrar registros.
add	dataStoreGroupTags	No	Tags a agregar a los registros.
remove	dataStoreGroupTags	No	Tags a eliminar de los registros.

DataStore Replace Tags (`action: replaceTags`)

Parámetro	Tipo	Requerido	Descripción
group	dataStoreGroup	Si	Grupo donde buscar los registros.
filterTags	dataStoreGroupTags	No	Filtrar registros por estos tags antes de reemplazar. Si vacío, aplica a todo el grupo.
tagMode	select	No	Modo de filtrado: any (OR), all (AND). Default: any.
oldTag	dataStoreGroupTags	Si	El tag que se quiere reemplazar (seleccionar de la lista del grupo).
newTag	text	Si	El nuevo tag que sustituira al anterior. Puede ser uno existente o nuevo.
ifNotFound	select	No	Si el registro no tiene el tag a reemplazar: `skip` = no hacer nada (default), `assign` = asignar el nuevo tag igualmente.
log	select	No	Registrar las acciones en la tabla de logs. Default: No.

DataStore Batch Tags (`action: batchTags`)

Parámetro	Tipo	Requerido	Descripción
group	dataStoreGroup	Si	Grupo donde buscar.
filterTags	dataStoreGroupTags	Si	Tags para filtrar los registros sobre los que se aplicara la acción.
filterMode	select	No	Modo de filtrado: any (OR), all (AND), exclude. Default: any.
batchAction	select	Si	Acción a aplicar: `add` (anadir tags), `remove` (eliminar tags), `replace` (reemplazar tag).
addTags	dataStoreGroupTags	No	Tags a agregar (visible si batchAction = add).
removeTags	dataStoreGroupTags	No	Tags a eliminar (visible si batchAction = remove).
oldTag	dataStoreGroupTags	No	Tag a reemplazar (visible si batchAction = replace).
newTag	text	No	Nuevo tag (visible si batchAction = replace).
ifNotFound	select	No	Si el tag no existe: skip o assign (visible si batchAction = replace).
log	select	No	Registrar en logs. Default: No.

DataStore Map (`action: map`)

Parámetro	Tipo	Requerido	Descripción
group	dataStoreGroup	Si	Grupo donde buscar.
keys	text	Si	Array de keys a mapear. Soporta `{{data.ids}}`.
field	text	Si	Campo a extraer de cada registro.
transform	select	No	Transformación: uppercase, lowercase, trim, o ninguna.

Asistente de asignación (Key y Field)

Para no tener que recordar ni teclear a mano los nombres, los campos key y field incluyen un asistente: un botón con una lupa, junto al botón {} de variables. Al pulsarlo se abre una lista con lo que ya existe en el grupo elegido.

Campo	Nodos	Qué lista
`key`	Add, Filter, Get Field, Exists, Delete	Las keys del grupo (hasta 50), con una vista previa del registro. Con más registros, escribe en el buscador para filtrar.
`field`	Get Field, Map	Los campos que aparecen en los últimos registros del grupo, con su tipo y un ejemplo.

Cómo usarlo:

Elige primero el grupo. Sin grupo, el asistente te lo recuerda.
Pulsa la lupa del campo key o field.
Busca si hace falta y haz clic en el valor: se escribe en el campo.

Qué conviene saber:

Es una ayuda, no una obligación. Puedes seguir escribiendo el valor a mano o usar una variable como {{data.pedido}}.
Si el grupo es una variable (por ejemplo {{data.grupo}}), el asistente no puede saber qué hay dentro: escribe el valor a mano.
Los campos se deducen de los registros reales. Solo se ofrecen los de primer nivel, que son los que leen estos nodos. Si el grupo aún no tiene registros, no habrá campos que mostrar.
Permisos. Hace falta poder ver el DataStore; si no, el asistente avisa en lugar de mostrar la lista.
Carga bajo demanda. Los datos se piden al abrir el asistente, no al abrir el nodo.

Salida

Varia según la acción:

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": "siguiente", "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 } }

Ejemplo de Uso

Caso básico

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

Reemplazar un tag por otro en todo el grupo

{
  "action": "replaceTags",
  "group": "pedidos",
  "oldTag": "pendiente",
  "newTag": "procesado",
  "ifNotFound": "skip"
}

Reemplazar tag solo en registros que tengan ciertos tags

{
  "action": "replaceTags",
  "group": "pedidos",
  "filterTags": ["urgente", "vip"],
  "tagMode": "all",
  "oldTag": "pendiente",
  "newTag": "prioritario",
  "ifNotFound": "assign",
  "log": "true"
}

Batch: añadir tag a todos los registros que coincidan

{
  "action": "batchTags",
  "group": "clientes",
  "filterTags": ["nuevo"],
  "filterMode": "any",
  "batchAction": "add",
  "addTags": ["bienvenida-enviada"]
}

Batch: eliminar tags de registros filtrados

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

Batch: reemplazar tag en registros que coincidan

{
  "action": "batchTags",
  "group": "productos",
  "filterTags": ["activo"],
  "filterMode": "any",
  "batchAction": "replace",
  "oldTag": "activo",
  "newTag": "descontinuado",
  "ifNotFound": "skip",
  "log": "true"
}

Notas

Soporta variables dinámicas {{variable}} en los campos key, row, dataKey y tags.
Los campos key y field tienen un asistente para elegir valores existentes: ver Asistente de asignación.
Si la acción es add y ya existe un registro con la misma key en el grupo, se actualiza.
Para bulk, el input puede ser un array o un objeto que se convierte a array.
La acción exists retorna isFound: true/false con los datos del registro si existe.
La acción delete puede eliminar por ID directo o por combinación de group + key.
La acción modifyTags permite agregar y eliminar tags simultaneamente en múltiples registros.
La acción map permite obtener un campo especifico de múltiples registros a la vez, con transformaciones opcionales.
La acción replaceTags busca un tag especifico en cada registro y lo sustituye por otro. Si el registro no tiene el tag, se puede configurar para asignar el nuevo tag igualmente (ifNotFound: assign) o no hacer nada (ifNotFound: skip).
La acción batchTags primero filtra registros por coincidencia de tags y luego aplica una operación masiva: anadir tags, eliminar tags o reemplazar un tag por otro.
Cada variante tiene su propio parentNode dataStore y su propio icono/color para facilitar la identificación visual.

Nodos Relacionados

DataStoreTrigger (trigger que se activa por cambios en el DataStore)
dataframe (versión legacy, obsoleta)
decision (para evaluar resultados de consultas)
iterator (para iterar sobre resultados filtrados)