OnPreStageChange-Ereignis (Client-API-Referenz)

Dieses Ereignis tritt auf, bevor die Geschäftsprozessflusssteuerung geändert wird. Dieses Ereignis tritt auf, nachdem der Benutzer die Schaltflächen Nächste Phase, Zurück zur vorherigen Phase oder Aktive Phase festlegen auf der Benutzeroberfläche ausgewählt hat oder wenn ein Entwickler die formContext.data.process.moveNext-, formContext.data.process.movePrevious- oder formContext.data.process.setActiveStage-Methode verwendet.

Hinweis

Das OnPreStageChange-Ereignis wird nur von Einheitliche Oberfläche unterstützt.

Über ein Webressourcenskript, das für das onPreStageChange-Ereignis registriert wurde, kann ein Entwickler folgende Schritte für das executionContext-Objekt aufrufen, das an das Webressourcenskript übergeben wird:

executionContext.getEventArgs().preventDefault();

Wenn Sie preventDefault aufrufen:

• Die Statusnavigation wird nicht verarbeitet. Die Prozessinstanz bleibt in der ursprünglichen Phase.
• Bei einer tabellenübergreifenden Navigation wird das Formular der Tabelle der Zieletappe nicht geöffnet.
• Die Speichern des Hauptformulars wird nicht verarbeitet. Wenn das Hauptformular in einem geänderten Status war, bleibt es im geänderten Status.
• Webressourcen mit onStageChange-Registrierung werden nicht aufgerufen.

Ein Ausführungskontextobjekt wird an den Ereignishandlern für dieses Ereignis übergeben. Sie können die getEventArgs-Methode verwenden, um ein Objekt abzurufen, das über die folgenden Methoden verfügt:

• getDirection: Gibt eine Zeichenfolge zurück, die entweder Next oder Previous ist, um die Richtung der Phasenänderung anzuzeigen.
• getStage: Gibt ein Phasenobjekt zurück. Ausßer wenn die Navigation zu einer neuen Tabelle weitergeht, repräsentiert die zurückgegebene Phase das Zielphasenobjekt, d. h. die nächste aktive Phase. Wenn die Navigation zu einer neuen Tabelle weitergeht, ist die Phase die Phase, vob der navigiert wird, d. h. das vorige aktive Phasenobjekt. Weitere Informationen: Phasenmethoden.

Unterstütze Möglichkeiten für das Ereignis

• formContext.data.process.addOnPreStageChange-Methode, um Ereignishandler für das Ereignis hinzuzufügen.
• formContext.data.process.removeOnPreStageChange-Methode, um Ereignishandler vom Ereignis zu entfernen.

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).