Saltearse al contenido
Nappai Documentation

List Database Properties

⚠️ ADVERTENCIA DE DEPRECACIÓN

Este componente está deprecado y será eliminado en una versión futura de Nappai. Por favor, migra a los componentes alternativos recomendados.

Esta herramienta te permite obtener la lista de propiedades de una base de datos en Notion. Solo necesitas el ID de la base de datos y una credencial de Notion configurada en Nappai.

¿Cómo funciona?

El componente hace una llamada HTTP a la API de Notion. Cuando lo activas, envía una solicitud GET a https://api.notion.com/v1/databases/{database_id} usando el token de integración que has configurado. La respuesta de Notion contiene un objeto JSON con todas las propiedades de la base de datos, que el componente devuelve como un diccionario. Si algo falla (por ejemplo, un ID incorrecto o un token inválido), el componente devuelve un mensaje de error legible.

Entradas

Campos de Entrada

  • Database ID: El identificador único de la base de datos de Notion que quieres inspeccionar.
    Este campo es obligatorio.

Nota sobre credenciales

  1. En la sección de credenciales de Nappai, crea una credencial llamada Notion API y añade tu Notion Integration Token.
  2. En el componente, selecciona esa credencial en el campo Credential.
  3. No es necesario introducir el token directamente en el componente; se gestiona automáticamente a través de la credencial.

Salidas

  • Data: Contiene la lista de propiedades de la base de datos en formato JSON. Puedes usarla directamente en tu flujo de trabajo o convertirla a otro formato si lo necesitas.
  • Tool: Un objeto Tool que permite a los agentes de LangChain usar esta funcionalidad como una herramienta estructurada.

Ejemplo de Uso

  1. Añade el componente “List Database Properties” a tu flujo de trabajo.
  2. Configura la credencial “Notion API” y selecciona la base de datos cuyo ID has copiado de Notion.
  3. Ejecuta el flujo.
  4. En la salida Data verás algo parecido a: json { “title”: {“title”: {}}, “created_time”: {“created_time”: {}}, “last_edited_time”: {“last_edited_time”: {}}, “status”: {“select”: {}}, “tags”: {“multi_select”: {}} }

Puedes usar esta salida para crear tablas, filtros o cualquier otra lógica dentro de tu dashboard.

Componentes Relacionados

  • NotionDirectoryLoader – Carga la estructura de carpetas y bases de datos de Notion.
  • NotionDatabaseProperties – Este mismo componente, pero en su versión actualizada (no legacy).
  • NotionPageContent – Extrae el contenido de páginas individuales dentro de una base de datos.

Consejos y Mejores Prácticas

  • Mantén tu token seguro: Nunca lo expongas en código público ni lo compartas.
  • Verifica el ID: Copia el ID directamente desde la URL de Notion para evitar errores.
  • Usa la salida Data: Puedes pasarla a un componente de transformación JSON para extraer campos específicos.
  • Manejo de errores: Si recibes un mensaje de error, revisa el token y los permisos de la integración en Notion.

Consideraciones de Seguridad

  • La credencial Notion API debe tener permisos mínimos necesarios (por ejemplo, solo lectura de bases de datos).
  • Asegúrate de que el token no se guarde en archivos de configuración que puedan ser accedidos por terceros.
  • Si tu flujo de trabajo se ejecuta en un entorno compartido, revisa los logs para evitar exponer datos sensibles.