maestro
latest
false
Wichtig :
Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.
UiPath logo, featuring letters U and I in white

Maestro-Benutzerhandbuch

Letzte Aktualisierung 30. Apr. 2025

Modellieren, implementieren und anschließend ausführen

In diesem Beispiel implementieren Sie einen einfachen Agent-Prozess, der Sie durch die grundlegenden Maestro-Funktionen zum Modellieren, Implementieren, Debuggen, Veröffentlichen, Bereitstellen und Verwalten eines Prozesses führt. Dieses einfache Prozessbeispiel verwendet keine anderen UiPath-Produkte.

Ziel ist es, einen einfachen Routing-Prozess wie in der folgenden Abbildung zu erstellen:

Hinweis: Die Agentic Process-Projektkonfiguration ist derzeit mandantengebunden. Stellen Sie sicher, dass Sie zwischen Bearbeitungssitzungen im selben Mandanten bleiben.
Hinweis: Die Agentic Process-Projektkonfiguration unterstützt derzeit nur eine Geschäftsprozessdatei (BPMN). Obwohl dem Projekt mehrere Dateien hinzugefügt werden können, führt dies zu unerwarteten Problemen sowohl beim Debuggen als auch bei der Veröffentlichung.

Modellieren eines Prozesses

Beginnen Sie zuerst mit der Modellierung des End-to-End-Prozesses und konfigurieren Sie dann die Komponenten.
  1. Navigieren Sie zu Ihrem Automation Cloud™-Mandanten.
  2. Wählen Sie in der Leiste auf der linken Seite aus der Liste der Produkte Maestro aus.
  3. Wählen Sie auf der Maestro- Startseite die Option Erste Schritte aus.
    Tipp: Sie können auch mit der Erstellung eines neuen Agent-Prozesses in Studio Web beginnen.
    Ihr neuer Agent-Prozess wird geöffnet.
  4. Wählen Sie oben links in der Designoberfläche Erste Schritte aus.
  5. Benennen Sie das Projekt in Einfaches Projekt und den Prozess in Einfacher Prozess um.


  6. Schließen Sie den Projekt-Explorer.
  7. Wählen Sie das Startereigniselement auf der Arbeitsfläche aus, um die Elementsymbolleiste anzuzeigen. Wählen Sie Hinzufügen: Textanmerkung aus der Element-Symbolleiste aus.
  8. Wählen Sie das Startereigniselement und dann Hinzufügen: Zwischenereignis in der Elementsymbolleiste aus.
    1. Doppelklicken Sie auf das Zwischenelement, um es umzubenennen. Benennen Sie es in Delay um.
      Tipp: Sie können auch das Feld auf der Registerkarte Eigenschaften auf der rechten Seite des Bildschirms benennen , um ein Element umzubenennen.
    2. Ändern Sie das Zwischenereignis verzögern in Timerzwischenspeicherungsereignis.


  9. Wählen Sie das Zwischen-Catch-Ereignis Delay Timers und dann Hinzufügen aus: Exklusives Gateway.
    1. Benennen Sie das exklusive Gateway als Welcher Pfad?.
  10. Wählen Sie Welcher Pfad? exklusives Gateway und wählen Sie Hinzufügen: Aufgabe aus.
    1. Benennen Sie die Aufgabe als A Task.
    Tipp: Während Sie Ihren Prozess zeichnen und konfigurieren, werden Validierungsfehler auf der Canvas angezeigt. Wählen Sie im Werkzeugmenü oben rechts die Option Validierungsfehler ausblenden aus, wenn Sie diese Visualisierungen ausblenden möchten


  11. Wählen Sie Welcher Pfad? exklusives Gateway erneut verwenden und Hinzufügen: Aufgabe auswählen.
    1. Benennen Sie die Aufgabe als B Task.


  12. Wählen Sie Welcher Pfad? exklusives Gateway.
    1. Erweitern Sie die erste Bedingung im Abschnitt Bedingungen auf der Registerkarte Eigenschaften .
      Der generierte Name der Bedingung beginnt mit edge_Gateway_{randomcharacters}.
    2. Geben Sie A für die erste Bedingung in das Feld Beschriftung ein.
    3. Erweitern Sie die zweite Bedingung.
    4. Geben Sie B in das Feld Beschriftung für die zweite Bedingung ein.


  13. Wählen Sie Eine Aufgabe und Hinzufügen: Ereignis beenden in der Ereignissymbolleiste aus.
    1. Nennen Sie das Endereignis als Ende A.
    Tipp: Erstellen Sie als Best Practice ein explizites Ende für Ihren Prozess. Um schnell herauszufinden, welchem Pfad Ihr Prozess gefolgt ist und für jeden ein explizites Ende anzugeben.
  14. Wählen Sie B-Aufgabe und dann Hinzufügen: Ereignis beenden in der Ereignis-Symbolleiste aus.
    1. Nennen Sie das Endereignis als Ende B.


