Saltearse al contenido
Nappai Documentation

Dropbox Writer

El Dropbox Writer permite subir archivos directamente a tu cuenta de Dropbox desde el dashboard de Nappai. Solo necesitas indicar el contenido del archivo, el nombre que tendrá y la carpeta de destino. El componente se encarga de autenticarte con la API de Dropbox y de crear el archivo en la ubicación elegida.

¿Cómo funciona?

Cuando activas el componente, Nappai busca la credencial de tipo Dropbox API que hayas configurado previamente. Con el token de acceso que obtienes de esa credencial, el componente llama a la API de Dropbox para crear un nuevo archivo con el nombre y el contenido que le has proporcionado. La carpeta de destino se especifica mediante el ID de la carpeta seleccionada en el panel de Dropbox.

Entradas

Campos de Entrada

  • File content: Contenido del archivo que quieres subir. Puedes pegar texto directamente o conectar la salida de otro componente que genere datos.
  • Select folder to upload: Carpeta de Dropbox donde se guardará el archivo. Se selecciona mediante el selector de directorios de Dropbox.
  • File Name: Nombre que tendrá el archivo en Dropbox. Este campo es obligatorio.

Nota sobre credenciales
Antes de usar el componente, asegúrate de:

  1. Configurar una credencial Dropbox API en la sección de credenciales de Nappai.
  2. Seleccionar esa credencial en el campo “Credential” del componente.
    La credencial requiere que configures los permisos de Dropbox en el App Console de tu cuenta de Dropbox.

Salidas

  • Path to File: Ruta completa del archivo recién creado en Dropbox. Puedes usar esta salida para enlazarla con otros componentes que necesiten acceder al archivo.

Ejemplo de Uso

  1. Añade el componente “Dropbox Writer” al flujo de trabajo.
  2. Configura la credencial: En el panel de credenciales, selecciona la credencial “Dropbox API” que ya has creado.
  3. Define el contenido:
    • Si el archivo es texto plano, escribe el contenido directamente en el campo File content.
    • Si el contenido proviene de otro componente (por ejemplo, un generador de texto), conecta la salida de ese componente al campo File content.
  4. Selecciona la carpeta: Haz clic en el selector de directorios y elige la carpeta donde quieres guardar el archivo.
  5. Escribe el nombre del archivo en el campo File Name (ej. report.txt).
  6. Ejecuta el flujo.
  7. Revisa la salida: El campo Path to File mostrará la ruta completa, por ejemplo https://www.dropbox.com/s/abcd1234/report.txt. Puedes usar esta ruta en componentes posteriores, como un correo electrónico o un registro de log.

Consejos y Mejores Prácticas

  • Verifica los permisos: Asegúrate de que la credencial tenga permisos de escritura en la carpeta elegida.
  • Controla el tamaño: Dropbox tiene límites de tamaño por archivo; evita subir archivos demasiado grandes.
  • Reutiliza la credencial: Si vas a subir archivos a varias carpetas, usa la misma credencial para evitar configuraciones repetidas.
  • Maneja errores: Si la subida falla, revisa el mensaje de error que devuelve la API; suele indicar problemas de autenticación o de permisos.

Consideraciones de Seguridad

  • La credencial Dropbox API contiene un token de acceso que permite leer y escribir en tu cuenta de Dropbox. Guarda la credencial en un lugar seguro y no la compartas públicamente.
  • Evita exponer el token en logs o en salidas visibles.
  • Si sospechas que el token ha sido comprometido, revoca la aplicación en el App Console y crea una nueva credencial.