activities
latest
false
重要 :
请注意此内容已使用机器翻译进行了部分本地化。
UiPath logo, featuring letters U and I in white
生产力活动
Last updated 2024年11月6日

DEPRECATED
查找文件和文件夹

UiPath.MicrosoftOffice365.Activities.Files.FindFilesAndFolders

描述

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

执行搜索后,该活动将返回匹配的 DriveItem 对象(“First ”和“ Results”),您可以将其用作后续活动中的输入变量;几乎所有 Excel 和文件活动都需要将其作为输入变量。

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

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

此活动需要以下作用域:

  • 站点。只读。全部

  • Sites.ReadWrite.All

项目兼容性

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. 为“输出”属性创建并输入 DriveItemDriveItem[] 变量。
  6. 运行活动。

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


  • 描述
  • 项目兼容性
  • 配置
  • 工作方式

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo White
信任与安全
© 2005-2024 UiPath。保留所有权利。