Orchestrierungsprozess

Lang andauernde Workflows sind Masterprojekte, die Serviceorchestrierung, menschliche Eingriffe und lang andauernde Transaktionen in Unattended-Umgebungen unterstützen.

Menschliches Eingreifen kommt ins Spiel, wenn bestimmte Prozesse menschliche Eingaben erfordern, um Ausnahmen, Genehmigungen oder Validierungen zu verarbeiten, bevor der nächste Schritt der Aktivität ausgeführt wird.

Workflowfragmentierung

Ein Workflow mit langer Ausführungszeit enthält UiPath.Persistence.Activities und kann mit Invoke Process und Aktivitäten ohne Benutzerinteraktion kombiniert werden, wodurch menschliche Aufgaben mit Roboteraufgaben koordiniert werden. Er wird in Sitzung 0 ausgeführt und gewährleistet so eine schnelle Ausführung. Bitte beachten Sie, dass das Debugging eines Orchestrierungsprozesses in einer Benutzersitzung erfolgt.

Lang andauernde Workflows können Folgendes orchestrieren:

• Hintergrundprozesse, die Aktivitäten enthalten können, die API-Aufrufe ausführen und in Sitzung 0 ausgeführt werden. Sie können mit der Aktivität Invoke Process aufgerufen werden.
• UI: Ein Prozess mit Benutzerinteraktionsaktivitäten, der über die Aktivität Start Job von Orchestrator aufgerufen und in einer Benutzersitzung ausgeführt wird.
• Human in the Loop: Der Benutzer interagiert durch Aufgaben, die das Ausfüllen von Formularen im Orchestrator erfordern. Dies impliziert die Verwendung der Aktivität Create Form Task zusammen mit Wait for Form Task und Resume.

Orchestrierungsprozessvorlage

Wechseln Sie in Studio zu Start > Orchestrierungsprozess, um die Vorlage zu öffnen, welche die standardmäßigen UiPath.Persistence.Activities- und UiPath.System.Activities-Abhängigkeiten in einem Flowchart-Workflowtyp enthält.

Die project.json -Datei der Vorlage verfügt über den Parameter supportsPersistence: true , der angibt, dass die Prozessausführung nach Abschluss der Aufgabe fortgesetzt wird.

Der Parameter requiresUserInteraction: false gibt an, dass dieser Workflow keine Benutzerinteraktionsaktivitäten enthält, ähnlich wie ein Hintergrundprozess.

Es wird nicht empfohlen, Parameter in der project.json-Datei manuell zu ändern.

Ein Prozess kann aus dem Fenster Projekteinstellungen in einen Orchestrierungsprozess umgewandelt werden, indem der Umschalter Unterstützt Persistenz auf Jagesetzt wird.

Snippets für Orchestrierungsprozesse

Zum Einstieg enthält das Panel Snippets eine Reihe von Workflow-Snippets, mit denen Sie einen Orchestrierungsprozess erstellen können.

Erstellen eines Orchestrierungsprozesses

Führen Sie die folgenden Schritte aus, um Aktivitäten, die Teil des UiPath.Persistence.Activities-Pakets sind, zu koppeln und Ihren eigenen Orchestrierungsprozess zu erstellen:

1. Verwenden Sie die Aktivität Add Queue Item and Get Reference, um ein Warteschlangenelement mit in-, in/out- oder out-Parametern hinzuzufügen und das entsprechende Objekt des Warteschlangenelements zu erhalten. Wenn das Warteschlangenelement verarbeitet ist, werden in der ItemInformation-Eigenschaft bereitgestellte Argumente wieder den zugeordneten Workflow-Variablen zugewiesen, wenn diese Aktivität an die Aktivität Wait for Queue Item and Resume gekoppelt ist.
   
   

   

   
   

2. Die Aktivität Wait for Queue Item and Resume muss mit den Aktivitäten „Add Queue Item“ und „Get Reference“ gekoppelt werden. Der Workflow wechselt in den Status „Angehalten“, sodass der Roboter bei dieser Aktivität auf den Abschluss eines bestimmten Warteschlangenelements wartet, bevor er mit dem nächsten Schritt im Prozess fortfährt.

   
   

   

   
   
3. Die Aktivität Start Job and Get Reference ruft andere Prozesse durch Bereitstellen von Argumenten vom Typ in, in/out oder out auf. Nach der Ausführung werden die geänderten Argumente dann wieder den Workflow-Variablen zugeordnet, wenn diese Aktivität an die Aktivität Wait for Job and Resume gekoppelt ist.
   
   

   

   
   
4. Die Aktivität Wait for Job and Resume muss mit Start Job and Get Reference gekoppelt werden, indem das von letzterer Aktivität ausgegebene Job Object bereitgestellt wird. Dadurch wird der aktuelle Prozess vorübergehend angehalten und auf den Abschluss des Referenzauftrags gewartet. Der Prozess wird fortgesetzt, sobald der Status des Referenzauftrags auf „Abgeschlossen“ aktualisiert wurde.
   
   

   

   
   

5. Verwenden Sie die Aktivität Create Form Task, um eine Aufgabe mit formularbasierter Visualisierung für menschliche Interaktionen innerhalb eines Workflows zu erstellen. Diese Formulare mit relevantem Workflow-Kontext werden den Benutzern zur Entscheidungsfindung und für andere Szenarien angeboten. Um den Formulardesigner in dieser Aktivität zu aktivieren, müssen Sie das Paket UiPath.FormActivityLibrary installieren.

   Hinweis: Wenn Sie eine Studio-Version ab 2021.4 verwenden, die mit UiPath.Persistence.Activities- und UiPath.FormActivityLibrary-Versionen vor 1.2.1 beginnt, wird das Fenster „Formulardesigner“ nicht fokussiert und Sie können mit Studio interagieren, wenn das Designerfenster geöffnet ist. Um dieses Problem zu vermeiden, stellen Sie sicher, dass die Pakete auf die neueste Version aktualisiert werden.
   
   

   

   
   
6. Die Aktivität Wait for Form Task and Resume muss mit Create Form Task gekoppelt werden, indem Task Object als Eingabe bereitgestellt wird, um den Workflow auszusetzen, bis diese bestimmte Aufgabe durch den Endbenutzer abgeschlossen wurde.
   
   

   

   
   
7. Verwenden Sie die Aktivität Resume After Delay, um die Ausführung des Workflows auszusetzen und zu einem bestimmten Datum und einer bestimmten Uhrzeit wieder aufzunehmen.
8. Führen Sie den Workflow in Studio aus. Immer wenn der Roboter eine Aktivität mit langer Ausführungszeit ausführt, wechselt Studio in den schreibgeschützten Zustand, wobei die Option Fortsetzen im Menüband aktiviert ist. Zum Fortfahren schließen Sie die zugrunde liegende Aufgabe, das Element oder den Auftrag in der Warteschlange ab und klicken auf Fortsetzen.

Best Practices

• Aktivitäten mit langer Ausführungszeit („Wait and Resume“-Aktivitäten), die Teil des UiPath.Persistence.Activities-Pakets sind, können nur in einem Orchestrierungsprozess-Einstiegspunkt – der als Main.xaml gekennzeichneten Datei – verwendet werden.
• Auf wiederverwendbare Komponenten, die auf einem Orchestrierungsprozess basieren, kann nur innerhalb eines anderen Orchestrierungsprozesses verwiesen werden.
• Wenn ein Workflow mit langer Ausführungszeit an die Warteschlangenverarbeitung angehängt ist und sich der Workflow im Status „Angehalten“ befindet, verbleibt das Warteschlangenelement auch nach 24 Stunden im Status „In Bearbeitung“, bis der Workflow bei der Wiederaufnahme den Transaktionsstatus setzt. Bezeichner der Warteschlangenelemente sind Teil des persistierten Workflow-Kontextes, wenn sie im gleichen Scope der „Wait and Resume“-Aktivitäten enthalten sind.

• Persistenzpunkte (Wait- und Resume-Aktivitäten) dürfen nicht innerhalb des Texts einer Für jede-Aktivität verwendet werden, da sie den Workflow nach dem Ausführen der ersten Iteration anhalten. Dies ist möglicherweise nicht das gewünschte Verhalten.

  Alternativ können Sie Schleifen mit Persistenzaktivitäten verwenden, z. B. die Aktivität Parallel für jeden. Bitte beachten Sie, dass die maximale Anzahl von Resume-Triggern pro Auftrag standardmäßig auf 1.000 begrenzt ist.

• Lang andauernde Workflows können in jedem verfügbaren Roboter desselben Typs wie dem, der einen Auftrag (z. B. unattended oder außerhalb der Produktion) in derselben Umgebung oder demselben Ordner angehalten hat, wieder aufgenommen werden, sodass lokale Ressourcen, die für die Ausführung erforderlich sind, auch nach Persistenzpunkten verfügbar sein müssen.
• Alle Variablen, die im Scope einer Aktivität mit langer Ausführungszeit verwendet werden, müssen serialisierbar sein. Die auf dieser Seite aufgeführten Variablentypen sind serialisierbar: „Text“, „True or False“, „Number“, „Array“, „Date“ und „Time“. Datentabellen- und GenericValue-Variablen.
• Nicht serialisierbare Datentypen können in getrennten Sequence-Scopes im selben Workflow oder durch den Aufruf anderer Dateien verwendet werden, solange sie sich zwischen Warte- und Fortsetzungsaktivitäten wie Wait for Job and Resume, Wait for Queue Item and Resume und Wait for Form Task and Resume befinden.
• Berücksichtigen Sie, dass einige Eigenschaften von Objekten, die von Aktivitäten mit langer Ausführungszeit generiert wurden, nicht im Lokal-Panel ausgewertet werden können.

• Implementieren Sie eine geeignete Batchverarbeitung in Workflows, die eine hohe Anzahl von Aktionen pro Auftrag erwarten. Bitte beachten Sie, dass es ein Standardlimit von 1.000 Aktionen (oder anderen Auftragstriggern) gibt, auf die ein Auftrag gleichzeitig warten kann.

  Hinweis: Die Delay- und Retry Scope-Aktivitäten werden nicht unterstützt und funktionieren nicht ordnungsgemäß, wenn sie im Hauptworkflow eines Orchestrierungsprozesses verwendet werden. In solchen Fällen sollten sie in eine No Persistence Scope-Aktivität gesetzt werden.