AddToQueueRequest-klasse

Artikel
07/17/2015

Contains the data that is needed to move an entity record from a source queue to a destination queue.

Navneområde: Microsoft.Crm.Sdk.Messages
Assembly: Microsoft.Crm.Sdk.Proxy (i Microsoft.Crm.Sdk.Proxy.dll)

Syntaks

'Deklaration
<DataContractAttribute(Namespace:="https://schemas.microsoft.com/crm/2011/Contracts")> _
Public NotInheritable Class AddToQueueRequest
    Inherits OrganizationRequest

[DataContractAttribute(Namespace="https://schemas.microsoft.com/crm/2011/Contracts")] 
public sealed class AddToQueueRequest : OrganizationRequest

Eksempel

The following example shows how to use this message. For this sample to work correctly, you must be connected to the server to get an IOrganizationService interface. For the complete sample, see the link later in this topic.

// Move a record from a source queue to a destination queue
// by using the AddToQueue request message.
AddToQueueRequest routeRequest = new AddToQueueRequest
{
    SourceQueueId = sourceQueueId,
    Target = new EntityReference(Letter.EntityLogicalName, _letterId),
    DestinationQueueId = destinationQueueId
};

// Execute the Request
_serviceProxy.Execute(routeRequest);

Bemærkninger

Message Availability

Denne meddelelse fungerer, uanset om den kaldende har forbindelse til serveren eller arbejder offline.

Usage

Overfør en forekomst af denne klasse til Execute method, which returns an instance of the AddToQueueResponse class.

Privileges and Access Rights

To perform this action, the caller must have privileges on the Queue and QueueItem entities and on the entity that is referred to in the Target property. You must also have access rights on the source and destination queue records and on the specified record in the Target property. For a complete list of required privileges, see AddToQueue Privileges.

Notes for Callers

Specifying the SourceQueueId property is optional. If the record that is specified by the Target is not in a queue, it is added to the destination queue. If the record is already in a queue, it is moved from the queue to the destination queue. The records cannot be added to multiple queues, except for email records that have the status “Received.” However, a “Received” email record cannot be added multiple times to the same queue.

Specifying the QueueItemProperties property is optional. The minimally required data for creating a queue item is provided in the DestinationQueueId and Target properties. However, if you want to include additional data, such as who works on the case (QueueItem.WorkerId), or to add custom fields, you have to use the QueueItemProperties property.

Nedarvningshierarki

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

Sikkerhed i tråd

Alle offentlige statiske (Shared i Visual Basic) medlemmer af denne type er trådsikret. Alle medlemmer af forekomsten er ikke garanteret trådsikkerhed.

Platforme

Development Platforms

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

Target Platforms

Windows Server 2008,Windows Server 2012,Windows 7

Change History

Se også

Reference

AddToQueueRequest-medlemmer
Microsoft.Crm.Sdk.Messages-navneområde
AddToQueueResponse

Andre ressourcer

Queue Entities
Sample: Add a Record to a Queue (Early Bound)
AddToQueue Privileges
How Role-Based Security Can Be Used to Control Access to Entities In CRM
How Instance-Based Security Can Be Used to Control Access to Entity Instances (Records) In CRM

Del via