findDuplicates()

1FindDuplicatesResult[] duplicateResults = 
2    connection.findDuplicates(SObject[] inputSObjectArray);

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