Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt

Use this file to discover all available pages before exploring further.

El nodo Bases de datos conecta tu workflow con tus bases de datos y ejecuta operaciones sobre los registros sin escribir código. Eliges la base, la colección y la operación, y el panel arma la petición por ti. Piensa en este nodo como un intermediario entre tu workflow y la base de datos: tú le indicas qué quieres hacer con los registros y él se encarga de hablar con el servicio.
Para administrar tus bases, colecciones, campos y registros en Datum, consulta la documentación completa de Datum. Este nodo asume que la base ya existe.

​
Concepto clave

Toda operación del nodo se resuelve contra una base + una colección + una operación. Los tres son obligatorios para que el nodo pueda construir la petición correcta.
ConceptoQué significa
Base de datosEl contenedor que tienes provisionado en Datum (equivale a “la base”).
ColecciónLa tabla dentro de la base: usuarios, pedidos, productos, etc.
OperaciónLa acción que realizarás sobre la colección: listar, obtener, crear, actualizar o eliminar.
Cambiar cualquiera de los tres limpia los campos dependientes de abajo. Si ya habías ingresado datos que se perderían, el panel te avisa con un modal antes de aplicar el cambio.

​
Configuración

El panel se organiza de arriba hacia abajo, en el mismo orden en que debes configurarlo.

​
Base de datos

Selector con las bases que tu cuenta tiene disponibles en Datum. Junto al label aparece un botón Abrir que abre la base en una pestaña nueva del app de Datum, útil para revisar colecciones y registros mientras configuras el nodo.
Selector de base de datos con botón Abrir en la esquina superior derecha
Si la lista aparece vacía o ves un error 401/403, tu usuario no tiene permiso sobre esa base. Contacta al administrador de Datum en tu cuenta.

​
Colección

Solo se habilita cuando hay una base seleccionada. Muestra las colecciones que creaste en la base (las colecciones internas de Datum no aparecen). Mientras cargan, el selector queda deshabilitado; si la carga falla, se mantiene deshabilitado hasta que la base cambie o se corrijan los permisos.

​
Operación

Define qué hará el nodo sobre la colección:
OperaciónPara qué sirve
Listar registrosTraer varios registros con filtros, orden y paginación.
Obtener registroTraer un único registro por su id.
Crear registroInsertar un nuevo registro.
Actualizar registroModificar un registro existente por id.
Eliminar registroBorrar un registro por id.

​
Campos según operación

El resto del panel cambia en función de la operación elegida.

​
ID del registro

Requerido por Obtener, Actualizar y Eliminar. Acepta un valor fijo o una variable: 
{{$context.userRecordId}}
Si eliges Obtener, Actualizar o Eliminar y dejas el ID vacío, el servicio responde con 404 Record not found. Esto es intencional: protege de llamadas accidentales contra toda la colección cuando lo que pedías era un único registro.

​
Valores de los campos

Para Crear y Actualizar, el panel abre un editor con un control específico por tipo de campo declarado en la colección:
Tipo del campoControl
text, email, url, numberInput con soporte de variables
boolInterruptor true/false o entrada de variable
dateCalendario + selector de hora o entrada de variable
select (simple o múltiple)Selector desplegable o entrada de variable
editorEditor de texto enriquecido
jsonÁrea de texto con sintaxis JSON
En los tipos que lo soportan, un selector junto al campo alterna entre Valor fijo (el control propio del tipo) y Variable (entrada libre para inyectar un {{$memory.x}} o {{$context.y}}).
Editor de campos mostrando controles según el tipo declarado en la colección

​
Filtros (solo Listar)

Constructor visual con uno o varios términos unidos por AND. Cada fila se compone de campo, operador y valor.
OperadorSignificado
=, !=Igual / distinto
>, >=, <, <=Comparación numérica o de fecha
~Contiene el texto
!~No contiene el texto
Los términos a los que les falta el campo o el valor se ignoran al ejecutar — no bloquean la petición ni generan error; simplemente no forman parte del filtro final.
Constructor visual de filtros con operadores y reglas AND

​
Ordenamiento (solo Listar)

Constructor con una fila por criterio. En cada fila eliges el campo y la dirección (ascendente o descendente). Los criterios se aplican en el orden en que están visibles.

​
Paginación (solo Listar)

Dos campos numéricos: página (por defecto 1) y por página (por defecto 50). Si dejas uno vacío o con un número inválido, el nodo usa el valor por defecto al ejecutar.

​
Guardar la respuesta

Activa el toggle Guardar respuesta en el encabezado del panel y define un nombre de variable. La respuesta completa del servicio se almacena en esa variable y queda disponible en los nodos siguientes.

​
Acceder a la respuesta sin manipulación

Usa la variable directamente en otros nodos: 
{{$context.basesRespuesta}}

​
Manipular la respuesta en un nodo Código

let respuesta = $context.getHttpResponse('basesRespuesta')
respuesta = respuesta.json()

const primerRegistro = respuesta.items?.[0]
$memory.set('primerRegistro', primerRegistro)
La llave que uses en $context.getHttpResponse('basesRespuesta') debe coincidir exactamente con la que configuraste en “Guardar respuesta”.

​
Respuesta de prueba

El botón Probar del encabezado ejecuta la petición contra Datum y abre un popover con el resultado. El popover muestra:
  • Código de estado (por ejemplo, 200 o 404)
  • Pestaña Cuerpo — respuesta formateada como JSON con botón de copiar
  • Pestaña Encabezados — encabezados de respuesta del servicio
Popover de respuesta del botón Probar con pestañas Cuerpo y Encabezados
Si cierras el popover y lo vuelves a abrir sin tocar la configuración, el nodo muestra la última respuesta en lugar de hacer una nueva llamada al servicio. En cuanto modificas cualquier campo, esa respuesta se marca como desactualizada y la próxima apertura ejecuta de nuevo.

​
Casos de uso

Un workflow de WhatsApp que captura leads necesita registrar el teléfono y el nombre del usuario sin pasar por un endpoint externo. Mapea {{$user.phone}} y {{$memory.nombre}} a los campos de la colección leads, elige la operación Crear y el registro queda guardado sin escribir una sola línea de código.
Un workflow de atención al cliente que personaliza respuestas consulta primero la colección clientes filtrando por el email del usuario. El resultado se guarda en una variable y los nodos siguientes lo usan para adaptar el mensaje. Antes esto requería un nodo API con URL construida a mano; ahora son tres dropdowns y un filtro visual.
Un workflow de seguimiento de pedidos recibe un código, busca el registro con la operación Obtener y actualiza el campo status a entregado con la fecha tomada de {{$context.now}}. El mismo proceso que antes requería dos nodos API ahora se resuelve en uno solo.