Ausführen eines Auftrags im Orchestrator

• Erstellen Sie einen Prozess im Orchestrator.
• Führen Sie die CLI-Datei exe (für Windows) oder dll (für Linux) aus.
• Fügen Sie die erforderlichen Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu.

1. Führen Sie die job-Aufgabe mit uipcli job aus. Jetzt sehen Sie eine Liste der verfügbaren Unteraufgaben.
2. Geben Sie die erforderlichen Parameter an und führen Sie die Unteraufgabe run aus.
   Siehe die Liste der Parameter unten.

   Parameter	Beschreibung
   -i oder --input_path (Nurerforderlich , wenn der Einstiegspunkt des Workflows Eingabeparameter hat)	Der vollständige Pfad zur JSON-Eingabedatei, die dem Prozess entspricht, den Sie ausführen möchten. Beispiel für ein JSON-Dateiformat: { "StringArgument_In": "MyConfigurationValue", "IntArgument_In": 1, "DictionaryArgument_In": { "Key1": "Value1", "Key2": "Value2" } }
   -P oder --priority	Die Priorität, mit der Sie den Auftrag ausführen möchten:- Niedrig.- Normal (Standard).- Hoch.
   -r oder --robots	Eine durch Kommas getrennte Liste bestimmter Roboternamen.
   -j oder --jobscount	Die Häufigkeit, mit der Sie den Prozess ausführen möchten. Die Standardanzahl der Prozessausführungen ist eins.
   -U oder --user	Der Name des Benutzers. Dies sollte ein Maschinenbenutzer sein, kein Orchestrator-Benutzer. Für lokale Benutzer ist das Format MaschinenName\BenutzerName.
   -M oder --machine	Der Name der Maschine, auf der Sie den Prozess ausführen möchten.
   -R oder --result_path	Der vollständige Pfad zu einer JSON-Datei oder zu einem Ordner, in dem Sie die Ergebnisse des Auftrags speichern möchten. Die Ergebnisse werden als JSON-Dateien zurückgegeben.
   -W oder --timeout	Das Timeout für Auftragsausführungen (Sekunden). Der Standardwert ist 1800 Sekunden.
   -f oder --fail_when_job_fails	Der Befehl schlägt fehl, wenn ein Auftrag fehlschlägt. Die Standardeinstellung dafür ist True.
   -w oder --wait	Der Befehl wartet, bis der Auftrag abgeschlossen ist. Die Standardeinstellung dafür ist True.
   -b oder --job_type (nur für moderne Ordner)	Der Laufzeittyp für den Auftrag. Sie können wählen:- Unattended - NonProduction .
   -u oder --username (Erforderlich, wenn Sie die Einfache Authentifizierung verwenden; über einen Benutzernamen und ein Kennwort)	Der Benutzername, der für die Authentifizierung bei Orchestrator verwendet wird. Sie müssen es mit dem entsprechenden Kennwort koppeln.
   -p oder --password (Erforderlich, wenn Sie die Einfache Authentifizierung verwenden; über einen Benutzernamen und ein Kennwort)	Das Kennwort, das für die Authentifizierung beim Orchestrator verwendet wird. Sie müssen es mit dem entsprechenden Benutzernamen koppeln.
   -t oder --token (Erforderlich , wenn Sie die tokenbasierte Authentifizierungverwenden)	Das OAuth2-Aktualisierungstoken , das für die Authentifizierung beim Orchestrator verwendet wird. Sie müssen ihn mit dem Kontonamen und der Client-ID koppeln.
   -a oder --accountName (Erforderlich , wenn Sie die tokenbasierte Authentifizierungverwenden)	Der Name des Orchestrator-CloudRPA-Kontos. Sie müssen es mit dem OAuth2-Aktualisierungstoken und der Client-IDkoppeln.
   -A oder --accountForApp	Der Name des Orchestrator-CloudRPA-Kontos (Organisationsname). Sie müssen ihn mit der Anwendungs-ID, dem Anwendungsgeheimnis und dem Anwendungs-Scope für eine externe Anwendung koppeln.
   -I oder --applicationId (Erforderlich, wenn Sie die Authentifizierung über externe Anwendungen verwenden)	Die ID der externen Anwendung. Sie müssen es mit dem Anwendungskonto, dem Anwendungsgeheimnis und dem Anwendungs-Scope koppeln.
   -S oder --applicationSecret (Erforderlich, wenn Sie die Authentifizierung über externe Anwendungen verwenden)	Das Geheimnis externen Anwendung. Sie müssen es mit dem Anwendungskonto, der Anwendungs-ID und dem Anwendungs-Scope koppeln.
   --applicationScope (Erforderlich, wenn Sie die Authentifizierung über externe Anwendungen verwenden)	Die Liste der Anwendungs-Scopes, getrennt durch einzelne Leerzeichen. Sie müssen es mit dem Anwendungskonto, der Anwendungs-ID und dem Anwendungsgeheimnis für eine externe Anwendungen koppeln.
   -o oder --organizationUnit	Der Name des Orchestrator-Ordners (Organisationseinheit). Um Unterordner einzugeben, geben Sie sowohl den Namen des übergeordneten Ordners als auch den Namen des Unterordners ein. Zum Beispiel AccountingTeam\TeamJohn.
   -l, --language	Die Orchestrator-Sprache.
   -y, --disableTelemetry	Deaktivieren der Telemetriedaten.
   --traceLevel	Zeigt die Ablaufverfolgung der Ereignisse an.
   --identityUrl (nur für PaaS-Bereitstellungen erforderlich )	Die URL Ihres Identitätsservers.
   --help	Zeigt die Parameter und Beispiele für diesen Befehl an.
   --version	Zeigt Versionsinformationen an.
   Process Name (pos.0) (Erforderlich)	Der Name des Prozesses, den Sie ausführen möchten.
   Orchestrator URL (pos.1) (Erforderlich)	Die URL der Orchestrator-Instanz.
   Orchestrator Tenant (pos.2) (Erforderlich) für SaaP-Bereitstellungen. (Optional) für PaaS-Bereitstellungen.	Der Mandant der Orchestrator-Instanz, in der Sie Prozesse ausführen möchten.

Verwendung:

job run <process_name> <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-j <jobscount>] [-R <result_path>] [-P <priority>] [-r <robots>] [-f <do_not_fail_when_job_fails>] [-W <timeout>] [-w <do_not_wait>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <account_for_app> -I <application_id> -S <application_secret> --applicationScope] [-o <folder_organization_unit>] [-l <language>]

Beispiele:

• job run ProcessName "https://uipath-orchestrator.myorg.com" default -u admin -p 123456

• job run ProcessName "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -P Low

• job run ProcessName "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -P Normal -o MyFolder

• Auftragsausführung ProcessName „https://uipath-orchestrator.myorg.com“ default -u admin -p 123456 -P High -o MyFolder

• job run ProcessName "https://uipath-orchestrator.myorg.com" default -t a7da29a2c93a717110a82 -a myAccount -f false -W 0

• Auftragsausführung ProcessName „https://uipath-orchestrator.myorg.com“ Standard -t a7da29a2c93a717110a82 -a myAccount -P Hoch -j 3 -w false

• job run ProcessName "https://uipath-orchestrator.myorg.com" default -t a7da29a2c93a717110a82 -a myAccount -P Low -r robotName -R C:\Temp

• Auftragsausführung ProcessName „https://uipath-orchestrator.myorg.com“ default -t a7da29a2c93a717110a82 -a myAccount -r robotName -RC:\Temp\status.json

• job run ProcessName "https://uipath-orchestrator.myorg.com" default -A accountForExternalApp -I myExternalAppId -S myExternalAppSecret --applicationScope "OR.Folders.Read OR.Settings.Read" -r robotName -R C:\Temp\status.json

Hinzufügen einer externen Anwendung

So registrieren Sie eine externe Anwendung, damit sie mithilfe von OAuth auf Ihre UiPath-Ressourcen zugreifen kann:

1. Melden Sie sich beim Mandanten als Administrator an.
2. Wechseln Sie zu Mandant > Zugriff verwalten > Rollen zuweisen und klicken Sie auf Konten und Gruppen verwalten.

   Die Mandantenebene wird geöffnet.

3. Wählen Sie auf der linken Seite Externe Anwendungenaus.

   Die Seite Externe Anwendungen wird geöffnet und listet alle vorhandenen externen Anwendungen auf, die für den aktuellen Mandanten registriert sind:

   
   

   

   
   
4. Klicken Sie rechts über der Tabelle auf Anwendung hinzufügen.
5. Füllen Sie das Feld Anwendungsname aus.
6. Wählen Sie eine Option für Anwendungstyp aus.

   Wenn Sie Vertrauliche Anwendung auswählen, erhalten Sie am Ende einen geheimen App-Schlüssel, also stellen Sie sicher, dass Ihre Anwendung ihn sicher speichern kann. Wenn dies nicht der Fall ist, wählen Sie die Option Nicht vertrauliche Anwendung aus.

7. Klicken Sie unter Ressourcen auf Scopes hinzufügen.

   Das Panel Ressource bearbeiten wird rechts geöffnet, wo Sie die Ressourcen auswählen können, auf die die Anwendung Zugriff haben soll.

8. Wählen Sie von der Dropdownliste Ressource die UiPath-API aus, welche die Anwendung verwenden kann.
   Hinweis: Sie können jeweils nur einen Scope für eine Ressource hinzufügen. Wenn Sie den Zugriff auf mehrere Ressourcen zulassen möchten, wiederholen Sie diesen Vorgang, um einen Scope für jede Ressource hinzuzufügen.
9. Aktivieren Sie auf der Registerkarte Benutzer-Scope(s) nach Bedarf die Kontrollkästchen für die logischen API-Berechtigungen, die Sie gewähren möchten.

   Die Erteilung von Berechtigungen unter dem Benutzer-Scope bedeutet, dass die externe Anwendung im Rahmen eines Benutzerkontexts auf diese Ressourcen zugreifen kann und ein Benutzer mit den entsprechenden Berechtigungen angemeldet sein muss.

10. Wenn es sich um eine vertrauliche Anwendung handelt, können Sie zur Registerkarte Anwendungs-Scope(s) wechseln, um nach Bedarf auch Berechtigungen auf Anwendungsebene für die ausgewählte Ressource zu erteilen.

    Mit Berechtigungen im Anwendungs-Scope hat die externe Anwendung Zugriff auf anwendungsweite Daten für die ausgewählten Scopes, ohne dass eine Benutzerinteraktion erforderlich ist.

    Nicht vertrauliche Anwendungen können nicht auf den Anwendungs-Scope zugreifen.

11. Klicken Sie auf Speichern.

    Der Bereich wird geschlossen und die ausgewählte Ressource und die Scopes werden der Tabelle Ressourcen im Formular hinzugefügt.

12. Wenn die externe Anwendung sie akzeptieren kann, können Sie eine URL im Feld Umleitungs-URL hinzufügen und die Autorisierungsantwort wird dorthin gesendet. Die Anwendung kann sie dann verwenden, um auf UiPath-Ressourcen zuzugreifen.
13. Klicken Sie auf Hinzufügen, um die Registrierung zu erstellen.

    Eine Bestätigungsmeldung wird geöffnet. Für vertrauliche Anwendungen enthält die Bestätigungsmeldung den geheimen App-Schlüssel, den die registrierte externe Anwendung verwenden kann, um eine Autorisierung anzufordern. Speichern Sie ihn an einem sicheren Ort, da er Ihnen nicht erneut angezeigt wird.