Siebel Data Quality Administration Guide > Universal Connector API > Batch Mode Data Matching Functions >

sdq_get_duplicates Function


This function is called to get the master record with the list of its duplicate records along with their match scores. This is done in batch mode. The number of records received for each call to this function is set in the BATCH_MATCH_MAX_NUM_OF_RECORDS session parameter before the function is called.

Syntax

int sdq_get_duplicates (int session_id, SSchar* xmlResultSet)

Parameters

session_id: The session ID obtained by initializing the session.

 

xmlRecordSet: An XML character string that the vendor library populates with a master record and a list of its duplicate records along with their match scores.

If the number of duplicates is more than the value of the parameter BATCH_MATCH_MAX_NUM_OF_RECORDS, the results can be split across multiple function calls with each function call including the master record as well. The XML is in the following format:

<Data>
<ParentRecord>
<DQ.MasterRecordsRowID>2-24-E</DQ.MasterRecordsRowID>
<DuplicateRecord>
<Account.Id>2-24-E</Account.Id>
<DQ.MatchScore>92</DQ.MatchScore>
</DuplicateRecord>

<DuplicateRecord>
<Account.Id>2-23-F</Account.Id>
<DQ.MatchScore>88</DQ.MatchScore>
</DuplicateRecord>
</ParentRecord>
</Data>

Return Value

A return value of 0 indicates successful execution, while a return value of 1 indicates that there are no duplicate records left. Any other value is a vendor error code.

The error message details from the vendor are obtained by calling the sdq_get_error_message function.

NOTE:  Data quality code only processes the returned XML character string while the return value is 0. Even if there are fewer records to return than the value of the BATCH_MATCH_MAX_NUM_OF_RECORDS parameter, the vendor driver sends a return value of 0 and then return a value of 1 in the next call.

Siebel Data Quality Administration Guide Copyright © 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices.