orchestrator
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

Orchestrator-Anleitung

Letzte Aktualisierung 1. Sep. 2025

Jobs verwalten

Starten eines Jobs

Bevor Sie die folgenden Schritte ausführen, müssen Sie einen Prozess erstellen.

  1. Wählen Sie im Ordner mit dem Prozess Automatisierungen, gehen Sie dann zu Aufträge und wählen Sie Starten.Alternativ können Sie einen Auftrag über eine der folgenden Optionen starten:
    • Wählen Sie unter Automatisierungen die Option Prozesse, suchen Sie den entsprechenden Prozess in der Liste und wählen Sie am Ende der Zeile die Option Auftrag starten.
    • Wählen Sie unter Automatisierungen die Option Trigger, suchen Sie den entsprechenden Trigger in der Liste und wählen Sie am Ende der Zeile die Option Auftrag jetzt starten.
  2. Gehen Sie im Fenster Auftrag starten über die Auswahlliste Prozessname, um einen Prozess zu wählen, der zuvor im aktuellen Ordner bereitgestellt wurde.
    Hinweis:
    • Wenn Sie in der Prozessliste Auftrag starten gewählt haben, ist der zugrunde liegende Prozess in der Auswahlliste Prozessname vorausgewählt.
    • Wenn Sie in der Triggerliste die Option Jetzt starten ausgewählt haben, ist der Prozess, der dem zugrunde liegenden Trigger zugeordnet ist, in der Auswahlliste Prozessname vorausgewählt.
  3. Konfigurieren Sie die erforderlichen Felder, wie in den folgenden Abschnitten beschrieben.
  4. Klicken Sie auf Starten. Das Fenster Auftrag starten wird geschlossen und wenn im aktuell aktiven Ordner Laufzeiten verfügbar sind, wird der Auftrag auf einem Roboter entsprechend den von Ihnen vorgenommenen Einstellungen gestartet. Der Status des Auftrags wird in Echtzeit auf der Seite Aufträge angezeigt.

Festlegen der Auftragspriorität

Wählen Sie in der Auswahlliste Auftragspriorität die Priorität des auszuführenden Auftrags aus, wenn sich diese von der auf Prozessebene festgelegten Prioritätsstufe unterscheiden soll. Dieses Feld wird automatisch mit der Priorität ausgefüllt, die aus dem Paket übernommen wurde.

Auswählen der Ausführungslaufzeit

Wählen Sie aus der Dropdownliste Runtime-Typ den Runtime-Typ aus, der zum Ausführen des Auftrags verwendet wird.

Die Anzahl der verfügbaren und verbundenen Runtimes wird unter der Dropdownliste angezeigt.

  • _ Verfügbar – Die Anzahl der verfügbaren Laufzeiten, berechnet als die Gesamtzahl der Laufzeiten abzüglich der Anzahl der ausgeführten Aufträge.

  • _ Verbunden – Die Gesamtanzahl der Laufzeiten, berechnet als Summe der Laufzeiten auf allen Maschinen, die mit dem Orchestrator verbunden sind, der dem aktiven Ordner zugeordnet ist.

    Runtime-Typ

    Beschreibung

    Produktion (Unattended)

    Der Auftrag wird im Unattended-Modus ausgeführt und verbraucht eine Unattended-Laufzeit.

    Tests

    Der Auftrag wird im Unattended-Modus ausgeführt und verbraucht eine Testing-Laufzeit.

    App Testing

    Der Auftrag wird im unbeaufsichtigten Modus ausgeführt und verbraucht eine Runtime „App-Test“.

    Wichtig: Die Runtime für App-Testing kann nur Folgendes ausführen:
    • Anwendungstestfälle aus Testautomatisierungsprojekten.
    • Mit einer Lizenz für App Test Developer erstellte Non-production-Prozesse für App-Testing.
    Wenn Sie einen anderen Prozesstyp wählen, können Sie im Auswahlmenü Runtime-Typ nicht die Option App-Testing wählen.

    Nichtproduktiv (NonProduction)

    Der Auftrag wird im Unattended-Modus ausgeführt und verbraucht eine NonProduction-Laufzeit.

    Cloud - Serverless Testing

    Der Auftrag wird im Unattended-Modus auf einer serverlosen Robotermaschine ausgeführt, die für die Ausführung in einer Testumgebung konfiguriert wurde. Die Anzahl der erforderlichen Robot Units ist spezifisch für Testumgebungen und hängt von der Größe der serverlosen Robotermaschine und der Anzahl der Minuten ab, die zum Ausführen eines Auftrags benötigt werden.

    Weitere Informationen finden Sie unter Robot Units – Verbrauch.

    Cloud - Serverless

    Der Auftrag wird im Unattended-Modus auf einer serverlosen Robotermaschine ausgeführt, die für die Ausführung in einer Produktionsumgebung konfiguriert wurde. Die Anzahl der erforderlichen Robotereinheiten ist spezifisch für Produktionsumgebungen und hängt von der Größe der serverlosen Robotermaschine und der Anzahl der Minuten ab, die zum Ausführen eines Auftrags benötigt wird.

    Weitere Informationen finden Sie unter Robot Units – Verbrauch.

    Cloud - VM Testing

    Der Auftrag wird im Unattended-Modus auf einer Cloud-VM ausgeführt, die für die Ausführung in einer Testing- oder Non-Production-Umgebung konfiguriert wurde. Beim Ausführen der VM werden die Robot Units für Testumgebungen verbraucht.

    Weitere Informationen finden Sie unter Robot Units – Verbrauch.

    Cloud – VM

    Der Auftrag wird im Unattended-Modus auf einer Cloud-VM ausgeführt, die für die Ausführung in einer Produktionsumgebung konfiguriert wurde. Beim Ausführen der VM werden die Robot Units für Produktionsumgebungen verbraucht.

    Weitere Informationen finden Sie unter Robot Units – Verbrauch.

