merge()

1public Boolean mergeRecords()
2{
3   Boolean success = false;
4   // Array to hold the results
5   String[] accountIds = new String[2];
6   try
7   {
8      // Create two accounts to merge
9      Account[] accounts = new Account[2];
10      Account masterAccount = new Account();
11      masterAccount.Name = "MasterAccount";
12      masterAccount.Description = "The Account record to merge with.";
13      accounts[0] = masterAccount;
14      Account accountToMerge = new Account();
15      accountToMerge.Name = "AccountToMerge";
16      accountToMerge
17            .Description = "The Account record that will be merged.";
18      accounts[1] = accountToMerge;
19      SaveResult[] saveResults = binding.create(accounts);
20
21      if (saveResults.Length > 0)
22      {
23         for (int i = 0; i < saveResults.Length; i++)
24         {
25            if (saveResults[i].success)
26            {
27               accountIds[i] = saveResults[i].id;
28               Console.WriteLine("Created Account ID: "
29                     + accountIds[i]);
30            }
31            else
32            {
33               // If any account is not created,
34               // print the error returned and exit
35               Console.WriteLine("An error occurred while creating account."
36                           + " Error message: "
37                           + saveResults[i].errors[0].message);
38               return success;
39            }
40         }
41      }
42
43      // Set the Ids of the accounts 
44      masterAccount.Id = accountIds[0];
45      accountToMerge.Id = accountIds[1];
46
47      // Attach a note to the account to be merged with the master,
48      // which will get re-parented after the merge
49      Note note = new Note();
50      Console.WriteLine("Attaching note to record " +
51            accountIds[1]);
52      note.ParentId = accountIds[1];
53      note.Title = "Merged Notes";
54      note.Body = "This note will be moved to the "
55            + "MasterAccount during merge";
56      SaveResult[] sRes = binding.create(new sObject[] { note });
57      if (sRes[0].success)
58      {
59         Console.WriteLine("Created Note record.");
60      }
61      else
62      {
63         Error[] errors = sRes[0].errors;
64         Console.WriteLine("Could not create Note record: "
65               + errors[0].message);
66      }
67
68      // Perform the merge
69      MergeRequest mReq = new MergeRequest();
70      masterAccount.Description = "Was merged";
71      mReq.masterRecord = masterAccount;
72      mReq.recordToMergeIds = new String[] { saveResults[1].id };      
73      
74      MergeResult mRes = binding.merge(new MergeRequest[] { mReq })[0];
75
76      if (mRes.success)
77      {
78         Console.WriteLine("Merge successful.");
79         // Write the IDs of merged records
80         foreach (String mergedId in mRes.mergedRecordIds)
81         {
82            Console.WriteLine("Merged Record ID: " + mergedId);
83         }
84         // Write the updated child records. (In this case the note.)
85         Console.WriteLine(
86               "Child records updated: " + mRes.updatedRelatedIds.Length);
87         success = true;
88      }
89      else
90      {
91         Console.WriteLine("Failed to merge records. Error message: " +
92               mRes.errors[0].message);
93      }
94   }
95   catch (SoapException e)
96   {
97      Console.WriteLine("An unexpected error has occurred: " +
98                                 e.Message + "\n" + e.StackTrace);
99   }
100   return success;
101}