加载项用户指南

上次更新日期 2026年3月30日

对象和附件

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

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

概述

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

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

先决条件

在开始之前：

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

步骤

构建您的项目。
测试您的项目。

构建项目

添加“获取凭据”活动。
输入（在设置期间）为 ServiceNow 实例用户名和密码（例如ServiceNowSignin ）创建的凭据资产的资产名称。
为“密码”值创建并输入SecureString变量（例如， password ）。
创建并输入String变量作为“用户名”值（例如username ）。
Add a second Get Credential activity.
输入（在设置期间）为 ServiceNow 实例客户端 ID 和客户端密码创建的凭据资产的资产名称（例如ServiceNowClients ）。
为“密码”值创建并输入SecureString变量（例如， clientSecret ）。
创建并输入String变量作为“用户名”值（例如clientId ）。
在两个“获取凭据” 活动之后添加“ServiceNow 作用域” 活动。
在“客户端密码”属性中，输入您在上述步骤中为客户端密码创建的SecureString变量（例如clientSecret ）。
在“客户端 ID”属性中，输入您为“客户端 ID”创建的String变量（例如clientId ）。
In the Password property, enter the SecureString variable you created for your password in the steps above (e.g., password).
在“用户名”属性中，输入您为用户名创建的String变量（例如clientId ）。
为端点 URL创建并输入String变量（例如endpointURL ）。
在“ServiceNow 作用域”活动中添加“插入 ServiceNow 记录” 活动。
单击“插入 ServiceNow 记录”活动中的“配置”按钮（这将打开“对象向导”）。
在“选择对象”下拉列表中，选择“事件” 。
为sys_id值创建并输入String变量（例如sysID ）
在“添加单个字段”文本框中，输入short_description 。
- 输入简短描述值（例如UiPath-Attachment ）。
Click Done.
为“ServiceNowStatus”值创建并输入ResponseStatus变量（例如insertRecordResponse ）。
在“插入 ServiceNow 记录” 活动之后添加“ 写入行” 活动。
输入以下Text ："Record created: "+insertRecordResponse.Success.ToString+" | sys_id: "+sysID（其中sysID是为上述sys_id “值”字段创建的变量）。
在“写入行” 活动之后添加“添加附件” 活动。
Click the Configure button inside the Add Attachment activity.
在“选择对象”下拉列表中，选择“事件” 。
在“文件名”属性中，输入本地文件的完整路径（例如"C:\UiPath_Projects\DemoFile.docx" ），或单击活动中的“选择文件”按钮。
在“对象系统 ID”属性中，输入您为“插入记录”活动创建的sys_id变量（例如sysID ）
为“附件 ID”属性创建并输入String变量（例如attachmentId ）。
为“ServiceNowStatus”值创建并输入ResponseStatus变量（例如addAttachmentResponse ）。
在“插入 ServiceNow 记录” 活动之后添加“ 写入行” 活动。
输入以下文本："Attachmentadded: "+addAttachmentResponse.Success.ToString+ " | sys_id: "+ attachmentId （其中attachmentId是为上述“AttachmentId”属性创建的变量）。
在“写入行” 活动之后添加“下载附件” 活动。
输入要下载文件的文件路径（例如"C:\UiPath_Projects\Downloads" ）。
在“系统 ID”属性中，输入您为“添加附件”活动创建的“附件 ID”变量（例如attachmentId ）。
在“下载附件” 活动之后添加“删除附件” 活动。
在“对象系统 ID”属性中，输入您为“添加附件”活动创建的“附件 ID”变量（例如attachmentId ）。

测试您的项目

在“删除附件” 活动之后添加“获取 ServiceNow 记录” 活动。
Click the Configure button inside the Insert ServiceNow Record activity.
在“选择对象”下拉列表中，选择“附件” 。
在“sys_id值”字段中，输入为“添加附件”活动创建的“附件 ID”变量（例如attachmentId ）
Click Done.
为“ServiceNowStatus”值创建并输入ResponseStatus变量（例如getRecordResponse ）。
将“ IF 条件”活动添加到“获取 ServiceNow 记录”活动之后。
在“条件”属性中，输入getRecordResponse.Success=False And getRecordResponse.Message.Contains("No Record") ，通过检查错误消息（其中getRecordResponse是您为上述“服务状态”属性创建的变量）来确定是否已成功删除附件记录。
In the Then statement box, add a Write Line activity.
1. 在“文本”属性中，输入“测试已通过:”+ getRecordResponse.Message 。
在“写入行” 活动后添加“删除 ServiceNow 记录” 。
1. Click the Configure button inside the Add Attachment activity.
2. 在“选择对象”下拉列表中，选择“事件” 。
3. 在“ID”属性中，输入您为“插入记录”活动创建的sys_id变量（例如sysID ）。
4. 为“ServiceNowStatus”值创建并输入ResponseStatus变量（例如deleteRecordResponse ）。
Add a Write Line activity after the Delete ServiceNow Record activity.
1. 在“文本”属性中，输入“已删除的记录:” + deleteRecordResponse.Success.ToString 。
In the Else statement box, add a Write Line activity.
1. 在“文本”属性中，输入“测试失败:” + getRecordResponse.Message 。
Click Run and verify the Output window includes the expected write line values.

操作完毕！

要了解有关 ServiceNow 活动（包括示例属性输入/输出）的更多信息，请参阅活动页面以获取完整的活动列表以及指向活动详细信息页面的链接。

在此页面上

概述
先决条件
步骤
构建项目
测试您的项目

此页面有帮助吗？

前一个概述

下一个关于

加载项用户指南

概述​

先决条件​

步骤​

构建项目​

测试您的项目​

此页面有帮助吗？

概述

先决条件

步骤

构建项目

测试您的项目