SharePoint 内容事件触发器使您能够根据在 SharePoint 站点中发生的事件自动处理任务。 触发器监听在 SharePoint 站点中发生的特定事件，并在事件发生时启动下游操作。
概览
SharePoint 内容事件触发器使您能够根据已订阅的事件启动自动化工作流。 配置 SharePoint 内容事件触发器，以监听已订阅的事件。 在 SharePoint 站点发生事件时，触发器将激活后续的自动化工作流。 SharePoint 内容事件触发器使您能够创建自动化，无需任何手动干预即可实现实时数据交换。
SharePoint 内容事件触发器使用 OAuth 连接对传入数据进行身份验证。 有关 SharePoint 的 OAuth 连接的更多信息，请参阅 创建 OAuth 连接。 使用 Client Credentials Flow 授权类型来设置 OAuth 连接。
先决条件
确保满足以下先决条件：
- Bot Creator 或平民开发者许可证。
- 事件触发器和查看我的机器人权限。
- 自动化所在文件夹的签入和签出权限。
- SharePoint 站点的活动 OAuth 连接。
支持的事件
您可以配置 SharePoint 内容事件触发器，以监听文件、文件夹和列表中的事件。 SharePoint 内容事件触发器支持以下事件。
| 事件 | 描述 |
|---|---|
| 文件已创建 | 在受监控的 SharePoint 站点中创建文件时。 |
| 文件已更新 | 在受监控的 SharePoint 站点中更新文件时。 |
| 文件夹已创建 | 在受监控的 SharePoint 站点中创建文件夹时。 |
| 文件夹已更新 | 在受监控的 SharePoint 站点中更新文件夹时。 |
| 列表项目已创建 | 在受监控的 SharePoint 站点中向列表添加项目时。 |
| 列表项目已更新 | 在受监控的 SharePoint 站点中更新现有列表项时。 |
设置
以下设置适用于 SharePoint 内容事件触发器：
- SharePoint OAuth
- 指定用于连接到 SharePoint 站点并验证会话的 OAuth 连接。 确保将 Microsoft Graph 权限添加到 OAuth 连接范围。 Microsoft Graph 范围允许触发器读取 SharePoint 文档库中的文件和文件夹相关事件，并读取 SharePoint 列表中的列表相关事件。
- 站点
- 指定要监控事件的 SharePoint 站点。 您可以直接输入链接，或使用选择站点选项，从站点下拉列表中选择所需站点。 站点下拉列表将连接到 SharePoint 站点，并列出该子域中的所有站点。注： 在手动指定站点时，请使用 https://{subdomain}.sharepoint.com/sites/{SiteName} 格式。
- 事件类型
- 指定触发器激活下游自动化操作所依据的事件类型。 您可以选择文件和文件夹或列表事件。
- 文件和文件夹
- 指定要订阅的基于文件或文件夹的事件类型。 您可以选择一个或多个事件进行订阅，当这些已订阅的事件发生时，触发器会激活下游操作。 在监听事件中选择要订阅的事件，并在文件夹路径字段中指定文件或文件夹的文件路径，以配置文件和文件夹类型触发器。
- 监听事件
- 指定要订阅的事件。 可从以下选项中选择一个或多个事件：
- 文件已创建
- 文件已更新
- 文件夹已创建
- 文件夹已更新
- 文件夹路径
- 指定事件发生的文件或文件夹的文件夹路径。 以 Documents/Folder1 格式输入文件夹路径。 还可以使用选择文件夹按钮，从已连接的 SharePoint 站点中导航并选择该文件夹。
- 列表
- 指定要订阅的基于列表的事件。 您可以选择一个或多个事件进行订阅，当这些已订阅的事件发生时，触发器会激活下游操作。
- 监听事件
- 指定要订阅的基于列表的事件。 可从以下选项中选择一个或多个事件：
- 列表项目已创建
- 列表项目已更新
- 列表
- 指定事件发生的列表名称。 您可以手动输入列表名称，或使用选择列表按钮浏览并从已连接的 SharePoint 站点中选择相应的列表。
- 响应
- 指定用于存储响应数据的变量。 触发器将响应数据以键值对格式保存，您可以在会话中的下游操作中使用此数据。 您可以使用以下任一选项：
-
多个变量： 创建并指定单独的变量以存储特定的响应数据。
使用添加变量映射选项来指定键和值对应的变量类型，以存储特定的响应数据。
- 记录： 创建并指定一个记录变量以存储完整的响应数据。
-
多个变量： 创建并指定单独的变量以存储特定的响应数据。
在审核日志中读取触发器响应数据
触发器响应数据包含所有已发生变更的事件的相关信息。 系统使用 Microsoft Graph 中 SharePoint API 的资源属性来生成触发器响应数据。 您可以在 审核日志 页面上的由触发器运行的机器人事件中查看以键值对形式存储的数据。 有关 SharePoint 响应数据的详细信息，请参阅 Working with SharePoint sites in Microsoft Graph。
您可以使用在 审核日志 中捕获的事件有效负载数据属性，作为会话中任何后续操作的输入。 您还可以根据 Microsoft Graph 中 SharePoint API 的资源类型属性构建这些属性的参数。 例如，要查看创建文件的文件夹路径，可以使用 parentReference.path，其中 parentReference 来自 BaseItem 资源属性，path 来自 itemReference 资源属性。