Activadores web de SharePoint

Los activadores web de SharePoint le permiten monitorear un sitio de SharePoint para detectar eventos. Puede configurar acciones que se activan cuando ocurre el evento monitoreado en el sitio SharePoint.

Resumen

Los activadores web de SharePoint le permiten iniciar un flujo de trabajo de automatización basado en los eventos suscritos. Configure el activador web de SharePoint para escuchar los eventos suscritos. Una vez que se produce el evento en el sitio SharePoint, el activador inicia el flujo de trabajo de automatización correspondiente. Los activadores web de SharePoint le permiten crear automatizaciones sin intervención manual, mediante el intercambio de datos en tiempo real.

Los activadores web de SharePoint utilizan la conexión ‌OAuth para autenticar los datos entrantes. Para obtener más información sobre la conexión ‌OAuth para SharePoint, consulte Crear conexiones ‌OAuth.
Nota: Se produce una latencia significativa entre el momento en que ocurre el evento en un sitio SharePoint y la Control Room recibe la notificación del sitio SharePoint. Para obtener más información, consulte la tabla de latencia en Microsoft Graph REST API Subscription latency.

Eventos admitidos

Puede configurar los activadores web de SharePoint para detectar eventos en archivos, carpetas y listas. Los activadores web de SharePoint admiten los siguientes eventos.

Eventos Descripción
Archivo creado Cuando se crea un archivo en el sitio SharePoint supervisado.
Archivo actualizado Cuando se actualiza un archivo en el sitio SharePoint supervisado.
Carpeta creada Cuando se crea una carpeta en el sitio SharePoint supervisado.
Carpeta actualizada Cuando se crea una carpeta en el sitio SharePoint supervisado.
Elemento de lista creado Cuando se agrega un elemento a una lista en el sitio SharePoint supervisado.
Elemento de lista actualizado Cuando se actualiza un elemento de lista existente en el sitio de SharePoint supervisado.

Requisitos previos

Asegúrese de que se cumplan los siguientes requisitos previos:

  • Una licencia de Bot Creator o Citizen Developer.
  • Permisos ACTIVADORES DE EVENTOS y Ver mis bots.
  • Permisos de Registro y Descarga en las carpetas en las que se encuentra la automatización.
  • Una conexión activa de ‌OAuth para el sitio de SharePoint.

Configuración

Las siguientes configuraciones están disponibles para el activador web de SharePoint.
SharePoint OAuth
La opción SharePoint OAuth le permite seleccionar la conexión ‌OAuth configurada. Asegúrese de agregar el permiso de Microsoft Graph al alcance de conexión de ‌OAuth. El alcance de Microsoft Graph permite que el activador lea la biblioteca de documentos de SharePoint para eventos relacionados con archivos y carpetas, y lea las listas de SharePoint para eventos relacionados con listas.
Sitio
La opción Sitio le permite configurar el sitio SharePoint que monitorea para eventos. Puede ingresar el enlace directamente o usar la opción Seleccionar sitio para seleccionar el sitio de la lista desplegable Sitios. La lista desplegable de Sitios se conecta al sitio SharePoint y muestra todos los sitios dentro del subdominio.
Tipo de evento
La opción Tipo de evento le permite configurar los eventos en los que el activador inicia las acciones de automatización subsiguientes. Puede configurar el activador en función de Archivo y carpeta o Lista.
En la opción Archivo y carpeta, seleccione los eventos del menú desplegable Escuchar evento e ingrese la ruta del archivo para eventos de archivo y la ruta de la carpeta para eventos de carpeta. Asegúrese de ingresar la carpeta principal para los eventos de la carpeta. Por ejemplo, para monitorear eventos de carpeta de una carpeta llamada XYZ, que se encuentra dentro de otra carpeta llamada ABC que está dentro de la carpeta de documentos SharePoint, ingrese Documents/ABC.
Respuesta
La opción Respuesta le permite capturar los datos de respuesta del activador en una variable de registro. Puede elegir crear una variable de registro o seleccionar una variable de registro existente para capturar los datos de respuesta. La variable de registro almacena la información del cuerpo de la respuesta de la API en un formato de pares clave-valor.

Lectura de datos de respuesta del activador en el registro de auditoría

Los datos de respuesta del activador contienen toda la información de los eventos en los que ocurrió el cambio. Los datos de carga útil del evento se generan utilizando las propiedades de recursos de las API de SharePoint en Microsoft Graph. Los datos. Puede ver los datos, almacenados en un par clave-valor, en la página Registro de auditoría. Para obtener más información sobre los datos de carga útil de eventos de SharePoint, consulte Working with SharePoint sites in Microsoft Graph.

Puede usar los atributos de datos de la carga útil del evento capturados en el Registro de auditoría como entradas para cualquier acción posterior dentro de la sesión. También puede construir los argumentos para los atributos a partir de las propiedades del tipo de recurso de las API de SharePoint en Microsoft Graph. Por ejemplo, para ver la ruta de la carpeta en la que se crea un archivo, puede usar parentReference.path, donde parentReference corresponde a las propiedades de recursos de BaseItem y path corresponde a las propiedades de recursos de itemReference.