遍历每个文件/文件夹

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) 查询。
  备注：

  该活动使用“文档链接”属性限制，以及根据“文件存储库”中指定的位置和“文件夹”参数中的值构建的 URL。不要在高级搜索参数中使用“文档链接:”或“路径:”属性限制。

• 简单搜索 - 在多个字段 (例如文件名和文件内容) 中输入用于搜索文件和文件夹的查询文本。此属性支持 String 变量和字符串格式的值。
• “使用简单搜索” - 处于活动状态时，将使用简单搜索，而不是高级搜索。如果此选项处于活动状态，则忽略“包括子文件夹”参数。该字段仅支持“布尔值”。
  备注：

  如果选中“使用简单搜索” ，则“文件存储库”属性仅支持“OneDrive” 、 “SharePoint”和“特定 URL”选项。如果选中“使用简单搜索”选项，则该活动现在可以与个人 Microsoft 帐户以及“应用程序 ID和密码”和“应用程序 ID 和证书”身份验证类型（在Microsoft Office 365 作用域活动中使用时）一起使用。

其他

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

选项

• 帐户 - 拥有 OneDrive 的用户的 ID 或用户主体名称。必须为应用程序 ID 和密码和应用程序 ID 和证书身份验证类型设置此参数。此属性支持 String 变量和字符串格式的值。
• 文件夹 - 指定文件存储库中要搜索的文件夹的路径 (例如，部分文件夹或部分文件夹/其他文件夹)。如果留空，则系统将搜索根文件夹。当文件存储库设置为全部时，不予考虑。此属性支持 String 变量和字符串格式的值。
• 包括子文件夹- 指定是否展开搜索，以包括所选云位置的所有子文件夹。该字段仅支持“布尔值”。
• Limit To First - The maximum number of files and folders to return. If left blank, it retrieves all files and folders matching the filter criteria. This field supports only integer and Int32 variables. The default value is 200.
• Trim Duplicates - Specifies whether duplicate file/folder items should be removed from the search results. This field only supports Boolean values (True, False). The default value is False.
• 返回内容- 选择是仅返回文件、仅返回文件夹还是同时返回两者：
  • 文件和文件夹
  • 文件
  • 文件夹

输出

• Index - A zero-based index that specifies which element of the current collection is being iterated. This field supports only integer and Int32 variables.

存储库

• Files Repository - The files repository where to search for files and folder. Select one of four options: All, OneDrive, SharePoint, SpecificUrl. The default value is All.

• “SharePoint 文档库” - 指定 SharePoint 站点中的文档库。此属性支持String变量和字符串格式的值。

• “SharePoint 站点 URL” - 要在其中搜索的 SharePoint 站点的 URL。此属性支持String变量和字符串格式的值。

• 特定 URL - 要搜索的特定位置的 URL。此属性支持String变量和字符串格式的值。

  备注：

  Sometimes Microsoft Search API returns duplicate file or folder items. By selecting the option Trim Duplicates, the activity removes duplicates from the search results.

筛选示例

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

查询	筛选器表达式
指定位置中的所有 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 日，文件名中包含"users"一词的所有 Excel 文件	"fileextension:xlsx AND filename:users AND lastmodifiedtime=06/14/2021"
在 2021 年 6 月 14 日之前修改，文件名中包含"users"一词的所有 Excel 文件	"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"""