SharePoint — Get list items

SharePoint — Get list items

Tipo: msfiles-get-list-items  ·  Paquete: OneDrive / SharePoint v1.0.5  ·  Salida: List<Dictionary<string,object>>

Lee los elementos de una lista de SharePoint junto con sus campos. Las listas de SharePoint funcionan como tablas; úsala para tratar una lista como origen de datos de tu proceso (solicitudes, inventarios, registros).

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 del sitio de SharePoint. Indica la lista por nombre o por ID.

Devuelve como máximo maxResults elementos, de una sola página de resultados de Microsoft Graph, en el orden en que los entrega SharePoint (normalmente, por orden de creación). No filtra: si necesitas solo algunos elementos, fíltralos después en el proceso. Es solo lectura.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
list	string	—	Nombre visible o ID de la lista.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
session	ZoanMicrosoftFilesSession	—	Sesión de Connect. Dentro del body de Connect se hereda.
maxResults	int	100	Número máximo de elementos. Valores no numéricos, 0 o negativos usan 100.

Salida

Devuelve un List<Dictionary<string,object>>. Cada elemento tiene dos claves:

Clave	Contenido
id	ID del elemento (texto, por ejemplo "12"). Úsalo en Update o Delete list item.
fields	Diccionario con las columnas por su nombre interno: Title, tus columnas y las de sistema (Created, Modified, AuthorLookupId…).

Accede a una columna con item["fields"]["Title"]. Los valores llegan como texto, número o booleano; las fechas, como texto ISO 8601 en UTC; las columnas de persona o de búsqueda, como el ID del elemento relacionado en <Columna>LookupId. Las columnas vacías pueden no aparecer en fields: si una columna es opcional, comprueba que exista antes de leerla.

Si la lista está vacía, devuelve una lista vacía.

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.
itemNotFound (Microsoft Graph, 404)	No existe una lista con ese nombre o ID en el sitio, o el siteId no es válido.
accessDenied (Microsoft Graph, 403)	A la conexión le falta Sites.Read.All / Sites.ReadWrite.All, o la cuenta no tiene acceso a la lista.

Ejemplo

OneDrive/SharePoint — Connect   credential = credential("m365-operaciones")   siteId = idSitio
 └─ body:
      SharePoint — Get list items   list = "Solicitudes"   maxResults = 500   → output: solicitudes
      For each   s in solicitudes
       └─ If   condition = s["fields"]["Estado"].ToString() == "Pendiente"
           └─ then:
                SharePoint — Update list item   list = "Solicitudes"   itemId = s["id"]   fields = { "Estado": "En proceso" }

Actividades relacionadas

• SharePoint — Add list item — añadir un elemento.
• SharePoint — Update list item — modificar un elemento.
• SharePoint — Delete list item — borrar un elemento.
• Todas las actividades de OneDrive / SharePoint