Beispiel: Angenommen, Sie haben 2 NonProduction-Laufzeiten und 1 Unattended-Laufzeit auf Maschinenvorlage A sowie 3 NonProduction-Laufzeiten und 2 Unattended-Laufzeiten auf Maschinenvorlage B. Beide sind einem Ordner zugeordnet. Sie verbinden eine Hostmaschine auf beiden Vorlagen. Das ergibt den folgenden Laufzeitstatus:

  • Unattended: 3 Available, 3 Connected
  • NonProduction: 5 Available, 5 Connected

Ein laufender Auftrag, der eine Laufzeit belegt, subtrahiert 1 von der Anzahl der verfügbaren Laufzeiten für diesen Typ.

Hinweis:

Zum Zeitpunkt der Veröffentlichung wählt der Orchestrator eine der verfügbaren Laufzeiten des persönlichen Arbeitsbereichs aus, um den Auftrag auszuführen. Die Laufzeitpriorität ist die folgende:

  • Produktion (Unattended)
  • Nichtproduktiv (NonProduction)

Wenn zum Beispiel keine Production-Laufzeit vorhanden ist, verwendet der Orchestrator eine verfügbare NonProduction-Laufzeit. Wenn keine vorhanden ist, schlägt der Auftrag fehl.

Wenn die ausgewählte Laufzeit zwischen Auftragsausführungen nicht verfügbar ist, schlägt die bevorstehende Auftragsausführung fehl, da der Orchestrator nicht nach der nächsten verfügbaren sucht.

Konfigurieren des Ausführungsziels

Konfigurieren Sie Ihr Ausführungsziel, indem Sie die Optionen im Bereich Ausführungsziel des Fensters Auftrag starten wie gewünscht festlegen.

Dynamisch zuordnen

Mit der Wahl von Dynamische Zuweisung ohne explizite Konto- und Maschinenauswahl können Sie unter dem Konto und der Maschine mehrfach, die als Erste verfügbar sind, einen Vordergrundprozess ausführen. Hintergrundprozesse werden auf jedem Konto ausgeführt, unabhängig davon, ob es beschäftigt ist oder nicht, solange Sie über ausreichend Runtimes verfügen.

Mit dieser Option können Sie einen Prozess bis zu 10.000 Mal in einem Auftrag ausführen.

Konto

Sie können einen der folgenden Ansätze wählen:

  • Das Angeben eines Kontos bedeutet, dass der Prozess unter diesem speziellen Benutzer- oder Roboterkonto ausgeführt wird.
  • Wenn Sie sowohl das Konto als auch die Maschine angeben, wird der Auftrag für dieses bestimmte Konto und die Maschine gestartet. Es stehen nur gültige Konto-Maschine-Paare zur Wahl.
  • Wenn Sie kein Konto angeben, weist der Orchestrator das Konto dynamisch zu.
Hinweis: Wenn Sie versuchen, einen Auftrag auszuführen, dem kein geeignetes Konto zugewiesen ist, wird eine Fehlermeldung angezeigt, die das Problem beschreibt.Außerdem ist die Taste Dem Ordner ein Konto zuweisen hervorgehoben. Wenn Sie die Taste wählen, können Sie dem Ordner entweder ein vorhandenes Konto zuweisen oder spontan ein neues Konto erstellen und dann den Workflow Auftrag starten fortsetzen.

Maschine

Sie können einen der folgenden Ansätze wählen:

  • Wenn Sie ein Maschinenobjekt angeben, wird der Prozess auf einem der Hostmaschinen ausgeführt, die mit der ausgewählten Maschinenvorlage verbunden sind. Wählen Sie eine bestimmte Hostmaschine aus dem Pool verbundener Hostmaschinen in der Auswahlliste aus.
  • Wenn Sie sowohl das Konto als auch die Maschine angeben, wird der Auftrag für dieses bestimmte Konto und die Maschine gestartet. Es stehen nur gültige Konto-Maschine-Paare zur Wahl.
  • Wenn Sie keine Maschine angeben, weist der Orchestrator die Hostmaschine dynamisch zu.

Stellen Sie sicher, dass Laufzeiten, die dem Auftragstyp entsprechen, der zugeordneten Maschinenvorlage zugewiesen werden. Es werden nur verbundene Hostmaschinen angezeigt, die dem aktiven Ordner zugeordnet sind.

Gültige Zuordnungen zwischen Konten und Maschinen wählen

Wählen Sie aus, welches spezifische Konto-Maschinen-Paar den Auftrag ausführen soll. Sie können auf Konto-Maschine-Zuordnung aktivieren klicken, wenn Ihr Auftrag für mehrere solcher Paare ausgeführt werden soll. Daraufhin wird für jedes Konto-Maschinen-Paar ein ausstehender Auftrag erstellt.

Hinweis: Dies funktioniert nur, wenn die Option Benutzer-Maschinen-Zuordnung auf der Registerkarte Allgemein Ihrer Mandanteneinstellungen ausgewählt ist.

Healing Agent aktivieren

Um Vorschläge und Informationen zum Debuggen zur Behebung von Problemen zu erhalten, die während der Auftragsausführung auftreten können, aktivieren Sie die Umschalttaste rHealing Agent aktivieren. Darüber hinaus können Sie Healing Agent erlauben, Probleme bei der Auftragsausführung selbstständig zu beheben, indem Sie die Option Selbstheilung durch Healing Agent aktivieren wählen.Ausführliche Informationen zu Healing Agent und seinen Funktionen finden Sie in der Dokumentation zu Healing Agent.

Konto-/Maschinenzuweisung bei Wiederaufnahme des Auftrags beibehalten

Mit dieser Einstellung können Sie konfigurieren, ob die verschiedenen Fragmente eines langfristigen Auftragsauf demselben Konto-Maschinen-Paar ausgeführt werden sollen.

Standardmäßig wird ein angehaltener Auftrag auf jedem verfügbaren Roboter auf jeder verfügbaren Maschine fortgesetzt.

Basierend auf Ihren Lizenz- oder Ressourcenanforderungen haben Sie die Möglichkeit, einen Auftrag auf derselben Maschine und im selben Kontokontext fortzusetzen, der den Auftrag gestartet hat.

Angenommen, Sie benötigen eine SAP-Lizenz, um einen Auftrag auszuführen. Anstatt eine SAP-Lizenz auf jeder verfügbaren Maschine zu installieren (erhöhte Kosten), können Sie sie auf einer einzelnen Maschine installieren und diese Maschine verwenden, um den Auftrag zu starten und fortzusetzen. Dieselbe Strategie kann für Benutzerlizenzen gelten. Sie können nur eine Benutzerlizenz zuweisen und zur Ausführung des Auftrags verwenden.

Beenden der Auftragsausführung planen

Die Prozessausführung kann manchmal fehlerhaft sein, was dazu führt, dass der Auftrag im Status „Ausstehend“ verbleibt. Wenn Sie den Umschalter aktivieren, haben Sie folgende Möglichkeiten (zum Erweitern klicken):

  • Wählen Sie Anhalten aus dem Dropdownmenü aus – es wird versucht, die Ausführung ordnungsgemäß zu beenden, nachdem das definierte Zeitintervall vergangen ist, weil der Auftrag im Status „Ausstehend“ festhängt (legen Sie die Zeit auf ein Minimum von 1 Minute, maximal 10 Tage, 23 Stunden und 59 Minuten fest);
  • Wählen Sie Beenden aus der Dropdownliste aus – es wird versucht, die Ausführung zwangsweise zu beenden, nachdem das definierte Zeitintervall vergangen ist, weil der Auftrag im Status „Ausstehend“ feststeckt (legen Sie die Zeit auf ein Minimum von 1 Minute, maximal 10 Tage, 23 Stunden und 59 Minuten fest).
  • Wählen Sie Anhalten aus der Dropdownliste aus, und aktivieren Sie die Option Automatisches „Beenden“ planen, wenn der Auftrag nicht angehalten wird – es wird versucht, die Ausführung ordnungsgemäß zu beenden, nachdem das definierte Zeitintervall vergangen ist, weil sich der Auftrag im Status „Ausstehend“ befindet, und dann wird versucht, ihn zwangsweise zu beenden, nachdem das definierte Zeitintervall vergangen ist, weil sich der Auftrag im Status „Anhalten“ befindet (legen Sie die Zeit auf mindestens 1 Minute fest, maximal 10 Tage, 23 Stunden und 59 Minuten).

Warnung generieren, wenn der Auftrag im Status „Ausstehend“ oder „Fortgesetzt“ festhängt

Durch Aktivieren des Umschalters aktivieren Sie Warnungen zu Aufträgen, die länger als die angegebene Dauer im Status „Ausstehend“ oder „Fortgesetzt“ verbleiben.

Die konfigurierbare Dauer beträgt mindestens eine Minute und maximal elf Tage.

Wenn der Auftrag die konfigurierte Dauer überschreitet, werden Sie in einem Popup-Fenster mit der Schweregradwarnung „Fehler“ mit dem folgenden Text darüber informiert:

"N Aufträge für #process {process_number} sind seit mehr als X Stunden und Y Minuten ausstehend oder werden fortgesetzt.", wo:

  • N – ist die Anzahl der Aufträge, die die Warnung ausgelöst haben.
  • {process_number} – die Prozess-ID

  • X – die konfigurierte Anzahl von Stunden, die der Auftrag überschritten hat, während er den Status „Ausstehend“ oder „Fortgesetzt“ hatte. Tage werden in Stunden konvertiert

  • Y – Die konfigurierte Anzahl von Minuten, die der Auftrag im Status „Ausstehend“ oder „Fortgesetzt“ überschritten hat.

Warnung generieren, wenn der Auftrag gestartet und nicht abgeschlossen wurde

Durch Aktivieren des Umschalters aktivieren Sie Warnungen über Aufträge, die nicht in der angegebenen Dauer abgeschlossen werden.

Die konfigurierbare Dauer beträgt mindestens eine Minute und maximal elf Tage.

Wenn der Auftrag die konfigurierte Dauer überschreitet, werden Sie in einem Popup-Fenster mit der Schweregradwarnung „Fehler“ mit dem folgenden Text darüber informiert:

„Auftrag für #Prozess {process_number} wird seit mehr als X Stunden und Y Minuten ausgeführt.“, wobei:

  • {process_number} – die Prozess-ID

  • X – die konfigurierte Anzahl von Stunden, die der Auftrag beim Versuch, ihn abzuschließen, überschritten hat. Tage werden in Stunden konvertiert.

  • Y – Die konfigurierte Anzahl von Minuten, die der Auftrag beim Versuch, ihn abzuschließen, überschritten hat.

Der Orchestrator verhindert das Starten von Aufträgen bei ungültigen Konfigurationen. Der Versuch, einen Auftrag in einem ungültigen Setup zu starten, führt zu einer beschreibenden Fehlermeldung, die Details zum Beheben Ihrer Konfiguration enthält.

Das Starten eines Auftrags über dynamische Zuweisung, das heißt ohne Angabe einer Maschine oder eines Kontos und mit einer inkompatiblen Ordnerkonfiguration, führt zu einem Fehler. Korrigieren Sie die Einrichtung, da andernfalls Aufträge auf unbestimmte Zeit nicht bearbeitet werden. Zum Beispiel kann kein .NET Framework 4.6.1-Hintergrundauftrag ausgeführt werden, wenn sich im Ordner nur plattformübergreifende Vorlagen befinden, da Aufträge im Status „ausstehend“ verbleiben, bis die Konfiguration korrigiert wurde.

Hinzufügen von Argumenten

Konfigurieren Sie im Abschnitt Runtime-Argumente des Fensters Auftrag starten folgende Einstellungen:

  • Wählen Sie den Einstiegspunkt. Wenn der Prozess nicht mehrere Einstiegspunkte unterstützt, zeigt Orchestrator in der Auswahlliste Einstiegspunkt fehlerhaft an und Sie können keine Auswahl treffen.

    Weitere Informationen dazu finden Sie unter Einstiegspunkten.

  • Geben Sie Eingabeargumente für den ausgewählten Prozess ein. Die Tabelle wird automatisch mit allen Eingabeargumenten gefüllt, die vom ausgewählten Prozess akzeptiert werden, und den entsprechenden Werten, die vom Paket geerbt werden.

    Hinweis: Auftragsargumente dürfen 10.000 Zeichen nicht überschreiten.
