Compartir a través de


Realizar operaciones especializadas con Actualizar

 

Publicado: noviembre de 2016

Se aplica a: Dynamics CRM 2015

Antes de esta versión, se requerían mensajes especializados para actualizar determinados valores de atributo de la entidad. En esta versión, UpdateRequest se puede utilizar ahora para establecer estos atributos. La siguiente tabla identifica las solicitudes de mensaje obsoletas especializadas y los atributos de mensaje relacionados que se pueden actualizar mediante UpdateRequest.

Solicitud de mensaje obsoleta

Atributo para actualizar

AssignRequest

<entidad>.OwnerId*

SetStateRequest

<entidad>.StateCode*

Importante

Para las entidades SLA y RoutingRule, cambiar OwnerId y StateCode en una sola invocación de mensaje Update no se admite y produce una excepción.

SetParentSystemUserRequest

SystemUser.ParentSystemUserId

SetParentTeamRequest

Team.BusinessUnitId

SetParentBusinessUnitRequest

BusinessUnit.ParentBusinessUnitId

SetBusinessEquipmentRequest

Equipment.BusinessUnitId

SetBusinessSystemUserRequest

SystemUser.BusinessUnitId

*<entidad> hace referencia a cualquier entidad que proporcione este atributo.

Nota

En las organizaciones de Microsoft Dynamics CRM Online, esta característica solo está disponible si su organización se ha actualizado a la Actualización 1 de Dynamics CRM Online 2015. Esta característica no está disponible para Dynamics CRM (local).

Estos mensajes especializados continuarán funcionando con el extremo 2011. Sin embargo, se recomienda usar el método UpdateRequest o Update si es posible para establecer estos atributos. El mensaje Update simplifica la SDK API y facilita la codificación de herramientas de integración de datos estándar usadas con Dynamics CRM. Además, es más fácil la codificación y el registro de un complemento para ejecutar para un único mensaje Update en lugar de varios mensajes especializados. La propiedad AttributeMetadata.IsValidForUpdate para los atributos indicados arriba ha cambiado a true en esta versión para habilitar esta característica.

Puede seguir usando estos mensajes especializados del extremo 2011 en su código. Sin embargo, la API Web que reemplaza eventualmente el extremo 2011 sólo admite el mensaje Actualizar para estos tipos de operaciones. Si desea obtener una ventaja en el cambio del código para alinearse con la API Web, puede hacerlo ahora. Vea Vista previa de API Web para más información.

Impacto de este cambio en los complementos

Cuando se procesan solicitudes de actualización que incluyen campos de propietario más otros campos estándar para entidades propiedad de negocio, los complementos registrados para el mensaje Update en la fase de canalización 20 y/o la fase 40 se ejecutan una vez para todos los campos que no son de propietario, y después una vez para los campos de propietario. Los ejemplos de campos de propietario serían businessunit y manager (para una entidad SystemUser ). Los ejemplos de entidades propiedad de negocio incluyen SystemUser, BusinessUnit, Equipment, y Team.

Cuando se procesan solicitudes de actualización que incluyen campos de estado más otros campos estándar para entidades propiedad de negocio, los complementos registrados para el mensaje Update en la fase de canalización 20 y/o la fase 40 se ejecutan una vez para todos los campos que no son de estado, y después una vez para los campos de estado.

Para que el código del complemento reciba todos los de datos de la actualización, debe registrar el complemento en la fase 10 y después almacenar información relevante en SharedVariables en el contexto del complemento para que complementos posteriores (en la canalización) para lo consuman.

Impacto de este cambio en los flujos de trabajo

Cuando se procesan solicitudes de actualización que incluyen campos de propietario más otros campos estándar para entidades propiedad de negocio, los flujos de trabajo registrados para el mensaje Update se ejecutan una vez para todos los campos que no son de propietario, y después una vez para los campos de propietario. Los flujos de trabajo registrados para el mensaje Assign por los usuarios se siguen desencadenando mediante actualizaciones en los campos de propietario.

Cuando se procesan solicitudes de actualización que incluyen campos de estado más otros campos estándar para entidades propiedad de negocio, los flujos de trabajo registrados para el mensaje Update se ejecutan una vez para todos los campos que no son de estado, y después una vez para los campos de estado. Los flujos de trabajo registrados para el paso Cambiar estado se siguen desencadenando mediante actualizaciones en los campos de estado.

Ver también

Escriba complementos para ampliar los procesos de negocio
Escribir flujos de trabajo para automatizar procesos de negocios

© 2017 Microsoft. Todos los derechos reservados. Copyright