UiPath Documentation
maestro
latest
false
Wichtig :
Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

Benutzerhandbuch zu Maestro

Einen einfachen Prozess implementieren

Überblick

Je nach Anwendungsfall ist der Einstieg in Maestro einfach oder etwas komplizierter. Ein einfacher Prozess könnte aus einigen miteinander verbundenen Schritten bestehen – wie dem Empfangen einer Eingabe, der Ausführung einer Automatisierung und der Rückgabe eines Ergebnisses – ideal für schnelle Machbarkeitsnachweise oder unkomplizierte Geschäftsabläufe. In diesem Abschnitt werden Sie in einen einfachen Flow eingeführt, damit Sie sich mit den Grundlagen vertraut machen können.

Dieses Handbuch zeigt, wie Sie einen einfachen Prozess implementieren, der die Kernfunktionen der Orchestrierung mit Agenten hervorhebt: Modellierung, Implementierung, Debugging, Veröffentlichung, Bereitstellung und Verwaltung. Der Prozess deckt nicht die Integration in andere UiPath-Produkte ab. Anweisungen zur Einrichtung und Implementierung von Abhängigkeiten wie Data Fabric, Integration Service, Studio Web, Agents und Action Center Action Apps finden Sie unter Anleitung – Komplexer Prozess.Zeichen

Ziel ist die Erstellung eines einfachen Routingprozesses, der dem aus folgendem Bild ähnelt:

Einen Prozess modellieren

Hinweis:
  • Die Projektkonfiguration des agentischen Prozesses ist derzeit mandantengebunden. Stellen Sie sicher, dass Sie zwischen den Bearbeitungssitzungen im selben Mandanten bleiben.
  • Die Projektkonfiguration des agentischen Prozesses unterstützt derzeit nur eine Geschäftsprozessdatei (.bpmn). Obwohl Sie dem Projekt mehrere Dateien hinzufügen können, führt dies zu unerwarteten Problemen sowohl beim Debuggen als auch bei der Veröffentlichung.

Beginnen Sie mit der Modellierung des End-to-End-Prozesses und konfigurieren Sie die Komponenten.

Erstellen Sie einen agentischen Prozess als neuen Typ von Studio-Projekt.

  1. Gehen Sie zu Ihrem Mandanten in Automatisierungs-Cloud™.

  2. Wählen Sie auf der linken Seite in der Liste der Produkte Maestro.

  3. Wählen Sie auf der Seite Maestro die Option Modellierung starten. Ihr neuer agentischer Prozess öffnet sich.

    Sie können auch zunächst einen neuen Prozess in Studio Web erstellen.

  4. Öffnen Sie das Kontextmenü, um das Projekt in Einfacher Prozess und den Prozess in Einfacher Prozess umzubenennen. Ihr agentischer Prozess ist standardmäßig Teil einer Lösung. Erfahren Sie mehr über Lösungen im Studio Web-Benutzerhandbuch.

  5. Wählen Sie das Startelement und wählen Sie in der Toolbox die Option Hinzufügen: Textanmerkung und geben Sie Eingabevariablenpfad ein.

  6. Wählen Sie das Startelement und dann in der Toolbox die Option Hinzufügen: Zwischenereignis.

  7. Wählen Sie in der Symbolleiste die Option Element ändern, wählen Sie dann Timer-Abfrage-Zwischenereignis und geben Sie „Verzögerung“ als Namen für das Zwischenereignis ein.

  8. Wählen Sie das Timer-Element aus, wählen Sie Hinzufügen: Exklusives Gateway in der Toolbox aus und geben Sie „Welcher Pfad?“ als Gateway-Namen ein.

  9. Wählen Sie das Gateway aus, wählen Sie Hinzufügen: Aufgabe und geben Sie „Eine Aufgabe“ als Namen ein.

    Validierungsfehler werden in der unteren linken Ecke der Arbeitsfläche angezeigt.

  10. Wählen Sie das Gateway erneut aus, wählen Sie Hinzufügen: Aufgabe und geben Sie Aufgabe B als Namen ein.

  11. Wählen Sie das Gateway aus und erweitern Sie die erste Bedingung, der Name wird generiert sein und mit edge_Gateway_{randomcharacters} beginnen, und geben Sie A für die Kennzeichnung ein. Erweitern Sie die zweite Bedingung und geben Sie B für die Kennzeichnung ein.

  12. Es hat sich bewährt, ein explizites Ende Ihres Prozesses zu erstellen. Um schnell zu erkennen, welchem Pfad der Prozess gefolgt ist, erstellen Sie ein explizites Ende für jeden Einzelnen.Wählen Sie die Aufgabe A aus und wählen Sie in der Toolbox die Option Hinzufügen: Endereignis und geben Sie Ende A als Namen ein.

  13. Wählen Sie die Aufgabe B aus und wählen Sie in der Toolbox die Option Hinzufügen: Endereignis und geben Sie Ende B als Namen ein.