Hinweis:

Wenn der

Fehler Robots without credentials cannot run processes that require an interactive session. angezeigt wird und keine UI-Interaktion erforderlich ist, können Sie über die Option Startet im Hintergrund in den Projekteinstellungen in Studio gehen.

Starten eines Agentenauftrags

Vor Ausführung folgender Schritte müssen Sie einen Prozess erstellen.

  1. Gehen Sie zu Automatisierungen, dann zu Aufträge aus dem Ordner, in dem sich der Prozess befindet.
  2. Klicken Sie auf Starten. Das Fenster Auftrag starten wird angezeigt.
  3. Wählen Sie in der Auswahlliste Prozessname einen Prozess aus, der zuvor im aktuellen Ordner bereitgestellt wurde. Um in der Auswahlliste nur Agents zu sehen, verwenden Sie den Filter Filtertyp und wählen Sie Agent.
  4. Konfigurieren Sie die erforderlichen Felder, wie in den folgenden Abschnitten beschrieben.
  5. Klicken Sie auf Starten. Das Fenster Auftrag starten wird geschlossen und der Auftrag wird gemäß den von Ihnen vorgenommenen Einstellungen gestartet. Der Status des Auftrags wird in Echtzeit auf der Seite Aufträge angezeigt.

Konfigurieren des Ausführungsziels

Konfigurieren Sie Ihr Ausführungsziel, indem Sie die Optionen auf der Registerkarte Ausführungsziel des FensterAuftrag starten je nach Wunsch einstellen.

Beenden der Auftragsausführung planen

Die Prozessausführung ist manchmal fehlerhaft, sodass der Auftrag im Status „ausstehend“ verbleibt.Wenn Sie den Schalter aktivieren, können Sie:

  • Wählen Sie Anhalten aus dem Dropdownmenü aus – es wird versucht, die Ausführung ordnungsgemäß zu beenden, nachdem das definierte Zeitintervall vergangen ist, weil der Auftrag im Status „Ausstehend“ festhängt (legen Sie die Zeit auf ein Minimum von 1 Minute, maximal 10 Tage, 23 Stunden und 59 Minuten fest);
  • Wählen Sie Beenden aus der Dropdownliste aus – es wird versucht, die Ausführung zwangsweise zu beenden, nachdem das definierte Zeitintervall vergangen ist, weil der Auftrag im Status „Ausstehend“ feststeckt (legen Sie die Zeit auf ein Minimum von 1 Minute, maximal 10 Tage, 23 Stunden und 59 Minuten fest).
  • Wählen Sie Anhalten aus der Dropdownliste aus, und aktivieren Sie die Option Automatisches „Beenden“ planen, wenn der Auftrag nicht angehalten wird – es wird versucht, die Ausführung ordnungsgemäß zu beenden, nachdem das definierte Zeitintervall vergangen ist, weil sich der Auftrag im Status „Ausstehend“ befindet, und dann wird versucht, ihn zwangsweise zu beenden, nachdem das definierte Zeitintervall vergangen ist, weil sich der Auftrag im Status „Anhalten“ befindet (legen Sie die Zeit auf mindestens 1 Minute fest, maximal 10 Tage, 23 Stunden und 59 Minuten).

Warnung generieren, wenn der Auftrag gestartet und nicht abgeschlossen wurde

Durch Aktivieren des Umschalters aktivieren Sie Warnungen über Aufträge, die nicht in der angegebenen Dauer abgeschlossen werden.

Die konfigurierbare Dauer beträgt mindestens eine Minute und maximal elf Tage.

Wenn der Auftrag die konfigurierte Dauer überschreitet, werden Sie in einem Popup-Fenster mit der Schweregradwarnung „Fehler“ mit dem folgenden Text darüber informiert:

„Auftrag für #Prozess {process_number} wird seit mehr als X Stunden und Y Minuten ausgeführt.“, wobei:

  • {process_number} – die Prozess-ID
  • X – die konfigurierte Anzahl von Stunden, die der Auftrag beim Versuch, ihn abzuschließen, überschritten hat. Tage werden in Stunden konvertiert.
  • Y – Die konfigurierte Anzahl von Minuten, die der Auftrag beim Versuch, ihn abzuschließen, überschritten hat.

Der Orchestrator verhindert das Starten von Aufträgen bei ungültigen Konfigurationen. Der Versuch, einen Auftrag in einem ungültigen Setup zu starten, führt zu einer beschreibenden Fehlermeldung, die Details zum Beheben Ihrer Konfiguration enthält.

Konto

Sie können einen der folgenden Ansätze wählen:

  • Das Angeben eines Kontos bedeutet, dass der Prozess unter diesem speziellen Benutzer- oder Roboterkonto ausgeführt wird.
  • Wenn Sie kein Konto angeben, weist der Orchestrator das Konto dynamisch zu.

Definition der Umgebungskonfiguration für codierte Agentenaufträge

Um Umgebungsvariablen für einen codierten Agentenauftrag festzulegen, verwenden Sie das Textfeld Umgebungskonfiguration. Codierte Agenten werden in der Benutzeroberfläche als (Agent - <programming language>) angezeigt.

Sie können das Feld Umgebungskonfiguration verwenden, um Geheimnisse wie z. B. API-Schlüssel mit einer der folgenden Methoden zu referenzieren:

  • Geben Sie den geheimen Wert direkt im Feld Umgebungskonfiguration ein, wie im folgenden Beispiel gezeigt:
    SECRET=Abc@123SECRET=Abc@123
    Sie können die Sicherheit von Geheimnissen verbessern, indem Sie in folgenden Szenarien Sternchen anstelle des Geheimniswerts anzeigen lassen:
    • Einen Auftrag starten, bei dem die Umgebungskonfiguration vom zugrundeliegenden Prozess übernommen wird.
    • Einen Auftrag neu starten.
    Um dieses Verhalten zu aktivieren, stellen Sie sicher, dass der Name des geheimen Schlüssels auf eine der folgenden Zeichenfolgen endet:
    • ACCESS_KEY
    • API_KEY
    • AUTH
    • CREDENTIALS
    • PASSWORD
    • PRIVATE_KEY
    • SECRET
    • SESSION
    • TOKEN
    Um den geheimen Wert zu aktualisieren, können Sie die Sternchen löschen und die neue Zeichenfolge eingeben.
  • Verweisen Sie auf ein geheimes Asset, die sich im selben Ordner wie der Agent befindet, wie im folgenden Beispiel gezeigt:
    MySecret=%ASSETS/SECRET%MySecret=%ASSETS/SECRET%
    Hinweis:
    • Wenn Sie nach dem geheimen Schlüssel =% eingeben, wird ein ASSETS/ Vorschlag zur Autovervollständigung angezeigt. Nach Annahme des Vorschlags wird eine Auswahlliste mit Elementen angezeigt, in der Sie das gewünschte Element wählen können.
    • Sie können keine Zugangsdaten aus externen Schlüsseltresoren abrufen, wenn Sie einen nicht verbundenen Proxy für Zugangsdaten verwenden.

