遍历每个文件/文件夹

UiPath.MicrosoftOffice365.Activities.Files.ForEachFileFolder

描述

使用 Microsoft Graph Microsoft 搜索API（用于高级搜索）或 Microsoft Graph搜索项目API（用于简单搜索），对与筛选条件匹配的每个文件/文件夹执行一个或一系列活动。

有关 Microsoft 搜索 API 实施的更多详细信息，请查看以下资源：

• Microsoft 搜索 API 概述
• 用于在 OneDrive 和 SharePoint 中搜索内容的 Microsoft 搜索 API
• 可搜索的网站属性

注意： 此活动不支持暂留。

项目兼容性

Windows - Legacy | Windows

配置

在活动正文中

• 遍历循环 - 输入引用当前迭代的名称。在配置“遍历 Excel 工作表”中添加的活动时，使用描述文件中工作表的名称可以更轻松地识别和选择迭代中的当前工作表。例如，对于包含报告的文件夹，您可以输入 Report。默认值为 DriveItem。

属性面板

常见

• “显示名称”- 设计器面板中活动的名称。此属性支持 String 变量和字符串格式的值。

输入

• 高级搜索 - 要检索的文件和文件夹的关键字查询语言 (KQL) 查询。

  备注：

  该活动将 documentLink 属性限制与从“ 文件存储库 ”中指定的位置和“ 文件夹 ”参数中的值构建的 URL 一起使用。 不要在“ 高级搜索 ”参数中使用“documentLink:”或“path:”属性限制。

• 简单搜索 - 在多个字段 (例如文件名和文件内容) 中输入用于搜索文件和文件夹的查询文本。此属性支持 String 变量和字符串格式的值。

• “使用简单搜索” - 处于活动状态时，将使用简单搜索而不是高级搜索。 如果此选项处于活动状态，则忽略“ 包括子文件夹 ”参数。 此字段支持布尔值。

  备注：

  如果选择了“ 使用简单搜索 ”，则“ 文件存储库” 属性仅支持“ OneDrive”、“ SharePoint”和“ 特定 URL ”选项。

  如果选中使用简单搜索选项，则该活动现在可以与个人 Microsoft 帐户以及应用程序 ID 和密码和应用程序 ID 和证书身份验证类型一起使用（在 Microsoft Office 365 作用域活动中使用时）。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。该字段仅支持“布尔值”。

选项

• 帐户 - 拥有 OneDrive 的用户的 ID 或用户主体名称。必须为应用程序 ID 和密码和应用程序 ID 和证书身份验证类型设置此参数。此属性支持 String 变量和字符串格式的值。
• 文件夹 - 指定文件存储库中要搜索的文件夹的路径 (例如，部分文件夹或部分文件夹/其他文件夹)。如果留空，则系统将搜索根文件夹。当文件存储库设置为全部时，不予考虑。此属性支持 String 变量和字符串格式的值。
• “包含子文件夹 ” - 指定是否扩展搜索以包含所选云位置的所有子文件夹。 此字段支持布尔值。
• 限制为第一项 - 要返回的文件和文件夹的最大数量。如果留空，则系统将检索与筛选条件相符的所有文件和文件夹。此字段仅支持整数和 Int32 变量。默认值为 200。
• 去除重复项 - 指定是否应从搜索结果中删除重复的文件/文件夹项目。该字段仅支持 Boolean 值(True 和 False)。默认值为 FALSE。

• “返回 内容” - 选择是仅返回文件、仅返回文件夹还是同时返回两者：

  • 文件和文件夹
  • 文件
  • 文件夹

输出

• “索引” - 从零开始的索引，用于指定要迭代当前集合的哪个元素。 此字段仅支持整数和 Int32 变量。

存储库

• “文件存储库 ” - 用于搜索文件和文件夹的文件存储库。 选择以下四个选项之一： “全部”、“ OneDrive”、“ SharePoint”、“ 特定网址”。 默认值为 “全部”。
• “SharePoint 文档库 ” - 指定 SharePoint 网站中的文档库。 此属性支持 String 变量和字符串格式的值。
• “SharePoint 网站 URL ” - 要在其中搜索的 SharePoint 网站的 URL。 此属性支持 String 变量和字符串格式的值。
• “特定 URL ” - 要在其中搜索的特定位置的 URL。 此属性支持 String 变量和字符串格式的值。
  注意： 有时 Microsoft Search API 会返回重复的文件或文件夹项目。 通过选择“ 修剪重复项” 选项，该活动会从搜索结果中删除重复项。

筛选示例

下表显示了查询文件或文件夹时非常有用的筛选器示例：

查询	筛选器表达式
指定位置中的所有 Excel 文件	"fileextension:xlsx"
指定位置中的所有文本和可移植文档格式文件	"fileextension:txt OR fileextension:pdf"
名称为“Agenda Brief.xlsx”的所有文件	"filename:""Agenda Brief.xlsx"""
文件名中包含“users”一词的所有 Excel 文件	"fileextension:xlsx AND filename:users"
于 2021 年 6 月 14 日修改的所有 Excel 文件，文件名中包含“users”一词	"fileextension:xlsx AND filename:users AND lastmodifiedtime=06/14/2021"
在 2021 年 6 月 14 日之前修改的所有 Excel 文件，文件名中包含“users”一词	"fileextension:xlsx AND filename:users AND lastmodifiedtime<06/14/2021"
“John Smith”在 2021 年 6 月 12 日之前创建的所有文件和文件夹	"createdby:""John Smith"" AND created<06/12/2021"
已与“Cory Belcher”显式共享的所有文件	"sharedwithusersowsuser:""Cory Belcher"""