Lists

Lists trabaja con las listas de tus sitios de SharePoint: consulta las listas de un sitio, crea listas nuevas y lee, añade, modifica o elimina sus elementos.

Muchas empresas usan las listas de SharePoint como un registro sencillo: incidencias, solicitudes de vacaciones, inventario o contactos. Con este componente un flujo puede leer ese registro o mantenerlo al día sin que nadie tenga que entrar en SharePoint.

Cuándo usarlo

• Cada solicitud que llega por un formulario quieres registrarla como un elemento nuevo de una lista.
• Un agente de IA tiene que consultar el estado de una incidencia guardada en una lista.
• Cuando se resuelve una tarea en otra herramienta, quieres actualizar su estado en la lista de SharePoint.
• Al empezar un proyecto quieres crearle una lista de tareas en su sitio.

Configuración

Necesitas una credencial Microsoft Shared Point, que se conecta iniciando sesión con tu cuenta de Microsoft. Al crearla eliges el acceso: con Read Only solo puedes leer; para crear, modificar o eliminar elige Full Access. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Microsoft Shared Point con la que se accede a tus sitios.
Operation (obligatorio)	Lo que hace el componente. Ver Operaciones. Por defecto, Get Site Lists.
Mode	Cómo indicas el sitio, la lista y el elemento: By Selector (los eliges de una lista) o By Manual Entry (escribes sus identificadores en Site ID, List ID y List Item ID). Por defecto, By Selector.
Site (obligatorio)	El sitio de SharePoint. La lista se carga al elegir la credencial.
List (obligatorio)	La lista con la que trabajas. En Get List Items, Create List Item, Update List Item y Delete List Item.
List Item (obligatorio)	El elemento de la lista, que aparece con su título y su identificador. En Update List Item y Delete List Item.
List Name (obligatorio)	El nombre de la lista nueva. Solo en Create List.
List Template	El tipo de lista nueva: genericList (lista personalizada), tasks (tareas), events (calendario), contacts (contactos), announcements (anuncios) o links (vínculos). Por defecto, genericList. Solo en Create List.
List Description	La descripción de la lista nueva. Solo en Create List.
Items Count	Cuántos elementos se leen como máximo. Por defecto, 100. Se usa en Get List Items.
Filter Query	Un filtro para quedarte solo con algunos elementos, escrito como lo admite SharePoint, por ejemplo fields/Title eq 'Impresora'. Solo en Get List Items.

Columnas de la lista

En Create List Item y Update List Item, al elegir la lista aparece un campo por cada columna, con el nombre de la columna. Rellena los que quieras guardar: los campos que dejes vacíos no se envían, así que en Update List Item solo cambian las columnas que rellenes. Las columnas de opciones aparecen como desplegables y las de sí o no como interruptores. Las columnas de persona, de búsqueda en otra lista, de vínculo y de ubicación no aparecen.

Operaciones

Operación	Qué hace
Get Site Lists	Devuelve las listas del sitio, con su nombre, descripción, enlace, tipo, número de elementos y fechas.
Create List	Crea una lista nueva en el sitio.
Get List Items	Devuelve los elementos de una lista, con el valor de cada columna, un resumen, el enlace, las fechas y quién los creó y modificó.
Create List Item	Añade un elemento a la lista con los valores de las columnas.
Update List Item	Cambia los valores de las columnas de un elemento existente.
Delete List Item	Elimina un elemento de la lista.

Resultado

La salida Data devuelve un elemento por cada lista o elemento encontrado, o un único elemento con el resultado de la operación, como la lista creada o la confirmación del cambio. Si una operación falla, la salida trae un elemento con el mensaje de error en lugar de detener el flujo.

Puedes conectar el resultado a un agente para que use los datos de la lista, o a otro componente que los procese o los envíe. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo consultar o actualizar la lista. Ver Tool Mode.

Ejemplo

El departamento de sistemas de una empresa registra las incidencias en la lista Incidencias de su sitio de SharePoint y quiere que las que llegan por correo se añadan solas.

1. Un agente lee cada correo de soporte y extrae el título, la descripción y la prioridad.
2. Añade Lists con la operación Create List Item y la credencial Microsoft Shared Point de sistemas.
3. En Site elige el sitio de Sistemas y en List la lista Incidencias.
4. Rellena los campos de las columnas que aparecen, como Title, Descripción y Prioridad, con los datos que ha extraído el agente.

Buenas prácticas

• Usa Filter Query en lugar de leer toda la lista cuando solo necesitas unos pocos elementos.
• Si cambias las columnas de la lista en SharePoint, vuelve a elegir la lista en el componente para que aparezcan los campos nuevos.
• Delete List Item no pide confirmación.

Componentes relacionados

• Sites: buscar sitios de SharePoint.
• Documents: gestionar documentos de SharePoint.