下载存储文件

“下载存储文件”活动，从 Orchestrator 中的指定存储桶下载文件。

UiPath.Core.Activities.Storage.DownloadStorageFile

描述

将文件上传到 Orchestrator 中的指定存储桶。

备注：

Orchestrator 权限

此活动在执行它的机器人的 Orchestrator 帐户下运行。它必须拥有对目标文件夹的以下Orchestrator 角色权限：

• Storage Buckets.View ：用于解析存储桶
• Storage Files.View ：用于从存储桶读取或下载文件
• Folders.View ：用于浏览和选择 Orchestrator 文件夹

项目兼容性

Windows - 旧版 | Windows | 跨平台

跨平台配置

• “Orchestrator 文件夹路径” - 要用于此活动的 Orchestrator 文件夹的路径。如果留空，则使用当前的 Orchestrator 文件夹。此字段仅支持字符串和String变量。
• “存储桶名称”- 文件所在的存储桶的名称。此字段仅支持字符串和 String 变量。
• “文件路径”- 要下载的存储桶内文件的完整路径。该文件必须存在于源 Orchestrator 存储容器中。此字段仅支持字符串和 String 变量。

¹For cross-platform projects created in Studio Web as part of a solution, the Orchestrator folder path field is unavailable. If the activity had a folder path before it became part of the solution, the field is displayed as read-only, and that folder overrides the solution resource. Selecting the resource again removes the folder.

²对于在 Studio Web 中创建的作为解决方案一部分的跨平台项目， “名称”字段提供了用于在设计时定义新的Orchestrator 资源（例如队列、资产或存储桶）或“打开 Orchestrator进行资源管理”的选项。

高级选项

选项

• “文件名和位置”- 要从中下载文件且包含文件名的完整本地路径。根据运行时间执行目录解析相对路径。此路径必须包含文件名，以便活动正常工作。此字段仅支持字符串和 String 变量。

• 超时（以毫秒为单位） - 指定最长等待时间（以毫秒为单位），如果超出该时间后 Orchestrator 未响应或文件传输取得进展，系统便会抛出错误。此选项不限制总传输时间，因此仍可通过慢速连接完成大文件传输。默认值为 300000 毫秒（5 分钟）。打开连接的时长始终限制为 30 秒。

  备注：

  超时时，活动将失败，并显示携带错误代码TimeoutException Orchestrator_Sys_Timeout ，因此“出错时继续”和“重试作用域”适用于任何其他错误。0 或负数值将替换为 30 秒，取消作业将报告为取消，而不是超时。

  在活动失败之前，将删除部分写入的目标文件。

• “出错时继续”- 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”（True 和 False）。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。

  备注：

  如果“Try Catch 异常处理”中包含该活动且“出错时继续”属性的值为“True”，则系统在执行项目时不会捕获任何错误。

输出

• “文件”- 引用要在其他活动中使用的已下载文件。

Windows - 旧版 Windows 配置

• 要下载的存储桶内文件的完整路径。该文件必须存在于源 Orchestrator 存储容器中。此字段仅支持字符串和 String 变量。
• “存储桶名称”- 文件所在的存储桶的名称。此字段仅支持字符串和 String 变量。

属性面板

常见

• “出错时继续”- 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”(True 和 False)。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。

  备注：

  如果“Try Catch 异常处理”中包含该活动且“出错时继续”属性的值为“True”，则系统在执行项目时不会捕获任何错误。

• “显示名称”- 活动的显示名称。

• 超时（以毫秒为单位） - 指定最长等待时间（以毫秒为单位），如果超出该时间后 Orchestrator 未响应或文件传输取得进展，系统便会抛出错误。此选项不限制总传输时间，因此仍可通过慢速连接完成大文件传输。默认值为 300000 毫秒（5 分钟）。打开连接的时长始终限制为 30 秒。

  备注：

  超时时，活动将失败，并显示携带错误代码TimeoutException Orchestrator_Sys_Timeout ，因此“出错时继续”和“重试作用域”适用于任何其他错误。0 或负数值将替换为 30 秒，取消作业将报告为取消，而不是超时。

  在活动失败之前，将删除部分写入的目标文件。

其他

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

输出

• “结果” - 引用要在其他活动中使用的已下载文件。

存储

• 要下载的存储桶内文件的完整路径。该文件必须存在于源 Orchestrator 存储容器中。此字段仅支持字符串和 String 变量。
• “存储桶名称”- 文件所在的存储桶的名称。此字段仅支持字符串和 String 变量。

目标

• “文件名和位置”- 要从中下载文件且包含文件名的完整本地路径。根据运行时间执行目录解析相对路径。此路径必须包含文件名，以便活动正常工作。此字段仅支持字符串和 String 变量。