NocoDB Component

El NocoDB Component te permite leer, crear, actualizar y eliminar registros en tus bases de datos NocoDB directamente desde el flujo de trabajo de Nappai. Con él puedes integrar tus datos de NocoDB con otras herramientas y flujos de automatización sin escribir código.

¿Cómo funciona?

El componente se conecta a la API de NocoDB usando un Access Token que has guardado previamente en una credencial de tipo NocoDB API. Cuando seleccionas una operación (Create, Delete, Get o Update) y envías los datos, el componente construye la llamada HTTP correspondiente y devuelve la respuesta. Si el modo de mapeo está activado, puedes procesar varios registros a la vez y usar valores dinámicos mediante Javascript.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

• Create: Añade uno o varios registros nuevos a la tabla seleccionada.
• Delete: Elimina registros existentes según los identificadores que proporciones.
• Get: Recupera registros de la tabla, con posibilidad de filtrar y ordenar.
• Update: Modifica registros existentes con los nuevos valores que indiques.

Para usar el componente, primero selecciona la operación que necesitas en el campo Operation (Operación).

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada Mapping Data y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

• Fixed (Fijo): Escribes el valor directamente en el campo.
• Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
• Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

• Records: Una lista de registros a crear, actualizar o eliminar, estructurada como registros de NocoDB.

  • Visible en: Create, Delete, Update

• Operation: Selecciona la operación que deseas ejecutar.

  • Visible en: Create, Delete, Get, Update

• Access Token: El token de acceso para tu base de datos NocoDB.

  • Visible en: Create, Delete, Get, Update

• Base Name: El nombre de la base de datos dentro de NocoDB.

  • Visible en: Create, Delete, Get, Update

• formula: Define condiciones para filtrar los registros devueltos por la API.

  • Visible en: Get

• Last Access Token: El token de acceso anterior (útil en algunos flujos de actualización).

  • Visible en: Create, Delete, Get, Update

• Limit: El número máximo de registros a devolver. Entre 1 y 1000, por defecto 20.

  • Visible en: Get

• Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros en lote.

  • Visible en: Create, Delete, Get, Update

• Order By: Define el orden de los registros devueltos por la API.

  • Visible en: Get

• Table Name: El nombre de la tabla dentro de la base de datos.

  • Visible en: Create, Delete, Get, Update

• Workspace Name: El nombre del espacio de trabajo donde se encuentra la base de datos.

  • Visible en: Create, Delete, Get, Update

• Tool Name: El nombre que tendrá el componente cuando se use como herramienta en un agente.

  • Visible en: Create, Delete, Get, Update

• Tool Description: Una descripción detallada de lo que hace esta herramienta.

  • Visible en: Create, Delete, Get, Update

• Tools arguments metadata: Define los metadatos de los argumentos que la herramienta aceptará.

  • Visible en: Create, Delete, Get, Update

Nota sobre credenciales
Este componente requiere una credencial de tipo NocoDB API.

1. Configura la credencial en la sección de credenciales de Nappai.
2. Selecciona esa credencial en el campo Credential del componente.
   Los campos de la credencial (Access Token, NocoDB Server Connection URL) no aparecen en la lista de entradas.

Salidas

• Result: Devuelve los datos procesados (por ejemplo, los registros creados o recuperados).
• Tool: Devuelve una herramienta que puede ser usada por agentes de IA para interactuar con NocoDB.

Ejemplo de Uso

Crear registros

1. Activa el modo Create en el campo Operation.
2. En Records, ingresa una lista JSON de los registros que quieres crear, por ejemplo:

   [
     {"name": "Juan", "email": "juan@example.com"},
     {"name": "Ana", "email": "ana@example.com"}
   ]

3. Selecciona la base, tabla y workspace correspondientes.
4. Haz clic en Run.
5. La salida Result mostrará los registros creados con sus identificadores.

Obtener registros filtrados

1. Selecciona la operación Get.
2. En formula, escribe una condición, por ejemplo: (status,eq,active)~and(age,gte,30).
3. En Limit, escribe 50.
4. En Order By, escribe -created_at para ordenar por fecha de creación descendente.
5. Ejecuta el flujo y revisa la salida Result.

Plantillas

(Esta sección se omite porque no hay plantillas que utilicen este componente.)

Componentes Relacionados

• NocoDB Custom: Base sobre la que se construye este componente.
• Nappai Credential Manager: Gestiona las credenciales de acceso a NocoDB.

Consejos y Mejores Prácticas

• Usa Mapping Mode cuando necesites procesar muchos registros a la vez para ahorrar tiempo.
• Limita el número de registros con Limit para evitar respuestas muy grandes.
• Aprovecha formula y Order By para filtrar y ordenar datos directamente en la API, reduciendo la necesidad de procesamiento posterior.
• Cuando uses el componente como herramienta, define un Tool Name claro y una Tool Description útil para que los agentes entiendan cuándo usarla.

Consideraciones de Seguridad

• Nunca expongas tu Access Token en el flujo de trabajo; confía en el gestor de credenciales de Nappai.
• Si compartes el flujo con otros usuarios, asegúrate de que tengan acceso a la credencial correspondiente.
• Revisa los permisos de tu token en NocoDB para limitarlo solo a las operaciones necesarias (lectura, escritura, etc.).