传统集成活动

上次更新日期 2024年12月13日

快速入门 - 对象和附件

概述

本指南旨在帮助您创建使用以下 ServiceNow 活动的工作示例：

此工作示例可用于快速验证与 ServiceNow 实例的连接，并熟悉活动的输入/输出数据类型。

完成本指南中的步骤后，您将获得一个自动化序列，该连接器将执行以下操作：

建立与 ServiceNow 实例的连接（ServiceNow 作用域）。
创建新的 ServiceNow 事件（插入 ServiceNow 记录）。
将文件上传到新事件（“添加附件”）。
将上传的文件下载到本地文件夹（下载附件）。
删除上传的文件 (删除附件)。
通过尝试检索附件记录并输出预期的错误消息（获取 ServiceNow 记录、 If）来验证文件是否已删除。
删除已创建的事件 (删除 ServiceNow 记录)。

先决条件

在开始之前：

完成 ServiceNow 安装步骤。
要附加到 ServiceNow 记录的本地文件。

步骤

构建项目

添加活动。
为您的 ServiceNow 实例用户名和密码（例如， “ServiceNowSignin” ）输入您（在安装过程中）创建的凭据资产的资产名称。
创建并输入 SecureString 变量作为密码值（例如，密码）。
为您的用户名值创建并输入 String 变量（例如， username）。
添加第二个 “获取凭据” 活动。
输入您（在安装过程中）为ServiceNow实例客户端 ID 和客户端密码创建的凭据资产的资产名称（例如， “ServiceNowClients”）。
创建并输入 SecureString 变量作为密码值（例如， clientSecret）。
为您的用户名值创建并输入 String 变量（例如， clientId）。
在两个“获取凭据”活动之后添加“ ServiceNow 作用域 ”活动。
在“ 客户端密码” 属性中，输入您在上述步骤中为客户端密码创建的 SecureString 变量（例如， clientSecret）。
在“ 客户端 ID ” 属性中，输入您为“客户端 ID” 创建的 String 变量（例如， clientId）。
在密码属性中，输入您在上述步骤中为密码创建的 SecureString 变量（例如，密码）。
在“ 用户名” 属性中，输入您为用户名创建的 String 变量（例如， clientId）。
为您的 EndpointURL 创建并输入 String 变量（例如， endpointURL）
在“ ServiceNow 作用域”活动中添加“ 插入 ServiceNow 记录 ”活动。
单击“ 插入 ServiceNow 记录” 活动中的“ 配置 ”按钮（这将打开“对象向导”）。
在“ 选择对象 ” 下拉列表中，选择 “事件”。
为 sys_id 值创建并输入 String 变量（例如 sysID）
使用“ 添加单个字段 ” 文本框输入 short_description。
- 输入 short_description 值（例如， “UiPath-Attachment”）。
单击“完成”。
为 ServiceNowStatus 值创建并输入 ResponseStatus 变量（例如， insertRecordResponse）。
在 插入 ServiceNow 记录 活动之后添加活动。
输入以下文本： “已创建记录: "+insertRecordResponse.Success.ToString+" | sys_id: "+sysID （其中 sysID 是为上述 sys_id 值字段创建的变量）。
在“写入行” 活动之后添加“ 添加附件 ” 活动。
单击“ 添加附件 ”活动中的“配置”按钮。
在“ 选择对象 ” 下拉列表中，选择 “事件”。
在“ 文件名” 属性中，输入本地文件的完整路径（例如， “C:\UiPath_Projects\DemoFile.docx”），或单击活动中的 “选择文件” 按钮。
在“ 对象系统 ID” 属性中，输入您为“ 插入记录” 活动创建的sys_id变量（例如， sysID）
为 AttachmentId 属性创建并输入 String 变量（例如， attachmentId）。
为 ServiceNowStatus 值创建并输入 ResponseStatus 变量（例如， addAttachmentResponse）。
在 插入 ServiceNow 记录 活动之后添加活动。
输入以下文本： “已添加附件: "+addAttachmentResponse.Success.ToString+ " | sys_id: "+attachmentId （其中， attachmentId 是为上述 AttachmentId 属性创建的变量）。
在“写入行”活动之后添加“ 下载附件 ”活动。
输入要下载文件的文件路径（例如，“C:\ UiPath_Projects \Downloads”）。
在“ 系统 ID” 属性中，输入您为“ 添加附件 ”活动创建的“附件ID”变量（例如，“ 附件ID”）。
在“下载附件”活动之后添加“ 删除附件 ”活动。
在“ 对象系统 ID” 属性中，输入您为“ 添加附件 ”活动创建的“附件ID”变量（例如，“ 附件ID”）。

测试您的项目

在“删除附件”活动之后添加“ 获取 ServiceNow 记录 ”活动。
单击“ 插入 ServiceNow 记录” 活动中的“配置”按钮。
在“ 选择对象 ” 下拉列表中，选择“ 附件”。
在“ sys_id 值 ”字段中，输入您为“ 添加附件 ”活动创建的AttachmentId变量（例如， attachmentId）
单击“完成”。
为 ServiceNowStatus 值创建并输入 ResponseStatus 变量（例如， getRecordResponse）。
在“ 获取 ServiceNow 记录” 活动之后添加一个活动。
在“ 条件” 属性中，输入 getRecordResponse.Success=False 和 getRecordResponse.Message.Contains("No Record") ，以通过检查错误消息来确定是否已成功删除附件记录（其中， getRecordResponse 是您为上面的 ServiceNowStatus 属性创建的变量)。
在“ Then 语句”框中，添加“写入行”活动。

1. 在“ 文本 ”属性中，输入 “测试已通过：”+getRecordResponse.Message。

2. 在“写入行” 活动之后添加“ 删除 ServiceNow 记录 ”。

3. 单击“ 添加附件 ”活动中的“配置”按钮。

4. 在“ 选择对象 ” 下拉列表中，选择 “事件”。

5. 在“ ID ”属性中，输入您为“ 插入记录” 活动创建的sys_id变量（例如 sysID）。

6. 为 ServiceNowStatus 值创建并输入 ResponseStatus 变量（例如， deleteRecordResponse）。
在“ 删除 ServiceNow 记 录” 活动之后添加“ 写入行 ”活动。

1. 在“ 文本 ” 属性中，输入 “已删除记录:”+deleteRecordResponse.Success.ToString。
在“ Else 语句”框中，添加“ 写入行 ”活动。
1. 在“ 文本 ” 属性中，输入 “测试失败：”+getRecordResponse.Message。
单击 “运行” 并验证“ 输出 ”窗口是否包含预期的写入行值。