下载活动附件

UiPath.MicrosoftDynamics.Activities.DownloadActivityAttachment

“ 下载活动附件 ” 活动使用 Web API GET 操作以新名称或现有名称 ( Filename ) 将指定附件 (AttachmentId) 下载到指定位置 (Folder)。

下载附件后，该活动会在 ResponseStatus 对象 (MicrosoftDynamicsStatus) 中输出请求的状态（成功/失败信息），您可以在后续活动（例如条件逻辑）中使用该对象。

工作方式

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

1. 完成 设置 步骤。
2. 将“ Microsoft Dynamics 应用程序作用域 ” 活动添加到您的项目中。
3. 添加活动或运行输出注释标识符的外部流程（例如， 插入记录、 上传活动附件、 搜索记录）。
4. 在“ Microsoft Dynamics 应用程序作用域 ”活动中添加“下载活动附件”活动。
5. 输入“ 输入 ”属性的值。
6. 为“ 输出 ” 属性创建并输入 ResponseStatus 变量。
   • 您的输入属性值将在 <a href=https://docs.microsoft.com/en-us/powerapps/developer/common-data-service/webapi/retrieve-entity-using-web-api?view= dynamics-ce-odata-9 target="_blank">GET 操作请求。
   • 此操作会将 ResponseStatus 值返回到您的输出属性变量。
     
     

     

     
     

属性

常见

• “显示名称 ” - 活动的显示名称。 此字段仅支持字符串或 String 变量。

输入

• “附件 ID”- 分配给要下载的附件的标识符。 此字段仅支持 Strings 或 String 变量。 要获取 附件 ID 值，请使用活动或运行输出附件标识符（例如， 插入记录、 上传活动附件、 搜索记录）的外部流程。
• “文件夹 ” - 要将文件下载到的文件夹的完整本地路径。 此字段仅支持 Strings 或 String 变量。
• “文件名 ” - 已下载文件的新名称。 此字段仅支持字符串或 String 变量。
  • 默认情况下，使用附件的文件名保存文件。 如果“文件 夹” 中存在同名文件，则覆盖现有文件。
  • 要重命名文件（并避免不必要的覆盖），请使用此属性输入具有类型扩展名的新文件名（例如 DemoFile_Download.docx）

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

输出

• “响应 状态” - 请求的状态（成功/失败信息）。 输入 ResponseStatus 变量 (UiPath.BAF.Models.ResponseStatus)。 ResponseStatus 对象包含三个可在其他活动中使用的属性。
  • “成功” - Boolean - 指定 API 请求是否成功。
  • 错误代码 - String - API 请求不成功 (Success=False) 时的响应错误。
  • 消息 - String - 错误消息。

示例

下图显示了活动依赖关系和输入/输出属性值的示例。

有关分步说明和示例，请参阅 快速入门 指南。