Power Automate 中的Microsoft SharePoint 连接器
在 Power Automate 中，Microsoft SharePoint 连接器支持以触发器和操作。
SharePoint 触发器
SharePoint 触发器允许您创建流来监视 SharePoint 列表或库中的更改。 如果订阅的列表中发生了一个或多个更改，则会触发该流以运行。
创建项时
在 SharePoint 列表中创建项时触发流。
创建或修改项目时
在创建项目时触发流，并在每次在 SharePoint 列表中修改它时触发流。
修改项或文件时
在 SharePoint 列表或文档库中修改项目或文件时触发流。
有关如何使用此触发器的详细信息，请参阅此教程视频： “修改项目或文件时”触发器和“获取更改”操作简介
删除项目时
删除列表中的项时触发流。 若要获取已删除项的属性，必须使用网站集管理员帐户将此触发器连接到预期运行该项目的关联 SharePoint 网站。
对于所选项
允许列表用户在选择列表中的项后触发流。
注意
只能从 SharePoint 列表手动执行默认环境中的流。
通过内容理解模型对文件进行分类时
当Microsoft Syntex内容理解模型对文件进行分类（如文件的分类日期属性中所示）时触发流。
有关何时Microsoft Syntex以及如何对文件进行分类的详细信息，请参阅：Microsoft Microsoft Syntex简介
创建文件时， (属性仅)
在文档库中创建文件时触发流，并仅返回与该文件关联的自定义文件属性。
在文件夹中创建文件时 [已弃用]
注意
此触发器已弃用，可能无法按预期工作。
在 SharePoint 文件夹中创建文件时触发流。 如果在运行此触发器的文件夹内的子文件夹中添加或更新文件，则不会运行此触发器。 如果需要在子文件夹中触发流，请为一个或多个子文件夹创建不同的流 () 。
创建或修改文件时，仅 (属性)
创建文件时以及每次修改库中的文件属性时，都会触发流。 在“Folder”属性中指定一个值，以针对特定文件夹;否则，触发器将应用于整个库。 仅返回与该文件关联的自定义文件属性。
在文件夹中创建或修改文件时 [已弃用]
注意
此触发器已弃用，可能无法按预期工作。
在创建文件时触发，并在每次在 SharePoint 文件夹中修改该文件时触发。 如果在子文件夹中添加/更新文件，则不会触发触发器。 如果需要在子文件夹中触发，则应创建多个触发器。
删除文件时
在文档库中删除文件时触发流。 可以选择指定要watch的文件夹。 删除文件夹时，触发器仅为已删除的文件夹（包括其子文件夹）激活一次。 若要获取已删除文件的属性，必须使用网站集管理员帐户将此触发器连接到预期运行触发器的关联 SharePoint 网站。
对于所选文件
允许文档库用户在选择文件后触发流。
注意
只能从 SharePoint 库手动执行默认环境中的流。
当站点请求加入中心站点时
在中心站点加入审批请求时触发流。
SharePoint 操作
添加附件
向指定的列表项添加新附件。
批准中心站点加入请求
批准中心站点加入请求。 此操作使用联接中心站点操作返回批准令牌以完成加入请求。
取消中心站点加入请求
取消中心加入请求。 如果适用，请指定“ 将中心站点加入状态设置为挂起 ”操作中使用的相同审批关联 ID。
签入文件
签入文档库中的签出文件，使文档版本可供其他人使用。
签出文件
签出文档库中的文件，以防止其他人编辑文档，以及你的更改在你检查文档之前可见。
复制文件
复制文件。 与 SharePoint 库中的 “复制到” 命令类似。 复制后，返回有关新文件的信息。
复制文件 [已弃用]
注意
此操作已弃用，可能无法按预期工作。
将文件复制到 SharePoint 网站。
复制文件夹
复制文件夹。 与 SharePoint 库中的 “复制到” 命令类似。 复制后，返回有关新文件夹的信息。
创建文件
将文件上传到 SharePoint 网站。 请确保选取现有库。
创建项目
在 SharePoint 列表中创建新项。
创建新文件夹
创建新的文件夹或文件夹路径。
为文件或文件夹创建共享链接
为文件或文件夹创建共享链接。
删除附件
删除指定的附件。
删除文件
删除由文件标识符指定的文件。
删除项目
从 SharePoint 列表中删除项。
放弃签出
如果你检查出文件而不对其进行更改，或者你进行了不想保留的更改，则放弃签出，而不是保存文件。 如果组织跟踪版本，则每次在文件中检查库时，都会创建一个新版本。 通过放弃签出，可以避免在未对文件进行任何更改时创建新版本。
提取文件夹
将存档文件提取到 SharePoint 文件夹中， (例如 .zip) 。
获取所有列表和库
获取所有列表和库。
获取附件内容
使用文件标识符返回文件内容。 内容可以复制到其他位置，或用作附件。
获取附件
返回指定列表项的附件列表。 若要访问文件的内容，请添加 “获取附件内容” 步骤，并使用此操作返回 的文件标识符 属性。
获取仅) 属性 (项或文件的更改
获取自 和 到指定时间间隔之前更改的所有列或文件属性。 若要获取修改项或文件时更改的所有列，请执行以下操作：
- 在 修改项或文件时 使用 触发器， 和
- 使用 触发器窗口开始令牌 & 触发窗口结束令牌 输出，从 修改项或文件时 触发器推断自上次检查项或文件更新流以来更改的列。
有关如何使用此操作的详细信息，请参阅此教程视频： “修改项目或文件时”触发器和“获取更改”操作简介
注意
- 列表或库应配置版本控制，以便推断自上次更改以来修改了哪些列或属性。
- 列表和库仅支持列更改。
- 不支持更改文件内容。
- 不支持附件更改。
- 触发器窗口开始令牌 & 触发器窗口结束令牌 仅在 修改项或文件触发器时 使用时可用。
获取文件内容
使用文件标识符获取文件内容。 可以将内容复制到其他位置，或将其用作附件。
使用路径获取文件内容
使用文件路径获取文件内容。
获取文件元数据
获取有关文件的信息，例如大小、etag、创建日期等。 使用文件标识符选择文件。 若要访问库中列中存储的值，请使用 “获取文件属性” 操作。
使用路径获取文件元数据
获取有关文件的信息，例如大小、etag、创建日期等。 使用文件路径选择文件。 若要访问库中列中存储的值，请使用 “获取文件属性” 操作。
获取文件属性
获取在库中由项 ID 指定的项的列中保存的属性。若要访问文件的内容，请添加“获取文件内容”步骤，并使用此操作返回的“文件标识符”属性。 将此与本地数据网关一起使用时，可能需要手动输入要连接到的库的名称。
仅) 获取 (属性的文件
获取库中存储的所有文件夹和文件在库中的列中保存的属性。 还可以向下筛选到与条件匹配的项。 若要处理此操作的输出，请使用 “应用于每个 ”部分。 将此与本地数据网关一起使用时，可能需要手动输入要连接到的库的名称。 有关此操作的详细信息，请参阅： 对 Power Automate 中流的 获取项 和 获取文件的 SharePoint 操作进行深入分析。
获取文件夹元数据
获取有关文件夹的信息。 使用文件标识符选择文件夹。
使用路径获取文件夹元数据
获取有关文件夹的信息。 使用文件夹路径选择文件夹。
获取项目
从 SharePoint 列表中按其 ID 获取单个项。
获取项目
从 SharePoint 列表中获取项。 有关此操作的详细信息，请参阅： 对 Power Automate 中流的 获取项 和 获取文件的 SharePoint 操作进行深入分析。
获取列表视图
从 SharePoint 列表中获取视图。
获取列表
从网站获取 SharePoint 列表。
授予对项目或文件夹的访问权限
向特定人员授予对 SharePoint 中的项目或文件夹的访问权限。
加入中心网站
将请求的站点加入中心站点。 如果中心需要批准，则需要审批令牌才能成功完成加入。 如果适用，请指定“ 将中心站点加入状态设置为挂起 ”操作中使用的相同审批关联 ID。
列出文件夹
返回 SharePoint 文件夹中包含的文件。
列出根文件夹
返回根 SharePoint 文件夹中的文件。
移动文件
移动文件。 与 SharePoint 库中的 “移动到” 命令类似。 在移动新文件后返回有关该文件的信息。
移动文件夹
移动文件夹。 与 SharePoint 库中的 “移动到” 命令类似。 在移动新文件夹后返回有关该文件夹的信息。
解析人员
返回单个匹配的用户值，以便可以将其分配给 person 类型的列。 如果没有匹配项或多个匹配项，则此操作会出错。
向 SharePoint 发送 HTTP 请求
构造要调用的 SharePoint REST API。 有关此操作的详细信息，请参阅： 在 Power Automate 中使用 SharePoint 发送 HTTP 请求流操作。
重要
此操作可能会执行您有权访问的任何 SharePoint REST API。 请谨慎继续操作。
设置内容审批状态
为已打开内容审批的列表或库中的项设置内容审批状态。 必须为页面和文件提供 ETag。 可以使用“获取文件元数据”操作获取 ETag。 此操作仅适用于 SharePoint Online 和 SharePoint 2019。
将中心站点加入状态设置为挂起
将请求站点的中心加入请求状态设置为挂起。 审批关联 ID 是一个可选参数，可帮助 SharePoint 标识特定的中心加入请求。 请求站点在给定时间只能有一个挂起的请求。
停止共享项目或文件
删除授予项目或文件访问权限的所有链接，并删除除所有者以外的所有具有直接访问权限的人员。
更新文件
汇报文件标识符指定的文件的内容。
更新文件属性
汇报由项 ID 指定的项的库中的列中存储的属性。 若要更新文件内容，请使用 “更新文件” 操作。 将此与本地数据网关一起使用时，可能需要手动输入要连接到的库的名称。
更新项目
汇报 SharePoint 列表中的项。
对 SharePoint Server 的支持
下表列出了 SharePoint 本地 2013、2016 或 2019 支持的所有操作和触发器。 不支持未提及的任何操作或触发器。
支持的触发器
| Trigger | SharePoint 2013 | SharePoint 2016 | SharePoint 2019 |
|---|---|---|---|
| 在文件夹中创建文件时 | 是 | 是 | 是 |
| 在文件夹中创建或修改文件时 | 是 | 是 | 是 |
| 创建项时 | 是1 | 是1 | 是1 |
| 创建或修改项目时 | 是1 | 是1 | 是1 |
| 创建文件时， (属性仅) | 否 | 否 | 是1 |
| 创建或修改文件时，仅 (属性) | 否 | 否 | 是1 |
| 删除项目时 | 否 | 否 | 是2 |
| 删除文件时 | 否 | 否 | 是2 |
| 解析人员 | 否 | 否 | 是 |
| 设置内容审批状态 | 否 | 否 | 是 |
注意
- 不支持“按视图限制列”。
- 虽然 SharePoint 2019 支持此触发器，但使用此触发器创建的流可能会遇到以下问题：
- 如果列表中超过 60 天没有活动，或者存在某些活动，但 60 天内没有删除任何项目，则触发器将无法激活。
- 系统用户删除列表项将激活触发器。
支持的操作
| 操作 | SharePoint 2013 | SharePoint 2016 | SharePoint 2019 |
|---|---|---|---|
| 获取文件元数据 | 是 | 是 | 是 |
| 使用路径获取文件元数据 | 是 | 是 | 是 |
| 获取文件夹元数据 | 是 | 是 | 是 |
| 使用路径获取文件夹元数据 | 是 | 是 | 是 |
| 获取文件内容 | 是 | 是 | 是 |
| 创建文件 | 是1 | 是1 | 是1 |
| 更新文件 | 是 | 是 | 是 |
| 复制文件 [已弃用]2 | 是 | 是 | 是 |
| 列出文件夹 | 是 | 是 | 是 |
| 提取文件夹 | 是 | 是 | 是 |
| 获取附件 | 是 | 是 | 是 |
| 添加附件 | 是 | 是 | 是 |
| 删除附件 | 是 | 是 | 是 |
| 获取项目 | 是3 | 是3 | 是3 |
| 获取项目 | 是4 | 是4 | 是4 |
| 创建项目 | 是4 | 是4 | 是4 |
| 更新项目 | 是4 | 是4 | 是4 |
| 删除项目 | 是 | 是 | 是 |
| 向 SharePoint 发送 HTTP 请求 | 是 | 是 | 是 |
注意
- 不支持通过将大文件作为一组区块上传来创建它。
- 此操作在其显示名称中包含“[已弃用]”。 “复制文件”操作不同于此操作。
- 此操作仅支持 OData 参数，它不包括“将条目限制到文件夹”、“包含嵌套项”和“按视图限制列”等参数。
- 不支持“按视图限制列”。
已弃用的触发器和操作
这些触发器已弃用，不再主动维护。 虽然它们仍存在于 Microsoft SharePoint 连接器中，但我们建议不要在任何新应用程序或解决方案中使用已弃用的触发器或操作。
| 名称 | 类型 | 支持的版本 | 建议的替代项 |
|---|---|---|---|
| 在文件夹中创建文件时 [已弃用] | Trigger | SharePoint 2019 | 创建文件时， (属性仅) |
| 在文件夹中创建或修改文件时 [已弃用] | Trigger | SharePoint 2019 | 创建或修改文件时，仅 (属性) |
| 复制文件 [已弃用] | 操作 | SharePoint 2019 | 复制文件 |
已知限制
支持的列表和库模板
列表的 Power Automate 流仅在泛型列表 (100) 和泛型文档库 (101) 中受支持。 我们目前不支持自定义列表和库模板，包括但不限于公告、联系人和任务等列表。
流运行
生成要为项触发的 Power Automate 流或创建或修改文件时，Power Automate 会定期检查在流触发器中配置的列表或库中的更改。 在大多数情况下，如果列表或库中有一个更改，流运行可能会在该更改后的几分钟内发生。 但是，由于流间隔自上次有效更改以来的间隔时间或对项或文件的后续编辑，因此流可能会在后续流运行中收集多个更改。
移动文件和流运行
将一个或多个文件从一个文档库移到另一个文档库时，原始文件将从源库移动到目标库。 移动文件不会更改任何自定义元数据，包括创建和修改文件时。 因此，此操作不会为与移动库关联的文件更新触发任何流。
将文件同步到 OneDrive for Business 和 SharePoint 文档库
当用户将一个或多个文件从一个文档库同步到另一个文档库时，原始文件 (将) 从客户端同步到目标库。 同步文件不会更改任何自定义元数据，包括文件创建和修改时间。 因此，此操作不会在该库中或 OneDrive for Business 中触发这些文件同步的任何流。
支持的查阅列
如果列表/库具有查阅列， 则“获取项目 ”和 “获取文件” 操作支持返回最多 12 个查阅列的项目。 如果列表或库超过此阈值，Power Automate 中的流将失败。