Freigeben über


setActiveProcess (Client-API-Referenz)

Legt einen Prozess als aktiven Prozess fest.

Wenn der als aktiv festgelegte Geschäftsprozess bereits eine Instanz hat, wird die Instanz als aktiv markiert und das primäre Datensatzformular wird neu geladen, um sie anzuzeigen. Wenn für den Prozess keine Instanz vorhanden ist, wird eine neue Instanz erstellt, als aktiv markiert und das primäre Datensatzformular wird neu geladen, um es anzuzeigen.

Wenn mehrere Instanzen des Prozesses vorhanden sind, wird eine davon gemäß der Standardlogik ausgewählt, um als aktiv markiert zu werden. Normalerweise ist dies die zuletzt vom aktuellen Benutzer verwendete Prozessinstanz.

Hinweis

  • Die setActiveProcess-Methode sollte beim Erstellen oder Bearbeiten eines Datensatzes verwendet werden. Verwenden Sie die setActiveProcess-Methode zum Festlegen des aktiven Prozesses für einen Geschäftsprozessfluss anstelle von processId und processInstanceId mit der Xrm.Navigation.openForm-Methode.
  • Die setActiveProcess-Methode lädt das Formular neu und alle nicht gespeicherten Daten gehen verloren.

Syntax

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

Parameter

Name des Dataflows Type Erforderlich Beschreibung
processId String Ja Die ID der Prozessinstanz wird als aktiver Prozess festgelegt.
callbackFunction Function Nein Eine Funktion, die aufgerufen wird, wenn der Vorgang abgeschlossen ist. Dieser Rückruffunktion wird einer der folgenden Zeichenfolgenwerte übergeben, um anzuzeigen, ob der Vorgang erfolgreich war:
- success: Der Vorgang war erfolgreich.
- invalid: Die processId ist ungültig oder der Prozess wird nicht aktiviert.

getActiveProcess
setActiveProcessInstance
formContext.data.process

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).