业务实体服务指南

10.2

上一个下一个

请求主体

在开始前，请使用读取匹配记录 API 确定可与原始根记录合并的匹配记录。把请求主体中的记录列表发送给预览合并 API。

您可以替代根记录中的字段值。例如，如果所有合并根记录都不包括名字的正确拼写，您可以在请求主体中指定名字。您还可以通过移除合并候选项或指定不同的合并候选项来替代子记录的合并方式。

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

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

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

{
  keys: [
    {
       rowid: "P2"
    }
  ]
}

以下代码显示了如何替代 Party 根记录中的一个字段以及如何替代 Telephone 子记录的合并候选项：

{
  keys: [
    {
      rowid: "P2"
    }
  ]
  overrides: {
    Party: {
      rowidObject: "P1",
      firstName: "Serge",   //override the value for the first name
      Telephone: {   // override which Telephone child records to merge
        item:[
          {
            rowidObject: "T1",
            MERGE: {
              item: [   // to remove the original merge candidates, specify null
                null,
                null
              ],
              $original: {
                item: [
                  {key:{rowid: "T2"}},
                  {key:{rowid: "T3"}}
                ]
              }
            }
          },
          {
            rowidObject: "T4",
            MERGE: {
              item: [   // to add or change merge candidates, specify matched records
                {key:{rowid: "T2"}}
              ],
            $original: {
              item: [
                null
              ]
            }
          }
        ]
      }
    }
  }
}

预览合并

下载指南

发送反馈

社区

Knowledge Base

成功门户

Rename Saved Search

目录

业务实体服务指南

业务实体服务指南

请求主体

请求主体