Compartilhar via


setActiveProcess (referência da API do cliente)

Define um processo como o processo ativo.

Se o processo empresarial 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 houver 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 setActiveProcess método para definir o processo ativo para um fluxo de processo empresarial em vez de processId e processInstanceId com Xrm.Navigation.openForm o 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 A ID do processo a ser definido como o processo ativo.
callbackFunction Função Não Uma função a ser chamada quando a operação for concluída. Essa função de retorno de chamada é passada 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: a processId não é válida ou o processo não está habilitado.

getActiveProcess
setActiveProcessInstance
formContext.data.process