Implementieren eines Prozesses

Führen Sie das folgende Verfahren aus, um dem Prozess, der im Abschnitt Modellieren eines Prozesses erstellt wurde, Funktionen hinzuzufügen.
  1. Wählen Sie das Element Startereignis aus, und benennen Sie es in Manueller Start um.
  2. Wählen Sie Neu hinzufügen aus dem Abschnitt Eingaben auf der Registerkarte Eigenschaften aus.


  3. Erstellen Sie die neue Variable wie folgt:
    • Name: Pfad
    • Typ: String
    • Wert: A


  4. Wählen Sie Speichern.
    Die neue Variable wird erstellt.
  5. Wählen Sie das Zwischenabrufereignis Timer verzögern aus.
  6. Gehen Sie zum Abschnitt Timer auf der Registerkarte Eigenschaften und fügen Sie die folgenden Werte hinzu:
    • Typ: Dauer
    • Wert: Fügen Sie 5 Sekunden von der Wertkonfiguration hinzu.


  7. Wählen Sie Welcher Pfad? exklusives Gateway.
  8. Erweitern Sie die Bedingungen im Abschnitt Bedingungen auf der Registerkarte Eigenschaften .
  9. Konfigurieren Sie die erste Bedingung.
    1. Wählen Sie Ausdrucks-Editor öffnen für die erste Bedingung aus.


    2. Verwenden Sie Variable einfügen, um die Ausgabevariable path für manuellen Start zu finden und einzufügen.
    3. Legen Sie den Wert auf "A" fest.
    4. Wählen Sie Speichern.


  10. Konfigurieren Sie die zweite Bedingung.
    1. Wählen Sie Ausdrucks-Editor öffnen für die zweite Bedingung aus.
    2. Verwenden Sie Variable einfügen, um die Ausgabevariable path für manuellen Start zu finden und einzufügen.
    3. Legen Sie den Wert auf "B" fest.
    4. Wählen Sie Speichern.


    Tipp: Alternativ können Sie einfach die folgenden Ausdrücke kopieren und in den Ausdrucks-Editor einfügen:
    • Ausdruck A: vars.path == "A"
    • Ausdruck B: vars.path == "B"

Debuggen eines Prozesses

Sie führen Ihren Prozess zunächst direkt durch, um sicherzustellen, dass er korrekt konfiguriert ist. Da der Standardwert für die Variable path auf A festgelegt ist, sollte der Prozess zu Aufgabe A und Ende A durchlaufen.
Zeigen Sie mit dem Cursor auf die obere linke Ecke eines Elements, und wählen Sie Klicken zum Hinzufügen eines Haltepunkts aus , um Haltepunkte zu konfigurieren. Derzeit können Haltepunkte nur dann festgelegt werden, wenn Sie mit dem Debuggen eines Prozesses beginnen. Sie werden jedoch zwischen den Ausführungen beibehalten.

  1. Wählen Sie Test aus, um den Prozess zu debuggen.


    Während der Ausführung der einzelnen Schritte läuft eine Animation. Sie können mit dem Diagramm interagieren. Weitere Informationen finden Sie auf den Registerkarten Ausführungspfad und Globale Variablen .

  2. Wählen Sie Zurück zum Designmodus aus, um das Debuggen zu beenden.
  3. Wählen Sie Schritt für Schritt testen aus, um die Variable path zu bearbeiten, um die Route B zu testen.
  4. Wählen Sie Nächster Schritt aus, um die Ausführung zum Zwischenabrufereignis Zeitverzögern zu verschieben.
  5. Aktualisieren Sie den Wert Manueller Start der path Variable auf der Registerkarte Globale Variablen auf B.


    Achtung: Aufgrund eines bekannten Problems gibt es keinen visuellen Indikator, der bei der Unterscheidung zwischen Eingabe- und Ausgabevariablen mit demselben Namen beim Debuggen hilft. Wenn Sie beides in der Liste sehen, erfolgt die Eingabe vor der Ausgabe. Sie sollten die erste bearbeiten, welche die Eingabe ist, und nicht die Ausgabe, die den Wert null hat.
  6. Wählen Sie 1 Variablen aktualisieren und dann Variablen aktualisieren im Dialogfeld aus, um die Änderungen zu übernehmen.
  7. Wählen Sie Weiter aus, um die Ausführung zu beenden.
    Während der Ausführung der einzelnen Schritte läuft eine Animation. Sie können mit dem Diagramm interagieren. Weitere Informationen finden Sie auf den Registerkarten Ausführungspfad und Globale Variablen . Diesmal folgt der Prozess dem Weg B.

  8. Wählen Sie Zurück zum Designmodus aus, um das Debuggen zu beenden.
Sie haben nun Ihren ersten Prozess vollständig debuggt.

Veröffentlichen, Bereitstellen und Starten eines Prozesses

  1. Wählen Sie Veröffentlichen aus, um den Agent-Prozess zu veröffentlichen.
    1. Wählen Sie Orchestrator-Feed des persönlichen Arbeitsbereichs im Feld Speicherort aus.
    2. Wählen Sie Veröffentlichen aus.


    Hinweis: Prozesse, die in einem Orchestrator-Feed des persönlichen Arbeitsbereichs veröffentlicht werden, werden automatisch bereitgestellt, aber diejenigen, die in einem Mandanten- oder Ordner-Feed veröffentlicht werden, müssen weiterhin im Orchestrator als separater Schritt bereitgestellt werden.
  2. Navigieren Sie zu Orchestrator.
  3. Wechseln Sie zu Mein Arbeitsbereich.
  4. Gehen Sie zur Registerkarte Automatisierungen und suchen Sie Einfache.Prozess (Simple.Process) in der Liste Prozesse (Processes) .


  5. Wählen Sie Einen Auftrag starten für den Einfachen.Prozess -Eintrag aus.
  6. Wählen Sie Start aus.


Sie haben Ihren ersten Prozess nun vollständig veröffentlicht, bereitgestellt und gestartet.

Verwalten eines Agent-Prozesses

  1. Navigieren Sie zum Maestro -Dienst.
  2. Wählen Sie Einfacher Prozess in der Liste der Prozesse aus, um die Ansicht Alle Instanzen für Ihren Prozess zu öffnen.
    Tipp: Sie können auch das Suchfeld verwenden, um die Liste bei Bedarf zu filtern.
  3. Wählen Sie die neueste Instanz aus, um die Instanzanzeige zu öffnen.
    Sie können die Prozessausführung durch jeden Schritt live verfolgen.

    Wählen Sie den Modellhintergrund aus, um die globalen Variablen und den Aktionsverlauf sowie den Ausführungspfad zu überprüfen. Wählen Sie einen Schritt im Modell oder Ausführungspfad aus, um Details und Variablen für diesen Ausführungsschritt zu überprüfen.

Sie haben nun Ihren ersten Prozess vollständig verwaltet.

Unterbrechen und Korrigieren eines Prozesses

In diesem Verfahren verursachen wir einen Fehler bei der Ausführung, um die Instanzverwaltung für die Wiederherstellung zu verwenden.
  1. Navigieren Sie zu Orchestrator.
  2. Wechseln Sie zu Mein Arbeitsbereich.
  3. Gehen Sie zur Registerkarte Automatisierungen und suchen Sie Einfache.Prozess (Simple.Process) in der Liste Prozesse (Processes) .


  4. Wählen Sie Einen Auftrag starten für den Einfachen.Prozess -Eintrag aus.
  5. Ändern Sie den Wert für die Variable path in C.


  6. Wählen Sie Start aus.
  7. Navigieren Sie zu Maestro.
  8. Wählen Sie Einfacher Prozess in der Liste der Prozesse aus, um die Ansicht Alle Instanzen für Ihren Prozess zu öffnen.
  9. Wählen Sie die neueste Instanz aus, um die Instanzanzeige zu öffnen.
    Der Prozess befindet sich auf der Seite Welcher Pfad? exklusives Gateway.



  10. Wählen Sie Welcher Pfad? exklusiven Gateway-Schritt, um den Fehler Kein ausgehender Flow für Gateway zu überprüfen.
    Dieser Fehler wird erwartet, da es keine Konfiguration für path == "C" gibt.

  11. Wählen Sie den ersten Schritt im Bereich Status und Schritt aus, um globale Variablen anzuzeigen.


  12. Aktualisieren Sie den zweiten Ausgabewert Manueller Start (zweite Zeile) für die Variable path auf A , um eine konfigurierte Bedingung zu erfüllen.


  13. Wählen Sie 1 Variablen aktualisieren aus, um die Variable zu aktualisieren.
  14. Fügen Sie zu Prüfungszwecken einen Kommentar im Feld Kommentar hinzu.


  15. Wählen Sie „Wiederholen“ aus.
  16. Fügen Sie einen Kommentar hinzu, und wählen Sie Instanz wiederholen aus, um den Schritt mit der neuen Variablen zu wiederholen und die Instanz abzuschließen.


  17. Überprüfen Sie die Registerkarte Aktionsverlauf , um den Prüfungspfad für Ihre Änderungen anzuzeigen.
Sie haben erfolgreich eine fehlerhafte Instanz behoben.

Migrieren zwischen Versionen eines Prozesses

Die Prozessablauflogik in ihrer derzeitigen Form ist nicht robust genug, um alle Pfadszenarien zu bewältigen. Sie beheben dieses Problem, indem Sie eine neue Version des Prozesses veröffentlichen. Diese aktualisierte Version wird nicht nur neue Prozessinstanzen aufnehmen, sondern auch bestehende, problematische Instanzen korrigieren. Um sicherzustellen, dass Sie alle Szenarien effektiv bewältigen, in denen path nicht gleich A ist, ändern Sie die B- Route in eine Nicht A- Route.

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

  1. Navigieren Sie zu Orchestrator.
  2. Wechseln Sie zu Mein Arbeitsbereich.
  3. Gehen Sie zur Registerkarte Automatisierungen und suchen Sie Einfache.Prozess (Simple.Process) in der Liste Prozesse (Processes) .
  4. Wählen Sie Einen Auftrag starten für den Einfachen.Prozess -Eintrag aus.
  5. Ändern Sie den Wert für die Variable path in C.


  6. Wählen Sie Start aus.
  7. Navigieren Sie zu Studio und öffnen Sie Einfacher Prozess.
  8. Wählen Sie Welcher Pfad? exklusives Gateway.
  9. Ändern Sie die Beschriftung B in Nicht A und die Bedingung in vars.path != A.


  10. Ändern Sie den Aufgabennamen der B-Aufgabe in Not A Task.
  11. Ändern Sie das Endereignis End B in End Not A.
  12. Wählen Sie Veröffentlichen aus, um das Projekt zu veröffentlichen.
    1. Wählen Sie Orchestrator-Feed des persönlichen Arbeitsbereichs im Feld Speicherort aus.
    2. Wählen Sie Veröffentlichen aus.
  13. Navigieren Sie zu Maestro.
  14. Wählen Sie Einfacher Prozess in der Liste der Prozesse aus, um die Ansicht Alle Instanzen für Ihren Prozess zu öffnen.
  15. Wählen Sie die neueste Instanz aus, um die Instanzanzeige zu öffnen.
    Der Prozess befindet sich auf der Seite Welcher Pfad? exklusives Gateway.
  16. Wählen Sie Migrieren aus, um den Prozess zu migrieren.
    1. Wählen Sie die Zielversion für den Prozess aus, den Sie gerade veröffentlicht haben.
      Im Kontext dieses Beispiels sollte es 1.0.1 lauten.
    2. Geben Sie einen Kommentar an.
    3. Wählen Sie Instanz migrieren aus.


  17. Wählen Sie Wiederholen aus , um den Schritt mit der neuen Variablen zu wiederholen.
    1. Geben Sie einen Kommentar an.
    2. Wählen Sie Instanz wiederholen aus.


  18. Überprüfen Sie die Registerkarte Aktionsverlauf , um den Prüfungspfad für Ihre Änderungen anzuzeigen.
Sie haben eine fehlerhafte Instanz erfolgreich zu einer neuen Version des Prozesses migriert.

War diese Seite hilfreich?

Hilfe erhalten
RPA lernen – Automatisierungskurse
UiPath Community-Forum
Uipath Logo White