Automation Ops
Neuestes
False
Bannerhintergrundbild
Automation Ops Benutzerhandbuch
Letzte Aktualisierung 26. Apr. 2024

Ausführen von Aufgaben

Das Ausführen von Aufgaben innerhalb der UiPath CLI für Windows-Geräte (UiPath.CLI.Windows) erfordert mehrere Aufgaben.

Die Hauptunterschiede zwischen Prozeduren für UiPath.CLI.Windows und Prozeduren für UiPath.CLI (UiPath CLI für Linux-Geräte) bestehen in zusätzlichen Argumenten, die Sie mit einigen Aufgaben übergeben können, die spezifisch für Ihren Gerätetyp sind läuft weiter.

Wichtig:
When using UiPath CLI, you must ensure that the project is closed in Studio. Doing otherwise causes a conflict leading to the following error message in CLI: The action could not be performed because the project is already opened in another Studio instance. Please close it and try again.

Anwendungsbereiche von API Access

Die folgende Tabelle zeigt die erforderlichen Anwendungs-Scopes für den Zugriff auf die Orchestrator-API, um eine CLI-Aufgabe auszuführen.

Anwendungs-Scope

Beschreibung

ODER.Assets

Lese- und Schreibzugriff für Assets im Orchestrator.

ODER.BackgroundTasks

BackgroundTasks Lese- und Schreibzugriff im Orchestrator.

ODER.Ausführung

Lese- und Schreibzugriff für die Ausführung im Orchestrator.

ODER.Ordner

Lese- und Schreibzugriff für Ordner im Orchestrator.

ODER.Aufträge

Aufträge Lese- und Schreibzugriff im Orchestrator.

ODER.Maschinen.Lesen

Maschinen-Lesezugriff im Orchestrator.

ODER.Überwachung

Überwachen des Lese- und Schreibzugriffs im Orchestrator.

OR.Robots.Read

Lesezugriff von Robotern im Orchestrator.

ODER.Einstellungen.Lesen

Lesezugriff auf Einstellungen im Orchestrator.

ODER.TestSets

Lese- und Schreibzugriff für TestSets im Orchestrator.

ODER.TestSetExecutions

Lese- und Schreibzugriff für TestSetExecutions im Orchestrator.

ODER.TestSetSchedules

TestSetSchedules Lese- und Schreibzugriff im Orchestrator.

ODER.Benutzer.Lesen

Benutzer-Lesezugriff im Orchestrator.

Hinzufügen einer externen Anwendung

So registrieren Sie eine externe Anwendung, damit sie OAuth verwenden kann, um auf Ihre UiPath-Ressourcen zuzugreifen:

  1. Wechseln Sie zu Administrator und wählen Sie die Organisation oben im Bereich auf der linken Seite aus.
  2. Wählen Sie Externe Anwendungen aus.
  3. Klicken Sie oben rechts auf Anwendung hinzufügen.
  4. Füllen Sie das Feld Anwendungsname aus.
  5. 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.

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

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

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

  10. Klicken Sie auf Speichern.

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

  11. Wenn die externe Anwendung bei Benutzer-Scopes registriert wurde, müssen Sie eine Umleitungs-URL hinzufügen, unter der die externe Anwendung die Autorisierungsantwort erhalten soll.

    Wenn nur Anwendungs-Scopes ausgewählt sind, ist die Angabe einer Umleitungs-URL optional.

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

Ausführen von UiPath.CLI.Wndows

Voraussetzungen: Um die UiPath CLI für Windows zu verwenden und Aufgaben auszuführen, installieren Sie .NET 6.0.7. Dazu muss .NET 6.0.7 Desktop Runtime enthalten sein, die mit SDK 6.0.302 geliefert werden.

Sie können Aufgaben ausführen, indem Sie uipcli.exe einschließlich der entsprechenden Parameter aufrufen. Um Unteraufgaben auszuführen, muss der Befehl das folgende Format haben: uipcli.exe <task name> <sub-task name> . So führen Sie die CLI aus:
  1. Öffnen Sie eine Eingabeaufforderung und navigieren Sie zu dem Ordner, der aus der NUPKG-Datei extrahiert wurde.
  2. Geben Sie uipcli.exe ein und wählen Sie die Eingabetaste aus.

Ausführen von UiPath.CLI

Voraussetzungen: Um die UiPath-CLI für plattformübergreifend zu verwenden und Auftragsaufgaben auszuführen, installieren Sie .NET 6.0.7, das mit dem SDK 6.0.302 ausgeliefert wird.

Sie können Aufgaben ausführen, indem Sie uipcli.exe einschließlich der entsprechenden Parameter aufrufen. Um Unteraufgaben auszuführen, muss der Befehl das folgende Format haben: dotnet uipcli.dll <task name> <sub-task name> . So führen Sie die CLI aus:
  1. Öffnen Sie eine Eingabeaufforderung und navigieren Sie zu dem Ordner, der aus der NUPKG-Datei extrahiert wurde.
  2. Geben Sie dotnet uipcli.dll ein und wählen Sie die Eingabetaste aus.

Anzeigen der CLI-Version

Führen Sie den Befehl uipcli --version aus.

Löschen von Assets aus Orchestrator