Ergebnis

Der BPMN-Prozess wird mit einem Startereignis, einem empfangenden Zwischenereignis vom Typ Zeit, einem exklusiven Gateway mit zwei beschrifteten Bedingungen, zwei Aufgaben und zwei benannten Endereignissen modelliert. Die Prozessstruktur ist auf der Arbeitsfläche sichtbar und bereit für die Implementierung.

Herzlichen Glückwunsch! Sie haben jetzt Ihren ersten End-to-End-BPMN-Prozess erstellt!

Fügen Sie dem Prozess jetzt einige Funktionen hinzu.

Einen Prozess implementieren

Ereignis starten

  1. Wählen Sie das Startelement aus, geben Sie im Eigenschaftenbereich „Manueller Start“ als Namen ein und wählen Sie im Abschnitt Argumente die Option „Neu hinzufügen“ aus, um eine Variable hinzuzufügen, die wir beim Starten des Prozesses verwenden können.

  2. Konfigurieren Sie die Variable mit diesen Werten und wählen Sie Speichern aus. Eine Ausgabevariable wird automatisch erstellt.

    • Name: Pfad
    • Type: String
    • Wert: A

  3. Wählen Sie das Ereignis Verzögerung, öffnen Sie den Eigenschaftenbereich und dann im Abschnitt Timer die OptionDauer. Geben Sie 5 Sekunden in der Wertkonfiguration ein.

  4. Wählen Sie das Gateway, erweitern Sie den Bereich Bedingungen, um die Bedingung für die Pfade „Nein“ und „Ja“ einzugeben, und wählen Sie den Textauswahl-Picker, um den Ausdruckseditor zu öffnen und die Bedingungen einzugeben.

  5. Suchen Sie mithilfe von Variable einfügen die Ausgabevariable path Manueller Start und fügen Sie diese ein.

    Setzen Sie den Wert gleich „A“ und wählen Sie Speichern.

  6. Öffnen Sie den Ausdrucks-Editor für Bedingung B, fügen Sie den Pfad der Ausgabevariable Manueller Start ein, legen Sie den Wert auf „B“ fest und wählen Sie Speichern.

Ergebnis

Das Startereignis, der Timer, die Gateway-Bedingungen und die Aufgaben sind vollständig mit Variablen und Routing-Ausdrücken konfiguriert. Der Prozess ist bereit für das Debuggen.

Alternativ können Sie die folgenden Ausdrücke einfach in den Ausdruckseditor kopieren/einfügen:

  • A

    vars.path == "A"
    vars.path == "A"
    
  • B

    vars.path == "B"
    vars.path == "B"
    

Herzlichen Glückwunsch! Sie haben jetzt Ihren ersten Prozess vollständig konfiguriert.

Hinweis:

Sie können das BPMN für die Verwendung in anderen Projekten herunterladen, indem Sie das Kontextmenü für den .bpmn Dateinamen öffnen.

Einen Prozess debuggen

Sie können Haltepunkte konfigurieren, indem Sie oben links auf ein Element zeigen und das Haltepunktsymbol auswählen. Derzeit können Haltepunkte erst festgelegt werden, wenn Sie mit dem Debuggen eines Prozesses beginnen. Sie werden jedoch zwischen den Ausführungen beibehalten. Lesen Sie mehr über Debugging und Haltepunkte.

Direkt debuggen

Lassen Sie zunächst Ihren Prozess durchlaufen, um sicherzustellen, dass Sie ihn korrekt konfiguriert haben. Setzen Sie den Standardwert für Ihre Variable path auf A, damit er in Aufgabe A und Ende A sichtbar wird.

  1. Wählen Sie Debuggen, um Ihren Prozess zu testen.

  2. Sehen Sie sich an, wie die einzelnen Schritte ausgeführt werden. Navigieren Sie zu den Abschnitten Ausführungspfad und Globale Variablen/Vorfälle, um zusätzliche Details anzuzeigen.

  3. Wählen Sie den Modus Zurück zum Designmodus, um das Debugging zu beenden.

Ergebnis

Der Prozess wird direkt ausgeführt und jeder Schritt ist im Ausführungspfad sichtbar. Der Fluss erreicht Aufgabe A und Ende A wie erwartet, was bestätigt, dass der Prozess korrekt konfiguriert ist.

Schritt für Schritt debuggen

Führen Sie Ihren Prozess Schritt für Schritt aus, um die Variable path zu manipulieren und Route B zu testen.

  1. Wählen Sie Schrittweise debuggen.

  2. Wählen Sie Nächster Schritt, um die Ausführung zum Timer zu verschieben

  3. Aktualisieren Sie die globale Variable path als Quelle des Ereignisses Manueller Start auf B. Wählen Sie Eingabe oder Tab, um die Änderung zu bestätigen.

  4. Wählen Sie im nächsten Dialogfeld 1 Variable aktualisieren und Variablen aktualisieren, um die Änderungen zu übernehmen.

  5. Wählen Sie Fortfahren, um die Ausführung zu beenden.

  6. Sehen Sie sich an, wie die einzelnen Schritte ausgeführt werden. Gehen Sie zu den Abschnitten Ausführungspfad und Globale Variablen/Vorfälle, um weitere Informationen zu sehen. Diesmal folgt der Prozess der Route B.

  7. Wählen Sie den Modus Zurück zum Designmodus, um das Debugging zu beenden.

Ergebnis

Der Prozess schließt die Route B ab, nachdem die Pfadvariable während der schrittweisen Ausführung auf B aktualisiert wurde. Die Bereiche Ausführungspfad und Globale Variablen bestätigen, dass die Routing-Änderung wirksam wurde.

.

Veröffentlichen und Bereitstellen eines einfachen Prozesses

  1. Wählen Sie Veröffentlichen aus.

  2. Wählen Sie zunächst den Speicherort und dann Veröffentlichen aus.

  3. Lesen Sie Veröffentlichung und Aktualisierung von agentischen Prozessen für die Schritte zum Veröffentlichen im Orchestrator.

Ergebnis

Der Prozess wird am ausgewählten Speicherort veröffentlicht und bereitgestellt. Der Prozess ist in Orchestrator verfügbar und bereit für die Verwaltung von Runtime-Instanzen.

Herzlichen Glückwunsch! Sie haben jetzt Ihren ersten Prozess vollständig veröffentlicht, bereitgestellt und gestartet.

Jetzt ist es an der Zeit, die Runtime-Instanz zu verwalten.

Verwalten eines Geschäftsprozesses

  1. Gehen Sie im Portal Automation Cloud zum Dienst Maestro.

  2. Wählen Sie in der Liste der Prozesse die Option Einfacher Prozess, um die Ansicht Alle Instanzen für Ihren Prozess zu öffnen. Bei Bedarf können Sie die Liste mithilfe des Filters filtern.

  3. Wählen Sie die neueste Instanz, um die Instanzansicht zu öffnen. Sie können live die schrittweise Ausführung des Prozesses sehen (vorausgesetzt, der 5-Sekunden-Timer wird noch ausgeführt).

