Files

El componente Files permite a los usuarios interactuar con sus archivos en Microsoft OneDrive directamente desde el dashboard de Nappai. Con él puedes listar carpetas, descargar archivos, subir nuevos, actualizar su contenido, moverlos o eliminarlos, todo sin salir de la plataforma.

¿Cómo funciona?

El componente se conecta a la API de Microsoft OneDrive mediante una credencial previamente configurada en Nappai. Cuando seleccionas una operación, el componente envía la solicitud correspondiente a la API y devuelve los resultados. Si habilitas el modo de mapeo, el componente puede procesar varios registros a la vez, lo que facilita la automatización de tareas en lote.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

• Get Folder Files: Lista los archivos dentro de una carpeta especificada.
• Get File: Obtiene el contenido o metadatos de un archivo concreto.
• Upload Files: Sube uno o varios archivos a una carpeta de OneDrive.
• Update File: Modifica el contenido o el nombre de un archivo existente.
• Delete File: Elimina un archivo de OneDrive.

Para usar el componente, primero selecciona la operación que necesitas en el campo Operation (Operación).

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada Mapping Data y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

• Fixed (Fijo): Escribes el valor directamente en el campo.
• Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
• Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

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

• Operation: Selecciona la operación que deseas ejecutar.

  • Visible en: Get Folder Files, Get File, Upload Files, Update File, Delete File

• Credential: Elige la credencial de Microsoft One Drive que ya has configurado en Nappai.
  Nota: Debes crear la credencial primero en la sección de credenciales de Nappai y luego seleccionarla aquí.

• File to upload: Archivos que quieres subir (pueden ser ID, URL o bytes).

  • Visible en: Upload Files

• Select file: Archivo seleccionado para operaciones de archivo único.

  • Visible en: Get File, Update File, Delete File

• Select folder: Carpeta seleccionada para operaciones que requieren una carpeta.

  • Visible en: Get Folder Files, Upload Files

• New Content: Nuevo contenido para actualizar un archivo.

  • Visible en: Update File

• Download File Content: Descarga el contenido del archivo (opcional).

  • Visible en: Get Folder Files, Get File

• File Path Or Url: ID o URL del archivo.

  • Visible en: Get File, Update File, Delete File

• File Id or URL: ID o URL de los archivos a subir.

  • Visible en: Upload Files

• Selection Mode: Modo de selección de archivos.

  • Visible en: Get File, Update File, Delete File, Get Folder Files, Upload Files

• File Type: Tipo de archivos a buscar.

  • Visible en: Get Folder Files

• Folder Path Or Url: Ruta o URL de la carpeta.

  • Visible en: Get Folder Files, Upload Files

• Max Count: Número máximo de archivos a recuperar.

  • Visible en: Get Folder Files

• New Name: Nuevo nombre para el archivo (opcional).

  • Visible en: Update File

• Load File Content: Carga el contenido de texto del archivo.

  • Visible en: Get Folder Files, Get File

• Tool Name: Nombre del tool que se mostrará al agente.

  • Visible en: Get Folder Files, Get File, Upload Files, Update File, Delete File

• Tool Description: Descripción detallada del tool.

  • Visible en: Get Folder Files, Get File, Upload Files, Update File, Delete File

• Tools arguments metadata: Metadatos de los argumentos del tool.

  • Visible en: Get Folder Files, Get File, Upload Files, Update File, Delete File

• Mapping Mode: Interruptor que habilita el modo de mapeo.

  • Visible en: Get Folder Files, Get File, Upload Files, Update File, Delete File

• Mapping Data: Entrada que aparece cuando el modo de mapeo está activado.

  • Visible en: Todas las operaciones (solo cuando Mapping Mode está activado)

Salidas

• Data: Resultado de la operación (por ejemplo, lista de archivos, contenido de un archivo, etc.).
• Tool: Objeto que permite que el componente sea usado como herramienta por un agente de IA.

Ejemplo de Uso

Obtener archivos de una carpeta

1. Activa el modo de mapeo si quieres procesar varias carpetas a la vez.
2. Selecciona la operación Get Folder Files.
3. Ingresa la ruta o URL de la carpeta en Folder Path Or Url.
4. Opcionalmente, marca Download File Content y Load File Content para obtener el contenido de los archivos.
5. Ejecuta el flujo y revisa la salida Data para ver la lista de archivos.

Subir un archivo

1. Selecciona la operación Upload Files.
2. En File Id or URL o File to upload, proporciona el archivo que deseas subir (puede ser un ID, una URL o los bytes del archivo).
3. En Folder Path Or Url, indica la carpeta de destino.
4. Ejecuta el flujo. La salida Data confirmará la subida y mostrará los metadatos del archivo nuevo.

Componentes Relacionados

• OneDriveFileComponentBase: Base del componente que maneja la lógica común de OneDrive.
• NappaiBaseComponent: Clase base que provee funcionalidades compartidas entre todos los componentes de Nappai.

Consejos y Mejores Prácticas

• Usa el modo de mapeo cuando necesites procesar listas de archivos o carpetas; evita ejecutar múltiples flujos individuales.
• Configura la credencial antes de usar el componente; sin ella, el componente no podrá conectarse a OneDrive.
• Limita el número de archivos con Max Count para evitar sobrecargar la API y mejorar el rendimiento.
• Guarda los resultados en una variable de flujo para reutilizarlos en pasos posteriores (por ejemplo, para enviar un correo con los archivos descargados).

Consideraciones de Seguridad

• La credencial de Microsoft One Drive contiene información sensible (Client ID, Client Secret, Tenant ID). Asegúrate de que solo los usuarios autorizados tengan acceso a la sección de credenciales de Nappai.
• Cuando habilites el modo de mapeo, revisa que los datos que se procesan no contengan información confidencial que no deba ser expuesta a otros componentes del flujo.