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