SharePoint — Update list item

SharePoint — Update list item

Tipo: msfiles-update-list-item  ·  Paquete: OneDrive / SharePoint v1.0.5

Actualiza los campos de un elemento existente de una lista de SharePoint. Solo cambia las columnas que indiques; el resto conserva su valor.

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. Indica el elemento con su itemId (de Get list items) y usa los nombres internos de columna en fields.

Los valores siguen las mismas reglas que en Add list item (fechas en ISO 8601, personas y búsquedas por <Columna>LookupId). Los valores null se omiten, así que no vacían la columna; para dejar vacía una columna de texto, envía "".

Aplicar dos veces los mismos valores deja el mismo resultado, así que es seguro reintentarla. SharePoint registra cada cambio como una versión nueva del elemento, con la cuenta de la conexión como autora.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
list	string	—	Nombre visible o ID de la lista.
itemId	string	—	ID del elemento de la lista.
fields	Dictionary	—	Valores a actualizar 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

Esta actividad no devuelve ningún valor.

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. / 'itemId' es obligatorio.	El parámetro 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.
itemNotFound (Microsoft Graph, 404)	No existe la lista, o no hay un elemento con ese itemId (quizá se borró).
invalidRequest (Microsoft Graph, 400)	Una columna no existe con ese nombre interno, o un valor no tiene el formato que espera.

Ejemplo

OneDrive/SharePoint — Connect   credential = credential("m365-operaciones")   siteId = idSitio
 └─ body:
      SharePoint — Update list item   list = "Solicitudes"   itemId = solicitud["id"]   fields = { "Estado": "Resuelto", "FechaCierre": DateTime.UtcNow.ToString("o") }

Actividades relacionadas

• SharePoint — Get list items — localizar el elemento y su ID.
• SharePoint — Add list item — añadir un elemento.
• SharePoint — Delete list item — borrar un elemento.
• Todas las actividades de OneDrive / SharePoint