Hinzufügen von Argumenten

Enthält das Paket Eingabe- und/oder Ausgabeargumente, werden diese im Abschnitt Runtime-Argumente in den Registerkarten Eingabe und Ausgabe angezeigt. Argumentwerte werden vom Paket geerbt, Sie können sie jedoch nach Bedarf bearbeiten.

Hinweis: Auftragsargumente dürfen 10.000 Zeichen nicht überschreiten.
Um zwischen den Argumenten und einer Ansicht des zugrunde liegenden JSON Schema zu wechseln, wählen Sie JSON Schema.

Starten eines agentischen Prozessauftrags

Vor Ausführung folgender Schritte müssen Sie einen Prozess erstellen.

  1. Gehen Sie zu Automatisierungen, dann zu Aufträge aus dem Ordner, in dem sich der Prozess befindet.
  2. Klicken Sie auf Starten. Das Fenster Auftrag starten wird angezeigt.
  3. Wählen Sie in der Auswahlliste Prozessname einen Prozess aus, der zuvor im aktuellen Ordner bereitgestellt wurde. Um nur agentische Prozesse in der Auswahlliste zu sehen Filter, verwenden Sie den Filtertyp und wählen Sie Agentische Prozesse.
  4. Konfigurieren Sie die erforderlichen Felder, wie in den folgenden Abschnitten beschrieben.
  5. Klicken Sie auf Starten. Das Fenster Auftrag starten wird geschlossen und der Auftrag wird gemäß den von Ihnen vorgenommenen Einstellungen gestartet. Der Status des Auftrags wird in Echtzeit auf der Seite Aufträge angezeigt.

Konfigurieren des Ausführungsziels

Konfigurieren Sie Ihr Ausführungsziel, indem Sie die Optionen auf der Registerkarte Ausführungsziel des FensterAuftrag starten je nach Wunsch einstellen.

Beenden der Auftragsausführung planen

Die Prozessausführung kann manchmal fehlerhaft sein, was dazu führt, dass der Auftrag im Status „Ausstehend“ verbleibt. Wenn Sie den Umschalter aktivieren, haben Sie folgende Möglichkeiten (zum Erweitern klicken):

  • Wählen Sie Anhalten aus dem Dropdownmenü aus – es wird versucht, die Ausführung ordnungsgemäß zu beenden, nachdem das definierte Zeitintervall vergangen ist, weil der Auftrag im Status „Ausstehend“ festhängt (legen Sie die Zeit auf ein Minimum von 1 Minute, maximal 10 Tage, 23 Stunden und 59 Minuten fest);
  • Wählen Sie Beenden aus der Dropdownliste aus – es wird versucht, die Ausführung zwangsweise zu beenden, nachdem das definierte Zeitintervall vergangen ist, weil der Auftrag im Status „Ausstehend“ feststeckt (legen Sie die Zeit auf ein Minimum von 1 Minute, maximal 10 Tage, 23 Stunden und 59 Minuten fest).
  • Wählen Sie Anhalten aus der Dropdownliste aus, und aktivieren Sie die Option Automatisches „Beenden“ planen, wenn der Auftrag nicht angehalten wird – es wird versucht, die Ausführung ordnungsgemäß zu beenden, nachdem das definierte Zeitintervall vergangen ist, weil sich der Auftrag im Status „Ausstehend“ befindet, und dann wird versucht, ihn zwangsweise zu beenden, nachdem das definierte Zeitintervall vergangen ist, weil sich der Auftrag im Status „Anhalten“ befindet (legen Sie die Zeit auf mindestens 1 Minute fest, maximal 10 Tage, 23 Stunden und 59 Minuten).

Warnung generieren, wenn der Auftrag gestartet und nicht abgeschlossen wurde

Durch Aktivieren des Umschalters aktivieren Sie Warnungen über Aufträge, die nicht in der angegebenen Dauer abgeschlossen werden.

Die konfigurierbare Dauer beträgt mindestens eine Minute und maximal elf Tage.

Wenn der Auftrag die konfigurierte Dauer überschreitet, werden Sie in einem Popup-Fenster mit der Schweregradwarnung „Fehler“ mit dem folgenden Text darüber informiert:

„Auftrag für #Prozess {process_number} wird seit mehr als X Stunden und Y Minuten ausgeführt.“, wobei:

  • {process_number} – die Prozess-ID
  • X – die konfigurierte Anzahl von Stunden, die der Auftrag beim Versuch, ihn abzuschließen, überschritten hat. Tage werden in Stunden konvertiert.
  • Y – Die konfigurierte Anzahl von Minuten, die der Auftrag beim Versuch, ihn abzuschließen, überschritten hat.

Der Orchestrator verhindert das Starten von Aufträgen bei ungültigen Konfigurationen. Der Versuch, einen Auftrag in einem ungültigen Setup zu starten, führt zu einer beschreibenden Fehlermeldung, die Details zum Beheben Ihrer Konfiguration enthält.

Konto

Sie können einen der folgenden Ansätze wählen:

  • Das Angeben eines Kontos bedeutet, dass der Prozess unter diesem speziellen Benutzer- oder Roboterkonto ausgeführt wird.
  • Wenn Sie kein Konto angeben, weist der Orchestrator das Konto dynamisch zu.

