Freigeben über

Schreiben von Skripts für Geschäftsprozessflüsse

  • Artikel

 

Veröffentlicht: November 2016

Gilt für: Dynamics CRM 2015

In Microsoft Dynamics CRM 2015 und Microsoft Dynamics CRM Online 2015-Update gibt es ein clientseitiges Objekt, das Sie verwenden können, um mit Geschäftsprozessflüssen in Ihren Skripts zu interagieren. Der Xrm.Page.data-Namespace wurde erweitert und enthält Methoden unter Xrm.Page.data.process. Der Xrm.Page.ui-Namespace wurde erweitert und enthält Methoden unter Xrm.Page.ui.process.

In diesem Thema

Struktur des Geschäftsprozessflusses

Aktionen, die automatisiert werden können

Ereignisse für Geschäftsprozessflüsse

Struktur des Geschäftsprozessflusses

Geschäftsprozessflüsse bestehen aus einer Serie von Phasen, die jeweils einige Schritte enthalten. Nur eine Phase ist die aktive Phase. Wenn die erforderlichen Schritte in einer Phase vollständig sind, kann der Prozess in die nächste Phase übergehen und diese wird zur aktiven Phase. Welche Phase die nächste ist, kann auf Grundlage des Geschäftsprozessflusses festgelegt werden, wie im folgenden Diagramm gezeigt.

Geschäftsprozessfluss-Objekte

Phasen können bestimmten verknüpften Entitäten zugeordnet werden, sodass ein Geschäftsprozessfluss mehrere Entitäten umfassen kann. Der Geschäftsprozess bleibt der gleiche führt den Benutzer zu dem gewünschten Abschluss.Weitere Informationen:TechNet: Geschäftsprozessflüsse

Aktionen, die automatisiert werden können

Normalerweise hängt der Fortgang der Geschäftsprozesse von der Benutzereingabe ab. Als Entwickler können Sie dieselben Aktionen programmgesteuert in Foremularskripten ausführen.

  • Ändern Sie den Prozess, wenn mehr als ein Prozess für die Entität verfügbar ist.
    Verwenden Sie Xrm.Page.data.process.getEnabledProcesses, um Informationen zu aktivierten Prozessen zu erhalten, die der Benutzer für die Entität auswählen kann. Verwenden Sie dann Xrm.Page.data.process.setActiveProcess, um einen der aktivierten Prozesse zu dem aktiven zu machen.

  • Gehen Sie zur nächsten Phase über, wenn alle erforderlichen Schritte ausgeführt wurden, um sie zur aktuellen aktiven Phase zu machen.
    Verwenden von Xrm.Page.data.process.moveNext.

  • Gehen Sie zur vorherigen Phase und machen Sie sie zur aktuelle aktiven Phase.
    Verwenden von Xrm.Page.data.process.movePrevious.

  • Wählen Sie eine Phase aus, um den Fortschritt der Schritte in der Phase anzuzeigen.
    Verwenden Sie Xrm.Page.data.process.getActivePath, um Informationen zu den Phasen abzurufen, die abgeschlossen wurden, zur aktuellen aktiven Phase und zu gültigen Phasen, die von der aktuellen aktiven Phase aus verfügbar sind. Überprüfen Sie die Schritte, die in dieser Phase enthalten sind, und vergleichen Sie die entsprechenden Formularattributwerte, um zu bestimmen, ob sie abgeschlossen sind.

  • Einen Schritt abschließen
    Schritte werden ausgeführt, wenn die entsprechenden Daten im Formular eingegeben sind. Sie können den Typ eines Attributs feststellen, indem Sie die Schritt getAttribute-Methode verwenden. Dadurch wird der logische Name des Attributs zurückgegeben. Verwenden Sie Xrm.Page.getAttribute, um das Attribut aus der Xrm.Page.data.entity.attributes-Sammlung abzurufen, und verwenden Sie dann die Attribut setValue-Methode, um den Wert festzulegen.

  • Herausfinden, ob ein Schritt erforderlich ist
    Verwenden Sie die Schritt isRequired-Methode, um zu bestimmen, ob ein Schritt vom Geschäftsprozessfluss erfordert wird.

  • Erweitern oder Reduzieren der Geschäftsprozessflusssteuerung
    Verwenden von Xrm.Page.ui.process.setDisplayState.

Ebenso gibt es einige Aufgaben, die Sie als Entwickler ausführen können, die ein Benutzer nicht ausführen kann.

  • Die Prozesssteuerung ausblenden
    Mit Xrm.Page.ui.process. 1468bab0-f6b3-4320-a60c-a88c9d4fcf1f#BKMK_setVisible können Sie steuern, ob die Geschäftsprozessflusssteuerung angezeigt wird.

  • Überspringen zu einer gültigen Phase.
    Verwenden Sie Xrm.Page.data.process.setActiveStage um eine der gültigen Phasen für die aktuelle Entität festzulegen.

  • Die Prozessdefinition einschließlich der aktuell nicht sichtbaren Phasen abfragen
    Verwenden Sie Xrm.Page.data.process.getActiveProcess, um die Definition des Geschäftsprozessflusses abzufragen, einschließlich der Phasen, die möglicherweise aufgrund der Verzweigungslogik im Prozess nicht sichtbar sind.

Ereignisse für Geschäftsprozessflüsse

Sie können mit jedem Ereignis interagieren, das aus dem Formular mit Geschäftsprozessflüssen bereitgestellt wird, aber zwei neue Ereignisse ermöglichen es, Code basierend auf Ereignissen nur für die Geschäftsprozessflusssteuerung auszuführen. Sie können Code ausführen, wenn die aktive Phase eines Geschäftsprozessflusses sich ändert (OnStageChange-Ereignis), oder wenn eine Phase ausgewählt wird (OnStageSelected-Ereignis).

Keines dieser neuen Ereignisse stellt eine Benutzeroberfläche zum Registrieren von Ereignishandlern bereit. Sie müssen bereitgestellte Methoden verwenden, um Handler für diese Ereignisse im Formular OnLoad-Ereignis hinzuzufügen und zu entfernen.Weitere Informationen:Geschäftsprozessflusssteuerungsereignisse

Siehe auch

Verwenden des Xrm.Page-Objektmodells
Xrm.Page.data.process (clientseitige Referenz)
Beispiel: Xrm.Page.data.process.getEnabledProcesses
Beispiel: Xrm.Page.data.process.getActivePath
Geschäftsprozessflusssteuerungsereignisse
TechNet: Geschäftsprozessflüsse

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright