SharePoint — Add list item

SharePoint — Add list item

Tipo: msfiles-add-list-item  ·  Paquete: OneDrive / SharePoint v1.0.5  ·  Salida: string

Añade un elemento nuevo a una lista de SharePoint, indicando los valores de sus columnas. Es una forma sencilla de registrar resultados donde el equipo ya trabaja, con vistas, filtros y alertas de SharePoint.

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.

Requiere siteId

Las actividades de listas necesitan que Connect tenga configurado el siteId. En fields usa los nombres internos de columna (los que ve la API, no siempre la etiqueta visible).

El nombre interno se fija al crear la columna y no cambia aunque la renombres: una columna creada como “Fecha de pago” suele tener el nombre interno Fecha_x0020_de_x0020_pago. Para verlo, abre la configuración de la columna en SharePoint (aparece en la dirección como Field=) o lee un elemento con Get list items y mira las claves de fields.

Valores de las columnas:

• Texto, número, sí/no y elección: el valor tal cual ("Pendiente", 1500, true).
• Fecha: texto ISO 8601 ("2026-10-15T00:00:00Z").
• Persona o búsqueda: el ID del elemento relacionado en <Columna>LookupId ("ResponsableLookupId": 7).
• Los valores null se omiten.

Cada ejecución crea un elemento nuevo; no comprueba si ya existe uno igual. Si reintentas tras un error, revisa antes con Get list items para no duplicar.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
list	string	—	Nombre visible o ID de la lista.
fields	Dictionary	—	Valores de las columnas como { columna: valor }, con nombres internos. Debe tener al menos un valor no nulo.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
session	ZoanMicrosoftFilesSession	—	Sesión de Connect. Dentro del body de Connect se hereda.

Salida

Devuelve un string con el ID del elemento creado (por ejemplo "42"). Guárdalo si vas a actualizarlo o borrarlo después.

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.
Esta actividad necesita un sitio de SharePoint. Indica 'siteId' en la actividad Connect.	Connect se abrió sin siteId.
'list' es obligatorio.	list está vacío o su expresión dio null.
'fields' es obligatorio.	fields está vacío, todos sus valores son null o no es un diccionario.
invalidRequest (Microsoft Graph, 400)	Una columna no existe con ese nombre interno, o un valor no tiene el formato que espera la columna (fecha, número, elección no válida).
itemNotFound (Microsoft Graph, 404)	No existe una lista con ese nombre o ID en el sitio.
accessDenied (Microsoft Graph, 403)	A la conexión le falta Sites.ReadWrite.All o la cuenta no puede agregar elementos a la lista.

Ejemplo

OneDrive/SharePoint — Connect   credential = credential("m365-operaciones")   siteId = idSitio
 └─ body:
      SharePoint — Add list item   list = "Solicitudes"   fields = { "Title": "Factura " + numeroFactura, "Estado": "Pendiente", "Monto": total }   → output: nuevoId
      Log   message = "Solicitud creada con ID " + nuevoId

Actividades relacionadas

• SharePoint — Get list items — leer los elementos de la lista.
• SharePoint — Update list item — modificar un elemento.
• SharePoint — Delete list item — borrar un elemento.
• Todas las actividades de OneDrive / SharePoint