业务实体服务指南

10.4

上一个下一个

请求主体

使用更新挂起的合并 API 之前，使用读取匹配记录 REST API 确定可以与目标根记录合并的匹配记录。把请求主体中的记录列表发送给更新挂起的合并 API。

您可以替代根记录中的字段值。例如，如果所有匹配根记录都不包括名字的正确拼写，您可以在请求主体中指定正确的名字。或者，您可以删除这些匹配记录或指定其他匹配记录。

在请求主体中使用以下属性：

属性/元素	类型	说明
keys	数组	必需。希望合并的匹配根记录的排序列表。可以通过行 ID 或通过源系统和源键的组合来标识记录。
overrides	对象	替代根记录中的字段值以及子记录的匹配项。
MERGE	对象	替代希望合并的子记录的字段值。在 overrides 对象内添加子记录类型，然后添加 MERGE 对象。

以下 JSON 代码示例标识了要与目标根记录合并的两个根记录：

{
  keys: [
    {rowid: "2478246"},
    {rowid: "2478230"}
  ]
}

以下示例请求主体显示了如何替代 Party 根记录中的一个字段以及如何替代 Telephone 子记录的匹配记录：

{
  keys: [
    {
      rowid: "2478246"
    }
  ]
  overrides: {
    Party: {
      rowidObject: "2478230",
      firstName: "Charlie",   //Override the value for the first name
      Telephone: {   // Specifies the Telephone child records to merge
        item:[
          {
            rowidObject: "2511",
            MERGE: {
              item: [   // To remove the original merge candidates, specify null
                null,
                null
              ],
              $original: {
                item: [
                  {key:{rowid: "2822"}},
                  {key:{rowid: "2733"}}
                ]
              }
            }
          },
          {
            rowidObject: "2644",
            MERGE: {
              item: [   // To add or change merge candidates, specify matched records
                {key:{rowid: "2822"}}
              ],
            $original: {
              item: [
                null
              ]
            }
          }
        ]
      }
    }
  }
}

更新挂起的合并

下载指南

发送反馈

社区

Knowledge Base

成功门户

Rename Saved Search

目录

业务实体服务指南

业务实体服务指南

请求主体

请求主体