IOrganizationService.Execute Method

  • Article

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

Executes a message in the form of a request, and returns a response.

Namespace: Microsoft.Xrm.Sdk
Assembly: Microsoft.Xrm.Sdk (in Microsoft.Xrm.Sdk.dll)

Syntax

'Declaration
<OperationContractAttribute> _
<FaultContractAttribute(GetType(OrganizationServiceFault))> _
Function Execute ( _
    request As OrganizationRequest _
) As OrganizationResponse

[OperationContractAttribute] 
[FaultContractAttribute(typeof(OrganizationServiceFault))] 
OrganizationResponse Execute (
    OrganizationRequest request
)

Parameters

  • request
    Type: OrganizationRequest. A request instance that defines the action to be performed.

Return Value

Type: OrganizationResponse
The response from the request. You must cast the return value of this method to the specific instance of the response that corresponds to the Request parameter.

Example

The following example shows how to use the Execute method to assign a queue to a team (early bound). For this sample to work correctly, you must be connected to the server to get an IOrganizationService interface. You can find the complete sample in the sample code package in the folder SampleCode\CS\BusinessDataModel\BusinessManagement\AssignRecordToTeam.cs.

The following example shows how to use the Execute method to assign a queue to a team (late bound). For this sample to work correctly, you must be connected to the server to get an IOrganizationService interface. You can find the complete sample in the sample code package in the folder SampleCode\CS\GeneralProgramming\LateBound\AssignQueueToTeamDE.cs.

// The queue ID would typically be passed in as an argument or determined by a query.
// The team ID would typically be passed in as an argument or determined by a query.
// Assign the queue to a team.
AssignRequest assignRequest = new AssignRequest()
{
    Assignee = new EntityReference
    {
        LogicalName = "team",
        Id = _teamId
    },

    Target = new EntityReference("queue", _queueId)
};

_service.Execute(assignRequest);

' The queue ID would typically be passed in as an argument or determined by a query.
' The team ID would typically be passed in as an argument or determined by a query.
' Assign the queue to a team.
Dim assignRequest As New AssignRequest() With {.Assignee = New EntityReference With { _
        .LogicalName = "team", .Id = _teamId}, .Target = New EntityReference("queue", _queueId)}

_service.Execute(assignRequest)

Remarks

Privileges and Access Rights

To execute the message, the caller must have the necessary privileges to the entity type that is specified in the request class. The caller must also have access rights on the specified records in the request class. For more information, see the Request class for the action you want to execute. For example, see AssignRequest.

Notes for Callers

For more information about the exceptions that can be thrown when this method is called, see Handle Exceptions in Your Code.

Method Availability

This method works regardless whether the caller is connected to the server or offline.

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

IOrganizationService Interface
IOrganizationService Members
Microsoft.Xrm.Sdk Namespace

Other Resources

Use Messages (Request and Response Classes) with the Execute Method
The Security Model of Dynamics CRM
Privileges by Message
Privileges by Entity
Handle Exceptions in Your Code
Troubleshooting and Error Handling

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