Beispiel: Verwenden von Geschäftsprozessflüssen

Dieses Beispiel veranschaulicht, wie das programmgesteuert mit Geschäftsprozessflüssen wie das Abrufen der Geschäftsprozessflussinstanzen für eine Tabellenzeile, das Abrufen des aktiven Pfads für eine Geschäftsprozessflussinstanz und die Prozessphasen und das Ändern der aktiven Phase gearbeitet werden kann. Informationen zu diesen Konzepten finden Sie unter Arbeiten mit Geschäftsprozessflüssen mittels Code

Dieses Beispiel kann heruntergeladen werden von Beispiel: Arbeiten mit Geschäftsprozessflüssen.

Anforderungen

Bevor Sie das Beispiel ausführen können:

  1. Lassen Sie sich den Zugriff auf eine Dataverse-Umgebung zuweisen.

  2. Sie müssen die erforderlichen Berechtigungen für die Lead-, Verkaufschancen- und Workflowtabellen und die Tabellenzeilen der Geschäftsprozessflussdefinition haben, die in diesem Beispiel verwendet werden.

  3. Visual Studio 2015 oder höher, um das Beispiel auszuführen.

  4. Um das Beispielprojekt herunterzuladen und die NuGet-Pakete wiederherzustellen, die im Beispielprojekt verwendet werden, ist eine Internetverbindung erforderlich.

Funktionsweise:

  1. Erstellt eine Beispielleadzeile. Erstellt automatisch eine Instanz des Geschäftsprozessflusses „Lead zu Verkaufschancen-Vertriebsprozess“ für die Leadzeile.

  2. Konvertiert die Leadzeile zu einer Verkaufschancenzeile.

  3. Ruft die Geschäftsprozessflussinstanzen ab, die der Zeile „Verkaufschancen“ mithilfe der RetrieveProcessInstances-Nachricht zugeordnet ist. Die erste Zeile in der zurückgegebenen Sammlung ist die aktive Geschäftsprozessflussinstanz für die Verkaufschancenzeile, in diesem Fall der „Lead zu Verkaufschancen-Vertriebsprozess“.

  4. Ruft den aktiven Pfad und die Prozessphasen für die „Lead zu Verkaufschancen-Vertriebsprozess“-Instanz mit der RetrieveActivePath Nachricht ab.

  5. Ruft die derzeit aktive Phase "Lead zu Verkaufschancen-Vertriebsprozess" Instanz ab und fragt den Benutzer, ob er zur nächsten Phase wechseln soll. Bei Bestätigung zum Weitergehen wird die nächste Phase im aktiven Pfad zur aktiven Phase für die "Lead zu Verkaufschancen-Vertriebsprozess" Instanz.

  6. Zuletzt fordert die Methode Sie auf, die Entitätsdatenzeilen, die bei der Beispielausführung erstellt wurden, zu löschen:

    Hier ist die Ausgabe des Beispiel:

    Beispielausgabe.

Ausführen des Beispiels

  1. Herunterladen das WorkWithBPF Visual Studio-Beispielprojekt und in einen Ordner auf dem Computer extrahieren.

  2. Suchen Sie die WorkWithBPF.sln Datei im extrahierten Ordner, und öffnen Sie sie in Visual Studio.

  3. Das Beispielprojekt verwendet die NuGet Pakete, die wiederhergestellt werden müssen, bevor sie das Beispiel ausführen können. Stellen Sie sicher, dass die automatische Wiederherstellung von NuGet Paketen in Visual Studio aktiviert ist. Weitere Informationen: Aktivieren und Deaktivieren von NuGet Paketwiederherstellung

    Alternativ wählen Sie Projekt>NuGet-Pakete verwalten und wählen Sie Widerherstellen, um den Download der im Beispiel verwendeten Pakete manuell wieder herzustellen.

  4. Drücken Sie F5 oder wählen Sie Debuggen>Debuggen starten.

  5. Wenn Sie keins der Beispiele zuvor ausgeführt haben, müssen Sie Informationen eingeben, um den Code auszuführen. Geben Sie andernfalls die Nummer für eine der Instanzen ein, die Sie zuvor eingerichtet haben.

    Eingabeaufforderung Beschreibung des Dataflows
    Einen Dynamics 365 Server-Namen und einen Port eingeben [crm.dynamics.com] Geben Sie den Namen des Dynamics 365 Server ein. Die Standardeinstellung ist Dynamics 365 (online) (crm.dynamics.com) in Nordamerika.

    Beispiel:
    crm5.dynamics.com
    Wird die Organisation in Microsoft Online Services bereitgestellt (y/n) [n] Geben Sie y ein, wenn es sich um eine Organisation handelt, die in Microsoft Online Services bereitgestellt wird. Andernfalls geben Sie n ein.
    Domäne\Benutzernamen eingeben Geben Sie Ihr Microsoft-Konto ein.
    Kennwort eingeben Geben Sie Ihr Kennwort ein. Die Zeichen werden in dem Fenster als „*“ angezeigt. Ihr Kennwort wird sicher im Microsoft Credential Manager zur späteren Wiederverwendung gespeichert.
    Organisationsnummer angeben (1-n) [1] Geben Sie aus der Liste der angezeigten Organisationen, zu denen Sie gehören, die entsprechende Nummer ein. Die Standardeinstellung ist 1 für die erste Organisation in der Liste.
  6. Das Beispiel führt die Vorgänge aus, die unter Was dieses Beispiel tut beschrieben werden, und fordert Sie möglicherweise zur Angabe weiterer Optionen auf.

  7. Wenn das Beispiel abgeschlossen ist, drücken Sie die EINGABETASTE, um das Konsolenfenster zu schließen.