Dropbox

El componente Dropbox permite a los usuarios extraer texto y archivos directamente desde su cuenta de Dropbox. Puedes elegir un archivo individual o una carpeta completa y el componente devolverá el contenido de los archivos compatibles (por ejemplo, .txt, .md, .csv, etc.) para que lo utilices en tu flujo de trabajo dentro del dashboard de Nappai.

¿Cómo funciona?

Cuando activas el componente, Nappai solicita un token de acceso a Dropbox. Este token se obtiene a través de la credencial Dropbox API que debes haber configurado previamente en la sección de credenciales de Nappai.
Una vez autenticado, el componente hace una llamada a la API de Dropbox para leer el archivo o la carpeta seleccionada.

• Si seleccionas un archivo, el componente lee su contenido y lo devuelve como una lista de objetos Data.
• Si seleccionas una carpeta, el componente recorre todos los archivos dentro de ella (recursivamente) y devuelve una lista de objetos Data y un mensaje con los archivos encontrados.

El resultado se entrega en dos salidas distintas:

• Data: contiene el texto extraído de cada archivo.
• Files: contiene un mensaje con la lista de archivos recuperados.

Entradas

• Upload file or select file: Permite subir un archivo desde tu computadora o seleccionar uno existente en tu cuenta de Dropbox.
• or Select folder: Permite elegir una carpeta completa dentro de tu Dropbox para procesar todos los archivos que contenga.

Credencial requerida
Este componente necesita una credencial de tipo Dropbox API.

1. Configura la credencial en la sección de credenciales de Nappai.
2. Selecciona esa credencial en el campo “Credential” del componente.
   La credencial debe incluir los permisos necesarios para leer archivos y carpetas.

Salidas

• Data: Lista de objetos Data con el contenido de cada archivo.
• Files: Mensaje que contiene la lista de archivos recuperados, útil para inspeccionar o procesar los archivos en pasos posteriores.

Ejemplo de Uso

1. Seleccionar un archivo

   • Arrastra el componente al flujo.
   • En el campo “Upload file or select file”, elige un archivo .txt de tu Dropbox.
   • Conecta la salida Data a un componente de procesamiento de texto (por ejemplo, “Text Analyzer”).

2. Seleccionar una carpeta

   • En el campo “or Select folder”, elige la carpeta que contiene varios archivos .csv.
   • Conecta la salida Files a un componente que liste los archivos (por ejemplo, “File List Viewer”).
   • Conecta la salida Data a un componente que procese cada archivo (por ejemplo, “CSV Parser”).

Componentes Relacionados

• GoogleDriveLoader – Carga archivos desde Google Drive.
• OneDriveLoader – Carga archivos desde OneDrive.
• LocalFileLoader – Carga archivos locales desde el servidor de Nappai.

Consejos y Mejores Prácticas

• Usa tipos de archivos compatibles: El componente solo procesa archivos de texto (TXT, MD, CSV, etc.).
• Evita carpetas muy grandes: Si la carpeta contiene cientos de archivos, considera dividirla o usar filtros de tipo de archivo.
• Revisa los permisos: Asegúrate de que la credencial tenga permisos de lectura para los archivos o carpetas que necesitas.
• Maneja errores: Conecta la salida de error (si la tienes) a un componente de notificación para alertar al usuario cuando la autenticación falle.

Consideraciones de Seguridad

• Protege tu token: La credencial de Dropbox contiene un token de acceso que permite leer tus archivos. No lo compartas públicamente.
• Revoca permisos innecesarios: Si solo necesitas leer archivos, solicita únicamente los permisos de lectura.
• Monitorea el uso: Revisa el historial de accesos en la consola de Dropbox para detectar accesos inesperados.