对象和附件

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

• 插入 ServiceNow 记录
• 添加附件
• 下载附件
• 删除附件
• 获取 ServiceNow 记录
• 删除 ServiceNow 记录

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

概述

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

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

   

   
   

先决条件

在开始之前：

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

步骤

1. 构建您的项目。
2. 测试您的项目。

构建您的项目

1. 添加 “获取凭据” 活动。
2. 为 ServiceNow 实例用户名和密码输入（在 安装过程中）您创建的凭据资产的“资产名称”（例如ServiceNowSignin ）。
3. 创建并输入 SecureString 变量作为您的 密码 值（例如password ）。
4. 为您的“用户 名”值创建并输入 String 变量（例如username ）。
5. 添加第二个 “获取凭据” 活动。
6. 输入您 （在安装 过程中）为 ServiceNow 实例“客户端 ID” 和“客户端密码” 创建的凭据资产的“资产名称”（ServiceNowClients例如 ）。
7. 创建并输入 SecureString 变量作为您的 密码 值（例如clientSecret ）。
8. 为您的“用户 名”值创建并输入 String 变量（例如clientId ）。
9. 在两个 “获取凭据 ”活动之后添加“ServiceNow 作用域 ”活动。
10. 在“客户端密码” 属性中，输入您在上述步骤中为“ 客户端密码”创建的 SecureString 变量（例如clientSecret ）。
11. 在“客户端 ID ” 属性中，输入您为“ 客户端 ID” 创建的 String 变量（例如clientId ）。
12. 在 密码 属性中，输入您在上述步骤中为密码创建的 SecureString 变量（例如，密码）。
13. 在 用户 名属性中，输入您为用户名创建的 String 变量（例如clientId ）。
14. 为您的 端点 URL创建并输入 String 变量（例如endpointURL ）。
15. 在“ServiceNow 作用域 ”活动中添加“插入 ServiceNow 记录 ”活动。
16. 单击“ 插入 ServiceNow 记录” 活动中的“ 配置 ”按钮（这将打开“对象向导”）。
17. 在“选择对象” 下拉列表中，选择 “事件” 。
18. 为 sys_id 值创建并输入 String 变量（例如sysID ）
19. 使用“添加单个字段”文本框，输入 short_description 。
    • 输入“ short_description” 值（例如UiPath-Attachment ）。
20. 单击“完成”。
21. 为 ServiceNowStatus 值创建并输入 ResponseStatus 变量（例如insertRecordResponse ）。
22. 在 插入 ServiceNow 记录 活动之后添加 写入行 活动。
23. 输入以下 文本: "Record created: "+insertRecordResponse.Success.ToString+" | sys_id: "+sysID（其中 sysID 是为上面的 sys_id 值 字段创建的变量）。
    
    

    

    
    
24. 在“ 写入行 ” 活动之后添加“ 添加附件 ” 活动。
25. 单击“ 添加附件 ”活动中的“配置”按钮。
26. 在“选择对象” 下拉列表中，选择 “事件” 。
27. 在“文件 名” 属性中，输入本地文件的完整路径（例如"C:\UiPath_Projects\DemoFile.docx" ）或单击活动中的 “选择文件” 按钮。
28. 在 对象 系统 ID 属性中，输入您为 插入记录 活动创建的 sys_id 变量（例如sysID ）
29. 为“附件 ID ” 属性创建并输入 String 变量（例如attachmentId ）。
30. 为 ServiceNowStatus 值创建并输入 ResponseStatus 变量（例如addAttachmentResponse ）。
31. 在 插入 ServiceNow 记录 活动之后添加 写入行 活动。
32. 输入以下 文本：“已添加附件: "+addAttachmentResponse.Success.ToString+ " | sys_id: "+attachmentId （其中 attachmentId 是为上述 附件 ID 属性创建的变量）。
33. 在“写入行 ”活动之后添加“下载附件 ”活动。
34. 输入要下载文件的文件 路径 （例如"C:\UiPath_Projects\Downloads" ）。
35. 在系统 ID 属性中，输入您为 添加附件 活动创建的 附件 ID 变量（例如attachmentId ）。
36. 在 “ 下载附 件 ”活动之后添加“ 删除附 件 ”活动。
37. 在对象系统 ID 属性中，输入您为 添加附件 活动创建的 附件 ID 变量（例如attachmentId ）。
    
    

    

    
    

测试您的项目

1. 在“删除附件 ”活动之后添加“获取 ServiceNow 记录 ”活动。
2. 单击“ 插入 ServiceNow 记录” 活动中的“配置”按钮。
3. 在“选择对象” 下拉列表中，选择“附件”。
4. 在“sys_id 值 ”字段中，输入您为“ 添加附件 ”活动创建的“ 附件 ID”变量（例如attachmentId ）
5. 单击“完成”。
6. 为 ServiceNowStatus 值创建并输入 ResponseStatus 变量（例如getRecordResponse ）。
7. 在“ 获取 ServiceNow 记录” 活动之后添加“IF 条件 ”活动。
8. 在“条件” 属性中，输入 getRecordResponse.Success=False And getRecordResponse.Message.Contains("No Record") ，以通过检查错误消息来确定是否已成功删除附件记录（其中 getRecordResponse 是您为上面的 ServiceNowStatus 属性创建的变量）。
9. 在“ Then 语句”框中，添加“写入行”活动。
   1. 在“文本”属性中，输入“测试通过：”+getRecordResponse.Message 。
10. 在“ 写入行 ”活动之后添加“ 删除 ServiceNow 记录 ”。
    1. 单击“ 添加附件 ”活动中的“配置”按钮。
    2. 在“选择对象” 下拉列表中，选择 “事件” 。
    3. 在 ID 属性中，输入您为 插入记录 活动创建的 sys_id 变量（例如sysID ）。
    4. 为 ServiceNowStatus 值创建并输入 ResponseStatus 变量（例如deleteRecordResponse ）。
11. 在“ 删除 ServiceNow 记 录” 活动之后添加“ 写入行 ”活动。
    1. 在“文本” 属性中，输入“已删除记录：” +deleteRecordResponse.Success.ToString 。
12. 在“ Else 语句”框中，添加“ 写入行 ”活动。
    1. 在“文本” 属性中，输入“测试失败：” +getRecordResponse.Message 。
13. 单击 “运行” 并验证“ 输出 ”窗口是否包含预期的写入行值。
    
    

    

    
    

操作完毕！

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