automation-ops
LATEST
false
UiPath logo, featuring letters U and I in white
Automation Ops Benutzerhandbuch
Automation CloudAutomation Cloud Public SectorAutomation Suite
Last updated 23. Okt. 2024

Jobs

UiPath-Installationsplattform

Sie können die UiPathInstallPlatform- Aufgabe verwenden, wenn:

  • Sie möchten eine andere Version der CLI herunterladen, um beispielsweise Windows- und plattformübergreifende Projekte zu packen.
  • Die Build-Agents haben keinen Zugriff auf den UiPath-NuGet-Feed.

    Sie sollten die UiPathInstallPlatform- Aufgabe vor allen anderen Aufgaben im Plugin ausführen. Die UiPath InstallPlatform- Aufgabe lädt die CLI nur dann aus dem öffentlichen NuGet-Feed herunter, wenn die kompatible Version nicht im Cache verfügbar ist.



CLI-Versionsauswahl

Wählen Sie die Version der CLI, die Sie mit Ihrer Azure DevOps-Erweiterung verwenden möchten, aus der Dropdownliste CLI-Version auswählen aus.

Die Optionen in der Dropdownliste umfassen:

  • Die neuesten verfügbaren Versionen der CLI.
  • Die Umgebungsanforderungen, die mit der von Ihnen ausgewählten CLI-Version kompatibel sein müssen.


Pfad zu nupkg . der CLI

Wenn Ihre Pipeline nicht auf den öffentlichen UiPath-Feed zugreifen kann und die CLI-Version, die Sie aus der Dropdownliste ausgewählt haben, nicht herunterladen kann, führen Sie die folgenden Schritte aus:

  1. Laden Sie die gewünschte CLI-Version aus dem öffentlichen UiPath-Feed herunter.
  2. Legen Sie die heruntergeladene NUPKG-Datei im Agent-Arbeitsbereichsverzeichnis Ihres Build-Agenten ab. Merken Sie sich den Pfad der NUPKG-Datei im Verzeichnis des Agent-Arbeitsbereichs. Beispiel: ${WORKSPACE}\nupkg\UiPath.CLI.xx.xx.xx.nupkg

    Verwenden Sie die Task InstallPlatform , und geben Sie den in Schritt 2 verwendeten Pfad in das Feld Path to CLI's nupkg ein.

UiPath Run Job

Der UiPath Run Job Schritt startet nach der Erstellung einen Prozess, der bereits auf einer Orchestrator-Instanz implementiert wurde. In der Orchestrator-Version 2020.10 finden Sie die Prozesse, die von dieser Aufgabe ausgeführt werden, auf der Registerkarte Prozesse. In Orchestrator-Versionen 2021.10 und höher finden Sie die Prozesse, die von dieser Aufgabe ausgeführt werden, in Automatisierungen unter Prozesse.



Konfiguration

Auftragsparameter

Beschreibung

Prozess (erforderlich)

Prozessname. Sie können den Prozessnamen aus der Orchestrator-UI verwenden.

Wenn der Prozess in einem modernen Ordner bereitgestellt wird, sollte dieses Argument der Name des Prozesses auf der Registerkarte Prozesse sein. Wenn der Prozess in einem klassischen Ordner bereitgestellt wird, muss das Argument aus dem Namen des Prozesses und der Umgebung bestehen (z. B. NAME: ProcessA ENVIRONMENT: Production ProcessName: ProcessA_Production ).

Parameter

Der vollständige Pfad zu einer JSON-Eingabedatei. Dies wird verwendet, wenn der Prozess eine Eingabe erfordert.

Beispiel für ein JSON-Dateiformat:

{
  "StringArgument_In": "MyConfigurationValue",
  "IntArgument_In": 1,
  "DictionaryArgument_In": {
    "Key1": "Value1",
    "Key2": "Value2"
  }
}{
  "StringArgument_In": "MyConfigurationValue",
  "IntArgument_In": 1,
  "DictionaryArgument_In": {
    "Key1": "Value1",
    "Key2": "Value2"
  }
}

Priorität

Die Priorität der Auftragsausführung.

Strategy

Geben Sie die Auftragsausführungsstrategie, dynamisch zugeordnete Aufträge oder roboterspezifische Aufträge an. Es gibt die folgenden Optionen:

  • Dynamisch zuweisen
  • Bestimmte Roboter

Auftragstyp (nur für moderne Ordner verfügbar)

Wählen Sie das Lizenzmodell der Runtime aus, unter der der Auftrag ausgeführt werden soll.

Orchestrator-Adresse

Die Adresse der Orchestrator-Instanz, in der Sie den Prozess ausführen.

Orchestrator-Mandant

Geben Sie den Orchestrator-Mandanten an.

Orchestrator-Ordner

Geben Sie den Ordner an, in dem der angegebene Prozess bereitgestellt wurde.
Um Unterordner einzugeben, geben Sie sowohl den Namen des übergeordneten Ordners als auch den Namen des Unterordners ein. Zum Beispiel AccountingTeam\TeamJohn.

Authentication

Für die Authentifizierung gegenüber Orchestrator müssen Sie im Voraus Anmeldeinformationen in Jenkins erstellen. Es gibt vier Optionen für die Authentifizierung:

(1) Authentifizierung bei einer lokalen Orchestrator-Instanz mit einem Benutzernamen und einem Kennwort.

(2) Authentifizieren Sie sich bei einem Cloud Orchestrator mithilfe eines Aktualisierungstokens (API-Schlüssel).

(3) Authentifizieren Sie sich bei einem Cloud-Orchestrator mithilfe einer externen App-Authentifizierung.

(4) Authentifizieren Sie sich bei einem lokalen Orchestrator mithilfe der externen App-Authentifizierung.

Ausgabepfad der Auftragsergebnisse

Geben Sie den Ausgabepfad der Auftragsergebnisse an (z. B. testResults.json ). Die Ergebnisse werden im JSON-Format ausgegeben.
Wenn nicht angegeben, werden die Ergebnisse als UiPathResults.json an das Artefakt-Staging-Verzeichnis ausgegeben. Die Ausgabe ist im JSON-Format.

Zeitüberschreitung

Geben Sie das Timeout für Auftragsausführungen in Sekunden an.

Fehlschlagen bei Auftragsfehler

Die Aufgabe schlägt fehl, wenn mindestens ein Auftrag fehlschlägt. Der Standardwert ist True.

Auf Auftragsabschluss warten

Es wird auf den Abschluss der Auftragsausführung gewartet. Der Standardwert ist True.

Protokollierungsstufe der Ablaufverfolgung

Einstellung zum Aktivieren der Ablaufverfolgungsprotokollierung auf einer der folgenden Ebenen:

  • Keine
  • Kritisch
  • Fehler (Error)
  • Warnung
  • Informationen
  • Ausführlich. (Die Standardeinstellung ist None).

    Nützlich für Debugzwecke.

Anzahl von Aufträgen

Die Anzahl der Auftragsausführungen. Der Standardwert ist 1.

Benutzer (nur für moderne Ordner verfügbar)

Der Name des Benutzers. Dies muss ein Maschinenbenutzer und kein Orchestrator-Benutzer sein.

Für lokale Benutzer sollte das Format MachineName\UserName lauten.

Maschine (nur für moderne Ordner verfügbar)

Der Name des Computers.

Roboternamen

Kommagetrennte Liste bestimmter Roboternamen.

Pipeline-Beispiel

pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
        UiPathRunJob(
          credentials: UserPass('825c83c9-9a14-44eb-883a-af54f8078af0'),
          failWhenJobFails: true,
          folderName: 'A_Classic',
          orchestratorAddress: 'https://testorchestrator.some-domain.com',
          orchestratorTenant: 'Default',
          parametersFilePath: '',
          priority: 'Low',
          processName: 'ProcessA_EnvB',
          resultFilePath: 'output.json',
          strategy: Dynamically(jobsCount: 1, machine: 'TestMachine', user: 'TestUser'), timeout: 3600, waitForJobCompletion: true, traceLoggingLevel: 'None'
        )
        UiPathRunJob(
          credentials: UserPass('825c83c9-9a14-44eb-883a-af54f8078af0'),
          failWhenJobFails: true,
          folderName: 'A_Classic',
          orchestratorAddress: 'https://testorchestrator.some-domain.com',
          orchestratorTenant: 'Default',
          parametersFilePath: '',
          priority: 'Low',
          processName: 'ProcessA_EnvB',
          resultFilePath: 'output.json',
          strategy: Robot('robot1,robot2'),
          timeout: 1800,
          waitForJobCompletion: false,
          traceLoggingLevel: 'None'
        )
    }
  }
}pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
        UiPathRunJob(
          credentials: UserPass('825c83c9-9a14-44eb-883a-af54f8078af0'),
          failWhenJobFails: true,
          folderName: 'A_Classic',
          orchestratorAddress: 'https://testorchestrator.some-domain.com',
          orchestratorTenant: 'Default',
          parametersFilePath: '',
          priority: 'Low',
          processName: 'ProcessA_EnvB',
          resultFilePath: 'output.json',
          strategy: Dynamically(jobsCount: 1, machine: 'TestMachine', user: 'TestUser'), timeout: 3600, waitForJobCompletion: true, traceLoggingLevel: 'None'
        )
        UiPathRunJob(
          credentials: UserPass('825c83c9-9a14-44eb-883a-af54f8078af0'),
          failWhenJobFails: true,
          folderName: 'A_Classic',
          orchestratorAddress: 'https://testorchestrator.some-domain.com',
          orchestratorTenant: 'Default',
          parametersFilePath: '',
          priority: 'Low',
          processName: 'ProcessA_EnvB',
          resultFilePath: 'output.json',
          strategy: Robot('robot1,robot2'),
          timeout: 1800,
          waitForJobCompletion: false,
          traceLoggingLevel: 'None'
        )
    }
  }
}

JSON-Eingabedatei

Um die Aufgabe „ Run Job “ zu konfigurieren, geben Sie eine JSON-Datei ein, die die Parameter enthält, die für die Ausführung des Prozesses im Orchestrator erforderlich sind. Der Orchestrator validiert nur primitive Werte. Nachfolgend finden Sie eine Übersicht über die erforderlichen Formate für Eingabeparameter, die an Orchestrator übergeben werden können:

ParameterErforderliches FormatBeispiel
StringSetzen Sie den Wert in Anführungszeichen.'string value'
Int32Geben Sie den Wert wie bei einem Integer an.11
BoolescherGeben Sie den Wert entweder als true oder falsean. true
DoubleGeben Sie einen Gleitkommawert an.3.5
DateTimeGeben Sie eine gültige JSON-Darstellung an."2012-04-23T18:25:43.511Z"
ArrayGeben Sie Werte als gültiges JSON an.[1,1,2,3,5,8] oder ["firstString", "secondString"]

JSON-Beispielschema

Das folgende JSON-Schema zeigt, wie die erforderlichen Parameter in eine JSON-Datei eingegeben werden. Stellen Sie sicher, dass die in der JSON-Datei übergebenen Argumente in dem Studio-Projekt vorhanden sind, das zum Veröffentlichen des Prozesses im Orchestrator verwendet wird.

{
    'in_JenkinsBaseUrl': 'http://localhost:8080/jenkins/',
    'in_JenkinsBuildName': '02_UiPathApplicationDemo'
}{
    'in_JenkinsBaseUrl': 'http://localhost:8080/jenkins/',
    'in_JenkinsBuildName': '02_UiPathApplicationDemo'
}

UiPath Manage Assets

Mit dem Schritt UiPath Assets verwalten können Sie Assets auf einer Orchestrator-Instanz bereitstellen, aktualisieren oder löschen. Um Assets bereitzustellen, müssen Sie sie in einer CSV-Datei wie im folgenden Beispiel beschreiben, die in uft-8 codiert ist.
name,type,value,description
asset_1_name,text,asset_value,this is an test description   # we can have comments
asset_2_name,integer,123
asset_3_name,boolean,false
asset_4_name,credential,"username::password"name,type,value,description
asset_1_name,text,asset_value,this is an test description   # we can have comments
asset_2_name,integer,123
asset_3_name,boolean,false
asset_4_name,credential,"username::password"

Es gibt vier Arten von Assets:

  • Text
  • Integer
  • Boolescher
  • Anmeldeinformationen. Für die Anmeldeinformationen müssen Sie den Benutzernamen und das Kennwort codieren, indem Sie :: verwenden, um die beiden Felder zu trennen.


Konfiguration

Auftragsparameter

Beschreibung

Aktion

Was mit den bereitgestellten Assets zu tun ist: Bereitstellen oder Löschen. Wenn ein bereitgestelltes Asset vorhanden ist, wird es stattdessen aktualisiert.

Orchestrator-Adresse

Die Adresse der Orchestrator-Instanz, in der Sie Assets bereitstellen oder aktualisieren.

Orchestrator-Mandant

Geben Sie den Orchestrator-Mandanten an, auf dem die Assets bereitgestellt oder aktualisiert werden sollen.

Orchestrator-Ordner

Geben Sie den Ordner an, in dem Assets bereitgestellt oder aktualisiert werden.

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

Authentication

Für die Authentifizierung gegenüber Orchestrator müssen Sie im Voraus Anmeldeinformationen in Jenkins erstellen. Es gibt vier Optionen für die Authentifizierung:

(1) Authentifizierung bei einer lokalen Orchestrator-Instanz mit einem Benutzernamen und einem Kennwort.

(2) Authentifizieren Sie sich bei einem Cloud Orchestrator mithilfe eines Aktualisierungstokens (API-Schlüssel).

(3) Authentifizieren Sie sich bei einem Cloud-Orchestrator mithilfe einer externen App-Authentifizierung.

(4) Authentifizieren Sie sich bei einem lokalen Orchestrator mithilfe der externen App-Authentifizierung.

CSV-Dateipfad

Der Pfad zur CSV-Datei mit den Asset-Details. Dieselbe Datei kann zum Bereitstellen oder Aktualisieren der Assets verwendet werden, obwohl der Typ für Updates nicht erforderlich ist.

Das Feld type kann auch leer sein, aber die Spalte muss vorhanden sein. Beim Löschen wird nur die Spalte name verwendet, sodass die anderen Spalten leer sein können, aber vorhanden sein müssen.
Sie können für jedes Asset eine optionale Beschreibung festlegen (z. B.: type , value , description ). Stellen Sie sicher, dass Sie alle Zeilenumbrüche entfernen, da jede Zeile als neues Asset interpretiert wird.

Protokollierungsstufe der Ablaufverfolgung

Einstellung zum Aktivieren der Ablaufverfolgungsprotokollierung auf einer der folgenden Ebenen:

  • Keine
  • Kritisch
  • Fehler (Error)
  • Warnung
  • Informationen
  • Ausführlich. (Die Standardeinstellung ist None).

    Nützlich für Debugzwecke.

Pipeline-Beispiel

pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
        UiPathAssets (
            assetsAction: DeployAssets(), 
            credentials: Token(accountName: '', credentialsId: ''), 
            filePath: '${WORKSPACE}/test.csv', 
            folderName: 'Default', 
            orchestratorAddress: 'https://test-orchestrator.somedomain.com', 
            orchestratorTenant: 'Default',
            traceLoggingLevel: 'None'
        )
        UiPathAssets(
            assetsAction: DeleteAssets(),
            credentials: UserPass('825c83c9-9a14-44eb-883a-af54f8078af0'),
            filePath: '${WORKSPACE}/test.csv',
            folderName: 'Default',
            orchestratorAddress: 'https://test-orchestrator.somedomain.com',
            orchestratorTenant: 'Default',
            traceLoggingLevel: 'None'
        )
    }
  }
}pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
        UiPathAssets (
            assetsAction: DeployAssets(), 
            credentials: Token(accountName: '', credentialsId: ''), 
            filePath: '${WORKSPACE}/test.csv', 
            folderName: 'Default', 
            orchestratorAddress: 'https://test-orchestrator.somedomain.com', 
            orchestratorTenant: 'Default',
            traceLoggingLevel: 'None'
        )
        UiPathAssets(
            assetsAction: DeleteAssets(),
            credentials: UserPass('825c83c9-9a14-44eb-883a-af54f8078af0'),
            filePath: '${WORKSPACE}/test.csv',
            folderName: 'Default',
            orchestratorAddress: 'https://test-orchestrator.somedomain.com',
            orchestratorTenant: 'Default',
            traceLoggingLevel: 'None'
        )
    }
  }
}

UiPath Pack

Anwendung: RPA

Typ: Aufgabe erstellen

UiPath Pack ist in Standardaufträgen und Pipelines verfügbar und ermöglicht es Ihnen, ein vorhandenes UiPath-Projekt in ein NuGet-Paket zu packen.



Konfiguration

Auftragsparameter

Beschreibung

Versionsverwaltungsmethode auswählen

UiPath-Pakete sind versioniert. Mit dem UiPath-Paket können Sie zwischen 3 verschiedenen Optionen wählen:

(1) Automatisch generieren

(2) Benutzerdefinierte Version definieren

(3) Verwenden Sie die aktuelle Version, die im Projekt festgelegt ist.

Projektpfad

Speicherort der zu packenden Projekte. Dies kann ein direkter Pfad zu einer project.json-Datei oder einem Verzeichnis mit einem oder mehreren Projekten sein. Im letzteren Fall wird jedes Projekt der Ebene eins einzeln gepackt.

Ausgabeordner

Pfad zu einem Ordner, in dem Sie das Paket erstellen möchten.

Ausgabetyp

Der Ausgabetyp des Projekts/der Projekte. Es gibt 5 Optionen für den/die Projekttyp(e):

(1) Ausgabetyp des Projekts

(2) Verpacken eines Prozessprojekts

(3) Ein Bibliotheksprojekt packen

(4) Packen Sie ein Testprojekt

(5) Packen Sie ein Objektprojekt.

Workflow-Analyse ausführen

Führen Sie die Workflow-Analyse vor dem Packen aus und überprüfen Sie das Projekt anhand vordefinierter Regeln auf Verstöße. Bei Fehlern wird der Auftrag fehlgeschlagen. Standardmäßig wird die Analyse nicht ausgeführt.

Protokollierungsstufe der Ablaufverfolgung

Einstellung zum Aktivieren der Ablaufverfolgungsprotokollierung auf einer der folgenden Ebenen:

  • Keine
  • Kritisch
  • Fehler (Error)
  • Warnung
  • Informationen
  • Ausführlich. (Die Standardeinstellung ist None).

    Nützlich für Debugzwecke.

Orchestrator verwenden

Verwenden Sie den Orchestrator-Feed, wenn Sie Bibliotheken verpacken. Der Orchestrator muss 20.4 oder höher sein. Der Bibliotheksfeed muss die API-Schlüssel-Authentifizierung unter Mandant > Einstellung > Bereitstellungzulassen.

Orchestrator-Adresse

Die Adresse der Orchestrator-Instanz, auf der Bibliotheksabhängigkeiten wiederhergestellt werden sollen.

Orchestrator-Mandant

Der Orchestrator-Mandant, von dem Bibliotheksabhängigkeiten wiederhergestellt werden sollen.

Authentication

Für die Authentifizierung gegenüber Orchestrator müssen Sie im Voraus Anmeldeinformationen in Jenkins erstellen. Es gibt vier Optionen für die Authentifizierung:

(1) Authentifizierung bei einer lokalen Orchestrator-Instanz mit einem Benutzernamen und einem Kennwort.

(2) Authentifizieren Sie sich bei einem Cloud Orchestrator mithilfe eines Aktualisierungstokens (API-Schlüssel).

(3) Authentifizieren Sie sich bei einem Cloud-Orchestrator mithilfe einer externen App-Authentifizierung.

(4) Authentifizieren Sie sich bei einem lokalen Orchestrator mithilfe der externen App-Authentifizierung.

Pipeline-Beispiel

ipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
      steps {
        UiPathPack (
          outputPath: "Output\)\)\)\)${env.BUILD_NUMBER}",
          projectJsonPath: "UiBank\)\)\)\)project.json",
          version: [$class: 'ManualVersionEntry', version: "${MAJOR}.${MINOR}.${env.BUILD_NUMBER}"]
          useOrchestrator: true,
          traceLoggingLevel: "None",
          orchestratorAddress: "OrchestratorUrl",
          orchestratorTenant: "tenant name",
          credentials: [$class: 'UserPassAuthenticationEntry', credentialsId: “credentialsId”]
        )
      }
    }
  }
}ipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('Build') {
      steps {
        UiPathPack (
          outputPath: "Output\)\)\)\)${env.BUILD_NUMBER}",
          projectJsonPath: "UiBank\)\)\)\)project.json",
          version: [$class: 'ManualVersionEntry', version: "${MAJOR}.${MINOR}.${env.BUILD_NUMBER}"]
          useOrchestrator: true,
          traceLoggingLevel: "None",
          orchestratorAddress: "OrchestratorUrl",
          orchestratorTenant: "tenant name",
          credentials: [$class: 'UserPassAuthenticationEntry', credentialsId: “credentialsId”]
        )
      }
    }
  }
}

UiPath Deploy

Anwendung: RPA

Typ: Post-Build-Aufgabe

UiPath Deploy ist in Standardaufträgen und Pipelines verfügbar und ermöglicht Ihnen die Bereitstellung eines UiPath NuGet-Pakets auf dem UiPath Orchestrator.



Konfiguration

Auftragsparameter

Beschreibung

Paketpfad

Der Ordner, der Ihre UiPath-Nuget-Pakete enthält.

Orchestrator-Adresse

Die Adresse der Orchestrator-Instanz, auf der die Pakete bereitgestellt werden sollen.

Orchestrator-Mandant

Der Orchestrator-Mandant, auf dem die Pakete bereitgestellt werden sollen.

Orchestrator-Ordner

Der Ordner, in dem bereitgestellt werden soll. Wenn es sich bei dem Ordner um einen klassischen Ordner handelt, müssen Sie auch das Umgebungsfeld (environments) festlegen. Für moderne Ordner ist das Festlegen des Feldes environments nicht erforderlich.
Um Unterordner einzugeben, geben Sie sowohl den Namen des übergeordneten Ordners als auch den Namen des Unterordners ein. Zum Beispiel AccountingTeam\TeamJohn.

Umgebungen (erforderlich für klassische Ordner)

Die Umgebung, in der das Paket als Prozess bereitgestellt wird. Für das Projekt und die Umgebung mit vorhandenen Prozessen werden die Prozesse aktualisiert, um die neueste Projektversion zu verwenden. Geben Sie die Umgebung an, in der das Paket als Prozess bereitgestellt wird. Für das Projekt und die Umgebung mit vorhandenen Prozessen werden die Prozesse aktualisiert, um die neueste Projektversion zu verwenden.

Einstiegspunkte

Geben Sie Einstiegspunkte an, um einen Prozess zu erstellen oder zu aktualisieren. Der Einstiegspunkt gibt den Dateipfad an, beginnend mit dem Stamm des Projekts.

Bedingungen:

  • Einstiegspunkte sind für die Orchestrator-Version 21.4 oder höher verfügbar (z. B. 21.4.UiPathDeploy.entryPoints). Bei Orchestrator-Versionen unter 21.4 müssen Sie einen beliebigen Wert eingeben, da das Feld nicht leer bleiben darf.
  • Standardeinstiegspunkt auf Main.xaml festgelegt.
  • Für klassische Ordner (veraltet) können Sie für jede Umgebung nur einen Einstiegspunkt angeben.
  • Weitere Informationen finden Sie unter Orchestrator-Einstiegspunkte.

Authentication

Für die Authentifizierung gegenüber Orchestrator müssen Sie im Voraus Anmeldeinformationen in Jenkins erstellen. Es gibt vier Optionen für die Authentifizierung:

(1) Authentifizierung bei einer lokalen Orchestrator-Instanz mit einem Benutzernamen und einem Kennwort.

(2) Authentifizieren Sie sich bei einem Cloud Orchestrator mithilfe eines Aktualisierungstokens (API-Schlüssel).

(3) Authentifizieren Sie sich bei einem Cloud-Orchestrator mithilfe einer externen App-Authentifizierung.

(4) Authentifizieren Sie sich bei einem lokalen Orchestrator mithilfe der externen App-Authentifizierung.

Protokollierungsstufe der Ablaufverfolgung

Einstellung zum Aktivieren der Ablaufverfolgungsprotokollierung auf einer der folgenden Ebenen:

  • Keine
  • Kritisch
  • Fehler (Error)
  • Warnung
  • Informationen
  • Ausführlich. (Die Standardeinstellung ist None).

    Nützlich für Debugzwecke.

Hinweis:

Stellen Sie sicher, dass Ihr Netzwerk den Zugriff auf den folgenden NuGet-Paketfeed zulässt:

  • https://api.nuget.org/v3/index.json
  • https://uipath.pkgs.visualstudio.com/_packaging/nuget-packages/nuget/v3/index.json
  • https://uipath.pkgs.visualstudio.com/Public.Feeds/_packaging/UiPath-* Internal/nuget/v3/index.json
  • https://www.myget.org/F/workflow
  • http://www.myget.org/F/uipath
  • https://www.myget.org/F/uipath-dev/api/v3/index.json

Pipeline-Beispiel

pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('PostBuild') {
      steps {
        UiPathDeploy (
          packagePath: "path\)\)\)    o\)\)NuGetpackage",
          orchestratorAddress: "OrchestratorUrl",
          orchestratorTenant: "tenant name",
          folderName: "folder name",
          environments: "environment",
          credentials: [$class: 'UserPassAuthenticationEntry', credentialsId: “credentialsId”],
          traceLoggingLevel: 'None'
        )
      }
    }
  }
}pipeline {
  agent any
  environment {
      MAJOR = '1'
      MINOR = '0'
  }
  stages {
    stage ('PostBuild') {
      steps {
        UiPathDeploy (
          packagePath: "path\)\)\)    o\)\)NuGetpackage",
          orchestratorAddress: "OrchestratorUrl",
          orchestratorTenant: "tenant name",
          folderName: "folder name",
          environments: "environment",
          credentials: [$class: 'UserPassAuthenticationEntry', credentialsId: “credentialsId”],
          traceLoggingLevel: 'None'
        )
      }
    }
  }
}

UiPath Run Tests

Anwendung: Testen

Typ: Post-Build-Aufgabe

UiPath Run Tests ist in Standardaufträgen und Pipelines verfügbar und ermöglicht Ihnen:

  • Führen Sie einen vorhandenen Testsatz im Orchestrator aus.
  • Verpacken, Bereitstellen und Ausführen von Testfällen, indem Sie den Pfad zu einem UiPath-Testprojekt angeben.

Nach Abschluss des Testlaufs wird die Registerkarte Testergebnis im Jenkins-Build veröffentlicht, in der die detaillierten Ergebnisse angezeigt werden. Darüber hinaus wird eine JUnit-Testergebnisdatei im Ausgabepfad der Testergebnisse erstellt, wenn angegeben, oder im Stammverzeichnis des Arbeitsbereichs, wenn nicht angegeben.

Je nach Ergebnis wird der Build entweder als erfolgreich (alle Testfälle wurden bestanden) oder als instabil (mindestens ein Testfall fehlgeschlagen) markiert.



Konfiguration

Auftragsparameter

Beschreibung

Ziel

  • Geben Sie einen vorhandenen Testsatz im UiPath Orchestrator an (um den Testsatz auszuführen).
  • Geben Sie den project.json -Pfad eines UiPath Testing-Projekts an (um das Testprojekt auszuführen).

Ausgabepfad der Testergebnisse

Der ausgeführte Testsatz gibt das Testergebnis als junit.xml zurück. Geben Sie den Pfad an, in dem das Ergebnis relativ zum Jenkins-Arbeitsbereichsverzeichnis gespeichert werden soll (z. B. result.xml ).

Eingabeparameter

Definieren Sie benutzerdefinierte Argumente für Ihre Testfälle, um Standardwerte auf Testsatzebene zu überschreiben. Über die Argumente können Sie die Testfälle zur Laufzeit parametrisieren. Um Argumente zu definieren, müssen Sie ein Paket mit Argumenten veröffentlicht haben.

Orchestrator-Adresse

Die Adresse der Orchestrator-Instanz, auf der die Pakete bereitgestellt werden sollen.

Orchestrator-Mandant

Der Orchestrator-Mandant, auf dem die Pakete bereitgestellt werden sollen.

Orchestrator-Ordner

Der Ordner, in dem bereitgestellt werden soll.

Wenn es sich bei dem Ordner um einen klassischen Ordner handelt, müssen Sie auch das Feld environments (Umgebungen) festlegen.
Für moderne Ordner wird die Einstellung environments . ist nicht erforderlich.
Um Unterordner einzugeben, geben Sie sowohl den Namen des übergeordneten Ordners als auch den Namen des Unterordners ein. Zum Beispiel AccountingTeam\TeamJohn.

Umgebungen (erforderlich für klassische Ordner)

Die Umgebung, in der das Paket als Prozess bereitgestellt wird. Für das Projekt und die Umgebung mit vorhandenen Prozessen werden die Prozesse aktualisiert, um die neueste Projektversion zu verwenden. Geben Sie die Umgebung an, in der das Paket als Prozess bereitgestellt wird. Für das Projekt und die Umgebung mit vorhandenen Prozessen werden die Prozesse aktualisiert, um die neueste Projektversion zu verwenden.

Authentication

Für die Authentifizierung gegenüber Orchestrator müssen Sie im Voraus Anmeldeinformationen in Jenkins erstellen. Es gibt vier Optionen für die Authentifizierung:

(1) Authentifizierung bei einer lokalen Orchestrator-Instanz mit einem Benutzernamen und einem Kennwort.

(2) Authentifizieren Sie sich bei einem Cloud Orchestrator mithilfe eines Aktualisierungstokens (API-Schlüssel).

(3) Authentifizieren Sie sich bei einem Cloud-Orchestrator mithilfe einer externen App-Authentifizierung.

(4) Authentifizieren Sie sich bei einem lokalen Orchestrator mithilfe der externen App-Authentifizierung.

Timeout (Sekunden)

Das Ausführungszeitlimit für den Testlauf. Der Standardwert ist 7200 Sekunden. Wenn das Timeout überschreitet, bevor die Ausführung im Orchestrator abgeschlossen ist und das Ergebnis zurückgegeben wird, wird die Erstellung abgebrochen und als fehlgeschlagen markiert.

Protokollierungsstufe der Ablaufverfolgung

Einstellung zum Aktivieren der Ablaufverfolgungsprotokollierung auf einer der folgenden Ebenen:

  • Keine
  • Kritisch
  • Fehler (Error)
  • Warnung
  • Informationen
  • Ausführlich. (Die Standardeinstellung ist None).

    Nützlich für Debugzwecke.

Pipeline-Beispiel

pipeline {
  agent any
  environment {
    MAJOR = '1'
    MINOR = '0'
  }
  stages {
    stage ('PostBuild') {
      steps {
        UiPathTest (
          testTarget: [$class: 'TestSetEntry', testSet: "My Test Set"],
          orchestratorAddress: "OrchestratorUrl",
          orchestratorTenant: "tenant name",
          folderName: "folder name",
          timeout: "10000",
          traceLoggingLevel: 'None',
          testResultsOutputPath: "result.xml",
          credentials: [$class: 'UserPassAuthenticationEntry', credentialsId: "credentialsId"]
        )
      }
    }
  }
}pipeline {
  agent any
  environment {
    MAJOR = '1'
    MINOR = '0'
  }
  stages {
    stage ('PostBuild') {
      steps {
        UiPathTest (
          testTarget: [$class: 'TestSetEntry', testSet: "My Test Set"],
          orchestratorAddress: "OrchestratorUrl",
          orchestratorTenant: "tenant name",
          folderName: "folder name",
          timeout: "10000",
          traceLoggingLevel: 'None',
          testResultsOutputPath: "result.xml",
          credentials: [$class: 'UserPassAuthenticationEntry', credentialsId: "credentialsId"]
        )
      }
    }
  }
}

War diese Seite hilfreich?

Hilfe erhalten
RPA lernen – Automatisierungskurse
UiPath Community-Forum
Uipath Logo White
Vertrauen und Sicherheit
© 2005–2024 UiPath. Alle Rechte vorbehalten