Realizar operaciones especializadas con Actualizar

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Antes de Actualización 1 de Microsoft Dynamics CRM Online 2015, se requerían mensajes especializados para actualizar determinados valores de atributo de la entidad. Ahora, 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.

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 el servicio de organización y facilita la codificación de herramientas de integración de datos estándar usadas con Dynamics 365. 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 servicio de organización solo admite el mensaje Update 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. Para obtener más información, vea Use la API web de Microsoft Dynamics 365.

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
Automatizar procesos de negocio mediante proceso de Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright