Export (0) Print
Expand All

OrderOption Message (MetadataService)

banner art

[Applies to: Microsoft Dynamics CRM 4.0]

Find the latest SDK documentation: CRM 2015 SDK

Works for all deployment typesWorks online only

Sets the order of a list of options.

The relevant classes are specified in the following table.

TypeClass
RequestOrderOptionRequest
ResponseOrderOptionResponse

Remarks

To perform this action, the caller must be a user in the organization for which metadata is requested and must have Write Attribute privilege.

Example

The following example shows how to use the OrderOption message.

[C#]
// Create an authentication token.
CrmAuthenticationToken token = new CrmAuthenticationToken();
token.OrganizationName = "AdventureWorksCycle";

// You can use enums.cs from the SDK\Helpers folder to get the enumeration for Active Directory authentication.
token.AuthenticationType = 0; 

// Create the metadata Web service;
MetadataService metadataService = new MetadataService();
metadataService.Url = "http://<servername>:<port>/MSCRMServices/2007/MetadataService.asmx";
metadataService.CrmAuthenticationTokenValue = token;
metadataService.Credentials = System.Net.CredentialCache.DefaultCredentials;
metadataService.PreAuthenticate = true;

// Create the request.
OrderOptionRequest orderOptionRequest = new OrderOptionRequest();

// Set the properties for the request
orderOptionRequest.AttributeLogicalName = "address1_addresstypecode";
orderOptionRequest.EntityLogicalName = EntityName.contact.ToString();

// Set the order for the options.
orderOptionRequest.Values = new int[] { 4, 3, 2, 1 };

// Execute the request
OrderOptionResponse orderOptionResponse = (OrderOptionResponse)metadataService.Execute(orderOptionRequest);
[Visual Basic .NET]
' Set up the CRM service.
Dim token As New CrmAuthenticationToken()
' You can use enums.cs from the SDK\Helpers folder to get the enumeration for Active Directory authentication.
token.AuthenticationType = 0
token.OrganizationName = "AdventureWorksCycle";

// Create the metadata Web service.
Dim metadataService As New MetadataService ()
metadataService.Url = "http://<servername>:<port>/mscrmservices/2007/MetadataService.asmx";
metadataService.CrmAuthenticationTokenValue = token;
metadataService.Credentials = System.Net.CredentialCache.DefaultCredentials
metadataService.PreAuthenticate = true;

' Create the request.
Dim orderOptionRequest As New OrderOptionRequest()

' Set the properties for the request.
orderOptionRequest.AttributeLogicalName = "address1_addresstypecode"
orderOptionRequest.EntityLogicalName = EntityName.contact.ToString()

' Set the order for the options.
orderOptionRequest.Values = New Integer() { 4, 3, 2, 1 }

' Execute the request.
Dim orderOptionResponse As OrderOptionResponse = CType(metadataService.Execute(orderOptionRequest), OrderOptionResponse)

See Also

Concepts

Reference


© 2010 Microsoft Corporation. All rights reserved.


Show:
© 2015 Microsoft