Partilhar via


setActiveProcess (referência da API do cliente)

Define um Processo como o processo ativo.

Se o processo comercial que está sendo definido como ativo já tiver uma instância, a instância será marcada como ativa e o formulário de registro primário será recarregado para mostrá-la. Se nenhuma instância existir para o processo, uma nova instância será criada, marcada como ativa, e o formulário de registro primário será recarregado para mostrá-la.

Se existirem várias instâncias do processo, uma delas será escolhida de acordo com a lógica padrão a ser marcada como ativa. Normalmente, essa é a instância de processo usada mais recentemente pelo usuário atual.

Observação

  • O setActiveProcess método deve ser usado durante a criação ou edição de um registro. Use o método para definir o processo ativo para um fluxo de processo de negócios em vez de processId e processInstanceId com Xrm.Navigation.openForm o setActiveProcess método .
  • O setActiveProcess método recarregará o formulário e todos os dados não salvos serão perdidos.

Sintaxe

formContext.data.process.setActiveProcess(processId, callbackFunction);

Parâmetro

Nome Tipo Obrigatório Description
processId String Yes O Id do processo a ser definido como o processo ativo.
callbackFunction Função Não Uma função para chamar quando a operação estiver concluída. Essa função de retorno de chamada recebe um dos seguintes valores de cadeia de caracteres para indicar se a operação foi bem-sucedida:
- success: A operação foi bem sucedida.
- invalid: O processId não é válido ou o processo não está habilitado.

getActiveProcess
setActiveProcessInstance
formContext.data.process