Voraussetzungen:

  • Erstellen Sie Assets im Orchestrator.
  • Erstellen Sie eine CSV-Datei, die die Assets enthält, die Sie löschen möchten. Die CSV-Datei muss die folgenden drei Spalten enthalten: name , type und value . Die Datenzellen unter den Spalten type und value können leer bleiben.
  • Führen Sie die CLI-Datei exe (für Windows) oder dll (für Linux) aus.
  • Fügen Sie unten die Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu:

    Anwendungs-Scope

    Beschreibung

    ODER.Assets

    Lese- und Schreibzugriff für Assets im Orchestrator.

    ODER.BackgroundTasks

    BackgroundTasks Lese- und Schreibzugriff im Orchestrator.

    ODER.Ausführung

    Lese- und Schreibzugriff für die Ausführung im Orchestrator.

    ODER.Ordner

    Lese- und Schreibzugriff für Ordner im Orchestrator.

    ODER.Aufträge

    Aufträge Lese- und Schreibzugriff im Orchestrator.

    ODER.Maschinen.Lesen

    Maschinen-Lesezugriff im Orchestrator.

    ODER.Überwachung

    Überwachen des Lese- und Schreibzugriffs im Orchestrator.

    OR.Robots.Read

    Lesezugriff von Robotern im Orchestrator.

    ODER.Einstellungen.Lesen

    Lesezugriff auf Einstellungen im Orchestrator.

    ODER.TestSets

    Lese- und Schreibzugriff für TestSets im Orchestrator.

    ODER.TestSetExecutions

    Lese- und Schreibzugriff für TestSetExecutions im Orchestrator.

    ODER.TestSetSchedules

    TestSetSchedules Lese- und Schreibzugriff im Orchestrator.

    ODER.Benutzer.Lesen

    Benutzer-Lesezugriff im Orchestrator.

Weitere Informationen zur CSV-Datei finden Sie in den Beispielen in der folgenden Tabelle:

name

Typ

Wert

asset1_name

N/AN/A

asset2_name

Bool

true

asset3_name

Integer

N/A

asset4_name

Anmeldeinformationen

username:password

So löschen Sie Assets aus Orchestrator:

  1. Führen Sie die asset -Aufgabe mit uipcli asset aus. Sie können eine Liste der verfügbaren Unteraufgaben anzeigen.
  2. Geben Sie die erforderlichen Parameter an und führen Sie die Unteraufgabe delete aus.

    Siehe die Liste der Parameter unten.

    Parameter

    Beschreibung

    Assets File (pos. 0) (Erforderlich)

    Der Name der CSV-Datei, die die Assets enthält, die Sie löschen 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 Ihre Assets verwalten möchten.

    -u, oder --username (Erforderlich , wenn Sie die Standardauthentifizierungverwenden, ü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 Authentifizierung verwenden)

    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 Authentifizierung verwenden)

    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. Sie müssen sie mit der Anwendungs-ID, demgeheimenAnwendungsgeheimnis und dem Anwendungsbereich für eine externe Anwendung koppeln.

    -I oder --applicationID (Erforderlich, wenn Sie die Authentifizierung über externe Anwendungen verwenden).

    Die externe Anwendungs-ID. Sie müssen es mit dem Anwendungskonto, demgeheimenAnwendungsgeheimnis und dem Anwendungsbereich 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 Anwendungsbereiche, getrennt durch einzelne Leerzeichen. Sie müssen es mit dem Anwendungskonto, derAnwendungs-IDund dem geheimen Anwendungsgeheimnis für eine externe Anwendung 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 oder --language

    Die Sprache, die in der Orchestrator-Benutzeroberfläche verwendet wird.

    -y oder --disableTelemetry

    Deaktivieren der Telemetriedaten.

    --traceLevel

    Zeigt die Ablaufverfolgung der Ereignisse an.

    --identityUrl (Nur fürPaaS- Bereitstellungen erforderlich )

    Die URL Ihres Identitätsservers.

Beispiele:

  • asset delete assets_file.csv "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -l en-US
  • asset delete assets_file.csv "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -o OurOrganization
  • asset delete assets_file.csv "https://uipath-orchestrator.myorg.com" default -t a7da29a2c93a717110a82 -a myAccount
  • asset delete assets_file.csv "https://uipath-orchestrator.myorg.com" default -A accountForExternalApp -I myExternalAppId -S myExternalAppSecret --applicationScope "OR.Folders.Read OR.Settings.Read"

Bereitstellen von Assets im Orchestrator

Voraussetzungen:

  • Erstellen Sie eine CSV-Datei, die die Assets enthält, die Sie im Orchestrator bereitstellen möchten.
    Die CSV-Datei muss die folgenden drei Spalten enthalten: name , type , value und description .
  • Führen Sie die CLI-Datei exe (für Windows) oder dll (für Linux) aus.
  • Fügen Sie unten die Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu:

    Anwendungs-Scope

    Beschreibung

    ODER.Assets

    Lese- und Schreibzugriff für Assets im Orchestrator.

    ODER.BackgroundTasks

    BackgroundTasks Lese- und Schreibzugriff im Orchestrator.

    ODER.Ausführung

    Lese- und Schreibzugriff für die Ausführung im Orchestrator.

    ODER.Ordner

    Lese- und Schreibzugriff für Ordner im Orchestrator.

    ODER.Aufträge

    Aufträge Lese- und Schreibzugriff im Orchestrator.

    ODER.Maschinen.Lesen

    Maschinen-Lesezugriff im Orchestrator.

    ODER.Überwachung

    Überwachen des Lese- und Schreibzugriffs im Orchestrator.

    OR.Robots.Read

    Lesezugriff von Robotern im Orchestrator.

    ODER.Einstellungen.Lesen

    Lesezugriff auf Einstellungen im Orchestrator.

    ODER.TestSets

    Lese- und Schreibzugriff für TestSets im Orchestrator.

    ODER.TestSetExecutions

    Lese- und Schreibzugriff für TestSetExecutions im Orchestrator.

    ODER.TestSetSchedules

    TestSetSchedules Lese- und Schreibzugriff im Orchestrator.

    ODER.Benutzer.Lesen

    Benutzer-Lesezugriff im Orchestrator.

Weitere Informationen zur CSV-Datei finden Sie im folgenden Beispiel.

name

Typ

Wert

Beschreibung

asset_1_name

text

„Ich habe einen Kommentar“

asset_1_description

asset_2_name

Integer

1

asset_2_description

asset_3_name

Bool

false

asset_3_description

asset_4_name

Anmeldeinformationen

username:password

asset_4_description

So stellen Sie Assets dem Orchestrator bereit:

  1. Führen Sie die asset -Aufgabe mit uipcli asset aus. Sie können eine Liste der verfügbaren Unteraufgaben anzeigen.
  2. Geben Sie die erforderlichen Parameter an und führen Sie die Unteraufgabe deploy aus.

    Siehe die Liste der Parameter unten.

    Parameter

    Beschreibung

    Assets File (pos. 0) (Erforderlich)

    Der Name der CSV-Datei, die die Assets enthält, die Sie löschen 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 Ihre Assets verwalten möchten.

    -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 Authentifizierung verwenden)

    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 Authentifizierung verwenden)

    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. Sie müssen sie mit der Anwendungs-ID, demgeheimenAnwendungsgeheimnis und dem Anwendungsbereich für eine externe Anwendung koppeln.

    -I oder --applicationID (Erforderlich, wenn Sie die Authentifizierung über externe Anwendungen verwenden).

    Die externe Anwendungs-ID. Sie müssen es mit dem Anwendungskonto, demgeheimenAnwendungsgeheimnis und dem Anwendungsbereich 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 Anwendungsbereiche, getrennt durch einzelne Leerzeichen. Sie müssen es mit dem Anwendungskonto, derAnwendungs-IDund dem geheimen Anwendungsgeheimnis für eine externe Anwendung 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 oder --language

    Die Sprache, die in der Orchestrator-Benutzeroberfläche verwendet wird.

    -y oder --disableTelemetry

    Deaktivieren der Telemetriedaten.

    --traceLevel

    Zeigt die Ablaufverfolgung der Ereignisse an.

    --identityUrl (Nur fürPaaS- Bereitstellungen erforderlich )

    Die URL Ihres Identitätsservers.

Beispiele:

  • asset deploy assets_file.csv "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -l en-US.
  • asset deploy assets_file.csv "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -o OurOrganization.
  • asset deploy assets_file.csv "https://uipath-orchestrator.myorg.com" default -t a7da29a2c93a717110a82 -a myAccount.
  • asset delete assets_file.csv "https://uipath-orchestrator.myorg.com" default -A accountForExternalApp -I myExternalAppId -S myExternalAppSecret --applicationScope "OR.Folders.Read OR.Settings.Read".

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 unten die Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu:

    Anwendungs-Scope

    Beschreibung

    ODER.Assets

    Lese- und Schreibzugriff für Assets im Orchestrator.

    ODER.BackgroundTasks

    BackgroundTasks Lese- und Schreibzugriff im Orchestrator.

    ODER.Ausführung

    Lese- und Schreibzugriff für die Ausführung im Orchestrator.

    ODER.Ordner

    Lese- und Schreibzugriff für Ordner im Orchestrator.

    ODER.Aufträge

    Aufträge Lese- und Schreibzugriff im Orchestrator.

    ODER.Maschinen.Lesen

    Maschinen-Lesezugriff im Orchestrator.

    ODER.Überwachung

    Überwachen des Lese- und Schreibzugriffs im Orchestrator.

    OR.Robots.Read

    Lesezugriff von Robotern im Orchestrator.

    ODER.Einstellungen.Lesen

    Lesezugriff auf Einstellungen im Orchestrator.

    ODER.TestSets

    Lese- und Schreibzugriff für TestSets im Orchestrator.

    ODER.TestSetExecutions

    Lese- und Schreibzugriff für TestSetExecutions im Orchestrator.

    ODER.TestSetSchedules

    TestSetSchedules Lese- und Schreibzugriff im Orchestrator.

    ODER.Benutzer.Lesen

    Benutzer-Lesezugriff im Orchestrator.

  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.
    ParameterBeschreibung
    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.
    -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.
    -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 Authentifizierung verwenden) 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 Authentifizierung verwenden) Der Name des Orchestrator-CloudRPA-Kontos. Sie müssen es mit dem OAuth2-Aktualisierungstoken und der Client-IDkoppeln.
    -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.
    -P oder --priorityDie Priorität, mit der Sie den Auftrag ausführen möchten:- Niedrig.- Normal (Standard).- Hoch.
    -r oder --robotsEine durch Kommas getrennte Liste bestimmter Roboternamen.
    -j oder --jobscountDie Häufigkeit, mit der Sie den Prozess ausführen möchten. Die Standardanzahl der Prozessausführungen ist eins.
    -U oder --userDer Name des Benutzers. Dies sollte ein Maschinenbenutzer sein, kein Orchestrator-Benutzer. Für lokale Benutzer ist das Format MaschinenName\BenutzerName.
    -M oder --machineDer Name der Maschine, auf der Sie den Prozess ausführen möchten.
    -R oder --result_pathDer 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 --timeoutDas Timeout für Auftragsausführungen (Sekunden). Der Standardwert ist 1800 Sekunden.
    -f oder --fail_when_job_failsDer Befehl schlägt fehl, wenn ein Auftrag fehlschlägt. Die Standardeinstellung dafür ist True.
    -w oder --waitDer 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 .
    -A oder --accountForAppDer Name des Orchestrator-CloudRPA-Kontos. Sie müssen ihn mit der Anwendungs-ID, dem Anwendungsgeheimnis und dem Anwendungs-Scope für eine externe Anwendung 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.
  • job run 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 -P High -j 3 -w false
  • job run ProcessName "https://uipath-orchestrator.myorg.com" default -t a7da29a2c93a717110a82 -a myAccount -r robotName -R C:\Temp\status.json

Analysieren eines Projekts

Voraussetzungen:

  • Erstellen Sie ein Projekt.
  • Führen Sie die CLI-Datei exe (für Windows) oder dll (für Linux) aus.
  • Fügen Sie unten die Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu:

    Anwendungs-Scope

    Beschreibung

    ODER.Assets

    Lese- und Schreibzugriff für Assets im Orchestrator.

    ODER.BackgroundTasks

    BackgroundTasks Lese- und Schreibzugriff im Orchestrator.

    ODER.Ausführung

    Lese- und Schreibzugriff für die Ausführung im Orchestrator.

    ODER.Ordner

    Lese- und Schreibzugriff für Ordner im Orchestrator.

    ODER.Aufträge

    Aufträge Lese- und Schreibzugriff im Orchestrator.

    ODER.Maschinen.Lesen

    Maschinen-Lesezugriff im Orchestrator.

    ODER.Überwachung

    Überwachen des Lese- und Schreibzugriffs im Orchestrator.

    OR.Robots.Read

    Lesezugriff von Robotern im Orchestrator.

    ODER.Einstellungen.Lesen

    Lesezugriff auf Einstellungen im Orchestrator.

    ODER.TestSets

    Lese- und Schreibzugriff für TestSets im Orchestrator.

    ODER.TestSetExecutions

    Lese- und Schreibzugriff für TestSetExecutions im Orchestrator.

    ODER.TestSetSchedules

    TestSetSchedules Lese- und Schreibzugriff im Orchestrator.

    ODER.Benutzer.Lesen

    Benutzer-Lesezugriff im Orchestrator.

  1. Führen Sie die package -Aufgabe mit uipcli package aus. Sie können eine Liste der verfügbaren Unteraufgaben anzeigen.
  2. Geben Sie die erforderlichen Parameter an und führen Sie die Unteraufgabe analyze aus.

    Siehe die Liste der Parameter unten.

Legende: (*) – Optional, empfohlen bei Verwendung zusätzlicher Paket-Feeds.

Parameter

Beschreibung

Project(s) Path (pos.0) (erforderlich)
Der Pfad zur project.json -Datei oder der Pfad zum Ordner, der mehrere project.json -Dateien enthält.

--analyzerTraceLevel

Wählen Sie aus, welche Nachrichtentypen nach der Analyse ausgegeben werden sollen:

  • Aus = Keine Nachricht anzeigen
  • Fehler (Error)

    -Warnung

    -Info

    -Ausführlich.

-stopOnRuleViolation

Der Auftrag schlägt fehl, wenn eine Regel verletzt wird.

--treatWarningsAsErrors

Warnungen als Fehler behandeln.

--resultPath

Der vollständige Pfad zu einer JSON-Datei, in der Sie die Ergebnisse speichern möchten.

Wenn Sie dies nicht als Argument hinzufügen, werden die Ergebnisse nur in der Standardkonsole ausgegeben.

--ignoredRules

Eine durch Kommas getrennte Liste von Regeln, die Sie während der Analyse ignorieren möchten.

--orchestratorUsername (*)

(Erforderlich, wenn Sie die Standardauthentifizierung 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.

--orchestratorPassword (*)

(Erforderlich, wenn Sie die Standardauthentifizierung 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.

-orchestratorAuthToken (*)

(Erforderlich, wenn Sie tokenbasierte Authentifizierung verwenden)

Das OAuth2-Aktualisierungstoken , das für die Authentifizierung beim Orchestrator verwendet wird. Sie müssen ihn mit dem Kontonamen und der Client-ID koppeln.

--orchestratorAccountName (*)

(Erforderlich, wenn Sie tokenbasierte Authentifizierung verwenden)

Der Name des Orchestrator-CloudRPA-Kontos. Sie müssen es mit dem OAuth2-Aktualisierungstoken und der Client-IDkoppeln.

--orchestratorAccountForApp (*)

Der Name des Orchestrator-CloudRPA-Kontos. Sie müssen sie mit der Anwendungs-ID, demgeheimenAnwendungsgeheimnis und dem Anwendungsbereich für eine externe Anwendung koppeln.

--orchestratorApplicationId (*)

(Erforderlich, wenn Sie die Authentifizierung über externe Anwendungen verwenden)

Die ID der externen Anwendung. Sie müssen sie mit dem **Anwendungskonto, dem Anwendungsgeheimnis und dem Anwendungs-Scope koppeln.

--orchestratorApplicationSecret (*)

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

--orchestratorApplicationScope (*)

(Erforderlich, wenn Sie die Authentifizierung über externe Anwendungen verwenden)

Die Liste der Anwendungsbereiche, getrennt durch einzelne Leerzeichen. Sie müssen es mit dem Anwendungskonto, derAnwendungs-IDund dem geheimen Anwendungsgeheimnis für eine externe Anwendung koppeln.

--orchestratorFolder (*)

Der Name des Ziel-Orchestrator-Ordners.

Um Unterordner einzugeben, geben Sie sowohl den Namen des übergeordneten Ordners als auch den Namen des Unterordners ein. Zum Beispiel AccountingTeam\TeamJohn.
--orchestratorUrl (*)

Die URL der Orchestrator-Instanz.

--orchestratorTenant (*)

Der Mandant der Orchestrator-Instanz, in der Sie eine Maschine löschen möchten.

--help

Zeigt die Parameter und Beispiele für diesen Befehl an.

Beispiele:

  • package analyze "C:\UiPath\Project\project.json" --analyzerTraceLevel "Error" --stopOnRuleViolation --treatWarningsAsErrors --resultPath "C:\UiPath\Project\output.json"
  • package analyze "C:\UiPath\Project\project.json" --analyzerTraceLevel "Error" --stopOnRuleViolation --treatWarningsAsErrors --resultPath "C:\UiPath\Project\output.json" --ignoredRules "ST-NMG-009,ST-DBP-020,UI-USG-011,ST-DBP-020"
  • package analyze "C:\UiPath\Project\project.json" --analyzerTraceLevel "Error" --stopOnRuleViolation --treatWarningsAsErrors --resultPath "C:\UiPath\Project\output.json" --ignoredRules "ST-NMG-009,ST-DBP-020,UI-USG-011,ST-DBP-020" --orchestratorUrl "https://orchestratorurl.com" --orchestratorTenant "default" --orchestratorUsername "username" --orchestratorPassword "\_ye5zG9(x" --orchestratorAuthToken "AuthToken" --orchestratorAccountName "AccountName" --orchestratorFolder "OrchestratorFolder"

Löschen von ML-Paketen

Voraussetzungen:

  • Veröffentlichen Sie ein Paket im Orchestrator.
  • Führen Sie die CLI-Datei exe (für Windows) oder dll (für Linux) aus.
  • Fügen Sie unten die Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu:

    Anwendungs-Scope

    Beschreibung

    ODER.Assets

    Lese- und Schreibzugriff für Assets im Orchestrator.

    ODER.BackgroundTasks

    BackgroundTasks Lese- und Schreibzugriff im Orchestrator.

    ODER.Ausführung

    Lese- und Schreibzugriff für die Ausführung im Orchestrator.

    ODER.Ordner

    Lese- und Schreibzugriff für Ordner im Orchestrator.

    ODER.Aufträge

    Aufträge Lese- und Schreibzugriff im Orchestrator.

    ODER.Maschinen.Lesen

    Maschinen-Lesezugriff im Orchestrator.

    ODER.Überwachung

    Überwachen des Lese- und Schreibzugriffs im Orchestrator.

    OR.Robots.Read

    Lesezugriff von Robotern im Orchestrator.

    ODER.Einstellungen.Lesen

    Lesezugriff auf Einstellungen im Orchestrator.

    ODER.TestSets

    Lese- und Schreibzugriff für TestSets im Orchestrator.

    ODER.TestSetExecutions

    Lese- und Schreibzugriff für TestSetExecutions im Orchestrator.

    ODER.TestSetSchedules

    TestSetSchedules Lese- und Schreibzugriff im Orchestrator.

    ODER.Benutzer.Lesen

    Benutzer-Lesezugriff im Orchestrator.

  1. Führen Sie die package -Aufgabe mit uipcli package aus. Sie können eine Liste der verfügbaren Unteraufgaben anzeigen.
  2. Geben Sie die erforderlichen Parameter an und führen Sie die Unteraufgabe delete aus.

    Siehe die Liste der Parameter unten.

    Parameter

    Beschreibung

    Package name (pos. 0) (Erforderlich)

    Der Name des Pakets, das Sie löschen möchten.

    Orchestrator URL (pos. 1)

    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 eine Maschine löschen möchten.

    -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 Authentifizierung verwenden)

    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 Authentifizierung verwenden)

    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. Sie müssen sie mit der Anwendungs-ID, demgeheimenAnwendungsgeheimnis und dem Anwendungsbereich für eine externe Anwendung koppeln.

    -I oder --applicationId (Erforderlich, wenn Sie die Authentifizierung über externe Anwendungen verwenden).

    Die externe Anwendungs-ID. Sie müssen es mit dem Anwendungskonto, demgeheimenAnwendungsgeheimnis und dem Anwendungsbereich 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 Anwendungsbereiche, getrennt durch einzelne Leerzeichen. Sie müssen es mit dem Anwendungskonto, derAnwendungs-IDund dem geheimen Anwendungsgeheimnis für eine externe Anwendung 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 oder --language

    Die Sprache, die in der Orchestrator-Benutzeroberfläche verwendet wird.

    -y oder --disableTelemetry

    Deaktivieren der Telemetriedaten.

    --traceLevel

    Zeigt die Ablaufverfolgung der Ereignisse an.

    --identityUrl (Nur fürPaaS- Bereitstellungen erforderlich )

    Die URL Ihres Identitätsservers.

    --help

    Zeigt die Parameter und Beispiele für diesen Befehl an.

Beispiele:

  • package delete PackageName "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -l en-US.
  • package delete PackageName "https://uipath-orchestrator.myorg.com" default -t refreshToken -a accountName.
  • package delete PackageName "https://uipath-orchestrator.myorg.com" default -A accountForExternalApp -I myExternalAppId -S myExternalAppSecret --applicationScope "OR.Folders.Read OR.Settings.Read".

Bereitstellen eines Pakets im Orchestrator

Voraussetzungen:

  • Erstellen Sie das Paket.
  • Führen Sie die CLI-Datei exe (für Windows) oder dll (für Linux) aus.
  • Fügen Sie unten die Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu:

    Anwendungs-Scope

    Beschreibung

    ODER.Assets

    Lese- und Schreibzugriff für Assets im Orchestrator.

    ODER.BackgroundTasks

    BackgroundTasks Lese- und Schreibzugriff im Orchestrator.

    ODER.Ausführung

    Lese- und Schreibzugriff für die Ausführung im Orchestrator.

    ODER.Ordner

    Lese- und Schreibzugriff für Ordner im Orchestrator.

    ODER.Aufträge

    Aufträge Lese- und Schreibzugriff im Orchestrator.

    ODER.Maschinen.Lesen

    Maschinen-Lesezugriff im Orchestrator.

    ODER.Überwachung

    Überwachen des Lese- und Schreibzugriffs im Orchestrator.

    OR.Robots.Read

    Lesezugriff von Robotern im Orchestrator.

    ODER.Einstellungen.Lesen

    Lesezugriff auf Einstellungen im Orchestrator.

    ODER.TestSets

    Lese- und Schreibzugriff für TestSets im Orchestrator.

    ODER.TestSetExecutions

    Lese- und Schreibzugriff für TestSetExecutions im Orchestrator.

    ODER.TestSetSchedules

    TestSetSchedules Lese- und Schreibzugriff im Orchestrator.

    ODER.Benutzer.Lesen

    Benutzer-Lesezugriff im Orchestrator.

  1. Führen Sie die package -Aufgabe mit uipcli package aus. Sie können eine Liste der verfügbaren Unteraufgaben anzeigen.
  2. Geben Sie die erforderlichen Parameter an und führen Sie die Unteraufgabe deploy aus.

    Siehe die Liste der Parameter unten.

    Parameter

    Beschreibung

    Package(s) Path (pos. 0) (Erforderlich)

    Der Pfad zu einer Paketdatei oder der Pfad zu einem Ordner, der mehrere Pakete enthält.

    Orchestrator URL (pos. 1) (Erforderlich)

    Die URL der Orchestrator-Instanz.

    Orchestrator-Mandant (Pos. 2)

    • (Erforderlich) für SaaP-Bereitstellungen.
    • (Optional) für PaaS-Bereitstellungen.

    Der Mandant der Orchestrator-Instanz, in der Sie eine Maschine löschen möchten.

    -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 Authentifizierung verwenden)

    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 Authentifizierung verwenden)

    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. 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 externe Anwendungs-ID. Sie müssen es mit dem Anwendungskonto, demgeheimenAnwendungsgeheimnis und dem Anwendungsbereich 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 Anwendungsbereiche, getrennt durch einzelne Leerzeichen. Sie müssen es mit dem Anwendungskonto, derAnwendungs-IDund dem geheimen Anwendungsgeheimnis für eine externe Anwendung koppeln.

    -c oder --createProcess
    Wenn auf truefestgelegt, wird ein Prozess im Orchestrator-Ordner erstellt, der im Befehl übergeben wird. Der Standardwert dafür ist True.
    Wenn auf falsefestgelegt, wird kein Prozess im Orchestrator-Ordner erstellt. Beispiel: --createProcess false..
    -e oder --environments (für klassische Ordner)

    Eine durch Kommas getrennte Liste der Umgebungen, in denen Sie das Paket bereitstellen möchten.

    Wenn die Umgebung nicht zum Standardordner (Organisationseinheit) gehört, müssen Sie dem Umgebungsnamen den Ordnernamen voranstellen. Wenn die Umgebung beispielsweise TestEnvironmentund der Ordnername AccountingTeamist, schreiben Sie die Umgebung als AccountingTeam\TestEnvironment.

    -h oder --entryPointsPath

    Definiert die spezifischen Einstiegspunkte zum Erstellen oder Aktualisieren des Prozesses. Dies ist der Dateipfad des Einstiegspunkts, beginnend beim Stamm des Projekts.

    Bei klassischen Ordnern kann für jede Umgebung nur ein einzelner Einstiegspunkt angegeben werden.

    -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 oder --language

    Die Sprache, die in der Orchestrator-Benutzeroberfläche verwendet wird.

    -y oder --disableTelemetry

    Deaktivieren der Telemetriedaten.

    --traceLevel

    Zeigt die Ablaufverfolgung der Ereignisse an.

    --identityUrl (Nur fürPaaS- Bereitstellungen erforderlich )

    Die URL Ihres Identitätsservers.

    --help

    Zeigt die Parameter und Beispiele für diesen Befehl an.

The uipcli creates a process with a default entry point if you do not specify one. If the entry point is specified, a process with that entry point is created and _{entryPoint} is appended to the process name. Additionally, all processes associated with the package.Id are updated to the latest version, regardless of whether the process was created manually or from a pipeline.

Beispiele:

  • package deploy "C:\UiPath\Project\TestsPackage.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -e SAPEnvironment,ExcelAutomationEnvironment -l en-US.
  • package deploy "C:\UiPath\Project\TestsPackage.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -A myAccountForExternalApp -I myExternalAppId -S myExternalAppSecret --applicationScope "OR.Folders.Read OR.Settings.Read".
  • package deploy "C:\UiPath\Project\TestsPackage.1.0.6820.22047.nupkg" "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -e SAPEnvironment,ExcelAutomationEnvironment -l en-US -h EntryPoint1,EntryPoint2.

Verpacken von Projekten in ein Paket

Voraussetzungen:

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

    Anwendungs-Scope

    Beschreibung

    ODER.Assets

    Lese- und Schreibzugriff für Assets im Orchestrator.

    ODER.BackgroundTasks

    BackgroundTasks Lese- und Schreibzugriff im Orchestrator.

    ODER.Ausführung

    Lese- und Schreibzugriff für die Ausführung im Orchestrator.

    ODER.Ordner

    Lese- und Schreibzugriff für Ordner im Orchestrator.

    ODER.Aufträge

    Aufträge Lese- und Schreibzugriff im Orchestrator.

    ODER.Maschinen.Lesen

    Maschinen-Lesezugriff im Orchestrator.

    ODER.Überwachung

    Überwachen des Lese- und Schreibzugriffs im Orchestrator.

    OR.Robots.Read

    Lesezugriff von Robotern im Orchestrator.

    ODER.Einstellungen.Lesen

    Lesezugriff auf Einstellungen im Orchestrator.

    ODER.TestSets

    Lese- und Schreibzugriff für TestSets im Orchestrator.

    ODER.TestSetExecutions

    Lese- und Schreibzugriff für TestSetExecutions im Orchestrator.

    ODER.TestSetSchedules

    TestSetSchedules Lese- und Schreibzugriff im Orchestrator.

    ODER.Benutzer.Lesen

    Benutzer-Lesezugriff im Orchestrator.

  1. Führen Sie die package -Aufgabe mit uipcli package aus. Sie können eine Liste der verfügbaren Unteraufgaben anzeigen.
  2. Geben Sie die erforderlichen Parameter an und führen Sie die Unteraufgabe pack aus.

    Siehe die Liste der Parameter unten.

Legende: (*) – Optional, nur nützlich, wenn Sie Abhängigkeiten von einer Bibliothek im Orchestrator haben.

Parameter

Beschreibung

Project(s) Path (pos. 0) (erforderlich)
Der Pfad zu einer project.json -Datei oder zu einem Ordner, der project.json -Dateien enthält.
-o, or --output (Required)

Der Ziel-Orchestrator-Ordner, in den Sie die Projekte packen möchten.

-v, or --version

Legen Sie die Paketversion fest.

--autoVersion

Eine Paketversion automatisch generieren.

--outputType

Die Ausgabe in einem bestimmten Typ erzwingen.

--libraryOrchestratorUsername (*)

(Erforderlich, wenn Sie die Standardauthentifizierung 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.

Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist

--libraryOrchestratorPassword (*)

(Erforderlich, wenn Sie die Standardauthentifizierung 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.

Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist

--libraryOrchestratorAuthToken (*)

(Erforderlich, wenn Sie tokenbasierte Authentifizierung verwenden)

Das OAuth2-Aktualisierungstoken , das für die Authentifizierung beim Orchestrator verwendet wird. Sie müssen ihn mit dem Kontonamen und der Client-ID koppeln.

Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist

--libraryOrchestratorAccountName (*)

(Erforderlich, wenn Sie tokenbasierte Authentifizierung verwenden)

Der Name des Orchestrator-CloudRPA-Kontos. Sie müssen es mit dem OAuth2-Aktualisierungstoken und der Client-IDkoppeln.

Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist

--libraryOrchestratorAccountForApp (*)

Der Name des Orchestrator-CloudRPA-Kontos. Sie müssen ihn mit der Anwendungs-ID, dem Anwendungsgeheimnis und dem Anwendungs-Scope für eine externe Anwendung koppeln.

Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist

--libraryOrchestratorApplicationId (*)

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

Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist

--libraryOrchestratorApplicationSecret (*)

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

Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist

--libraryOrchestratorApplicationScope (*)

(Erforderlich, wenn Sie die Authentifizierung über externe Anwendungen verwenden)

Die Liste der Anwendungsbereiche, getrennt durch einzelne Leerzeichen. Sie müssen es mit dem Anwendungskonto, derAnwendungs-IDund dem geheimen Anwendungsgeheimnis für eine externe Anwendung koppeln.

Dies ist erforderlich, wenn Ihr Paket auf Bibliotheken aus dem Orchestrator-Feed verweist

--libraryOrchestratorFolder (*)

Der Name des Ziel-Orchestrator-Ordners.

Um Unterordner einzugeben, geben Sie sowohl den Namen des übergeordneten Ordners als auch den Namen des Unterordners ein. Zum Beispiel AccountingTeam\TeamJohn.
--libraryOrchestratorUrl (*)

Die URL der Orchestrator-Instanz.

--libraryOrchestratorTenant (*)

Der Mandant der Orchestrator-Instanz, in der Sie eine Maschine löschen möchten.

-y, or --disableTelemetry

Deaktivieren der Telemetriedaten.

--traceLevel

Zeigt die Ablaufverfolgung der Ereignisse an.

-l, or --language

Die Sprache, die in der Orchestrator-Benutzeroberfläche verwendet wird.

--help

Zeigt die Parameter und Beispiele für diesen Befehl an.

Beispiele:

  • package pack "C:\UiPath\Project\project.json" -o "C:\UiPath\Package" -v 1.0.6820.22047.
  • package pack "C:\UiPath\Project\project.json" -o "C:\UiPath\Package" --autoVersion.
  • package pack "C:\UiPath\Project\project.json" -o "C:\UiPath\Package" --outputType Tests -l en-US.

Testen eines Pakets/Ausführen eines Testsatzes

Voraussetzungen:

  • Erstellen Sie ein Paket oder einen Testsatz.
  • Führen Sie die CLI-Datei exe (für Windows) oder dll (für Linux) aus.
  • Fügen Sie unten die Anwendungs-Scopes für den Zugriff auf die Orchestrator-API hinzu:

    Anwendungs-Scope

    Beschreibung

    ODER.Assets

    Lese- und Schreibzugriff für Assets im Orchestrator.

    ODER.BackgroundTasks

    BackgroundTasks Lese- und Schreibzugriff im Orchestrator.

    ODER.Ausführung

    Lese- und Schreibzugriff für die Ausführung im Orchestrator.

    ODER.Ordner

    Lese- und Schreibzugriff für Ordner im Orchestrator.

    ODER.Aufträge

    Aufträge Lese- und Schreibzugriff im Orchestrator.

    ODER.Maschinen.Lesen

    Maschinen-Lesezugriff im Orchestrator.

    ODER.Überwachung

    Überwachen des Lese- und Schreibzugriffs im Orchestrator.

    OR.Robots.Read

    Lesezugriff von Robotern im Orchestrator.

    ODER.Einstellungen.Lesen

    Lesezugriff auf Einstellungen im Orchestrator.

    ODER.TestSets

    Lese- und Schreibzugriff für TestSets im Orchestrator.

    ODER.TestSetExecutions

    Lese- und Schreibzugriff für TestSetExecutions im Orchestrator.

    ODER.TestSetSchedules

    TestSetSchedules Lese- und Schreibzugriff im Orchestrator.

    ODER.Benutzer.Lesen

    Benutzer-Lesezugriff im Orchestrator.

  1. Führen Sie die test -Aufgabe mit uipcli test aus. Sie können eine Liste der verfügbaren Unteraufgaben anzeigen.
  2. Geben Sie die erforderlichen Parameter an und führen Sie die Unteraufgabe run aus.

    Siehe die Liste der Parameter unten.

    Parameter

    Beschreibung

    Orchestrator URL (pos. 0) (Erforderlich)

    Die URL der Orchestrator-Instanz.

    Orchestrator Tenant (pos. 1)

    • (Erforderlich) für SaaP-Bereitstellungen.
    • (Optional) für PaaS-Bereitstellungen.

    Der Mandant, in dem sich das Paket oder der Testsatz befindet.

    -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 Authentifizierung verwenden)

    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 Authentifizierung verwenden)

    Der Name des Orchestrator-CloudRPA-Kontos. Sie müssen es mit dem OAuth2-Aktualisierungstoken und der Client-IDkoppeln.

    -A, --accountForApp

    Der Name des Orchestrator-CloudRPA-Kontos. Sie müssen sie mit der Anwendungs-ID, demgeheimenAnwendungsgeheimnis und dem Anwendungsbereich für eine externe Anwendung koppeln.

    -I oder --applicationId (Erforderlich, wenn Sie die Authentifizierung über externe Anwendungen verwenden).

    Die externe Anwendungs-ID. Sie müssen es mit dem Anwendungskonto, demgeheimenAnwendungsgeheimnis und dem Anwendungsbereich 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.

    -P oder --project-path

    Der Pfad zur Testpaketdatei, die Sie testen möchten.

    -s oder --testset
    Der Name, der für den Testsatz angezeigt wird, den Sie ausführen möchten. Stellen Sie sicher, dass der Testsatz die neueste Version der Testfälle enthält.
    Wenn sich der Testsatz nicht im Standardordner befindet, stellen Sie sicher, dass Sie den entsprechenden Ordnernamen davor einschließen. Zum Beispiel AccountingTeam\TestSet.

    --out

    Der Typ der Datei, die die Ergebnisse zurückgibt.

    -r oder --result_path

    Der Zielpfad der Datei, in der Sie die Ergebnisse speichern möchten.

    -e oder --environment (erforderlich für klassische Ordner)
    Die Umgebung, in der Sie das Paket bereitstellen möchten. Sie müssen es mit dem project path .
    -w oder --timeout

    Die Zeit (in Sekunden), die Sie auf die Ausführung des Testsatzes warten möchten. Der Standardwert ist 7200 Sekunden.

    -i oder --input_path (Erforderlich , wenn der Einstiegspunkt-Workflow Eingabeparameter hat, die Sie über die Befehlszeile übergeben möchten)

    Der vollständige Pfad zu einer JSON-Eingabedatei.

    --attachRobotLogs

    Fügt Roboterprotokolle für jeden ausgeführten Testfall und einen JUnit-Testbericht an.

    -o oder --organizationUnit

    Der Orchestrator-Ordner, in dem Sie die Testsätze ausführen möchten.

    -l oder --language

    Die Sprache, die in der Orchestrator-Benutzeroberfläche verwendet wird.

    -y oder --disableTelemetry

    Deaktivieren der Telemetriedaten.

    --traceLevel

    Zeigt die Ablaufverfolgung der Ereignisse an.

    --identityURL (Nur für PaaS-Bereitstellungenerforderlich )

    Die URL Ihres Identitätsservers.

    --help

    Zeigt die Parameter und Beispiele für diesen Befehl an.

Beispiele:

  • test run "https://uipath-orchestrator.myorg.com" default -A myAccountForExternalApp -I myExternalAppId -S myExternalAppSecret --applicationScope "OR.Folders.Read OR.Settings.Read" -s "MyRobotTests".
  • test run "https://uipath-orchestrator.myorg.com" default -t a7da29a2c93a717110a82 -a myAccount -P "C:\UiPath\Project\project.json" -e TestingEnv -r "C:\results.json" --out uipath -l en-US.
  • test run "https://uipath-orchestrator.myorg.com" default -t a7da29a2c93a717110a82 -a myAccount -P "C:\UiPath\Project\project.json" -e TestingEnv -r "C:\results.json" -i "C:\UiPath\Project\input-params.json" --out uipath -l en-US --attachRobotLogs "true".

War diese Seite hilfreich?

Hilfe erhalten
RPA lernen – Automatisierungskurse
UiPath Community-Forum
UiPath Logo weiß
Vertrauen und Sicherheit
© 2005-2024 UiPath. All rights reserved.