ビジネスエンティティサービスガイド

10.4

前へ次へ

要求本文

［保留中のマージの更新］APIを使用する前に、［一致するレコードの読み取り］REST APIを使用して、ターゲットルートレコードとマージできる一致レコードを判断します。［保留中のマージの更新］APIの要求本文で、レコードのリストを送信します。

ルートレコードでフィールドの値をオーバーライドできます。例えば、一致したルートレコードに名（ファーストネーム）の正しいスペルが含まれていない場合、要求本文で正しい名を指定できます。また、一致したレコードを削除したり、他の一致レコードを指定したりすることもできます。

要求本文で、次のプロパティを使用します。

プロパティ/要素	タイプ	説明
keys	配列	必須。マージする、一致したルートレコードの順序付きリスト。レコードは行IDによって、またはソースシステムとソースキーの組み合わせによって識別できます。
overrides	オブジェクト	ルートレコードおよび一致子レコードで、フィールドの値をオーバーライドします。
MERGE	オブジェクト	マージする子レコードのフィールド値をオーバーライドします。 overrides オブジェクト内で子レコードのタイプを追加してから、 MERGE オブジェクトを追加します。

次のJSONコードサンプルは、ターゲットルートレコードとマージする2つのルートレコードを識別します。

{
  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

Success Portal

Rename Saved Search

目次

ビジネスエンティティサービスガイド

ビジネスエンティティサービスガイド

要求本文

要求本文