SharePoint 网页触发器

SharePoint 网页触发器可用于监控 SharePoint 站点的事件。 您可以在 SharePoint 站点中配置在监控事件发生时激活的操作。

概述

SharePoint 网页触发器使您能够根据已订阅的事件启动自动化工作流。 配置 SharePoint 网页触发器，以监听已订阅的事件。 在 SharePoint 站点发生事件时，触发器将激活后续的自动化工作流。 SharePoint 网页触发器使您能够创建自动化，无需任何人工干预即可实现实时数据交换。

SharePoint 网页触发器使用 OAuth 连接对传入数据进行身份验证。 有关 SharePoint 的 OAuth 连接的更多信息，请参阅 创建 OAuth 连接。
注： 在 SharePoint 站点发生事件与 Control Room 从 SharePoint 站点接收到通知之间存在显著延迟。 有关详细信息，请参阅 Microsoft Graph REST API Subscription latency 中的延迟表。

支持的事件

您可以配置 SharePoint 网页触发器，以监听文件、文件夹和列表中的事件。 SharePoint 网页触发器支持以下事件。

事件 描述
文件已创建 在受监控的 SharePoint 站点中创建文件时。
文件已更新 在受监控的 SharePoint 站点中更新文件时。
文件夹已创建 在受监控的 SharePoint 站点中创建文件夹时。
文件夹已更新 在受监控的 SharePoint 站点中创建文件夹时。
列表项目已创建 在受监控的 SharePoint 站点中向列表添加项目时。
列表项目已更新 在受监控的 SharePoint 站点中更新现有列表项时。

先决条件

确保满足以下先决条件：

  • Bot Creator 或平民开发者许可证。
  • 事件触发器和查看我的机器人权限。
  • 自动化所在文件夹的签入和签出权限。
  • SharePoint 站点的活动 OAuth 连接。

设置

以下设置适用于 SharePoint 网页触发器。
SharePoint OAuth
SharePoint OAuth 选项允许您选择已配置的 OAuth 连接。 确保将 Microsoft Graph 权限添加到 OAuth 连接范围。 Microsoft Graph 范围允许触发器读取 SharePoint 文档库中的文件和文件夹相关事件，并读取 SharePoint 列表中的列表相关事件。
站点
站点选项允许您配置用于事件监控的 SharePoint 站点。 您可以直接输入链接，或使用选择站点选项，从站点下拉列表中选择所需站点。 站点下拉列表将连接到 SharePoint 站点，并列出该子域中的所有站点。
事件类型
事件类型选项允许您配置在何种事件下触发器将激活后续的自动化操作。 您可以根据文件和文件夹或列表配置触发器。
在文件和文件夹选项中，从监听事件下拉列表中选择事件，并为文件事件输入文件路径，为文件夹事件输入文件夹路径。 确保输入用于文件夹事件的父文件夹。 例如，要监控名称为 XYZ 的文件夹中的文件夹事件，该文件夹位于 SharePoint 文档文件夹的另一个文件夹 ABC 中，请输入 Documents/ABC。
响应
响应选项可用于将触发器响应数据捕获到一个记录变量中。 您可以选择创建一个记录变量，或选择一个已有的记录变量来捕获响应数据。 记录变量以键值对格式捕获 API 响应正文信息。

在审核日志中读取触发器响应数据

触发器响应数据包含所有已发生变更的事件的相关信息。 系统使用 Microsoft Graph 中 SharePoint API 的资源属性来生成触发器响应数据。 您可以在 审核日志 页面上的由触发器运行的机器人事件中查看以键值对形式存储的数据。 有关 SharePoint 响应数据的详细信息，请参阅 Working with SharePoint sites in Microsoft Graph。

您可以使用在 审核日志 中捕获的事件有效负载数据属性，作为会话中任何后续操作的输入。 您还可以根据 Microsoft Graph 中 SharePoint API 的资源类型属性构建这些属性的参数。 例如，要查看创建文件的文件夹路径，可以使用 parentReference.path，其中 parentReference 来自 BaseItem 资源属性，path 来自 itemReference 资源属性。