AutoMapEntityRequest Class

Applies To: Microsoft Dynamics CRM 2013, Microsoft Dynamics CRM Online

Contains the data that is needed to generate a new set of attribute mappings based on the metadata.

Namespace: Microsoft.Crm.Sdk.Messages
Assembly: Microsoft.Crm.Sdk.Proxy (in Microsoft.Crm.Sdk.Proxy.dll)

Syntax

'Declaration
<DataContractAttribute(Namespace:="https://schemas.microsoft.com/crm/2011/Contracts")> _
Public NotInheritable Class AutoMapEntityRequest
    Inherits OrganizationRequest
[DataContractAttribute(Namespace="https://schemas.microsoft.com/crm/2011/Contracts")] 
public sealed class AutoMapEntityRequest : OrganizationRequest

Remarks

Message Availability

For this message to work, the caller must be connected to the server.

Usage

Pass an instance of this class to the Execute method, which returns an instance of the AutoMapEntityResponse class.

Privileges and Access Rights

To perform this action, the caller must have the privileges that are listed in AutoMapEntity Privileges.

Notes for Callers

Use this helper function after you create a new relationship. This message is provided as a productivity enhancement so that you do not have to manually add all attribute mappings. Instead, you can generate a set of likely mappings and minimize the amount of manual work to add or remove individual mappings to meet your requirements. This message will map all the attributes between the two related entities where the attribute names are identical and the types are identical. The mapping may result in some mappings that you do not want; therefore, you should always check the resulting mapping before you publish the customization.

Note

If you use this function where entity mappings already exist, the existing mappings are removed.

Inheritance Hierarchy

System.Object
   Microsoft.Xrm.Sdk.OrganizationRequest
    Microsoft.Crm.Sdk.Messages.AutoMapEntityRequest

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows Server 2008, Windows Server 2012, Windows 7 (All Versions), Windows 8 (All Versions)

Target Platforms

Windows Server 2008, ,Windows Server 2012, ,Windows 7 (All Versions),

Change History

See Also

Reference

AutoMapEntityRequest Members
Microsoft.Crm.Sdk.Messages Namespace

Other Resources

Customize Entity and Attribute Mappings
AutoMapEntity Privileges

Send comments about this topic to Microsoft.
© 2013 Microsoft Corporation. All rights reserved.