Událost OnPreStageChange (reference k rozhraní API klienta)

K této události dochází před fází změny řízení toku obchodního procesu. K této události dochází poté, co uživatel vybere další fázi, přesunout do předchozí fáze nebo nastavit tlačítka Aktivní fáze v uživatelském rozhraní nebo když vývojář použije formContext.data.process.moveNext, formContext.data.process.movePreviousnebo formContext.data.process.setActiveStage metody.

Poznámka:

Událost OnPreStageChange je podporována pouze u sjednoceného rozhraní.

V rámci skriptu webového prostředku zaregistrovaného do události onPreStageChange může vývojář vyvolat následující kód u objektu executionContext předaného do skriptu webového prostředku:

executionContext.getEventArgs().preventDefault();

Při volání preventDefault:

  • Navigace ve fázi nebude zpracována. Instance procesu zůstane v původní fázi.
  • V navigaci mezi tabulkami se formulář tabulky cílové fáze neotevře.
  • Uložení hlavního formuláře nebude zpracováno. Pokud by hlavní forma byla ve špinavém stavu, zůstala by ve špinavém stavu.
  • Žádné webové prostředky, které zaregistrovaly onStageChange, nebudou vyvolány.

Objekt kontextu spuštění se předává obslužným rutinům událostí pro tuto událost. Pomocí metody getEventArgs můžete načíst objekt, který má následující metody:

  • getDirection: Vrátí řetězec, který je buď nebo NextPrevious zobrazit směr změny fáze.
  • getStage: Vrátí objekt fáze. Kromě případu, kdy se navigace přesune do nové tabulky, představuje vrácená fáze objekt cílové fáze – tedy další aktivní fázi. Když se navigace přesune do nové tabulky, fáze je fáze, ze které se prochází – tj. z předchozího objektu aktivní fáze. Další informace: Metody fáze.

Podporované metody pro tuto událost

Události (reference k rozhraní API klienta)
Události ve formulářích a mřížkách v modelem řízených aplikacích