插入导入集记录

UiPath.ServiceNow.Activities.InsertImportSetRecords

“插入导入集记录”活动使用 ServiceNow导入集 - GET API 更新现有记录或插入新记录。

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

提示：

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

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

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

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

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

工作方式

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

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

     

     
     

在活动正文中

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

• “对象 ” - 要使用的导入集。 使用“ 对象向导 ”选择导入集。 “ 对象向导 ” 下拉列表包含您在 ServiceNow 应用程序中拥有的导入集。

属性

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

常见

• “显示名称 ” - 活动的显示名称。 输入 String 或 String 变量。

输入

• “数据表 ” - 要插入的数据。 输入 DataTable 变量。

其他

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

输出

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