onPreProcessStatusChange-Ereignis (Client-API-Referenz)

Gilt für Dynamics 365 (online), Version 9.x.

Dieses Ereignis tritt auf, bevor der Status einer Prozessinstanz wechselt.

Verwenden Sie die formContext.data.process.addOnPreProcessStatusChange-Methode, um Ereignishandler für dieses Ereignis hinzuzufügen, und die formContext.data.process.removeOnPreProcessStatusChange-Methode, um diese zu entfernen.

Über ein Webressourcenskript, das für das onPreProcessStatusChange-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 Statusänderung wird nicht verarbeitet. Die Prozessinstanz bleibt in der ursprünglichen Phase im Originalzustand.
• Die Speichern des Hauptformulars wird nicht verarbeitet. Wenn das Hauptformular in einem geänderten Status war, bleibt es im geänderten Status.
• Webressourcen mit onProcessStatusChange-Registrierung werden nicht aufgerufen.

Diese Client-API wird nur im einheitlichen Client unterstützt. Der Vorgängerwebclient unterstützt diese Client-API nicht.

Unterstütze Möglichkeiten für das Ereignis

• formContext.data.process.addOnPreProcessStatusChange-Methode zum Hinzufügen von Ereignishandlern für dieses Ereignis.
• formContext.data.process.removeOnPreProcessStatusChange-Methode, um Ereignishandler für dieses 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).