DropboxComponentFolder

Este componente te permite interactuar con tus carpetas en Dropbox de forma sencilla. Es ideal para automatizar tareas como mover archivos a carpetas específicas, descargar contenido desde la nube, ver qué archivos hay en una carpeta o compartir carpetas y archivos con colegas mediante enlaces o correos electrónicos.

¿Por qué usar este componente?

Automatización de seguridad: No necesitas ingresar claves manuales. El componente usa automáticamente las credenciales de tu proyecto configuradas en Nappai.
Gestión completa: Puedes realizar acciones de subida, descarga, listado y compartición.
Flexibilidad: Diferentes modos para seleccionar cómo identificarás las carpetas (por ID, nombre, URL, etc.).

¿Cómo funciona?

El componente funciona como un puente seguro entre tu flujo de automatización y tu almacenamiento en Dropbox. Internamente, verifica que tengas las credenciales correctas del proyecto para autenticar la conexión. Según la operación que elijas, realiza la acción solicitada en la API de Dropbox. Por ejemplo, si seleccionas una operación de “Compartir”, el componente generará enlaces accesibles para los destinatarios indicados. El resultado de la acción se devuelve en el campo Data, lo que te permite continuar tu flujo con esa información.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio externo de Dropbox:

Dirígete a la sección de Credenciales en tu panel de Nappai.
Crea una nueva credencial del tipo Dropbox API y guarda los campos requeridos (como Claves de API, Secretos y Tokens). Puedes encontrar estos datos en la App Console de tu cuenta de Dropbox. Asegúrate de configurar los permisos (Dropbox Permissions) adecuados para que el componente pueda realizar las acciones necesarias.
En tu flujo de trabajo, selecciona la credencial guardada en el campo Credential de este componente.

Entradas

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

Mode of Input: Define el método que usarás para seleccionar las carpetas o recursos. Si eliges “All folders”, se usarán todas las carpetas hasta un límite de 100 archivos. Según la opción seleccionada (como “By Id”, “By Filename”, “By Url”), el componente esperará datos correspondientes.
Folder Id: El identificador único de la carpota. Si no se proporciona ningún valor, se utilizará la carpota raíz por defecto.
Select folder: Te permite seleccionar una carpota específica mediante un selector de archivos integrado en la interfaz.
Operation: Selecciona la acción principal que deseas realizar (por ejemplo, subir, descargar, listar o compartir).
Folder Path: La ruta de la carpeta que deseas crear en Dropbox. Utiliza un formato como ‘/MyNewFolder’ o ‘/Projects/NewFolder’. Este campo es requerido para operaciones que impliquen la creación de carpetas.
Emails to Share With: Una lista de direcciones de correo electrónico separadas por comas para compartir la carpeta con otros usuarios. Este campo es requerido si la operación es de compartición.
Folder Name: El nombre de la carpeta que vas a crear. Puedes usar un formato como ‘MyNewFolder’ o ‘Projects/NewFolder’.
Access Level: Define el nivel de permiso que tendrán los usuarios que accedan a la carpeta compartida.
Allow Editing: Si activas esta opción, los destinatarios podrán editar los archivos compartidos. Esta configuración solo aplica para usuarios con permisos de visualización.
Custom Message: Escribe un mensaje personalizado que se incluirá en la invitación de compartición enviada a los destinatarios.

Salidas

El componente produce una salida principal que contiene el resultado de la operación realizada:

Data: Contiene el estado de la operación, los archivos procesados, enlaces de compartición (si aplica) y cualquier detalle de error. Puedes utilizar esta salida para conectar con otros componentes que necesiten saber si la acción fue exitosa o para recibir los enlaces generados.

Ejemplo de Respuesta JSON

A continuación, se muestra un ejemplo de cómo se estructura la respuesta exitosa del componente. Este ejemplo asume que se realizó una operación de compartición o listado con éxito: json { “status”: true, “processed_files”: [“/Documentos/Proyectos”, “/Documentos/Facturas”], “share_links”: { “/Documentos/Proyectos”: “https://www.dropbox.com/s/abc123xyz/share_link_project” }, “error_details”: null }

Conectividad

La salida Data de este componente suele conectarse lógicamente a los siguientes tipos de nodos en un flujo de trabajo:

Componentes de Procesamiento de Datos: Para transformar o filtrar la lista de archivos procesados antes de continuar.
Componentes de Notificación o Email: Para enviar los enlaces de compartición generados (share_links) a usuarios o equipos.
Componentes de Lógica o Condicionales: Para verificar el campo status y tomar decisiones basadas en si la operación fue exitosa o fallida.
Componentes de Almacenamiento Local: Para descargar o guardar los archivos indicados en processed_files en tu sistema local.

Ejemplo de Uso

Escenario: Crear una carpeta de proyecto y compartirla con el equipo

Imagina que quieres automatizar la creación de una carpeta en Dropbox cada vez que se inicia un nuevo proyecto.

Configura el campo Operation para seleccionar la acción de crear y compartir.
En Folder Path, escribe la ruta donde quieres ubicar la carpeta, por ejemplo: /Proyectos/NuevoProyecto.
En Folder Name, indica el nombre: ReportesTrimestrales.
En Emails to Share With, ingresa los correos del equipo: ana@empresa.com, pepe@empresa.com.
Ajusta Access Level y Allow Editing según los permisos deseados.
Ejecuta el flujo. El componente creará la carpeta en Dropbox y generará los enlaces de acceso.
La salida Data contendrá el estatus true y los detalles de la operación, lo cual puedes usar para registrar el éxito en un log o enviar una confirmación.

Consejos y Mejores Prácticas

Límites de Selección: Ten en cuenta que al usar la opción “All folders” en el modo de entrada, el componente detendrá el proceso después de procesar 100 archivos. Planifica tus flujos para manejar grandes volúmenes dividiendo las tareas si es necesario.
Rutas y Nombres: Al crear carpetas, asegúrate de que el Folder Path y Folder Name sigan un formato válido y no contengan caracteres especiales que Dropbox no acepte.
Seguridad de Enlaces: Revisa siempre el campo Allow Editing cuando compartas carpetas con información sensible. Si solo deseas que los destinatarios vean los archivos, desactívalo para prevenir cambios no autorizados.
Credenciales Centradas: Aprovecha la configuración automatizada de credenciales. Configura tus claves de API en una sola credencial del proyecto y reutilízalas en este componente para mantener la seguridad de tu entorno.

Consideraciones de Seguridad

Autenticación Automática: Este componente utiliza las credenciales de tu proyecto de forma automática, lo que reduce el riesgo de exponer tokens o claves sensibles directamente en los flujos de trabajo.
Permisos de API: Asegúrate de que la credencial de Dropbox API tenga únicamente los permisos necesarios (Dropbox Permissions) para las operaciones que vas a realizar, siguiendo el principio de mínimo privilegio.
Compartición de Datos: Al compartir carpetas, verifica los correos electrónicos en Emails to Share With y el nivel de acceso antes de ejecutar el flujo, para evitar la divulgación no intencionada de información.