Hinzufügen von Argumenten

Enthält das Paket Eingabe- und/oder Ausgabeargumente, werden diese im Abschnitt Runtime-Argumente in den Registerkarten Eingabe und Ausgabe angezeigt. Argumentwerte werden vom Paket geerbt, Sie können sie jedoch nach Bedarf bearbeiten.

Hinweis: Auftragsargumente dürfen 10.000 Zeichen nicht überschreiten.
Um zwischen den Argumenten und einer Ansicht des zugrunde liegenden JSON Schema zu wechseln, wählen Sie JSON Schema.

Starten eines Auftrags über einen API-Trigger

Sie können einen Auftrag über einen API-Trigger in einer Drittanbieteranwendung Ihrer Wahl starten. Befolgen Sie diese folgenden Schritte:

  1. Erstellen Sie einen API-Trigger basierend auf dem Prozess, den Sie ausführen möchten. Dadurch wird die erforderliche URL zum Starten des Auftrags generiert. Befolgen Sie dazu die Anweisungen im Thema Erstellen eines API-Triggers.
  2. Erstellen Sie ein dediziertes persönliches Zugriffstoken und gewähren Sie ihm Zugriff auf die erforderlichen Ressourcen. Dies geschieht auf Organisationsebene auf der Seite Einstellungen > Persönliches Zugriffstoken. Kopieren Sie das PAT nach dem Speichern sofort, da es nicht erneut angezeigt wird.
  3. Fügen Sie das persönliche Zugriffstoken in das Feld „Bearer-Token“ ein, um Ihre Anforderung zu autorisieren.
  4. Rufen Sie die Auftrags-URL ab, indem Sie neben dem gewünschten Mandanten in der Triggerliste auf die Option Vollständige Slug-URL kopieren klicken und sie dann in Ihr Tool einfügen.
  5. Konfigurieren Sie Ihre Argumente nach Bedarf.

    Sie können Argumente eingeben als:

    Parameter der Abfragezeichenfolge

    Bei einem Auftrag mit der Slug hw-process und den Argumenten files und folders sieht die cURL, die Sie in der Befehlszeile verwenden können, so aus: 
    curl --location --request POST 'https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/t/6ea73196-ca89-446c-81e1-5279bdd36dc2/hw-process?argument1=files&argument2=folders' \
--header 'Cookie: __cf_bm=_5E_r3oulk6zLCr6.CUij.RFN4lCeTgYMR31gradWtI-1697542233-0-AdP+xhO+SE5PQ6wnoEum5qRu4wzUgGgOrezRhHrR4dcVvhsvl9yV/V3KAFhi/TmomqMtmxc426WT83lDMoL1seQ='curl --location --request POST 'https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/t/6ea73196-ca89-446c-81e1-5279bdd36dc2/hw-process?argument1=files&argument2=folders' \
--header 'Cookie: __cf_bm=_5E_r3oulk6zLCr6.CUij.RFN4lCeTgYMR31gradWtI-1697542233-0-AdP+xhO+SE5PQ6wnoEum5qRu4wzUgGgOrezRhHrR4dcVvhsvl9yV/V3KAFhi/TmomqMtmxc426WT83lDMoL1seQ='

    Formulardaten

    Bei einem Auftrag mit der Slug hw-process und den Argumenten files und folders sieht die cURL, die Sie in der Befehlszeile verwenden können, so aus: 
    curl --location 'https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/t/6ea73196-ca89-446c-81e1-5279bdd36dc2/hw-process' \
--header 'Cookie: __cf_bm=_5E_r3oulk6zLCr6.CUij.RFN4lCeTgYMR31gradWtI-1697542233-0-AdP+xhO+SE5PQ6wnoEum5qRu4wzUgGgOrezRhHrR4dcVvhsvl9yV/V3KAFhi/TmomqMtmxc426WT83lDMoL1seQ=' \
--form 'argument1="files"' \
--form 'argument2="folders"'curl --location 'https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/t/6ea73196-ca89-446c-81e1-5279bdd36dc2/hw-process' \
--header 'Cookie: __cf_bm=_5E_r3oulk6zLCr6.CUij.RFN4lCeTgYMR31gradWtI-1697542233-0-AdP+xhO+SE5PQ6wnoEum5qRu4wzUgGgOrezRhHrR4dcVvhsvl9yV/V3KAFhi/TmomqMtmxc426WT83lDMoL1seQ=' \
--form 'argument1="files"' \
--form 'argument2="folders"'

    JSON-Haupttext

    Bei einem Auftrag mit der Slug hw-process und den Argumenten files und folders sieht die cURL, die Sie in der Befehlszeile verwenden können, so aus: 
    curl --location 'https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/t/6ea73196-ca89-446c-81e1-5279bdd36dc2/hw-process' \
--header 'Content-Type: application/json' \
--data '{
    "argument1" : "files",
    "argument2" : "folders"
}
'curl --location 'https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/t/6ea73196-ca89-446c-81e1-5279bdd36dc2/hw-process' \
--header 'Content-Type: application/json' \
--data '{
    "argument1" : "files",
    "argument2" : "folders"
}
'

    Argumente können auch durch eine Kombination der oben genannten Methoden eingegeben werden.

    Hinweis: Auftragsargumente dürfen 10.000 Zeichen nicht überschreiten.
  6. Führen Sie den Auftrag aus.

    Je nach Aufrufmodus, den Sie in der Triggerdefinition ausgewählt haben, wird der Auftrag wie folgt ausgeführt:

    • Asynchrones Polling

    • Asynchrones Fire-and-Forget

    • Synchronisierung (Long Polling)

    Beachten Sie, dass der Aufrufmodus in der Abfragezeichenfolge oder im Textkörper mit dem Parameter $callMode überschrieben werden kann.

    Weitere Informationen zu diesen Optionen finden Sie im Abschnitt Erläuterung der Anrufmodi.

Ratenbegrenzung

Die Anzahl der Anforderungen, die an den Statusendpunkt gestellt werden können, ist für jeden gestarteten Auftrag auf 10 pro 10 Sekunden begrenzt.

