Executar operações especializadas usando Atualização

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

Antes desta versão, as mensagens especializadas eram exigidas para a atualização de determinados valores de atributo de entidade. Nesta versão, 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.

*<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 a API do SDK e facilita a codificação de ferramentas de integração de dados padrão usadas com o Dynamics CRM. 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. No entanto, a API da Web que eventualmente substituirá o ponto de extremidade 2011 oferece suporte somente à mensagem de Atualização 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 Visualização da API da Web 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
Gravar fluxos de trabalho para automatizar processos empresariais

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais