Partilhar via


Executar operações especializadas usando Atualização

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Antes da Atualização 1 do Microsoft Dynamics CRM Online 2015, as mensagens especializadas eram exigidas para a atualização de determinados valores de atributo de entidade. Agora UpdateRequest pode ser usado para definir estes atributos. A tabela a seguir identifica as solicitações de mensagem preterida especializadas e os atributos de mensagem relacionados que podem ser atualizados usando UpdateRequest.

Solicitação de mensagem preterida

Atributo a ser atualizado

AssignRequest

<entidade>.OwnerId*

SetStateRequest

<entidade>.StateCode*

Importante

Para entidades SLA e RoutingRule, changing o OwnerId e StateCode em uma única mensagem de Atualização não tem suporte e resulta em uma exceção.

SetParentSystemUserRequest

SystemUser.ParentSystemUserId

SetParentTeamRequest

Team.BusinessUnitId

SetParentBusinessUnitRequest

BusinessUnit.ParentBusinessUnitId

SetBusinessEquipmentRequest

Equipment.BusinessUnitId

SetBusinessSystemUserRequest

SystemUser.BusinessUnitId

*<entidade> refere-se a qualquer entidade que fornece esse atributo.

Essas mensagens especializadas continuarão a funcionar com o ponto de extremidade 2011. Entretanto, a recomendação é usar o método UpdateRequest ou Update quando possível para definir esses atributos. A mensagem Update simplifica o serviço da organização e facilita a codificação de ferramentas de integração de dados padrão usadas com o Dynamics 365. Além disso, é mais fácil codificar e registrar um plug-in a ser executado para uma única mensagem Atualizar em vez de várias mensagens especializadas. A propriedade AttributeMetadata.IsValidForUpdate dos atributos listados acima foi alterada para true nesta versão para habilitar este recurso.

Você pode continuar a usar essas mensagens especializadas do ponto de extremidade 2011 em seu código. Entretanto, a API da Web que acabará substituindo o serviço da organização dá suporte somente à mensagem Atualizar para esses tipos de operações. Se você quiser obter uma vantagem competitiva na alteração de seu código para alinhá-lo à API da Web, agora pode fazer isso. Consulte Use a API da Web do Microsoft Dynamics 365 para obter mais informações.

Impacto desta alteração em plug-ins

Quando as solicitações de atualizações são processadas e incluem os campos do proprietário além de outros campos padrão para entidades de propriedade da empresa, os plug-ins registrados para a mensagem Atualizar no pipeline estágio 20 e/ou estágio 40 são executados uma vez para todos os campos diferentes de proprietário e então uma vez para os campos de proprietário. Exemplos de campos de proprietário seriam businessunit e manager (para uma entidade SystemUser). Exemplos de entidades de propriedade de empresa incluem SystemUser, BusinessUnit, Equipment e Team.

Quando as solicitações de atualizações são processadas e incluem os campos estado/status além de outros campos padrão, os plug-ins registrados para a mensagem Atualizar no pipeline estágio 20 e/ou estágio 40 são executados uma vez para todos os campos diferentes de estado/status e então uma vez para os campos de estado/status.

Para que o código de plug-in receba as alterações de dados completas da atualização, você deverá registrar o plug-in no estágio 10 e então armazenar as informações relevantes no SharedVariables no contexto de plug-in para os plug-ins posteriores (no pipeline) para consumir.

Impacto desta alteração em fluxos de trabalho

Quando as solicitações de atualizações são processadas e incluem os campos do proprietário além de outros campos padrão, os fluxos de trabalho registrados para a mensagem Atualizar serão executados uma vez para todos os campos diferentes de proprietário e então uma vez para os campos de proprietário. Os fluxos de trabalho registrados por usuários na mensagem Atribuir continuam a ser disparados por atualizações para campos de proprietário.

Quando as solicitações de atualizações são processadas e incluem os campos de estado/status além de outros campos padrão, os fluxos de trabalho registrados para a mensagem Atualizar serão executados uma vez para todos os campos diferentes de estado/status e então uma vez para os campos de estado/status. Os fluxos de trabalho registrados para a etapa Alterar Status continuam a ser disparados por atualizações para campos de estado/status.

Confira Também

Crie plug-ins para ampliar os processos empresariais
Automatizar processos empresariais usando o processo do Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais