findDuplicatesByIds()

1FindDuplicatesResult[] duplicateResults =
2    connection.findDuplicatesByIds(Id[] inputIdArray);

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[] objectsToSearch = new SObject[2];
26    String[] inputIds = new String[2];
27    // Instantiate an empty Java SObject
28    SObject searchCriteria = new SObject();
29    // Set its type to Lead. This tells findDuplicatesByIds() to use the duplicate rules
30    // for Lead
31    searchCriteria.setType("Lead");
32    /*
33     * Set the necessary fields for matching, based on the standard matching rules for Lead
34     * (Search help.salesforce.com for "Standard Contact and Lead Matching Rule" to see the
35     * rules).
36     */
37    searchCriteria.setField("FirstName", "Marc");
38    searchCriteria.setField("LastName", "Benioff");
39    searchCriteria.setField("Company", "Salesforce.com Inc");
40    searchCriteria.setField("Title", "CEO");
41    searchCriteria.setField("Email", "ceo@salesforce.com");
42    // Add the sObjects to the input array
43    objectsToSearch[0] = searchCriteria;
44    objectsToSearch[1] = searchCriteria;
45
46    SaveResult[] saveResults = connection.create(objectsToSearch);
47
48    for (int i = 0; i < saveResults.length; ++i) {
49      if (saveResults[i].isSuccess()) {
50        System.out.println("Successfully created ID: " + saveResults[i].getId());
51        inputIds[i] = saveResults[i].getId();
52      } else {
53        System.out.println("Error: could not create SObject.");
54        System.out.println("The error reported was: " +
55          saveResults[i].getErrors()[0].getMessage() + "\n");
56      }
57    }
58    /*
59     * By default, findDuplicatesByIds() returns only record IDs. To return additional values,
60     * set the second parameter to true.
61     */
62    connection.setDuplicateRuleHeader(
63        /*
64         * @param allowSave - Not Applicable for this API call
65         */
66        false,
67        /* @param includeRecordDetails */
68        false,
69        /*
70         * @param runAsCurrentUser - Not Applicable for this API call
71         */
72        false);
73
74    // Invoke findDuplicatesByIds() to find duplicates based on the information in the
75    // SObject array
76    FindDuplicatesResult[] callResults = connection.findDuplicatesByIds(inputIds);
77
78    // Iterate through the results
79    /* For each Id in the input array, get the duplicate results. There could be more matches
80     * depending on the data in the organization.
81     */
82    for (FindDuplicatesResult findDupeResult : callResults) {
83      // If errors were found for this Id, print them out
84      if (!findDupeResult.isSuccess()) {
85        for (Error findDupError : findDupeResult.getErrors()) {
86          System.out.println("FindDuplicatesRule errors detected: " + findDupError.getMessage());
87        }
88      } else {
89        /*
90         * Get the DuplicateResult object array for the result. Each element in the array represents
91         * the result of testing one duplicate rule for the Id. Process each DuplicateResult.
92         */
93        for (DuplicateResult dupeResult : findDupeResult.getDuplicateResults()) {
94          System.out.println("Duplicate rule: " + dupeResult.getDuplicateRule());
95          // Print out the name of the object associated with the duplicate
96          // rule
97          System.out.println("Source of this duplicate rule is: " +
98            dupeResult.getDuplicateRuleEntityType());
99          for (MatchResult matchResult : dupeResult.getMatchResults()) {
100            if (!matchResult.isSuccess()) {
101              for (Error e : matchResult.getErrors()) {
102                System.out.println("Errors detected: " + e.getMessage());
103              }
104            } else {
105              System.out.println("Matching rule is: " + matchResult.getRule());
106              System.out.println("Object type for this matching rule is: " + matchResult.getEntityType());
107              for (MatchRecord matchRecord : matchResult.getMatchRecords()) {
108                System.out.println("Duplicate record ID: " + matchRecord.getRecord().getId());
109              }
110            }
111          }
112        }
113      }
114    }
115  }
116}