DropboxComponentFile

Este componente actúa como un puente seguro entre tu flujo de automatización en Nappai y tu cuenta de Dropbox. Permite realizar diversas acciones sobre tus archivos (como leer, listar, descargar o gestionar permisos) de forma automatizada, utilizando las credenciales de API que hayas configurado previamente en tu cuenta.

Su diseño simplificado te permite centrarte en los resultados sin necesidad de gestionar manualmente los protocolos de conexión o los tokens de seguridad en cada ejecución.

¿Cómo funciona?

Internamente, este componente se conecta directamente a la API oficial de Dropbox utilizando los permisos y las claves de seguridad que has guardado en la sección de Credenciales de Nappai.

Cuando ejecutas el flujo:

1. El componente lee los parámetros que le proporcionas (como el ID del archivo, el nombre o la carpeta destino).
2. Utiliza tu “Modo de Entrada” para decidir cómo buscar o seleccionar los recursos deseados.
3. Realiza la acción solicitada (por ejemplo, listar archivos o descargar uno) y devuelve los resultados estructurados para que puedas continuar con el siguiente paso de tu automatización.

Conexión y Credenciales

Para que este componente funcione correctamente, es obligatorio configurar una conexión segura con tu cuenta de Dropbox.

Importante: Este componente requiere una credencial de tipo Dropbox API.

Sigue estos pasos antes de usar el componente en tus flujos:

1. Dirígete a la sección de Credenciales en el panel de administración de Nappai.
2. Crea una nueva credencial del tipo Dropbox API.
3. Ingresa los datos requeridos (API Key, API Secret, Token) que puedes obtener en la App Console de Dropbox.
4. Guarda la credencial.
5. En la configuración de este componente, selecciona la credencial que acabas de crear en el campo Credential.

Entradas

Los siguientes campos están disponibles para configurar este componente. Estos parámetros permiten definir qué archivos deseas gestionar y cómo deseas interactuar con ellos.

• Operation: Define la acción principal que deseas realizar con los archivos de Dropbox (ej. lectura, escritura, listado).

  • Visible en: Todas las operaciones

• Mode of Input: Define el método que se utilizará para seleccionar los archivos. Si eliges “All Folders”, se usarán todos los archivos hasta un límite de 100. Si eliges “By Id”, los inputs se basarán en el ID del archivo.

  • Visible en: Todas las operaciones

• Selection Mode: Define el modo de selección para los archivos. Si eliges “Folder”, se devolverán todos los archivos dentro de esa carpeta. Si eliges “File”, el archivo se seleccionará individualmente de la lista.

  • Visible en: Todas las operaciones

• File Id: El ID único del archivo que deseas procesar. Introduce aquí el identificador del archivo.

  • Visible en: Todas las operaciones

• Select file: Permite seleccionar un archivo específico para utilizarlo en la operación.

  • Visible en: Todas las operaciones

• Folder Id [REQUERIDO]: El ID único de la carpeta. Introduce aquí el identificador de la carpeta. Este campo es obligatorio para el correcto funcionamiento del componente.

  • Visible en: Todas las operaciones

• Select folder: Selecciona una carpeta. Si no se selecciona ninguna, se utilizará la carpeta raíz por defecto.

  • Visible en: Todas las operaciones

• Filename: Nombre que se utilizará para el archivo. Si no se proporciona, se usará el nombre del archivo binario en el componente. En operaciones de obtención (“Get”), este campo se utiliza como un filtro de búsqueda.

  • Visible en: Todas las operaciones

• File Content: Contenido que se utilizará para el archivo. Si el archivo es de tipo Drive mimeType, se deben usar operaciones de copia o movimiento.

  • Visible en: Todas las operaciones

• New Name: Permite actualizar el nombre de un archivo existente.

  • Visible en: Todas las operaciones

• Email: Correo electrónico del usuario con el que se compartirá el archivo.

  • Visible en: Todas las operaciones

• Role: El rol que se asignará al usuario en la operación de compartición.

  • Visible en: Todas las operaciones

• Send Notification: Indicador para enviar una notificación al usuario involucrado.

  • Visible en: Todas las operaciones

• Download Base64 Content: Si se activa, incluye el contenido del archivo convertido a formato Base64 al realizar una operación de obtención (“Get”) utilizando el ID del archivo.

  • Visible en: Todas las operaciones

• Process File Content: Si se activa, incluye el contenido del archivo procesado en texto plano al realizar una operación de obtención (“Get”) utilizando el ID del archivo.

  • Visible en: Todas las operaciones

• File Type: Selecciona el tipo de archivo que se utilizará como filtro. Si se selecciona “Any” (Cualquiera), se devolverán todos los archivos. Si se selecciona “File” o se proporciona un ID de archivo, este campo se ignorará.

  • Visible en: Todas las operaciones

Salidas

Al finalizar la ejecución del componente, recibirás los resultados en el siguiente campo para utilizarlos en el resto de tu flujo de trabajo:

• Data: El resultado principal de la operación. Dependiendo de la acción realizada (listado, descarga, etc.), este campo contendrá la información estructurada del archivo, su contenido procesado o un código de estado de éxito.

Ejemplo de Respuesta JSON

A continuación, se muestra un ejemplo de cómo se ve la estructura de datos que devuelve este componente al tener éxito, para que sepas qué variables puedes mapear en los siguientes nodos: json { “name”: “contrato_ventas.pdf”, “path_lower”: “/contratos/contrato_ventas.pdf”, “id”: “id:abc123xyz”, “size”: 154020, “server_modified”: “2023-10-27T14:30:00Z”, “content_hash”: “e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855”, “is_download_available”: true, “download_url”: “https://dl.dropboxusercontent.com/1/view/…” }

Conectividad

Este componente suele conectarse a nodos de procesamiento de datos para leer el contenido de los archivos descargados, o a nodos de almacenamiento para mover archivos a otras ubicaciones. También es común conectar sus salidas a componentes de notificación para informar sobre el estado de los archivos gestionados.

Ejemplo de Uso

Escenario: Deseas descargar el contenido de un archivo PDF específico de Dropbox para analizar su texto.

1. Arrastra el componente DropboxComponentFile a tu flujo.
2. En Mode of Input, selecciona By Id si conoces el identificador del archivo.
3. En File Id, pega el ID del archivo PDF.
4. Activa la casilla Process File Content para obtener el texto directamente.
5. Conecta la salida Data a un componente de análisis de texto o de respuesta de la automatización.

Consejos y Mejores Prácticas

• Límites de selección: Ten en cuenta que al seleccionar “All Folders”, el sistema procesará hasta 100 archivos. Si tienes carpetas con más elementos, considera refinar tu selección con filtros o ID específicos.
• Credenciales Seguras: Asegúrate de mantener tus credenciales de Dropbox API actualizadas y no compartirlas públicamente, ya que otorgan acceso a toda tu cuenta de almacenamiento.
• Validación de ID: Verifica que el Folder Id esté siempre presente, ya que es un campo requerido para el correcto funcionamiento del componente.

Consideraciones de Seguridad

• Manejo de Credenciales: Las claves de API y los tokens de acceso se manejan de forma segura en el panel de Nappai y no se almacenan en el código de los flujos.
• Permisos de Dropbox: Asegúrate de que la credencial utilizada tenga los permisos adecuados (lectura, escritura, compartición) en la consola de aplicaciones de Dropbox para evitar errores de “Unauthorized”.
• Límites de API: Dropbox impone límites en el número de llamadas a su API. Si procesas grandes volúmenes de datos, monitorea el uso para evitar limitaciones temporales.