Folders

El componente Folders te permite trabajar con carpetas en tu cuenta de Microsoft OneDrive directamente desde el dashboard de Nappai. Con él puedes listar las carpetas existentes, crear nuevas, eliminar las que ya no necesites y compartirlas con otras personas. Todo se hace a través de la API de OneDrive, por lo que necesitas una credencial previamente configurada en Nappai.

¿Cómo funciona?

Cuando activas el componente, Nappai envía peticiones a la API de Microsoft OneDrive usando la credencial que hayas seleccionado. Dependiendo de la operación elegida, el componente construye la URL y los parámetros necesarios y realiza la llamada HTTP correspondiente. Los resultados se devuelven como un objeto Data que puedes usar en otros componentes o como un Tool que un agente de IA puede invocar.

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 Folders: Lista todas las carpetas dentro de la ruta o carpeta padre especificada.
• Create Folder: Crea una nueva carpeta con el nombre indicado dentro de la carpeta padre seleccionada.
• Delete Folder: Elimina la carpeta cuyo ID se proporciona.
• Share Folder: Comparte la carpeta especificada con los usuarios que ingreses y les asigna el nivel de permiso elegido.

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:

• Parent folder: Carpeta padre donde se realizará la operación (por ejemplo, la ruta o ID de la carpeta).

  • Visible en: Get Folders, Create Folder

• Operation: Selecciona la acción que quieres ejecutar.

  • Visible en: Get Folders, Create Folder, Delete Folder, Share Folder

• Folder ID: Identificador único de la carpeta que quieres eliminar o compartir.

  • Visible en: Delete Folder, Share Folder

• Folder Name: Nombre de la carpeta que quieres crear.

  • Visible en: Create Folder

• Mapping Mode: Habilita el modo de mapeo para procesar varios registros a la vez.

  • Visible en: Get Folders, Create Folder, Delete Folder, Share Folder

• Parent Path: Ruta o URL del padre (por ejemplo, /Documents o https://domain-my.sharepoint.com/...).

  • Visible en: Get Folders, Create Folder

• Permission Role: Nivel de permiso que se asignará al compartir la carpeta.

  • Visible en: Share Folder

• Share with: Direcciones de correo electrónico de las personas con las que compartir la carpeta, separadas por comas.

  • Visible en: Share Folder

• Selection Mode: Modo de selección de carpetas (por ejemplo, por ID o por nombre).

  • Visible en: Get Folders, Create Folder

• Share Message: Mensaje opcional que se incluirá en la invitación de compartición.

  • Visible en: Share Folder

• Tool Name: Nombre que se mostrará al agente cuando el componente se utilice como herramienta.

  • Visible en: Get Folders, Create Folder, Delete Folder, Share Folder

• Tool Description: Descripción detallada de lo que hace la herramienta.

  • Visible en: Get Folders, Create Folder, Delete Folder, Share Folder

• Tools arguments metadata: Metadatos de los argumentos que la herramienta acepta.

  • Visible en: Get Folders, Create Folder, Delete Folder, Share Folder

Credencial
Este componente necesita una credencial de tipo Microsoft One Drive.

1. Ve a la sección de credenciales de Nappai y crea una nueva credencial de tipo Microsoft One Drive.
2. Selecciona esa credencial en el campo Credential del componente.
   La credencial debe incluir el Client ID, Client Secret, Tenant ID y el nivel de acceso a OneDrive. No se muestran estos campos en la lista de entradas porque ya están configurados en la credencial.

Salidas

• Data: Resultado de la operación (por ejemplo, lista de carpetas, confirmación de creación, etc.).
• Tool: Representación de la operación como una herramienta que un agente de IA puede invocar.

Ejemplo de Uso

Obtener carpetas

1. Selecciona la operación Get Folders.
2. En Parent Path escribe /Documents.
3. Desactiva Mapping Mode si solo quieres una carpeta.
4. Ejecuta el flujo y obtendrás una lista de carpetas dentro de /Documents.

Crear una carpeta

1. Selecciona la operación Create Folder.
2. En Parent Path escribe /Documents.
3. En Folder Name escribe Reportes 2025.
4. Ejecuta el flujo y la carpeta aparecerá en tu OneDrive.

Componentes Relacionados

• OneDriveFileComponent – Gestiona archivos dentro de OneDrive.
• OneDriveShareComponent – Comparte archivos y carpetas con usuarios externos.
• OneDriveSyncComponent – Sincroniza carpetas entre OneDrive y otras aplicaciones.

Consejos y Mejores Prácticas

• Usa Mapping Mode cuando necesites procesar listas de carpetas en lote.
• Verifica que el Permission Role sea el correcto antes de compartir; los permisos de lectura no permiten editar.
• Guarda la salida Data en una variable para usarla en pasos posteriores del flujo.
• Si vas a eliminar carpetas, confirma el Folder ID para evitar borrados accidentales.

Consideraciones de Seguridad

• La credencial de Microsoft One Drive contiene información sensible; protégela y comparte solo con usuarios autorizados.
• Los datos de las carpetas compartidas se envían a través de HTTPS, garantizando la confidencialidad.
• Revisa los permisos de la credencial para limitar el acceso solo a los recursos necesarios.