Grenzwert für ausstehende Aufträge

Die maximale Anzahl der ausstehenden Aufträge, die über API-Trigger gestartet wurden, ist 100. Dies kann mit der Einstellung Trigger – API-Trigger – Maximale Grenze für ausstehende Aufträge auf Mandantenebene geändert werden, die einen Standardwert von 10 hat.

Anhalten eines Jobs

Wählen Sie im Menü Weitere Aktionen für den Auftrag die Option Anhalten. Orchestrator markiert den Status des Auftrags als Wird angehalten und sendet eine Benachrichtigung an den Roboter, die Ausführung des Automatisierungsprojekts wird jedoch fortgesetzt.

Wenn auf eine Aktivität Sollte anhalten gestoßen wird, wird diese als Ergebnis true zurückgegeben. Sie können das Ergebnis als Marker verwenden, um zu bestimmen, wann eine Aktivität Auftrag anhalten aufgerufen werden soll, um einen reibungslosen Herunterfahrungsprozess einzuleiten.

Wenn keine Aktivität Auftrag anhalten gefunden wird, wird die Ausführung des Auftrags erst zum Ende des Projekts angehalten. Der Endstatus des Auftrags ist Erfolgreich.

Hinweis:
  • Ein über den Orchestrator gestarteter Auftrag kann nur über den Orchestrator angehalten werden.
  • Ein über den Assistant gestarteter Auftrag kann sowohl über den Orchestrator auf der Seite Aufträge als auch über den UiPath® Assistant angehalten werden.
  • Sobald ein Auftrag angehalten wurde, gehen die Zeitpläne für die Beendigung des Auftrags verloren und Sie müssen die Optionen zum Zeitplan der Beendigung der Auftragsausführung beim Neustart des Auftrags neu konfigurieren.

Fortsetzen eines Auftrags

Klicken Sie auf die entsprechende Schaltfläche Weitere Aktionen und dann Fortsetzen.

Abbrechen eines Jobs

Kicken Sie auf die entsprechende Schaltfläche Weitere Aktionen (More Actions) und dann auf Eliminieren (Kill). Das Automationsprojekt wird zwangsweise gestoppt, der Job wird als Angehalten (Stopped) markiert und im Fenster Jobdetails (Job Details) wird „Abgebrochen“ angezeigt.

Hinweis:
  • Ein über den Orchestrator gestarteter Auftrag kann sowohl über den Orchestrator auf der Seite Aufträge als auch über den UiPath Assistant beendet werden.
  • Ein über den Assistant gestarteter Auftrag kann sowohl über den Orchestrator auf der Seite Aufträge als auch über den UiPath Assistant beendet werden.
  • Sobald ein Auftrag beendet wurde, gehen die Zeitpläne für die Beendigung des Auftrags verloren und Sie müssen die Optionen zum Zeitplan der Beendigung der Auftragsausführung beim Neustart des Auftrags neu konfigurieren.

Neustarten eines Auftrags

Mit dieser Funktion können Sie einen Auftrag schnell über die Auftragsliste ausführen, ohne das Konfigurieren des Auftrags durchlaufen zu müssen. Sie können jeden Auftrag mit einem endgültigen Status neu starten – Angehalten, Fehlerhaft oder Erfolgreich.

Hinweis:
  • Sie können keine Aufträge neu starten, die von Agenten wie dem Assistant oder durch Remote-Debugging-Sitzungen von Studio ausgelöst wurden.
  • Wenn Sie einen Auftrag neu starten, bei dem die Optionen Beenden der Auftragsausführung planen aktiv waren, müssen Sie diese Optionen neu konfigurieren.

Dieses Verfahren startet mit der Annahme, dass Sie vorher einen Auftrag gestartet haben, der bereits einen endgültigen Status erreicht hat.

  1. Klicken Sie auf die entsprechende Schaltfläche Weitere Aktionen und wählen Sie Neu Starten (Restart) aus. Das Fenster Starten Job wird mit den Anfangseinstellungen des Jobs angezeigt.
  2. Nehmen Sie die gewünschten Änderungen vor.
  3. Klicken Sie auf Starten. Das Fenster Aufträge starten wird geschlossen und die Ausführung startet. Der Status der einzelnen Aufträge wird in Echtzeit auf der Seite Aufträge angezeigt.

Anzeigen von Jobdetails

Hinweis:

  • Wenn der Seitenbereich geöffnet ist, können Sie auf einen beliebigen Auftrag in der Liste klicken, um die entsprechenden Details für alle im Bereich enthaltenen Registerkarten anzuzeigen. Beim Auftragslistenraster kann ein horizontaler Bildlauf ausgeführt werden, wobei die Spalte „Prozess“ fixiert bleibt, wenn dies für Ihre Bildschirmgröße und Auflösung erforderlich ist. Beachten Sie, dass Sie einige Spalten vergrößern können, wodurch eine Bildlaufleiste für den leichteren Zugriff angezeigt wird.

  • Sie können oben rechts bei einer beliebigen Registerkarte auf das Symbol zum Erweitern klicken, um sie als Fenster in voller Größe zu öffnen, wobei der Name des zugrunde liegenden Prozesses in den Breadcrumbs angezeigt wird. Mit der Schaltfläche Reduzieren an der gleichen Stelle wird das Fenster wieder im Seitenbereich angezeigt.

  • Auftragsdetails enthalten keine weiteren Aspekte der Lizenzierung für fehlgeschlagene Aufträge. Verwenden Sie die Überwachungsfunktion für Details zur Lizenzierung.

Um Details zu einem bestimmten Auftrag anzuzeigen, klicken Sie auf die entsprechende Schaltfläche Details. Dadurch wird ein Seitenbereich angezeigt, der den Abschnitt Auftragsdetails mit verschiedenen Informationen enthält, z. B.:

  • den Namen des zugrunde liegenden Pakets
  • den für die Auftragsausführung verwendete Einstiegspunkt
  • Den ausführenden Roboter und die Maschine
  • Startzeit und Endzeit des Auftrags
  • die Auftragsdauer
  • Die Gründe für das Scheitern von Aufträgen
  • die Gründe dafür, warum der Auftrag nicht startet
  • mögliche Aktionen, um Probleme zu beheben und den Start des Auftrags auszulösen
