列出存储文件

UiPath.Core.Activities.Storage.ListStorageFile

描述

列出 Orchestrator 中指定存储桶中与给定模式匹配的文件。

项目兼容性

Windows - 旧版 | Windows | 跨平台

跨平台配置

• “Orchestrator 文件夹”- 要用于此活动的 Orchestrator 文件夹的路径。如果留空，则使用当前的 Orchestrator 文件夹。使用 / 作为目录分隔符来指定所需的目标目录。此字段仅支持 String 变量。
• “存储桶名称”- 文件所在的存储桶的名称。此字段仅支持字符串和 String 变量。
• “目录”- 要从中开始匹配的目录。此字段为必填字段。如果将此字段留空，则操作将从根目录开始。使用 \ 作为目录分隔符来指定所需的目标目录。

高级选项

选项

• “筛选”- 用于筛选结果文件的匹配模式。如果留空，则返回所有文件 (从目录开始，具体取决于“递归”属性字段的配置方式)。此字段是可选的。此字段仅支持 String 变量。匹配语法为文件通配符，具体来说，它与 Microsoft 文件系统全局匹配器的规则相匹配：
• *.pdf - 匹配目录中具有.pdf扩展名的所有文件。
• \*.pdf - 匹配目录和任何子目录中具有 .pdf 扩展名的所有文件（请注意，它不会覆盖 Recurse 设置，如果您要求 ** 并将 Recurse 指定为 False，则只会列出 Directory 文件夹）。
  注意：“递归”属性不会覆盖此筛选器类型。例如，请求 ** 并将“递归”配置为 False 仅列出目录文件夹。
• dir\*.pdf - 匹配所请求目录中名为dir的子目录中具有.pdf扩展名的所有文件，就像将dir添加到目录中的任何内容一样。
• **\dir\*.pdf - 匹配任何子目录中名为 dir 的所有具有 .pdf 扩展名的文件。仅当“递归”属性字段设置为 True 时，才能按预期工作。
• **\foo.txt - 任何子目录中名为foo.txt的任何文件。
• a\b\c.jpg - 位于目录 a\b 中的名为 c.jpg 的文件，相对于“目录”属性中指定的任何内容。这是文件的“存在”测试。
• “超时（以毫秒为单位）”- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会抛出错误。默认值为 30000 毫秒（30 秒）。
• “递归”- 一个布尔值变量，用于指定是否递归遍历所有子目录。此字段为必填字段。默认情况下，此字段设置为 True。
• “出错时继续”- 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”（True 和 False）。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。
  注意：如果“Try Catch 异常处理”中包含该活动且“出错时继续”属性的值为 True，则系统在执行项目时不会捕获任何错误。

输出

• “结果” - 引用要在其他活动中使用的结果文件名集合。

Windows - 旧版 Windows 配置

属性面板

常见

• “出错时继续”- 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”（True 和 False）。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。
  注意：如果“Try Catch 异常处理”中包含该活动且“出错时继续”属性的值为 True，则系统在执行项目时不会捕获任何错误。
• “显示名称”- 活动的显示名称。
• “超时（以毫秒为单位）”- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会抛出错误。默认值为 30000 毫秒（30 秒）。

其他

• “文件夹路径”- 要用于此活动的 Orchestrator 文件夹的路径。如果留空，则使用当前的 Orchestrator 文件夹。使用 / 作为目录分隔符来指定所需的目标目录。此字段仅支持 String 变量。
• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

输出

• “结果”- 包含与指定模式匹配的文件名的 StorageFileInfo 变量数组。这随后可用作“遍历循环”活动的输入。此字段仅支持 IEnumerable<StorageFileInfo> 变量。

存储

• “目录”- 要从中开始匹配的目录。此字段为必填字段。如果将此字段留空，则操作将从根目录开始。使用 \ 作为目录分隔符来指定所需的目标目录。
• “筛选”- 用于筛选结果文件的匹配模式。如果留空，则返回所有文件 (从目录开始，具体取决于“递归”属性字段的配置方式)。此字段是可选的。此字段仅支持 String 变量。匹配语法为文件通配符，具体来说，它与 Microsoft 文件系统全局匹配器的规则相匹配：
• *.pdf - 匹配目录中具有.pdf扩展名的所有文件。
• \*.pdf - 匹配目录和任何子目录中具有 .pdf 扩展名的所有文件（请注意，它不会覆盖 Recurse 设置，如果您要求 ** 并将 Recurse 指定为 False，则只会列出 Directory 文件夹）。
  注意：“递归”属性不会覆盖此筛选器类型。例如，请求 ** 并将“递归”配置为 False 仅列出目录文件夹。
• dir\*.pdf - 匹配所请求目录中名为dir的子目录中具有.pdf扩展名的所有文件，就像将dir添加到目录中的任何内容一样。
• **\dir\*.pdf - 匹配任何子目录中名为 dir 的所有具有 .pdf 扩展名的文件。仅当“递归”属性字段设置为 True 时，才能按预期工作。
• **\foo.txt - 任何子目录中名为foo.txt的任何文件。
• a\b\c.jpg - 位于目录 a\b 中的名为 c.jpg 的文件，相对于“目录”属性中指定的任何内容。这是文件的“存在”测试。
• “递归”- 一个布尔值变量，用于指定是否递归遍历所有子目录。此字段为必填字段。默认情况下，此字段设置为 True。
• “存储桶名称”- 文件所在的存储桶的名称。此字段仅支持字符串和 String 变量。