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 |
|---|---|
<entidade>.OwnerId* |
|
<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. |
|
SystemUser.ParentSystemUserId |
|
Team.BusinessUnitId |
|
BusinessUnit.ParentBusinessUnitId |
|
Equipment.BusinessUnitId |
|
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