Hinweis:

Für Agenten- und agentische Prozessaufträge enthält der Bereich mit Einzelheiten zum Auftrag eine Registerkarte Ablaufverfolgung. Die Ablaufverfolgung bietet eine umfassende, hierarchische Ansicht der Auftragsausführung, ihrer Eingaben und Ausgaben sowie aller anderen aufgerufenen Ressourcen oder ausgeführten Aufträge in Verbindung mit der Ausführung.

In der Ablaufverfolgungsansicht können Sie außerdem positives oder negatives Feedback sowie Kommentare zu jedem Element der Ablaufverfolgung abgeben.

Wenn Sie in der Ansicht Ablaufverfolgung auf die Option Rohdaten anzeigen schalten, können Sie einen Abschnitt mithilfe von Tastenkombinationen minimieren oder erweitern:
  • Um einen Abschnitt zu minimieren, gehen Sie über die Tastenkombination [ + Ctrl + Shift auf einem Windows- oder Linux-Computer oder die Tastenkombination [ + Cmd + Option auf einem macOS-Computer.
  • Um einen Abschnitt zu erweitern, verwenden Sie die Tastenkombination Ctrl + Shift + ] auf einem Windows- oder Linux-Computer oder die Tastenkombination Cmd + Option + ] auf einem macOS-Computer.
Hinweis: Wenn der Healing Agent aktiviert ist und während der Auftragserstellung Probleme erkennt, wird im Detailbereich des Auftrags eine Registerkarte Healing Agent angezeigt. Über diese Registerkarte können Sie die Debug-Datei herunterladen oder sie in Studio öffnen, und Sie erhalten Informationen zu den während der Auftragserstellung aufgetretenen Problemen. Zusätzlich zur Problembeschreibung können Sie sich Screenshots und Vorschläge dazu anzeigen lassen, wie sich das jeweilige Problem beheben lässt. Wenn Sie Selbstheilung durch Healing Agent aktivieren gewählt haben, finden Sie auf der Registerkarte Healing Agent auch Details dazu, wie der Healing Agent die identifizierten Probleme gelöst hat. Weitere Informationen zu Healing Agent und dessen Funktionen finden Sie in der Dokumentation zu Healing Agent.

Im Kontext eines SAP-Mandanten können Sie die Schaltfläche Zurück zu SAP verwenden, um zum Prozess in der SAP Build Process Automation zurückzukehren.

Jobprotokolle anzeigen

Um die Protokolle für einen bestimmten Auftrag anzuzeigen, klicken Sie auf die entsprechende Schaltfläche Details. Dadurch wird ein Seitenbereich angezeigt, der den Abschnitt Protokolle mit Daten zum ausgewählten Auftrag enthält.

Um die Protokolle für einen Auftrag manuell zu aktualisieren, wählen Sie die Schaltfläche Aktualisieren im Abschnitt Protokolle des Auftragsseitenbereichs aus.

Bei Aufträgen, die sich weder im Status Ausstehend noch im Status „Endgültig“ befinden, können Sie die Auftragsprotokolle automatisch in einem Zehn-Sekunden-Intervall aktualisieren. Um die Option zu aktivieren, wählen Sie die Dropdownliste neben Aktualisieren im Abschnitt Protokolle des Auftragsseitenbereichs und dann Automatische Aktualisierung aktivieren aus. Die Schaltfläche Aktualisieren ändert das Erscheinungsbild, um Ihre Auswahl zu bestätigen. Die Option bleibt für zukünftige Aufträge erhalten, auch wenn Sie Ihr Browserfenster aktualisieren.

Protokolle für einen Auftrag werden bis zu einer Minute, nachdem der Auftrag einen endgültigen Status erreicht hat, automatisch aktualisiert. Ab diesem Zeitpunkt können Sie die automatische Aktualisierung nicht mehr auswählen und die manuelle Aktualisierung der Protokolle ist die einzige verfügbare Option.

Hinweis: Protokolle für Aufträge, die über Remote-Debugging-Sitzungen gestartet wurden, sind nicht auf der Seite Auftragsprotokolle verfügbar. Sie finden sie auf der globalen Seite Protokolle.

Anzeigen der Bedingungen für die Auftragswiederaufnahme

Um die erforderlichen Trigger für die Wiederaufnahme eines angehaltenen Auftrags anzuzeigen, klicken Sie auf die entsprechende Schaltfläche Details. Dadurch wird ein Seitenbereich angezeigt, der die Registerkarte Fortsetzungsbedingungen mit Details zu den konfigurierten Workflow-Aufgaben für den ausgewählten Auftrag enthält.

Sie können sich durch die Liste klicken, um auf die Trigger für die anderen Aufträge zuzugreifen.

Anzeigen der Videozeitleiste

Um eine Videoaufzeichnung einer Auftragsausführung zusammen mit den zugrunde liegenden Protokollen anzuzeigen, klicken Sie auf die entsprechende Schaltfläche Details. Dadurch wird ein Seitenbereich angezeigt, der die Registerkarte Videozeitleiste mit einem Videobereich oben und einer Protokollliste unten enthält.

Sie können auch auf diese Registerkarte zugreifen, indem Sie auf der Registerkarte Protokolle desselben Panels auf Aufzeichnung öffnen klicken.

Weitere Informationen finden Sie in den Themen zur Videoaufzeichnung.

Herunterladen der Ausführungsmedien

Um die Aufzeichnung für einen fehlgeschlagenen Auftrag herunterzuladen, klicken Sie auf Weitere Optionen > Aufzeichnung herunterladen. Das Ausführungsmedium wird gemäß Ihren Einstellungen heruntergeladen.

War diese Seite hilfreich?

Support und Services
Hilfe erhalten
UiPath Academy
RPA lernen – Automatisierungskurse
UiPath-Forum
UiPath Community-Forum
Uipath Logo
Vertrauen und Sicherheit
Nutzungsbedingungen
Datenschutzerklärung
Cookie-Richtlinie
© 2005–2025 UiPath. Alle Rechte vorbehalten