Ergebnis

Die Instanzanzeige wird geöffnet und zeigt den Prozess live an, einschließlich der globalen Variablen, des Aktionsverlaufs und des Ausführungspfads. Einzelne Schritte können auf Details und Variablenwerte überprüft werden.

Wählen Sie den Modellhintergrund aus, um globale Variablen und den Aktionsverlauf sowie den Ausführungspfad anzuzeigen. Wählen Sie einen Knoten im Modell oder den Ausführungspfad aus, um Details und Variablen für diesen Ausführungsschritt zu überprüfen.Herzlichen Glückwunsch! Sie haben Ihren ersten Prozess jetzt vollständig verwaltet. Unterbrechen Sie jetzt unseren Prozess, damit Sie den Fehler beheben können!

Einen Prozess unterbrechen und reparieren

Bei diesem Verfahren verursachen wir einen Fehler bei der Ausführung, um ihn mithilfe der Instanzverwaltung zur wiederherzustellen.

  1. Gehen Sie zu Orchestrator, zur Registerkarte Automatisierungen des Ordners Mein Arbeitsbereich und suchen Sie in der Liste Processes nach Simple.Process

  2. Wählen Sie Auftrag starten für den Einstieg Simple.Process, aber bearbeiten Sie diesmal die Argumente, bevor Sie den Auftrag unterbrechen.

  3. Wählen Sie die Registerkarte Argumente und bearbeiten Sie die Variable path. Setzen Sie den Wert auf C und wählen Sie Speichern.

  4. Wählen Sie Start aus.

  5. Gehen Sie zu Maestro und wählen Sie in der Liste der Prozesse die Option Einfacher Prozess, um die Ansicht Alle Instanzen für Ihren Prozess zu öffnen.

  6. Wählen Sie das Gateway Welcher Pfad? um den Fehler Kein ausgehender Fluss für Gateway zu sehen, der zu erwarten ist, da wir keine Konfiguration für path==”C” haben.

  7. Wählen Sie den Container für den ersten Schritt oder den Modellhintergrund aus, um die globalen Variablen anzuzeigen.

  8. Stellen Sie sicher, dass der Fluss einer konfigurierten Bedingung folgt, indem Sie die Variable path für die Ausgabe Manueller Start (die zweite) auf A aktualisieren.

  9. Wählen Sie 1 Variable aktualisieren, um die Variable zu aktualisieren und einen Kommentar zu Prüfungszwecken hinzuzufügen.

  10. Wählen Sie Wiederholen, fügen Sie einen Kommentar hinzu und wählen Sie Instanz wiederholen, um den Schritt mit der neuen Variable zu wiederholen und die Instanz vollständig zu sehen.

    :::note
    You might need to refresh the page to see the instance complete.
    :::
    
    ![Retry instance dialog with comment field](https://dev-assets.cms.uipath.com/assets/images/maestro/maestro-retry-instance-597470-64bdf93f.webp)
    :::note
    You might need to refresh the page to see the instance complete.
    :::
    
    ![Retry instance dialog with comment field](https://dev-assets.cms.uipath.com/assets/images/maestro/maestro-retry-instance-597470-64bdf93f.webp)
    
  11. Sehen Sie sich den Aktionsverlauf an, um den Prüfpfad unserer Änderungen zu sehen.

Ergebnis

Die fehlerhafte Instanz wird wiederhergestellt, indem die Pfadvariable aktualisiert wird und der fehlgeschlagene Gateway-Schritt wiederholt wird. Der Aktionsverlauf zeichnet die Variablenänderung und den erneuten Versuch als Prüfungspfad auf.

Herzlichen Glückwunsch! Sie haben eine defekte Instanz erfolgreich repariert.

Migration zwischen Versionen eines Prozesses

Die aktuelle Logik des Prozessflusses ist nicht robust genug, um alle Pfadeszenarien zu verwalten. Sie lösen dieses Problem, indem Sie eine neue Version des Prozesses veröffentlichen. Diese aktualisierte Version unterstützt nicht nur neue Prozessinstanzen effektiv, sondern korrigiert auch vorhandene, problematische Instanzen. Um sicherzustellen, dass Sie alle Szenarien effektiv behandeln, in denen path nicht A entspricht, ändern Sie die Route B zu einer Route Nicht A.

Bei diesem Verfahren verursachen Sie einen Fehler bei der Ausführung, um ihn mit einer neuen Version zu beheben.

  1. Gehen Sie zu Orchestrator.
  2. Gehen Sie zu Mein Arbeitsbereich.
  3. Gehen Sie zur Registerkarte Automatisierungen und suchen Sie Simple.Process in der Liste Prozesse.
  4. Wählen Sie Auftrag starten für den Einstieg Simple.Process und dann Starten.
  5. Wählen Sie die Registerkarte Argumente und bearbeiten Sie die Variable path.
  6. Setzen Sie den Wert auf C und wählen Sie Speichern.
  7. Wählen Sie Start aus.

Beheben Sie jetzt den Fehler in Ihrem Prozess, damit Sie diese fehlerhafte Instanz migrieren können.

  1. Öffnen Sie Ihren einfachen Prozess in UiPath Studio.

  2. Wählen Sie das Gateway Welcher Pfad? und öffnen Sie den Eigenschaftenbereich.

  3. Ändern Sie die Kennzeichnung B zu Nicht A und die Bedingung vars.path != A zu.

  4. Ändern Sie den Namen der Aufgabe B in Aufgabe Nicht A ab.

  5. Ändern Sie den Namen des Endereignisses Ende B in Ende Nicht A ab.

  6. Wählen Sie Veröffentlichen, wählen Sie den Feed „Persönlicher Arbeitsbereich“ des Orchestrators und Veröffentlichen.

Migrieren Sie jetzt Ihre fehlerhafte Instanz zur neuen Version.

  1. Gehen Sie zu Maestro, wählen Sie Prozessinstanzen und dann Einfacher Prozess in der Liste der Prozesse, um die Ansicht Alle Instanzen für Ihren Prozess zu öffnen.

  2. Wählen Sie die neueste Instanz, um die Instanzansicht zu öffnen. Sie werden sehen, das der Prozess sich am Gateway Welcher Pfad? im Status „Fehlgeschlagen“ befindet.

    Hinweis:

    Möglicherweise müssen Sie die Schaltfläche „Aktualisieren“ für die Liste auswählen, um die neueste Instanz zu sehen.

  3. Wählen Sie Migrieren, die Zielversion des gerade veröffentlichten Prozesses (sollte 1.0.1 sein, könnte aber für Sie anders sein), geben Sie einen Kommentar ein und wählen Sie Instanz migrieren.

  4. Wählen Sie Wiederholen aus, fügen Sie einen Kommentar hinzu und wählen Sie Instanz wiederholen aus, um den Schritt mit der neuen Variable zu wiederholen und zu beobachten, wie die Instanz fertiggestellt wird.

    Hinweis:

    Möglicherweise müssen Sie die Seite aktualisieren, um die Instanz abgeschlossen zu sehen.

  5. Sehen Sie sich den Aktionsverlauf an, um den Prüfpfad Ihrer Änderungen zu sehen.

Ergebnis

Die fehlerhafte Instanz wird zur aktualisierten Prozessversion migriert und es wird erfolgreich wiederholt, wobei die Route „Nicht A“ folgt. Der Aktionsverlauf zeichnet die Migrations- und Wiederholungsaktionen für Prüfungszwecke auf.

Herzlichen Glückwunsch! Sie haben eine fehlerhafte Instanz zu einer neuen Version des Prozesses migriert!

Endgültiger Prozess

So sieht der endgültige Prozess aus:

War diese Seite hilfreich?

Verbinden

Benötigen Sie Hilfe? Support

Möchten Sie lernen? UiPath Academy

Haben Sie Fragen? UiPath-Forum

Auf dem neuesten Stand bleiben