查找文件和文件夹

UiPath.MicrosoftOffice365.Activities.Files.FindFilesAndFolders

描述

使用 Microsoft Graph搜索项目和共享文件API 查找与搜索参数 (查询) 的值匹配的文件、元数据和/或内容。 默认情况下，此活动会搜索已连接的 OneDrive。 您可以选择将搜索位置更改为 SharePoint 站点（ DriveName和SiteURL ）。

执行搜索后，该活动将返回匹配的DriveItem对象（第一个和结果），您可以在后续活动中将其用作输入变量；几乎所有“ Excel和文件”活动都需要此文件作为输入变量。

此活动不得超过 200 个结果。 如果您要处理更多文件， 请使用“遍历文件/文件夹 ”活动。

备注： 查找文件和文件夹 不支持 Sites.Selected 应用程序权限。

项目兼容性

Windows - Legacy | Windows

配置

属性

常见

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

输入

• 查询- 定义要检索的文件或文件夹的自由文本搜索短语。 如果留空，则返回根文件夹的内容。 有关支持的查询参数的完整列表，请参阅 Microsoft API 文档中的驱动器项目属性。 此属性支持String变量和字符串格式的值。
• “子文件夹”- (可选) 要执行搜索操作的子文件夹 (例如，某文件夹或一级文件夹/二级文件夹/三级文件夹) 路径。如果留空，则搜索根文件夹。此属性支持 String 变量和字符串格式的值。

选项

• 帐户 - 拥有 OneDrive 的用户的 ID 或用户主体名称。必须为应用程序 ID 和密码和应用程序 ID 和证书身份验证类型设置此参数。

其他

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

输出

• “第一个 ” - 与指定查询匹配的第一个文件或文件夹。 此字段仅支持 DriveItem 变量。 如果您计划在后续活动中使用输出数据，则为必需。 DriveItem 包含有关文件的信息，包括文件的名称、大小、类型等，您可以在后续活动中使用这些信息。
• “结果 ” - 与查询匹配的所有文件和文件夹以“驱动器项目”数组形式返回。 驱动器项目包含文件名、类型、大小、ID 等信息，可在后续活动中使用。 在其他活动中使用“ 结果 ” DriveItem 变量时，请在数组中指定要使用的项目（例如， myFiles(0)）。

Sharepoint

• “驱动器名称”- 在 OneDrive 或 SharePoint 中搜索指定文件或文件夹的驱动器的名称。如果 SharePoint 中存在此驱动器，则必须指定“网站 URL”。如果留空，则在“网站 URL”字段中指定的 SharePoint 网站的默认驱动器（通常为“文档”）中执行搜索。此属性支持 String 变量和字符串格式的值。
• “网站 URL”- 用于搜索指定文件或文件夹的 SharePoint 网站 URL。仅在 SharePoint 中搜索时才需要。例如，如果要在 SharePoint 网站的文档中搜索，则网站 URL 可以是“https://uipath.sharepoint.com/sites/Quickstart”您的“驱动器名称”为“文档”。此属性支持 String 变量和字符串格式的值。

工作方式

以下步骤和消息序列图是活动从设计时（即活动依赖项和输入/输出属性）到运行时如何工作的示例。

1. 完成 设置 步骤。
2. 将“ Microsoft Office 365 作用域 ”活动添加到您的项目中。
3. 在“Microsoft Office 365 作用域”活动中添加“查找文件和文件夹”活动。
4. 输入“输入”属性的值。
5. 为“输出”属性创建并输入 DriveItem 和 DriveItem[] 变量。

6. 运行活动。

   • 您的输入属性值将发送到“获取范围”API。
   • API 将 DriveItem 和 DriveItem[] 值返回到您的输出属性变量。