Merge Message
![]() |
Merges the information from two entity instances of the same type.
The relevant classes are specified in the following table.
Type | Class |
Request | MergeRequest |
Response | MergeResponse |
Target | TargetMerge |
Entity | See below. |
The following table shows the entities and target classes for this message.
Entity | Target Class |
account | TargetMergeAccount |
contact | TargetMergeContact |
lead | TargetMergeLead |
Dynamic entity | TargetMergeDynamic |
Remarks
For a description of how actions on a parent instance affect child instances, see Cascading Rules.
For a list of required privileges, see Merge Privileges.
Example
The following code example shows how to use the Merge message.
[C#] // Set up the CRM Service. CrmService service = new CrmService(); service.Credentials = System.Net.CredentialCache.DefaultCredentials; // Create the target for the request. TargetMergeAccount target = new TargetMergeAccount(); // EntityId is the GUID of the account that is being merged into. target.EntityId = new Guid("2B951FBC-1C56-4430-B23B-20A1349068F3"); // Create the request. MergeRequest merge = new MergeRequest(); // SubordinateId is the GUID of the account merging. merge.SubordinateId = new Guid("AD618DB2-F0DB-4A6A-8C4B-2F2213EAA38E"); merge.Target = target; merge.PerformParentingChecks = false; account updateContent = new account(); updateContent.address1_line1 = "54321 NE Main St"; merge.UpdateContent = updateContent; // Execute the request. MergeResponse merged = (MergeResponse)service.Execute(merge);
[Visual Basic .NET] ' Set up the CRM Service. Dim service As New CrmService() service.Credentials = System.Net.CredentialCache.DefaultCredentials ' Create the target for the request. Dim target As New TargetMergeAccount() ' EntityId is the GUID of the account that is being merged into. target.EntityId = new Guid("2B951FBC-1C56-4430-B23B-20A1349068F3") ' Create the request. Dim merge As New MergeRequest() ' SubordinateId is the GUID of the account merging. merge.SubordinateId = new Guid("AD618DB2-F0DB-4A6A-8C4B-2F2213EAA38E") merge.Target = target merge.PerformParentingChecks = false Dim updateContent As New account() updateContent.address1_line1 = "54321 NE Main St" merge.UpdateContent = updateContent ' Execute the request. Dim merged As MergeResponse = CType(service.Execute(merge), MergeResponse)
Related Topics
© 2007 Microsoft Corporation. All rights reserved.
Show: