Jobs verwalten

Starten eines Jobs

Hinweis:

Die Verfügbarkeit der Funktionen hängt vom Cloud-Angebot ab, das Sie verwenden. Weitere Informationen finden Sie auf der Seite Funktionsverfügbarkeit.

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. Verwenden Sie auf der Seite Auftrag starten das Dropdownmenü Prozess, um einen Prozess auszuwählen, der zuvor im aktuellen Ordner bereitgestellt wurde.
   Hinweis:

   • Wenn Sie in der Prozessliste die Option Auftrag starten ausgewählt haben, ist der zugrunde liegende Prozess im Dropdownmenü Prozess vorausgewählt.
   • Wenn Sie in der Triggerliste die Option Auftrag jetzt starten ausgewählt haben, ist der Prozess, der mit dem zugrunde liegenden Trigger verknüpft ist, im Dropdownmenü Prozess vorausgewählt.
3. Konfigurieren Sie die erforderlichen Felder, wie in den folgenden Abschnitten beschrieben.
4. Wählen Sie Start aus. 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 vom Paket geerbten Priorität aufgefüllt.

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.
  App-Testroboter	Der Auftrag wird im unbeaufsichtigten Modus ausgeführt und verbraucht eine App Test Robot-Runtime. Wichtig: Die App Test Robot-Runtime kann nur Folgendes ausführen: Anwendungstestfälle aus einem Paket vom Projekttyp Testautomatisierung. RPA-Workflows für App Testing (erstelltes Projekt mit App Test Developer-Lizenz). Wenn Sie einen anderen Prozesstyp auswählen, können Sie die Option App Test Robot im Dropdownmenü Runtime-Typ nicht auswä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. See Robot units - Consumption for more details.
  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. See Robot units - Consumption for more details.
  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. See Robot units - Consumption for more details.
  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. See Robot units - Consumption for more details.

  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)
    • 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 mehr verfügbar ist, schlägt die bevorstehende Auftragsausführung fehl, da 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 Auswahl.

  • Wenn Sie kein Konto angeben, weist der Orchestrator das Konto dynamisch zu.

    Hinweis:

    • Wenn Sie versuchen, einen Auftrag auszuführen, ohne dass dem Ordner ein geeignetes Konto zugewiesen ist, erhalten Sie eine Error-Nachricht, in der das Problem erläutert wird.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.
    • Wenn einem Ordner nur Roboterkontogruppen zugewiesen werden, können die einzelnen Roboterkonten innerhalb dieser Gruppen nicht zum Ausführen von Aufträgen verwendet werden. Damit ein Roboterkonto Aufträge in einem Ordner ausführen kann, muss das einzelne Roboterkonto diesem Ordner explizit zugewiesen werden.

    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 Auswahl.

  • 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 die Option Konto-Maschine-Zuordnung hinzufügen auswählen, wenn Ihr Auftrag auf mehreren solchen Paaren ausgeführt werden soll. Wenn Sie dies tun, wird ein ausstehender Auftrag für jedes Konto-Maschinen-Paar erstellt.

  Hinweis:

  Dies funktioniert nur, wenn die Option Benutzer-Maschinen-Zuordnung aktivieren 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 Healing 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 den 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 Auftrags mit langer Ausführungszeit auf demselben Konto-Maschinen-Paar ausgeführt werden.

  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):

  • Select Stop from the drop-down menu - this attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a pending state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

  • Select Kill from the drop-down menu - this attempts to forcefully end the execution after the defined time interval has passed since the job is stuck in a pending state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

  • Select Stop from the drop-down menu and turn on the Schedule automatic "Kill", if the job does not stop option - this attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a pending state and then attempts to forcefully end it after the defined time interval has passed since the job is stuck in a stopping state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

    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. Stellen Sie sicher, dass Sie die Einrichtung korrigieren, ansonsten bleiben Aufträge auf unbestimmte Zeit ausstehend. 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.

    Konfigurieren von Umgebungsvariablen

  Hinweis:

  Environment configuration is only applied for Robot version 2025.10 and above.

  Um Umgebungsvariablen für einen Auftrag anzugeben, verwenden Sie das Textfeld Umgebungskonfiguration.

  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@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
    • TOKENUm den geheimen Wert zu aktualisieren, können Sie die Sternchen löschen und die neue Zeichenfolge eingeben.

  • Verweisen Sie auf ein Asset vom Typ Geheimnis, das sich im selben Ordner wie der Auftrag befindet, wie im folgenden Beispiel:

    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

    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 die Option Wird im Hintergrund gestartet in den Studio-Projekteinstellungen verwenden.

  Starten eines Agentenauftrags

  Hinweis:

  Die Verfügbarkeit der Funktionen hängt vom Cloud-Angebot ab, das Sie verwenden. Weitere Informationen finden Sie auf der Seite Funktionsverfügbarkeit.

  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:

  • Select Stop from the drop-down menu - this attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a pending state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

  • Select Kill from the drop-down menu - this attempts to forcefully end the execution after the defined time interval has passed since the job is stuck in a pending state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

  • Select Stop from the drop-down menu and turn on the Schedule automatic "Kill", if the job does not stop option - this attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a pending state and then attempts to forcefully end it after the defined time interval has passed since the job is stuck in a stopping state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

    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 Agents 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@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
    • TOKENUm 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%
    

    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.

  Abbildung 1. JSON-Schema

  

  Starten eines agentischen Prozessauftrags

  Hinweis:

  Die Verfügbarkeit der Funktionen hängt vom Cloud-Angebot ab, das Sie verwenden. Weitere Informationen finden Sie auf der Seite Funktionsverfügbarkeit.

  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):

  • Select Stop from the drop-down menu - this attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a pending state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

  • Select Kill from the drop-down menu - this attempts to forcefully end the execution after the defined time interval has passed since the job is stuck in a pending state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

  • Select Stop from the drop-down menu and turn on the Schedule automatic "Kill", if the job does not stop option - this attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a pending state and then attempts to forcefully end it after the defined time interval has passed since the job is stuck in a stopping state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

    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.

  Abbildung 2. 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 auf die Option Vollständige Slug-URL kopieren neben dem gewünschten Mandanten in der Trigger-Liste 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 '{AutomationCloudURL}/{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 '{AutomationCloudURL}/{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 '{AutomationCloudURL}/{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

  Click the corresponding More Actions button, and then Kill. The automation project is forcefully stopped, the job is marked as Stopped, and "Job canceled" is displayed in the Job Details window.

  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.

  Duplicating a Job

  To quickly start a new job using the configuration of an existing one, you can duplicate any job directly from the Jobs list.

  Select the corresponding More Actions button, and then select Duplicate job.

  This action opens the Start Job form pre-filled with the original job’s configuration, allowing you to review or modify the settings before starting the job. After opening the Start Job form, you can adjust any settings as needed before launching the new job.

  

  Anzeigen von Jobdetails

  Hinweis:

  • Während das Seitenpanel geöffnet ist, können Sie einen beliebigen Auftrag in der Liste auswählen, um die jeweiligen Details für alle im Panel enthaltenen Registerkarten anzuzeigen. Sie können das Auftragslistenraster horizontal scrollen, 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 das Erweiterungssymbol in der oberen Ecke jeder Registerkarte auswählen, um es als Fenster in voller Größe mit dem Namen des zugrunde liegenden Prozesses in der Navigationsleiste zu öffnen.Die Schaltfläche Reduzieren in derselben Ecke bringt das Fenster zurück ins Seitenpanel.
  • 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, wählen Sie die entsprechende Schaltfläche Details aus. Dadurch wird ein Seitenpanel angezeigt, das den Abschnitt Auftragsdetails enthält und Ihnen verschiedene Informationen bereitstellt:

  • Graph: you can toggle the graph view on or off using the Graph button. The graph provides a visualization of related job executions (parent, child, sblings as applicable), complementing the Trace tree view.

  • Error: error information generated during job execution.

  • Resume conditions: conditions and triggers configured for job resumption.

  • Autopilot Healing: information related to Autopilot Healing actions applied to the job.

  • Job information: core job metadata and execution status details. When applicable, this card displays pending reasons, explaining why a job is waiting or blocked.

  • Environment Variables: environment variables available at job execution time.

  • Input: the input arguments of the job.

  • Output: the output arguments of the job.

  • Raw message: unprocessed message that the job emitted before formatting.

  • Runtime details: runtime-related information for the job execution. Some fields and actions are displayed conditionally, depending on job type and status.

    • Start time: the date and time when the job execution started.
    • End time: the date and time when the job execution ended.
    • Duration: the total execution time of the job.
    • Creation time: the date and time when the job was created.
    • Consumption: the number of consumed units for the job execution, when applicable.
    • Actions: applicable to video recordings, this section includes:
      • Open, to open the video recording.
      • Delete, to delete the video recording.

  • Execution environment: execution information:

    • Package: the name and version of the package used to execute the job.
    • Compatibility: the compatibility type of the job’s execution environment.
    • Host identity: the identity under which the job was executed.
    • Machine: the machine template assigned to the job execution.
    • Robot: the robot used to execute the job.
    • Account/Identity: the account under which the robot executed the job.
    • Hostname: the name of the machine where the job was executed.
    • Healing agent: indicates whether Autopilot Healing is enabled for the job.
    • Healing agent self-healing: indicates whether self-healing actions are enabled for the healing agent.

  • Job state history: a chronological timeline of the job states and the duration spent in each state.

  • Additional information: additional job details:

    • Job key: a unique identifier assigned to the job.
    • Entry point: the workflow or process entry point used to start the job.
    • Type: the type of job executed, such as an agentic process.
    • Runtime type: displayed for certain job types, provides additional classification of the runtime used to execute the job.
    • Source: the trigger or source that initiated the job execution.
    • Priority: the priority level assigned to the job.
    • User interaction: describes if user interaction is Required or Not required.
    • Healing agent status: the current status of the healing agent for the job.
    • Machine size: the machine size used for the job execution, when available.
    • Screenshots: screenshots associated with the job execution, when available.

  • Attachments: files associated with the job execution.

  • Human review: information related to human review activities linked to the job.

    Wenn der Inhalt der Eingabe- und Ausgabe-Argumente eines Auftrags groß ist, wird standardmäßig nur ein Teil davon angezeigt.

    Wenn das Argument diese Größe überschreitet, wird der vollständige Inhalt als Datei in einem Remote-Speicher hinterlegt und kann bei Bedarf geladen oder heruntergeladen werden:

  • Expand - loads the full file in the editor, up to a certain size limit.

  • Download - downloads the full file when the argument size exceeds the limit.

  • Copy - for improved performance, available only for arguments within a certain limit.

    Hinweis:

    If Healing Agent is enabled and detects issues during job execution, a Healing Agent tab appears in the job details panel. The tab allows you to download the debug file or open it in Studio, and provides you with information on the issues that occurred during job execution. In addition to the issue description, you can view screenshots and suggestions on how to address each issue. If you selected Enable Healing Agent self-healing, the Healing Agent tab also provides details on how Healing Agent addressed the issues it identified. For more information on Healing Agent and its capabilities, refer to the Healing Agent documentation.

    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.

  Anzeigen von Auftragsverfolgungen

  Hinweis:

  Die Verfügbarkeit der Funktionen hängt vom Cloud-Angebot ab, das Sie verwenden. Weitere Informationen finden Sie auf der Seite Funktionsverfügbarkeit.

  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.

    Für Agent-Aufträge ist das in der Ansicht „Ablaufverfolgung“ hinzugefügte Feedback während der Entwurfsphase automatisch im Bereich „Evaluierungen von Agents“ verfügbar, sodass Sie Evaluierungen aus Auftragsausführungen erstellen, sie bearbeiten und Ihren Agent basierend auf manuell eingegebenem Feedback verbessern können. Erfahren Sie mehr über Evaluierungen.

    Abbildung 3. Ablaufverfolgungen der Agent-Runtime

    

  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 Videozeitleiste

  Hinweis:

  If a job was suspended and later resumed, the video timeline displays only the execution that occurred after the job resumed.

  Um eine Videoaufzeichnung einer Auftrag-Ausführung zusammen mit den zugrunde liegenden Protokollen anzuzeigen, wählen Sie die entsprechende Schaltfläche Details aus. Dadurch wird ein Seitenbereich angezeigt, der die Registerkarte Video-Zeitleiste enthält, mit einem Videobereich oben und einer Protokollliste unten.

  Sie können auch auf diese Registerkarte zugreifen, indem Sie auf der Registerkarte Details im selben Bereich die Option Aufzeichnen öffnen auswählen.

  Überprüfen Sie die 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.