Saturn Studio – Microsoft OneDrive

📌 ¿Qué es este módulo?

Microsoft OneDrive es el servicio de almacenamiento en la nube de Microsoft. Este módulo permite obtener, subir, descargar, mover, crear y eliminar archivos o carpetas en OneDrive directamente desde Saturn Studio.

📚 Descripción de los comandos

📁 Get Files

Obtener archivos desde una carpeta específica en OneDrive.

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Microsoft necesaria para obtener archivos.	credential
Carpeta	Carpeta de OneDrive donde se buscarán los archivos.	Root
Asignar variable	Variable donde se almacenará el resultado. Ejemplo: [{“id”: “F1AA1BDEBE2D6235!sb180ff3714ec4e22878e81b6b729bbac”, “name”: “File.xlsx”}]	{var}

⬇️ Download File

Descargar un archivo desde OneDrive.

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Microsoft necesaria para descargar archivos.	credential
ID del archivo	ID del archivo que se desea descargar.	F1AA1BDEBE2D6235!s7dea54c…
Asignar variable	Variable donde se almacenará el resultado. Ejemplo: [{“filename”: “document.docx”}]	{var}

⬆️ Upload File

Subir un archivo a OneDrive.

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Microsoft necesaria para subir archivos.	credential
Carpeta	Carpeta de destino en OneDrive.	Root
Nombre del archivo	Nombre del archivo a subir.	filename.xlsx
Archivo a subir	Archivo a cargar en OneDrive.	File to upload
Si existe archivo con mismo nombre	Acción si el archivo ya existe: Replace, Rename o Error.	Replace
Asignar variable	Variable donde se almacenará el resultado. Ejemplo: {“message”: “Files uploaded successfully”}	{var}

📂 Create Folder

Crear una carpeta en OneDrive.

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Microsoft necesaria para crear carpetas.	credential
Carpeta	Carpeta en la cual se creará la nueva carpeta.	Root
Nombre de la carpeta	Nombre de la nueva carpeta a crear.	New Folder
Si existe carpeta con mismo nombre	Acción si ya existe una carpeta con ese nombre: Replace, Rename o Error.	Rename
Asignar variable	Variable donde se almacenará el resultado. Ejemplo: {“folder”: {“name”: “Folder”}}	{var}

🔄 Move File/Folder

Mover un archivo o carpeta a una nueva ubicación dentro de OneDrive.

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Microsoft necesaria para mover archivos.	credential
Tipo	Seleccionar si se moverá un archivo o carpeta.	File
ID del archivo	ID del archivo o carpeta que se desea mover.	F1AA1BDEBE2D6235!…
ID carpeta destino	ID de la carpeta de destino.	F1AA1BDEBE2D6235!…
Asignar variable	Variable donde se almacenará el resultado.	{var}

❌ Delete File/Folder

Eliminar un archivo o carpeta de OneDrive.

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Microsoft necesaria para eliminar archivos.	credential
Tipo	Seleccionar si se eliminará un archivo o una carpeta.	Folder
ID del elemento	ID del archivo o carpeta a eliminar.	F1AA1BDEBE2D6235!…
Asignar variable	Variable donde se almacenará el resultado. Ejemplo: {“message”: “Folder deleted successfully”}	{var}

🧪 Ejemplo de uso

• Get Files
  Obtener todos los archivos almacenados en la carpeta raíz de OneDrive.
• Upload File
  Subir un archivo llamado informe.xlsx al directorio raíz y reemplazar si ya existe.
• Download File
  Descargar un archivo específico usando su ID y almacenarlo localmente.
• Create Folder
  Crear una nueva carpeta de nombre “Documentos” en el directorio raíz.
• Move File/Folder
  Mover un archivo a una nueva carpeta usando los respectivos IDs.
• Delete File/Folder
  Eliminar una carpeta llamada “Antiguos” usando su ID.

🧩 Requisitos

1. Tener una credencial válida de Microsoft OneDrive configurada en Saturn Studio.
2. Conocer los IDs de archivos o carpetas si se van a mover, eliminar o descargar.
3. Para subir archivos, se requiere indicar el archivo y su nombre de destino.
4. Las operaciones son válidas solo dentro del espacio de almacenamiento asignado al usuario autenticado.