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.
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.
Observação
Para organizações que utilizam o Microsoft Dynamics CRM Online, esse recurso só estará disponível se a sua organização tiver atualizado para a Atualização 1 do Dynamics CRM Online 2015. Este recurso não está disponível para o Dynamics CRM (local).
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