findDuplicates()

1SObject[] inputSObjectArray = new SObject[1];
2// Instantiate an empty Java SObject
3SObject searchCriteria = new SObject();
4// Set its type to Lead. This tells findDuplicates() to use the duplicate rules 
5// for Lead
6searchCriteria.setType("Lead");
7/*
8 * Set the necessary fields for matching, based on the standard matching rules 
9 * for Lead (Search help.salesforce.com for "Standard Contact and Lead Matching 
10 * Rule" to see the rules).
11 */
12searchCriteria.setField("FirstName", "Mark");
13searchCriteria.setField("LastName", "Benioff");
14searchCriteria.setField("Company", "Salesforce.com Inc");
15searchCriteria.setField("Title", "CEO");
16searchCriteria.setField("Email", "ceo@salesforce.com");
17// Add the sObject to the input array
18inputSObjectArray[0] = searchCriteria;
19/*
20 * By default, findDuplicates() returns only record IDs. To return 
21 * additional values, set the second parameter to true.
22 */
23connection.setDuplicateRuleHeader( /* @param allowSave - Not Applicable 
24                                      for this API call */ false, 
25                                   /* @param includeRecordDetails */ false, 
26                                   /* @param runAsCurrentUser - Not 
27                                      Applicable for this API call */ false);
28
29// Invoke findDuplicates() to find duplicates based on the information in the 
30// SObject array
31FindDuplicatesResult[] callResults = 
32        connection.findDuplicates(inputSObjectArray);
33
34if (callResults == null || callResults.length == 0) {
35    System.out.println("Major error while calling findDuplicates(). Cannot proceed");
36    return;
37}
38
39// Iterate through the results
40// For each SObject in the input array, get the duplicate results
41for (FindDuplicatesResult findDupResult : callResults) {
42    // If errors were found for this SObject, print them out
43    if (!findDupResult.isSuccess()) {
44        for (Error findDupError : findDupResult.getErrors()) {
45            System.out.println("FindDuplicatesRule errors detected: " + 
46                    findDupError.getMessage());
47        }
48    } else {
49        /*
50         * Get the DuplicateResult object array for the result. Each element in 
51         * the array represents the result of testing one duplicate rule for the
52         * SObject. Process each DuplicateResult.
53         * SObject. Process each DuplicateResult
54         */
55        for (DuplicateResult dupeResult : findDupResult.getDuplicateResults()) {
56            System.out.println("Duplicate rule: " + 
57                    dupeResult.getDuplicateRule());
58            // Print out the name of the object associated with the duplicate 
59            // rule
60            System.out.println("Source of this duplicate rule is: " + 
61                    dupeResult.getDuplicateRuleEntityType());
62            for (MatchResult matchResult : dupeResult.getMatchResults()) {
63                if (!matchResult.isSuccess()) {
64                    for (Error e : matchResult.getErrors()) {
65                        System.out.println("Errors detected: " + 
66                                e.getMessage());
67                    }
68                } else {
69                    System.out.println("Matching rule is: " + 
70                        matchResult.getRule());
71                    System.out.println("Object type for this matching rule is: " +
72                        matchResult.getEntityType());
73                    for (MatchRecord matchRecord : matchResult.getMatchRecords()) {
74                        System.out.println("Duplicate record ID: " + 
75                                matchRecord.getRecord().getId());
76                    }
77                }
78            }
79        }
80    }
81}