Database

El componente Database te permite trabajar con tus bases de datos de Notion directamente desde el dashboard de Nappai. Con él puedes ver las propiedades de una base de datos, listar todas las bases disponibles o crear una nueva base de datos dentro de una página de Notion. Todo ello sin necesidad de escribir código, solo configurando los campos que necesites.

¿Cómo funciona?

El componente se conecta a la API de Notion mediante un token de integración que debes haber configurado previamente en la sección de credenciales de Nappai. Cuando lo añades a un flujo, seleccionas la operación que quieres realizar (List Properties, List o Create) y rellenas los campos correspondientes. Si activas el Mapping Mode, el componente puede procesar varios registros a la vez, lo que facilita la automatización de tareas en lote.

Operaciones

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

• List Properties: Obtiene las propiedades de una base de datos específica. Si no indicas un ID, devuelve todas las bases disponibles con sus propiedades e IDs.
• List: Devuelve la lista de todas las bases de datos que tienes en tu cuenta de Notion.
• Create: Crea una nueva base de datos dentro de una página de Notion, con el título y las propiedades que especifiques.

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:

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

  • Visible en: List Properties, List, Create

• Database ID (DropdownInput): ID de la base de datos para listar sus propiedades. Si está vacío, devuelve una lista de todas las bases disponibles con sus propiedades e IDs.

  • Visible en: List Properties

• Database ID (MessageInput): ID de la base de datos donde se buscarán las propiedades.

  • Visible en: List

• Database Title (MessageInput): Título de la nueva base de datos de Notion.

  • Visible en: Create

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

  • Visible en: List Properties, List, Create

• Parent Page ID (MessageInput): ID de la página de Notion donde se creará la nueva base de datos.

  • Visible en: Create

• Properties Database (DropdownInput): Selecciona las propiedades que tendrá la nueva base de datos.

  • Visible en: Create

• Tool Name: Nombre del tool que se mostrará al agente cuando el componente se conecte como herramienta.

  • Visible en: List Properties, List, Create

• Tool Description: Descripción detallada de lo que hace este tool.

  • Visible en: List Properties, List, Create

• Tools arguments metadata: Define los metadatos de los argumentos del tool.

  • Visible en: List Properties, List, Create

Nota: Este componente requiere una credencial de tipo Notion API.

1. Configura primero la credencial en la sección de credenciales de Nappai.
2. Luego selecciona esa credencial en el campo Credential del componente.
3. La credencial necesita un Notion Integration Token (token de integración de Notion). Puedes crear uno siguiendo la guía oficial de Notion: aquí.

Salidas

• Data: Resultado de la operación (lista de bases, propiedades, etc.).
• Tool: Información del tool que puede ser utilizada por agentes de IA.

Ejemplo de Uso

1. List Properties

1. Añade el componente Database al flujo.
2. Selecciona la operación List Properties.
3. En Database ID (DropdownInput) elige la base de datos de la que quieres ver las propiedades.
4. (Opcional) Activa Mapping Mode si quieres procesar varias bases a la vez.
5. Ejecuta el flujo y obtén en la salida Data la lista de propiedades de la base seleccionada.

2. Create

1. Añade el componente Database al flujo.
2. Selecciona la operación Create.
3. En Database Title escribe el nombre de la nueva base de datos.
4. En Parent Page ID indica la página donde se creará.
5. En Properties Database elige las propiedades que tendrá la base.
6. (Opcional) Activa Mapping Mode para crear varias bases en un solo flujo.
7. Ejecuta el flujo y obtén en la salida Data la información de la base creada.

Componentes Relacionados

• NotionPage – Gestiona páginas individuales de Notion.
• NotionQuery – Ejecuta consultas avanzadas sobre bases de datos.
• NotionDatabaseComponent – Base de la que hereda este componente.

Consejos y Mejores Prácticas

• Revisa los IDs: Asegúrate de que los IDs de base de datos y página sean correctos para evitar errores.
• Usa Mapping Mode cuando necesites procesar varias bases o registros a la vez; reduce la cantidad de ejecuciones.
• Guarda la credencial en un lugar seguro y no la compartas públicamente.
• Prueba en modo de prueba antes de usarlo en producción para verificar que la operación devuelve los resultados esperados.

Consideraciones de Seguridad

• El token de integración de Notion debe mantenerse confidencial; cualquier persona con acceso puede leer y modificar tus bases de datos.
• Evita exponer la credencial en flujos que se compartan públicamente.
• Utiliza la política de permisos de Notion para limitar el alcance del token a las páginas y bases de datos necesarias.