Table of Contents

Search

  1. Preface
  2. Introduction to Business Entity Services
  3. Enterprise Java Bean Business Entity Service Calls
  4. Representational State Transfer Business Entity Service Calls
  5. Simple Object Access Protocol Business Entity Service Calls
  6. Services for Cross-reference Records and BVT Calculations
  7. Supporting Corporate Linkage Service
  8. External Calls to Cleanse, Analyze, and Transform Data
  9. Appendix A: Using REST APIs to Add Records
  10. Appendix B: Using REST APIs to Upload Files
  11. Appendix C: Using REST APIs to Manage Reports

Request Body

Request Body

Before you use the Update Pending Merge API, use the Read Matched Records REST API to determine the matched records that you can merge with the target root record. Send the list of records in the request body for the Update Pending Merge API.
You can override field values in the root record. For example, if none of the matched root records contain the correct spelling of the first name, you can specify the correct first name in the request body. Also, you can remove matched records or specify other matching records.
Use the following properties in the request body:
Properties / Elements
Type
Description
keys
array
Required. An ordered list of the matched root records that you want to merge. You can identify the records either by row ID or by a combination of the source system and the source key.
overrides
object
Overrides the field values in a root record and the matches for child records.
MERGE
object
Overrides the field values in child records that you want to merge. Add the type of child record within the
overrides
object and then add the
MERGE
object.
The following JSON code sample identifies two root records to merge with the target root record:
{ keys: [ {rowid: "2478246"}, {rowid: "2478230"} ] }
The following sample request body shows how to override a field in the Party root record and how to override the matched records for Telephone child records:
{ 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 ] } } ] } } } }

0 COMMENTS

We’d like to hear from you!