查找文件和文件夹

UiPath.MicrosoftOffice365.Activities.Files.FindFilesAndFolders

描述

重要提示：

从版本 2.7.21 开始，此活动已被弃用并从包中删除。建议您将此活动替换为“遍历文件/文件夹”（传统）或“遍历文件或文件夹”（Integration Service 连接）。

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

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

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

Find Files and Folders doesn't support the Sites.Selected application permission.

作用域

此活动需要以下作用域：

• 站点。只读。全部

或

• Sites.ReadWrite.All

项目兼容性

Windows - Legacy | Windows

配置

属性

常见

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

输入

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

选项

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

其他

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

输出

• First - The first file or folder matching the specified query. This field supports only DriveItem variables. Required if you plan to use the output data in subsequent activities. The DriveItem contains information about the file including its name, size, type, etc., that you can use in subsequent activities.
• Results - All files and folders matching the query returned as an array of DriveItems. DriveItems contain info such as filename, type, size, ID, etc., and can be used in subsequent activities. When using the Results DriveItem variable in other activities, specify the item in the array that you want to use (e.g., myFiles(0)).

Sharepoint

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

工作方式

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

1. 完成步骤。
2. 将“Microsoft Office 365 作用域”活动添加到您的项目。
3. Add the Find Files And Folders activity inside the Microsoft Office 365 Scope activity.
4. 输入“输入”属性的值。
5. 为“输出”属性创建并输入 DriveItem 和 DriveItem[] 变量。
6. 运行活动。
   • 您的输入属性值将发送到“搜索项目”API。
   • API 将 DriveItem 和 DriveItem[] 值返回到您的输出属性变量。