添加附件

UiPath.ServiceNow.Activities.AddAttachment

“添加附件” 活动使用 ServiceNow Attachment - POST API 将文件（附件）上传到特定记录对象（ Object和ObjectSysId ）。

上传文件后，该活动会在 ResponseStatus 对象 (ServiceNowStatus) 中输出附件的 sys_id ( AttachmentId ) 和上传状态（成功/失败信息）。 这两个输出都可以用作后续活动中的输入变量（例如，“ 下载附件”中的“附件 ID” 、“ 条件逻辑中的“ 删除附件 ” 和“ ServiceNowStatus ”）。

工作方式

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

1. 完成 设置 步骤。
2. 将“ ServiceNow 作用域 ”活动添加到项目中。
3. 在“ ServiceNow 作用域 ”活动中添加“添加附件”活动。
4. 单击“ 添加附件 ”活动中的“配置”按钮（这将打开“ 对象向导”）。
5. 选择要将文件添加到的 对象 ，然后输入“ 输入 ”属性的值。
6. 为“ 输出 ” 属性创建并输入 String 和 ResponseStatus 变量。
   • 您的输入属性值将发送到附件 - POST API。
   • API 将 String (sys_id) 和 ResponseStatus 值返回到您的输出属性变量。
     
     

     

     
     

在活动正文中

要输入“ 添加附件 ” 属性值，请单击“ 配置 ” 按钮以打开“ 对象向导 ”，然后选择一个 ServiceNow 对象（您也可以选择以 String形式输入对象）。

要了解有关对象向导的更多信息，请参阅业务活动框架页面。

• “对象 ” - 要将文件上传到的 ServiceNow 对象的类型。 使用“ 对象向导 ”选择对象或输入有效的 String 或 String 变量。
• “文件 ” - 要附加的文件。 此字段仅支持 Strings 或 String 变量。
• “系统 ID ” - 要附加文件的记录的 ID。 此字段仅支持 Strings 或 String 变量。

属性

常见

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

输入

• “文件名 ” - 要上传的文件的完整本地路径。 输入 String 或 String 变量。
• “对象系统 ID”- 要将文件上传到的 ServiceNow 记录的 sys_id 。输入String或String变量。 要获取sys_id值，您可以遵循 ServiceNow唯一记录标识符 (sys_id)文档中显示的其中一种方法，或右键单击 ServiceNow 用户界面中的记录，然后在弹出菜单中选择“复制 sys_id”选项。

其他

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

输出

• 附件 ID - 附件的 sys_id 。 输入 String a 变量。 您为此属性创建的变量可用作后续活动（例如， 获取 ServiceNow 记录、 下载附件等）中的输入变量。
• ServiceNowStatus - 请求的状态（成功/失败信息）。 输入 ResponseStatus 变量 (UiPath.BAF.Models.ResponseStatus)。 ResponseStatus 对象包含三个可在其他活动中使用的属性。
  • “成功” - Boolean - 指定 API 请求是否成功。
  • 错误代码 - String - API 请求不成功 (Success=False) 时的响应错误。
  • 消息 - String - 错误消息。

示例

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

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