One Drive

⚠️ ADVERTENCIA DE DEPRECACIÓN

Este componente está deprecado y será eliminado en una versión futura de Nappai. Por favor, migra a los componentes alternativos recomendados.

Este componente permite cargar archivos o carpetas desde Microsoft OneDrive directamente a tu flujo de trabajo en Nappai. Puedes elegir entre cargar un solo archivo o todos los archivos dentro de una carpeta, y filtrar por tipo de archivo (documentos, hojas de cálculo o PDF).

¿Cómo funciona?

Cuando arrastras el componente al dashboard, Nappai solicita una credencial de Microsoft OneDrive. Con esa credencial, el componente se conecta a la API de OneDrive y descarga los archivos solicitados.

• Si seleccionas un archivo, se usa UnstructuredFileIOLoader para leer su contenido y devolverlo como texto.
• Si seleccionas una carpeta, se emplea OneDriveCustomLoader con la opción recursive=True para recorrer todos los subdirectorios y recoger los archivos que coincidan con el filtro de tipo (document, sheet, pdf).
  El resultado se devuelve en dos formas:

1. Data – una lista de objetos Data que contienen el texto extraído y metadatos del archivo.
2. Files – un mensaje que incluye la lista de rutas de los archivos descargados, útil para visualizarlos o procesarlos en pasos posteriores.

Entradas

• Upload file or select file
  Selecciona un archivo individual en OneDrive. El componente leerá su contenido y lo devolverá como texto.

• or Select folder
  Selecciona una carpeta en OneDrive. El componente buscará recursivamente todos los archivos compatibles dentro de esa carpeta.

• File Type
  Elige qué tipos de archivos quieres cargar:

  • all – Todos los tipos compatibles.
  • document – Documentos y hojas de cálculo.
  • sheet – Solo hojas de cálculo.
  • pdf – Solo archivos PDF.

Credencial

Este componente requiere una credencial de tipo Microsoft One Drive.

1. Ve a la sección de credenciales de Nappai y crea una nueva credencial llamada “Microsoft One Drive”.
2. Proporciona los siguientes datos:
   • Client ID – Ejemplo: <CLIENT_ID>
   • Client Secret – Ejemplo: <CLIENT_SECRET>
   • Tenant ID – Ejemplo: <TENANT_ID>
   • Microsoft onedrive access – Selecciona el nivel de acceso que necesites.
3. En el componente, selecciona la credencial recién creada en el campo Credential.

Nota: La credencial se almacena de forma segura en Nappai y no se muestra en la interfaz de usuario.

Salidas

• Data (método: fetch_content)
  Devuelve una lista de objetos Data con el contenido de texto de cada archivo y sus metadatos.

• Files (método: result_file)
  Devuelve un mensaje que contiene la lista de rutas de los archivos descargados, útil para visualizarlos o procesarlos en pasos posteriores.

Ejemplo de Uso

1. Configura la credencial: crea y selecciona la credencial “Microsoft One Drive”.
2. Arrastra el componente al flujo de trabajo.
3. Selecciona una carpeta en OneDrive que contenga los PDFs que quieres procesar.
4. Establece “File Type” a pdf para limitar la descarga solo a archivos PDF.
5. Conecta la salida Data al componente de resumen de texto (por ejemplo, “Text Summarizer”).
6. Ejecuta el flujo y obtén un resumen de todos los PDFs de la carpeta.

Componentes Relacionados

• MicrosoftOneDriveUploader – Sube archivos a OneDrive desde Nappai.
• MicrosoftOneDriveSearch – Busca archivos en OneDrive por nombre o metadatos.
• MicrosoftOneDriveDelete – Elimina archivos o carpetas de OneDrive.

Consejos y Mejores Prácticas

• Usa la selección de carpeta cuando necesites procesar varios archivos; evita cargar archivos individuales innecesarios.
• Filtra por tipo de archivo para reducir el tiempo de procesamiento y el consumo de recursos.
• Revisa los metadatos (por ejemplo, file_name, file_size) antes de procesar los datos para asegurarte de que son los archivos correctos.
• Mantén tus credenciales actualizadas y revoca los accesos que ya no necesites.

Consideraciones de Seguridad

• Los tokens de acceso se obtienen de forma segura mediante OAuth 2.0 y se almacenan en la nube de Nappai.
• Los archivos descargados se procesan en memoria; si manejas datos sensibles, considera moverlos a un almacenamiento seguro antes de procesarlos.
• Asegúrate de que la credencial tenga el mínimo nivel de permiso necesario para la tarea (por ejemplo, solo lectura si no necesitas escribir).