setActiveProcess (справочник по API клиента)

Задает процесс в качестве активного процесса.

Если бизнес-процесс, заданный как активный, уже имеет экземпляр, экземпляр будет помечен как активный, а первичная форма записи будет перезагружена, чтобы отобразить ее. Если для процесса нет экземпляра, создается новый экземпляр, помеченный как активный, и первичная форма записи будет перезагружена, чтобы отобразить ее.

Если существует несколько экземпляров процесса, один из них будет выбран в зависимости от логики по умолчанию, которую необходимо пометить как активный. Как правило, это последний используемый экземпляр процесса текущим пользователем.

Замечание

• Метод setActiveProcess следует использовать при создании или редактировании записи. setActiveProcess Используйте метод, чтобы задать активный процесс для потока бизнес-процессов вместо processId метода.processInstanceIdXrm.Navigation.openForm
• Метод setActiveProcess перезагрузит форму, и все несохраненные данные будут потеряны.

Синтаксис

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

Параметр

Имя	Тип	Обязательно	Description
processId	String	Да	Идентификатор процесса, заданного в качестве активного процесса.
callbackFunction	Функция	нет	Функция, вызываемая при завершении операции. Эта функция обратного вызова передает одно из следующих строковых значений, чтобы указать, выполнена ли операция успешно. - success: операция выполнена успешно. - invalid: идентификатор процесса недействителен или процесс не включен.

Связанные статьи

getActiveProcess
setActiveProcessInstance
formContext.data.process