Событие OnPreStageChange (справочник по API клиента)

Это событие происходит до изменения этапа управления потоком бизнес-процессов. Это событие возникает после того, как пользователь выбирает следующий этап, перемещается на предыдущий этап или задает кнопки активного этапа в пользовательском интерфейсе или когда разработчик использует formContext.data.process.moveNextметоды , formContext.data.process.movePreviousили formContext.data.process.setActiveStage методы.

Замечание

Событие OnPreStageChange поддерживается только в едином интерфейсе.

Из скрипта веб-ресурса, зарегистрированного в событии onPreStageChange, разработчик может вызвать следующий объект executionContext, переданный в скрипт веб-ресурса:

executionContext.getEventArgs().preventDefault();

При вызове preventDefault:

  • Навигация по этапу не будет обработана. Экземпляр процесса останется на исходном этапе.
  • В перекрестной навигации форма таблицы конечного этапа не откроется.
  • Сохранение основной формы не будет обработано. Если основная форма была в грязном состоянии, она останется в грязном состоянии.
  • Любые веб-ресурсы, зарегистрированные вStageChange, не будут вызываться.

Объект контекста выполнения передается обработчикам событий для этого события. Метод getEventArgs можно использовать для получения объекта, имеющего следующие методы:

  • getDirection: возвращает строку, которая является либо NextPrevious для отображения направления изменения этапа.
  • getStage: возвращает объект этапа. Кроме того, когда навигация перемещается в новую таблицу, возвращаемый этап представляет объект конечного этапа, то есть следующий активный этап. При переходе на новую таблицу этап — это этап, из который перемещается предыдущий активный объект. Дополнительные сведения: методы этапов.

Методы, поддерживаемые для этого события

  • formContext.data.process. Метод addOnPreStageChange для добавления обработчиков событий для этого события.
  • formContext.data.process. Метод removeOnPreStageChange для удаления обработчиков событий для этого события.

События (справочник по API клиента)
События в формах и сетках в приложениях на основе моделей

  • Last updated on