Saltearse al contenido
Nappai Documentation

Baserow Component

El Baserow Component te permite conectar tu flujo de trabajo con una base de datos Baserow. Con él puedes crear nuevos registros, eliminar los existentes, leer datos filtrados y actualizar información directamente desde tu dashboard de Nappai.

¿Cómo funciona?

El componente se comunica con la API de Baserow usando la credencial que configures en Nappai. Cuando seleccionas una operación (Create, Delete, Get o Update), el componente envía una solicitud HTTP al servidor de Baserow con los parámetros que hayas configurado. Los resultados se devuelven como datos estructurados que pueden ser usados por otros componentes o por un agente de IA.

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 especificada.
  • Delete: Elimina registros existentes según la identificación que proporciones.
  • Get: Recupera registros que cumplan con los filtros y el orden que definas.
  • Update: Modifica registros existentes con los 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 Baserow.

    • Visible en: Create, Delete, Update

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

    • Visible en: Create, Delete, Get, Update

  • Base Name: El nombre de la base donde se encuentra la tabla.

    • Visible en: Create, Delete, Get, Update

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

    • Visible en: Get

  • Last Url: La última URL utilizada para tu base de datos Baserow.

    • Visible en: Create, Delete, Get, Update

  • Limit: Número de registros a devolver. Si se deja vacío, se devuelve un máximo de 20 registros.

    • 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 la ordenación de los registros devueltos por la API.

    • Visible en: Get

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

    • Visible en: Create, Delete, Get, Update

  • Tool Name: El nombre del asistente que se mostrará al agente cuando este componente se utilice como herramienta.

    • Visible en: Create, Delete, Get, Update

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

    • Visible en: Create, Delete, Get, Update

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

    • Visible en: Create, Delete, Get, Update

Credencial
Para que el componente funcione, debes configurar una credencial de tipo Baserow API en la sección de credenciales de Nappai. Luego, selecciona esa credencial en el campo “Credential” del componente. La credencial requiere:

  • Baserow user email
  • Baserow user Password
  • Baserow Server Connection URL

No incluyas estos campos en la sección de entradas.

Salidas

  • Result: Devuelve los datos procesados por la operación (por ejemplo, los registros creados o recuperados).
  • Tool: Genera una herramienta que puede ser utilizada por un agente de IA para interactuar con la base de datos.

Ejemplo de Uso

Supongamos que quieres crear un nuevo registro en la tabla Clientes de tu base Ventas:

  1. Selecciona la operación Create.
  2. En Base Name escribe Ventas.
  3. En Table Name escribe Clientes.
  4. En Records escribe la lista de registros en formato JSON, por ejemplo: 
    [
      {"nombre": "Ana Pérez", "email": "ana@example.com", "edad": 29}
    ]
  5. Activa Mapping Mode si quieres crear varios registros a la vez.
  6. Conecta la salida Result a otro componente que necesite esos datos.

El componente enviará la solicitud a Baserow y devolverá el registro creado en la salida Result.

Componentes Relacionados

  • BaserowCustom: Base sobre la que se construye este componente, que maneja la lógica común de conexión y mapeo.
  • DataInput: Tipo de entrada usado para pasar listas de registros.
  • DropdownInput: Tipo de entrada usado para seleccionar operaciones, bases y tablas.

Consejos y Mejores Prácticas

  • Limita el número de registros: Cuando uses la operación Get, especifica un límite razonable para evitar respuestas muy grandes.
  • Revisa los nombres de columnas: Los filtros y ordenaciones dependen de los nombres exactos de las columnas en Baserow.
  • Utiliza Mapping Mode: Si necesitas procesar varios registros a la vez, activa el modo de mapeo para mejorar la eficiencia.
  • Guarda la credencial: Una vez configurada, la credencial se reutiliza en todos los componentes que requieran acceso a Baserow.

Consideraciones de Seguridad

  • Protege la credencial: Asegúrate de que la credencial de Baserow esté almacenada de forma segura en Nappai y que solo los usuarios autorizados puedan acceder a ella.
  • Control de acceso: Limita quién puede editar los campos sensibles como Records y Formula para evitar la exposición accidental de datos.
  • Registros sensibles: Si manejas información confidencial, considera cifrar los datos antes de enviarlos a Baserow o usar una base de datos con acceso restringido.