插入 ServiceNow 记录

UiPath.ServiceNow.Activities.InsertRecord

“ 插入 ServiceNow 记录” 活动使用 ServiceNow 表 - POST API 插入新的记录对象。

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

此活动还会返回新记录对象的 sys_id 值。 例如，如果要插入 ServiceNow 事件 对象，则可以通过在对象向导中添加 String 变量来输出 sys_id 值（请参见下面的 示例 ）。

提示：

此活动包提供三种不同的方法用于插入记录： 插入服务立即记录、更新插入记录或 插入导入集记录。

“插入 ServiceNow 记录” 和“更新插入 记录” 活动使用 REST API 直接写入生产表。 “ 插入导入集记录” 活动使用 REST 导入集 API 写入导入集表，数据将从该表转换为目标生产表。

为避免将记录直接插入生产表，建议您使用“更新插入 ServiceNow 记录” 活动插入新记录。

有关详细信息，包括对导入集性能进行故障排除，请参阅 ServiceNow 文档中的 导入集 。

要了解有关使用导入集的更多信息，请参阅 ServiceNow 文档中的 Web 服务导入集 和 使用导入集导入数据 。

工作方式

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

1. 完成 设置 步骤。
2. 将“ ServiceNow 作用域 ”活动添加到项目中。
3. 在“ ServiceNow 作用域 ”活动中添加“插入 ServiceNow 记录”活动。
4. 单击“ 插入 ServiceNow 记录” 活动中的“配置”按钮（这将打开“ 对象向导”）。
5. 选择要插入的 对象 ，然后添加要填充的字段（包含值）。
6. 为“ 输出 ”属性创建并输入 ResponseStatus 变量。
   • 您的输入属性值将发送到 Table - POST API。
   • API 会将 ResponseStatus 值返回到您的输出属性变量。
     
     

     

     
     

在活动正文中

要输入“ 插入 ServiceNow 记录” 属性值，您必须使用“ 对象向导 ”，方法是单击“ 配置 ”按钮。

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

• sys_id - 所创建的 ServiceNow 记录的 ID。 输入 String 变量。 插入新记录时，ServiceNow 会自动生成 sys_id 。 要检索此值以在其他活动中使用，请在对象向导中创建并输入一个 String 变量（示例如下）。

属性

注意： 如果您没有看到所选对象的属性列表，即使查看了“添加多个字段”选项，也可能是因为您在 ServiceNow 中没有足够的权限查看对象元数据和修改数据。 有关更多详细信息，请参阅 权限问题故障排除 。

高级

• “其他 字段” - DataRow ，其中包含要插入的列和值。 列名称必须与所选对象类型在 ServiceNow 数据库表格中显示的名称匹配。

常见

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

其他

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

输出

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

示例

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

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