Compartilhar via


formContext.data.process (referência da API do Cliente)

Fornece eventos, métodos e objetos para interagir com os dados de fluxo do processo empresarial em um formulário. Consulte formContext.ui.process (referência da API do Cliente) para obter métodos para interagir com o controle de fluxo do processo empresarial no formulário.

Processar eventos e métodos de manipulador de eventos

Use os seguintes eventos e métodos de manipulador de eventos para gravar scripts para fluxos de processo de negócios.

Event Métodos de manipulador de eventos
OnPreProcessStatusChange addOnPreProcessStatusChange
removeOnPreProcessStatusChange
OnProcessStatusChange addOnProcessStatusChange
removeOnProcessStatusChange
OnPreStageChange addOnPreStageChange
removeOnPreStageChange
OnStageChange addOnStageChange
removeOnStageChange
OnStageSelected addOnStageSelected
removeOnStageSelected

Métodos do Processo Ativo

Use esses métodos para recuperar informações sobre o processo ativo e definir um processo diferente como o processo ativo.

Nome Description
getActiveProcess Retorna um objeto Process que representa o processo ativo.
setActiveProcess Define um processo como o processo ativo.

Métodos de processo

Um processo contém os dados de um fluxo de processo empresarial. Use os métodos para acessar as propriedades do processo.

Nome Description
Getid Retorna o identificador exclusivo do processo.
getName Retorna o nome do processo.
getStages Retorna uma coleção de estágios no processo.
isRendered Retorna um valor booliano que indica se o processo é renderizado.

Métodos ProcessInstance

Use esses métodos para recuperar informações sobre todas as instâncias de processo de um registro e definir uma instância de processo como a instância ativa.

Nome Description
getProcessInstances Retorna todas as instâncias de processo para o registro de tabela ao qual o usuário que está chamando tem acesso.
setActiveProcessInstance Define uma instância de processo como a instância ativa.

Métodos de instância

Uma instância de processo contém os dados de uma instância do fluxo de processo empresarial. Use os métodos para acessar as propriedades da instância do processo.

Nome Description
getInstanceId Retorna o identificador exclusivo da instância do processo.
getInstanceName Retorna o nome da instância do processo.
getStatus Retorna o status atual da instância do processo.
setStatus Define o status atual da instância do processo ativo.

Métodos de Estágio Ativo

Use esses métodos para recuperar informações sobre o estágio ativo e definir um estágio diferente como o estágio ativo.

Nome Description
getActiveStage Retorna um objeto Stage que representa o estágio ativo.
setActiveStage Define um estágio concluído como o estágio ativo.

Métodos de estágio

Um estágio contém os dados de um estágio em um fluxo de processo de negócios. Use os métodos para acessar as propriedades do estágio.

Nome Description
getCategory Retorna um objeto com um método getValue que retornará o valor inteiro da categoria de fluxo de processo empresarial.
getEntityName Retorna o nome lógico da tabela associada ao estágio.
Getid Retorna o identificador exclusivo do estágio.
getName Retorna o nome do estágio.
getNavigationBehavior Retorna um objeto de comportamento de navegação para um estágio que pode ser usado para definir se o botão Criar está disponível para os usuários criarem outro registro de tabela em um cenário de navegação de fluxo de processo comercial entre tabelas.
getStatus Retorna o status do estágio.
getSteps Retorna uma coleção de etapas no estágio.

Métodos de etapa

Uma etapa contém os dados de uma etapa em um estágio em um fluxo de processo de negócios. Use os métodos para acessar as propriedades da etapa.

Nome Description
getAttribute Retorna o nome lógico da coluna associada à etapa.
getName Retorna o nome da etapa.
getProgress Retorna o progresso da etapa de ação.
isRequired Retorna um valor booliano que indica se a etapa é necessária no fluxo do processo de negócios.
setProgress Atualiza o progresso da etapa de ação.

Use esses métodos para passar para os estágios seguintes e anteriores. Ambos os métodos farão com que o evento OnStageChange ocorra.

Nome Description
moveNext Progride para o próximo estágio.
movePrevious Move para o estágio anterior.

Outros métodos úteis

Use esses métodos para encontrar informações sobre os estágios no caminho ativo, processos habilitados e estágio selecionado.

Nome Description
getActivePath Obtém uma coleção de estágios atualmente no caminho ativo com métodos para interagir com os estágios exibidos no controle de fluxo do processo empresarial.
getEnabledProcesses Recupera de forma assíncrona os fluxos de processo de negócios habilitados para uma tabela para a qual o usuário atual pode alternar.
getSelectedStage Obtém o estágio selecionado no momento.

formContext.ui.process (referência da API do Cliente)
Entender o modelo de objeto Xrm
Controles (referência da API do cliente)