更新或插入记录

UiPath.ServiceNow.Activities.UpsertRecords

“更新插入 记录” 活动使用 ServiceNow 批处理 - POST API 来更新或插入一条或多条记录。

完成操作后，该活动会在 DataTable 对象 (Result) 中输出插入结果，并在 ResponseStatus 对象 (ServiceNowStatus) 中输出操作状态（成功/失败信息），您可以在后续活动（例如，条件逻辑）。

提示：

此活动包提供四种不同的方法来更新和/或插入记录：更新 ServiceNow 记录、插入 ServiceNow 记录、更新插入记录或插入导入集记录。

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

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

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

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

工作方式

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

完成设置步骤。
将“ ServiceNow 作用域 ”活动添加到项目中。
在“ ServiceNow 作用域 ”活动中添加“更新插入记录”活动。
单击“更新插入 记录” 活动中的“配置”按钮（这将打开“ 对象向导”）。
选择要用于导入集的对象，然后输入输入属性。
为“ 输出 ” 属性创建并输入 DataTable 变量和 ResponseStatus 变量。
- 您的输入属性值将发送到 Batch - POST API。
- API 将 DataTable 和 ResponseStatus 值返回到您的输出属性变量。

要选择对象，您必须通过单击“ 配置 ”按钮使用“对象向导”。

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

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

“数据表 ” - 要插入或更新的记录数据。输入 DataTable 变量。
- 要更新现有记录，请将 sys_Id 值添加到包含要进行更新的数据行中。
- 不包含 sys_id 值的数据行将作为新记录插入（新记录的 sys_id 将在结果 DataTable 对象中返回）。
- 每次活动运行时，您可以更新或插入的最大记录数为 200。如果要插入/更新超过 200 条记录，可以为每个包含 200 条记录的 DataTable 添加 for 循环或更新插入活动（例如，如果总共有 4,000 条记录，则可以将记录拆分为 20活动）。有关更多信息，请参阅 ServiceNow 文档中的批处理 API 。

“状态” - 请求的状态（成功/失败信息）。输入 ResponseStatus 变量 (UiPath.BAF.Models.ResponseStatus)。 ResponseStatus 对象包含三个可在其他活动中使用的属性。
- “成功” - Boolean - 指定 API 请求是否成功。
- 错误代码 - String - API 请求不成功 (Success=False) 时的响应错误。
- 消息 - String - 错误消息。
“结果 ” - 插入或更新记录的结果。结果 DataTable 与输入 数据表具有相同的结构，但以下情况除外：
- 成功插入的新记录现在包含 sys_id 值。
- 系统将附加一个新的“操作类型”列，其中包含“ 添加 ”或 “更新 ”值，以指示记录是已更新还是已添加到表中。
- 如果操作失败，则会附加一个新的“错误”列，并包含错误信息。