OneDrive/SharePoint — Create folder

OneDrive/SharePoint — Create folder

Tipo: msfiles-create-folder  ·  Paquete: OneDrive / SharePoint v1.0.5  ·  Salida: Dictionary<string,object>

Crea una carpeta en la unidad y devuelve sus datos (incluido el ID), que normalmente usarás como destino al subir o mover archivos.

Cómo funciona

Opera sobre la sesión creada con OneDrive/SharePoint — Connect. Pásala en el parámetro session, o coloca esta actividad dentro del body de Connect para heredarla automáticamente.

Si no indicas folderId, la carpeta se crea en la raíz de la unidad. Para anidarla, pasa el ID de la carpeta padre.

Si el nombre ya existe, crea otra carpeta

Si ya hay una carpeta (o archivo) con ese nombre en el mismo lugar, Microsoft 365 no falla: crea la nueva con un nombre numerado (Informes 1). Por eso no es idempotente: ejecutarla dos veces deja dos carpetas. Si la carpeta puede existir de antes, búscala primero con List files y créala solo si no aparece. El nombre real queda en la salida (carpeta["name"]).

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
name	string	—	Nombre de la carpeta. Sin caracteres no permitidos en OneDrive/SharePoint (" * : < > ? / \ |).

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
session	ZoanMicrosoftFilesSession	—	Sesión de Connect. Dentro del body de Connect se hereda.
folderId	string	—	ID de la carpeta padre. Si se omite, la raíz de la unidad.

Salida

Devuelve un Dictionary<string,object> con los datos de la carpeta creada: id, name (el nombre final, que puede llevar número si ya existía), isFolder (true), size, webUrl, parentId, modifiedTime, createdTime y childCount (0). Usa carpeta["id"] como folderId de destino en Move, Copy o al crear subcarpetas.

Errores comunes

Mensaje	Causa y solución
No hay una sesión de OneDrive/SharePoint disponible. Indica 'session' desde una actividad msfiles-connect o coloca esta actividad dentro del cuerpo de la actividad Connect para que herede la sesión automáticamente.	La actividad está fuera del body de Connect y no recibió session. Colócala dentro del body o pasa session = sesion.
'name' es obligatorio.	name está vacío o su expresión dio null.
itemNotFound (Microsoft Graph, 404)	No existe una carpeta padre con ese folderId.
invalidRequest (Microsoft Graph, 400)	El nombre tiene caracteres no permitidos.
La creación de la carpeta no devolvió ningún elemento.	Microsoft Graph respondió sin datos de la carpeta. Comprueba con List files si se creó antes de reintentar.

Ejemplo

OneDrive/SharePoint — Connect   credential = credential("m365-operaciones")
 └─ body:
      OneDrive/SharePoint — Create folder   name = "Informes " + DateTime.Now.ToString("yyyy-MM")   → output: carpeta
      OneDrive/SharePoint — Move            id = idReporte   folderId = carpeta["id"]

Actividades relacionadas

• OneDrive/SharePoint — Upload — subir archivos a la carpeta.
• OneDrive/SharePoint — Move — mover archivos a la carpeta.
• OneDrive/SharePoint — List files — listar su contenido.
• Todas las actividades de OneDrive / SharePoint