Clase de IsValidStateTransitionRequest

Artículo
12/03/2014

Se aplica a: CRM 2015 on-prem, CRM Online

Contains the data that is needed to validate the state transition.

Espacio de nombres: Microsoft.Crm.Sdk.Messages
Ensamblado: Microsoft.Crm.Sdk.Proxy (en Microsoft.Crm.Sdk.Proxy.dll)

Sintaxis

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

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

Ejemplo

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.

// Create an EntityReference to represent an open case
EntityReference caseReference = new EntityReference()
{
    LogicalName = Incident.EntityLogicalName,
    Id = _caseIncidentId
};

IsValidStateTransitionRequest checkState = 
    new IsValidStateTransitionRequest();

// Set the transition request to an open case
checkState.Entity = caseReference;

// Check to see if a new state of "resolved" and 
// a new status of "problem solved" are valid
checkState.NewState = IncidentState.Resolved.ToString();
checkState.NewStatus = (int)incident_statuscode.ProblemSolved;

// Execute the request
IsValidStateTransitionResponse checkStateResponse = 
    (IsValidStateTransitionResponse)_serviceProxy.Execute(checkState);

Comentarios

Message Availability

Este mensaje funciona independientemente de si el autor de la llamada está conectado al servidor o no.

Usage

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

Privileges and Access Rights

To perform this action, the caller must have privileges on the specified entity in the Entity property and access rights on the specified record in the Entity property. For a complete list of the required privileges, see IsValidStateTransition Privileges.

Notes for Callers

If an incident (case) or opportunity is already closed or canceled, or if an incident (case) has open activities, an exception is thrown.

Supported Entities

La siguiente tabla muestra las entidades predeterminadas que admiten este mensaje. Para las entidades enumeradas de este mensaje, la columna Disponibilidad muestra Servidor si el autor de la llamada debe estar conectado al servidor, y Ambos si el autor de la llamada puede estar conectado o desconectado.

Entity	Availability
Incident	2 (Both)
msdyn_PostAlbum	2 (Both)
msdyn_PostConfig	2 (Both)
msdyn_PostRuleConfig	2 (Both)
msdyn_wallsavedquery	2 (Both)
msdyn_wallsavedqueryusersettings	2 (Both)
Opportunity	2 (Both)

Jerarquía heredada

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

Seguridad de hilo

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para el hilo. No se garantiza que los miembros de instancia sean seguros para el hilo.

Plataformas

Plataformas de desarrollo

Windows Vista, Windows Server 2003 y

Plataformas de destino

Windows Vista,Windows XP

Change History

Vea también

Referencia

Miembros de IsValidStateTransitionRequest
Espacio de nombres de Microsoft.Crm.Sdk.Messages
IsValidStateTransitionResponse

Otros recursos

Opportunity Entities
Incident (Case) Entities
IsValidStateTransition Privileges
Sample: Validate Record State and Set State of the Record
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

Compartir a través de