活动

遍历每个文件/文件夹

UiPath.MicrosoftOffice365.Activities.Files.ForEachFileFolderConnections

描述

通过 OneDrive 或 SharePoint 遍历文件和文件夹的列表。

在“遍历 文件/文件夹 ”中添加要重复的活动，并在配置活动时从“查看更多按钮”菜单中选择“ 使用变量 ” > “当前项目”，以指明要对迭代中的每个项目重复操作。

注意：此活动使用分页来处理大量项目并缓解性能问题。此活动不支持暂留。

重要提示：Microsoft Graph API 不区分文件夹和 OneNote 文件，因此将返回两者。

作用域

此活动需要以下作用域：

文件。读取
Files.ReadWrite
文件读取全部
Files.ReadWrite.All
站点。只读。全部
Sites.ReadWrite.All

项目兼容性

Windows | 跨平台

配置

Microsoft OneDrive 和 SharePoint 连接 - 要在活动中使用的 Microsoft 365 帐户的连接。
位置- 用于搜索文件和文件夹的位置。用于指定要检索的文件或文件夹的方法： “输入 ID ”、 “输入 URL”或“使用变量”。
- “文件夹选取器”- 浏览 OneDrive 或 SharePoint 文件夹，然后选择一个文件或文件夹。该字段接受IResource输入。
- “输入 ID” 选项：
  - “文件或文件夹 ID”- 文件或文件夹的 ID。要检索 ID，请在 OneDrive 网页版中打开文件并检索其 URL。ID 在 URL 中编码。例如：如果 URL 为 https://yourcompany.sharepoint.com/Doc.aspx?sourcedoc=%7BA1CA7E78-BA59-4DD4-A6B9-5F5BBC37FA85%7D&file=Merge_sheets.xlsx，则解码后的文件 ID 为 A1CA7E78-BA59-4DD4-A6B9-5F5BBC37FA85。%7B 和 %7D 是文件 ID 的分隔符。此属性支持 String 变量和字符串格式的值。
  - SharePoint 站点地址 - 包含文件或文件夹的 SharePoint 站点的 URL。在浏览器中打开您的 SharePoint 站点并检索 URL，例如 https://yourCompany.sharepoint.com/sites/Marketing。此属性支持 String 变量和字符串格式的值。
  - SharePoint 文档库 - 指定 SharePoint 站点中包含文件或文件夹的文档库。在浏览器中打开您的 SharePoint 站点，转到“文档”选项卡，然后检索 URL，例如 https://yourCompany.sharepoint.com/sites/Marketing/Shared%20Documents/Forms/AllItems.aspx。此属性支持 String 变量和字符串格式的值。
- 输入 URL 选项：
  - “文件或文件夹 URL”- 文件或文件夹的 URL。在浏览器中打开文件或文件夹并检索其完整 URL。此属性支持 String 变量和字符串格式的值。
- 使用“查看更多”按钮菜单以使用变量，或者如果您已修改文件夹并需要检索最新数据，请选择“重新加载文件夹选取器” 选项。

其他选项

选项

限制为第一项 - 要返回的文件和文件夹的最大数量。如果留空，则表示“无限制”。此字段支持 Int32 变量和 Int32 值。
“返回 内容” - 要返回的结果类型：文件和文件夹、仅文件、仅文件夹。
修剪重复项 - 布尔值。设置为 True 可从搜索结果中删除重复的文件和文件夹。
简单搜索- 在多个字段 (例如文件名或文件内容) 中用于搜索文件和文件夹的查询文本。此属性支持String变量和字符串格式的值。使用 “查看更多”按钮菜单以切换到“高级搜索”。
备注： 简单搜索 适用于企业帐户和个人帐户。 高级搜索 仅适用于企业帐户，并且包含“ 包括子文件夹 ”选项。
高级搜索 - 定义用于筛选文件和文件夹的高级搜索条件。个人 Microsoft 帐户不支持此选项。高级搜索使用文件夹构建器来配置搜索条件。
- 包括子文件夹 - 布尔值。设置为 True 可将搜索范围扩大到选定位置中的所有子文件夹。

输出

已处理的文件或文件夹总数 - 活动处理的项目总数。可在“遍历文件/文件夹”活动之外使用。自动生成的输出变量。您可以按原样使用，也可以使用其他名称保存。

正文

存储自动化中使用的其他活动的活动主体。

筛选限制

“筛选器”构建器中的按 文件扩展名 筛选可能不适用于 .avi、 .svg、 .gif、 .ico、 .jpeg、 .jpg、 .mov、 .mp3、 .mp4、 .ogg、 .png、 .rtf、 .tiff、 .wav、 .webm、 .webp、或 .wmv。
按 “上次修改人” 或“ 与用户共享 ” 筛选可能会返回不完整的结果。
图形 API 会从搜索值的开头修剪特殊字符。例如，如果您搜索“_Sorted”，则 API 将返回名称中包含“Sorted”一词的所有文件/文件夹，并省略“_”字符。
在使用高级搜索而不配置任何筛选器的情况下遍历 OneDrive 根文件夹中的文件时，即使“包括子文件夹” 为False ，该活动也可能返回所有 OneDrive 文件，而不仅仅是 OneDrive 根文件夹的文件。
由于 Microsoft 的限制，简单搜索无法识别图像文件。请改用高级搜索，并按以下条件筛选：File or folder name contains .jpg。