Criar scripts para fluxos de processos de negócios

 

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

Com o Atualização do Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015 há um objeto do cliente que você pode usar para interagir com os fluxos de processos de negócios em seus scripts. O namespace Xrm.Page.data é estendido para incluir métodos em Xrm.Page.data.process. O namespace Xrm.Page.ui é estendido para incluir métodos em Xrm.Page.ui.process.

Neste tópico

Estrutura dos fluxos do processo empresarial

Ações que podem ser automatizadas

Eventos para fluxos do processo empresarial

Estrutura dos fluxos do processo empresarial

Os fluxos de processo empresarial consistem em uma série de etapas, contendo várias etapas. Somente um estágio é o estágio ativo. Quando as etapas necessárias em cada estágio são concluídas, o processo pode prosseguir para o próximo estágio e o estágio se torna ativo. Qual é o próximo estágio pode ser definido com base nas condições no fluxo de processo empresarial conforme mostrado no diagrama a seguir.

Os estágios podem ser associados às entidades relacionadas específicas, portanto, um fluxo de processo corporativo pode medir várias entidades. O processo empresarial permanecerá o mesmo e leva o usuário para um término desejado.Para obter mais informações:TechNet: Fluxos do processo de negócios

Ações que podem ser automatizadas

Geralmente, progredir no processo empresarial depende da entrada do usuário. Como um desenvolvedor, você pode executar as mesmas ações de forma programática em scripts de formulário.

• Alterar o processo quando há mais de um processo disponível para a entidade.
  Use Xrm.Page.data.process. getEnabledProcesses para recuperar informações sobre todos os processos habilitados que o usuário pode optar para a entidade. Use Xrm.Page.data.process. setActiveProcess para especificar um dos processos habilitados como ativo.

• Mover para o próximo estágio em que as todas as etapas necessárias são concluídas para tornar o estágio atual ativo.
  Usar Xrm.Page.data.process. moveNext

• Mover para o estágio anterior e torná-lo o estágio atual ativo.
  Usar Xrm.Page.data.process. movePrevious

• Selecione um estágio para exibir o status das etapas no estágio.
  Use Xrm.Page.data.process. getActivePath para recuperar informações sobre estágios que foram concluídos, o estágio atual ativo e os estágios disponíveis válidos do estágio ativo atual. Examine as etapas incluídas no estágio e compare os valores de atributo do formulário correspondente para determinar se foram concluídos.

• Concluir uma etapa
  As etapas são concluídas quando os dados correspondentes são inseridos no formulário. Você pode determinar o atributo usando a etapa do método getAttribute. Isso retornará o nome lógico do atributo. Use Xrm.Page.getAttribute para recuperar o atributo de conjunto de Xrm.Page.data.entity.attributes e use o método do método setValue para definir o valor.

• Detecte se uma etapa é necessária
  Use o método da etapa isRequired para determinar se uma etapa é exigida pelo fluxo de processos empresarial.

• Expandir ou recolher o controle do fluxo de processo empresarial
  Usar Xrm.Page.ui.process.setDisplayState

Também há algumas considerações que você pode fazer como um desenvolvedor que um usuário não pode executar.

• Ocultar o controle de processo
  Use Xrm.Page.ui.process. 1468bab0-f6b3-4320-a60c-a88c9d4fcf1f#BKMK_setVisible, você poderá controlar se exibir o controle de fluxo do processo empresarial.

• Pular para um estágio concluído válido.
  Use Xrm.Page.data.process. setActiveStagepara configurar um dos estágios concluídos válidos para a entidade atual.

• Consulte a definição de processo incluindo os estágios não visíveis atualmente
  Use Xrm.Page.data.process.getActiveProcess para consultar a definição de fluxo de processos empresarial, incluindo os estágios que não podem ser vistos devido à lógica de ramificação no processo.

Eventos para fluxos do processo empresarial

Você pode interagir com qualquer evento fornecido pelo formulário com fluxos de processos empresariais, mas dois novos eventos permitem executar o código com base em eventos somente para o controle de fluxo do processo empresarial. Você pode executar o código quando o estágio ativo do fluxo do processo empresarial mudar (Evento OnStageChange) ou quando um estágio é selecionado (Evento OnStageSelected).

Nenhum destes novos eventos oferece uma interface do usuário para registrar os manipuladores de eventos. Você deve usar métodos fornecidos para adicionar ou remover manipuladores para estes eventos no evento de formulário OnLoad.Para obter mais informações:Eventos de controle do fluxo do processo empresarial

Confira Também

Use o modelo de objeto Xrm.Page
Xrm.Page.data.process (referência do cliente)
Exemplo: Xrm.Page.data.process.getEnabledProcesses
Exemplo: Xrm.Page.data.process.getActivePath
Eventos de controle do fluxo do processo empresarial
TechNet: Fluxos do processo de negócios

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais