Auftragsaufgaben

Überblick

Ihre Pipeline besteht aus verschiedenen Phasen, die wiederum in Aufträge unterteilt werden können. Für jeden Auftrag können Sie die Schritte so konfigurieren, dass diese die UiPath-Aufgaben enthalten, die in der UiPath-Integration für Azure DevOps enthalten sind.

Wichtig: Ab April 2023 und 2023.4 werden neue Ausführungen in klassischen Ordnern blockiert. Bei Aufgaben, die einen klassischen Ordner in ihrer Konfiguration enthalten, wird die Meldung Folder not found angezeigt und die Aufgabe wird nicht ausgeführt. Weitere Informationen zum Entfernen von klassischen Ordnern finden Sie hier.

Voraussetzungen

Informationen zur Vorbereitung Ihrer Umgebung finden Sie unter Voraussetzungen für Azure DevOps-Erweiterungen.

Überlegungen

Bevor Sie mit der Ausführung von Aufgaben in Ihrer Pipeline beginnen, sollten Sie Folgendes beachten:

• Sie müssen UiPath-Aufgaben nur in Windows-basierten Build-Agenten ausführen.
• Konfigurieren Sie eine UiPath Orchestrator-Dienstverbindung.
• Zum Testen der Funktionen ist die Orchestrator-Version 2020.4 oder höher erforderlich.
• Wenn Sie eine lokale Version des Orchestrators mit HTTPS verwenden, importieren Sie das SSL-Zertifikat, um sicherzustellen, dass HTTPS-Aufrufe an den Orchestrator vertrauenswürdig sind.

Befehlszeilenschnittstelle

Die Azure DevOps-Erweiterung verfügt über eine integrierte CLI (Befehlszeilenschnittstelle), die spezifisch für UiPath ist.

Zwischenspeichern der CLI

Wenn Sie den Build-Agenten ausführen, kommuniziert die CLI mit dem Orchestrator und ermöglicht Ihnen die Ausführung Ihrer Auftragsaufgaben.

Standardmäßig ist die CLI in der AzureDevOps-Erweiterung vorgepackt und wird bei der ersten Ausführung im Agent.ToolsDirectory (Azure-Cache) gespeichert.

Beim Ausführen einer Auftragsaufgabe über den Build-Agenten sucht das System nach der CLI, die sich innerhalb von Agent.ToolsDirectory befinden sollte, um die Ausführung abzuschließen.

Wenn die CLI nicht in Agent.ToolsDirectory (Azure-Cache) gefunden wird, lädt das System sie automatisch aus dem öffentlichen NuGet-Feed herunter. Voraussetzung dafür ist, dass der öffentliche NuGet-Feed nicht von einer Firewall blockiert wird und über Ihren Build-Agent darauf zugegriffen werden kann.

Wenn Sie Ihre Firewall nicht über Ihren Build-Agent öffnen können, können Sie die CLI manuell herunterladen (entsprechend der Build-Version, die für Ihr aktuelles Plugin verwendet wird) und sie mithilfe der Task Plattform installieren manuell in Agent.ToolsDirectory platzieren.

Hinzufügen von UiPath-Aufgaben zum Pipeline-Agent-Pool

Um eine Automatisierung in Ihrer Pipeline zu definieren, müssen Sie dem Agentenpool einzelne Aufgaben hinzufügen und konfigurieren.

1. in Azure DevOps und wechseln Sie zu Pipelines.
2. Erstellen Sie eine neue Pipeline oder bearbeiten Sie eine vorhandene.
3. Fügen Sie einen Auftrag zum Agent-Pool hinzu.
4. Suchen Sie nach einer der folgenden Aufgaben:
   1. UiPath Run Job
   2. UiPath Manage Assets
   3. UiPath-Installationsplattform
   4. UiPath Pack
   5. UiPath Deploy
   6. UiPath Test
5. Klicken Sie auf Hinzufügen und konfigurieren Sie die Aufgabe.
6. Ordnen Sie die Aufgaben im Agent-Pool bei Bedarf neu an und speichern Sie dann Ihre Pipeline.

UiPath Run Job

Sie können diese Aufgabe verwenden, um einen Prozess auszuführen, der bereits auf einer Orchestrator-Instanz bereitgestellt wurde. Weitere Informationen finden Sie unter Prozesse und Aufträge.

Konfiguration

Verwenden Sie die folgende Tabelle, um die Eingaben von UiPath Run Job zu konfigurieren.

Eingabe	Beschreibung
Anzeigename (erforderlich)	Geben Sie einen Namen für Ihre Aufgabe ein.
Orchestrator-Verbindung (erforderlich)	Konfigurieren Sie die Dienstverbindung für den Zugriff auf UiPath Orchestrator-Dienste. Sie können eine Verbindung nur für diesen Schritt konfigurieren oder eine vorhandene globale Verbindung verwenden. Weitere Informationen finden Sie unter Konfigurieren der UiPath Orchestrator-Dienstverbindung.
Prozess (erforderlich)	Der Prozess ist die Paketversion, die mit einem bestimmten Ordnertyp verknüpft ist. Sie müssen diese Eingabe basierend auf dem Ordnertyp konfigurieren, in dem der Prozess bereitgestellt wird. Bei modernen Ordnern ist die Eingabe der Prozessname, der auf der Registerkarte Prozesse aufgeführt ist. Um den Prozessnamen herauszufinden, können Sie den Orchestrator sowie Ihren Ordner öffnen und zu Automatisierungen > Prozesse navigieren. Bei klassischen Ordnern (veraltet) ist die Eingabe der Name des Prozessnamens, gefolgt von einem Unterstrich und dann dem Umgebungsnamen , in dem die Roboter gehostet werden. Betrachten Sie als Beispiel für diese Namenskonvention die folgenden Variablen: Der Name des Prozesses istTestAutomation. Der Name der Umgebung ist Production. Ihr Prozessname für diese Eingabe ist TestAutomation_Production.
Eingabeparameter	Geben Sie den Dateipfad zu einer JSON-Eingabedatei an, z. B. Input\jobParameters.json.
Priorität	Wählen Sie die Priorität der Auftragsausführung aus, wenn Sie eine bestimmte Reihenfolge auf Prozessebene festlegen möchten. Standardmäßig ist dieser Parameter auf Normal eingestellt.
Orchestrator-Ordner (erforderlich)	Geben Sie den Ordner an, in dem der Prozess bereitgestellt wird. Für klassische Ordner können Sie bestimmte Roboternamen verwenden. Für moderne Ordner können Sie bestimmte Benutzer- und Maschinennamen verwenden. Um Unterordner einzugeben, geben Sie sowohl den Namen des übergeordneten Ordners als auch den Namen des Unterordners ein. Verwenden Sie beispielsweise AccountingTeam\TeamJohn.
Strategy	Geben Sie die Ausführungsstrategie für die dynamische oder roboterspezifische Zuordnung an. Bei dynamisch zugeordneten Aufträgen wird der Prozess unter dem Konto und der Maschine ausgeführt, die verfügbar sind. Alternativ können Sie roboterspezifische Aufträge auswählen.
Auftragstyp	Nur für moderne Ordner verfügbar. Wählen Sie das Lizenzmodell der Laufzeit aus, unter der der Auftrag ausgeführt werden soll. Weitere Informationen finden Sie unter Roboterlizenzierung.
Anzahl von Aufträgen	Nur für dynamische Zuordnungsstrategie verfügbar. Geben Sie an, wie oft Sie diese Aufgabe ausführen möchten. Standardmäßig ist diese Eingabe auf 1 festgelegt.
Benutzer	Nur für moderne Ordner zusammen mit einer dynamischen Zuordnungsstrategie verfügbar. Fügen Sie den Benutzernamen der Maschine hinzu. Beispielsweise ist ein lokaler Benutzer für diese Eingabe MachineName\UserName.
Maschine	Nur auf modernen Ordnern zusammen mit einer dynamischen Zuordnungsstrategie verfügbar. Der Name der Maschine, auf der die Ausführung erfolgt.
Ausgabe	Die Ergebnisse werden in einer JSON-Datei gesammelt. Sie müssen den Pfad der Auftragsergebnisse angeben (z. B. Output\testResults.json). Wenn Sie diese Angabe leer lassen, wird die Standardausgabe an das Artefakt-Stagingverzeichnis unter dem folgenden Namen gesendet: UiPathResults.json.
Zeitüberschreitung	Geben Sie die Anzahl der zu wartenden Sekunden an, bevor die Anfrage abgebrochen wird.
Aufgabenfehler bei Auftragsfehler	Wählen Sie diese Option, um die Aufgabe als fehlgeschlagen zu kennzeichnen, wenn mindestens ein Auftrag fehlgeschlagen ist. Diese Option ist standardmäßig nicht ausgewählt.
Auf Auftragsabschluss warten	Warten Sie auf die Fertigstellung des laufenden Auftrags. Diese Option ist standardmäßig nicht ausgewählt.
Ablaufverfolgungsstufe	Wählen Sie die Protokollierungsstufe aus der Dropdownliste aus.
robotsIds	Kommagetrennte Liste bestimmter Roboternamen.

YAML-Pipeline

Sie können eine Vorschau eines vollständig geparsten YAML-Dokuments für UiPath Run Job anzeigen.

- task: UiPathRunJob@2
  displayName: 'Start ProcessProject'
  inputs:
    #orchestratorConnection: 'service-connection-name' # Service connection to UiPath Orchestrator
    #processName: 'ProccessProject_CI-Pipeline' # The name of the process
    #parametersFilePath: 'Input\\jobParameters.json' # json file with input values if the process requires them
    #priority: 'Low' # Options 'Low', 'Normal', 'High'
    #folderName: 'MyFolder' # Specify the folder to deploy to. For clasic folders, you can use specific robot names. For modern folders, you can use specific user and machine names.
    #strategy: 'Dynamically' # Options 'Specific', 'Dynamically'
    #jobCount: 1 # The number of job runs. (default 1) - used if strategy is 'Dynamically'
    #user: 'MyUser'
    #machine: 'machine'
    #robotsIds: 'robot1, robot2'
    #resultFilePath: 'Output\\testResults.json'
    #timeout: 3600
    #failWhenJobFails: false
    #waitForJobCompletion: false,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None

UiPath Manage Assets

Sie können diese Aufgabe verwenden, um Assets auf Ihrer Orchestrator-Instanz bereitzustellen, zu aktualisieren oder zu löschen.

Die folgenden Asset-Typen werden unterstützt:

• Text – speichert nur Zeichenfolgen (Anführungszeichen sind nicht erforderlich)
• Boolean – unterstützt die Werte „true“ und „false“
• Integer – speichert nur ganze Zahlen
• Credential – enthalten Benutzernamen und Kennwörter, die der Roboter zur Ausführung bestimmter Prozesse benötigt. Für diesen Asset-Typ müssen Sie den Benutzernamen und das Kennwort codieren, indem Sie :: verwenden, um die beiden Felder zu trennen.

Um Assets bereitzustellen, müssen Sie sie in einer CSV-Datei hinzufügen, die in UTF-8 codiert ist, wie im folgenden Beispiel:

name,type,value, description asset_1_name,text,asset_value, asset_2_name,integer,123,asset_3_name,boolean,false, this is an asset description asset_4_name,credential,"username::password",

Weitere Informationen finden Sie unter Orchestrator-Assets.

Konfiguration

Verwenden Sie die folgende Tabelle, um die Eingaben von UiPath Manage Assets zu konfigurieren.

Argument	Beschreibung
Anzeigename (erforderlich)	Geben Sie einen Namen für Ihre Aufgabe ein.
Orchestrator-Verbindung (erforderlich)	Konfigurieren Sie die Dienstverbindung für den Zugriff auf UiPath Orchestrator-Dienste. Sie können eine Verbindung nur für diesen Schritt konfigurieren oder eine vorhandene globale Verbindung verwenden. Weitere Informationen finden Sie unter Konfigurieren der UiPath Orchestrator-Dienstverbindung.
Orchestrator-Ordner (erforderlich)	Geben Sie den Ordner an, in dem der Prozess bereitgestellt wird. Für klassische Ordner können Sie bestimmte Roboternamen verwenden. Für moderne Ordner können Sie bestimmte Benutzer- und Maschinennamen verwenden. Um Unterordner einzugeben, geben Sie sowohl den Namen des übergeordneten Ordners als auch den Namen des Unterordners ein. Verwenden Sie beispielsweise AccountingTeam\TeamJohn.
Asset-Aktion auswählen (erforderlich)	Wählen Sie eine Option aus der Dropdownliste aus.
Assets-CSV-Datei (erforderlich)	Fügen Sie den CSV-Dateipfad hinzu. Sie können dieselbe Datei sowohl für Asset-Aktionen zum Bereitstellen als auch für die Aktualisierung verwenden. Was es zu bedenken gilt: Die Verwendung von Anführungszeichen innerhalb von Werten ist zulässig (z. B. ""A new version of RPA REPORT – AM Email Quote to Agent is available"" ). JSON-Werte werden unterstützt (z. B. "{""MaxRetryNumber"":3,""Name"":My Test Process}" ) Kommentare werden nicht unterstützt (z. B. asset_1_name,credential,""username::password"" # asset_1_description comment ) Bei Asset-Aktionen zum Löschen können Sie nur die Namensspalte verwenden und die anderen Spalten leer lassen. (Optional) Sie können für jedes Asset eine Beschreibung mit der folgenden Syntax festlegen: type, value ,description
Ablaufverfolgungsstufe	Wählen Sie die Protokollierungsstufe aus der Dropdownliste aus.

YAML-Pipeline

Sie können eine Vorschau eines vollständig geparsten YAML-Dokuments für UiPath Manage Assets anzeigen.

- task: UiPathAssets@2
  displayName: 'Deploy/Update assets'
  inputs:
    #orchestratorConnection: 'service-connection-name' # Service connection to UiPath Orchestrator
    #assetActionType: 'Deploy' # Options: Deploy, Delete
    #csvFile: 'assets_deploy.csv' # the path to the csv file containing the assets description,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None

UiPath-Installationsplattform

Sie können die Aufgabe UiPathInstallPlatform verwenden, wenn Build-Agenten keinen Zugriff auf den UiPath NuGet-Feed haben. Sie sollten die Aufgabe UiPathInstallPlatform vor allen anderen Aufgaben in der Erweiterung ausführen. Diese Aufgabe verfügt über ein vorgefertigtes Tool, das alle anderen UiPath-Aufgaben verwenden. Die Aufgabe ist optional, der Vorteil besteht jedoch darin, dass sie die Zeit für die Ausführung anderer Aufgaben verkürzt.

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 (erforderlich) 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 Verzeichnis Agent.Tools Ihres Build-Agenten ab. Merken Sie sich den Pfad der NUPKG-Datei im Verzeichnis Agent.Tools . Beispiel: $(Agent.ToolsDirectory)\nupkg\UiPath.CLI.xx.xx.xx.nupkg
3. Verwenden Sie die Task InstallPlatform , und geben Sie den in Schritt 2 verwendeten Pfad in das Feld Path to CLI's nupkg ein.

   

YAML-Pipeline

Sie können eine Vorschau eines vollständig geparsten YAML-Dokuments für die UiPath-Installationsplattform anzeigen, einschließlich des CLI-Versionsselektors:

- task: UiPathInstallPlatform-preview@2
  displayName: 'UiPath Install Platform'
  inputs:
    cliVersion: 'WIN_22.10.8418.30339' or 'X_22.10.8418.30339' or '21.10.8319.10920
    cliNupkgPath:'$(Agent.ToolsDirectory)\nupkg\UiPath.CLI.X.22.10.8418.30339.nupkg'

UiPath Pack

Mit der UiPathPack-Aufgabe können Sie ein vorhandenes UiPath-Projekt in ein NuGet-Paket packen.

Konfiguration

Verwenden Sie die folgende Tabelle, um die Eingaben von UiPath Pack zu konfigurieren.

Argument	Beschreibung
Anzeigename (erforderlich)	Geben Sie einen Namen für Ihre Aufgabe ein.
Versionsverwaltungsmethode auswählen (erforderlich)	Sie können eine automatisch generierte Version auswählen, die Projektversion verwenden oder eine neue Version definieren. Weitere Informationen finden Sie unter Paketversionen.
Version (erforderlich)	Nur für moderne Ordner zusammen mit einer dynamischen Zuordnungsstrategie verfügbar. Das Festlegen der Paketversion bietet die Möglichkeit, die erstellten Pakete und deren Quellversionen effizienter zu verfolgen. Beispielsweise kann das Microsoft-Assembly-Muster verwendet werden, um die NuGet-Paketversion zu erstellen: [Hauptversion].[Nebenversion].[Buildnummer].[Revisionsnummer].
Projektpfad (erforderlich)	Wählen Sie den Speicherort des Projekts aus, das verpackt werden soll. 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.
Ausgabetyp auswählen (nur für manuelle Versionierung erforderlich)	Legen Sie einen Projekttyp für das Projekt fest, das gepackt werden soll. Wenn Sie None festlegen, wird der Projekttyp aus der JSON-Datei des Projekts extrahiert. Die folgenden Projekttypen werden unterstützt: „Process“, „Library“, „Tests“, „Objects“, „None“.
Orchestrator-Verbindung (erforderlich)	Konfigurieren Sie die Dienstverbindung für den Zugriff auf UiPath Orchestrator-Dienste. Sie können eine Verbindung nur für diesen Schritt konfigurieren oder eine vorhandene globale Verbindung verwenden. Weitere Informationen finden Sie unter Konfigurieren der UiPath Orchestrator-Dienstverbindung.
Output Path	Legen Sie einen Ordnerpfad fest, auf dem das Paket abgelegt werden soll.
Workflow-Analyse ausführen	Wählen Sie diese Option aus, um Workflow-Analyseregeln in Ihrem Automatisierungsprojekt auszuführen (z. B. Aufträge bei Fehlern fehlschlagen lassen). Standardmäßig ist diese Option nicht aktiviert. Weitere Informationen finden Sie unter Regeln für Anwendungstests mit der Workflow-Analyse.
Ablaufverfolgungsstufe	Wählen Sie die Protokollierungsstufe aus der Dropdownliste aus.

YAML-Pipeline

Sie können eine Vorschau eines vollständig geparsten YAML-Dokuments für das UiPath Pack anzeigen.

- task: UiPathPack@2
  inputs:
    #versionType: AutoVersion # Options: AutoVersion, CurrentVersion, ManualVersion 
    #version: '1.0.0' # Required when versionType == ManualVersion
    #projectJsonPath: '$(Build.SourcesDirectory)\MyFirstProcess'
    #outputPath: '$(Build.ArtifactStagingDirectory)\Packages\MyFirstProcess'
    #outputType: 'None' # Options: Process, Library, Tests, Objects, None
    #runWorkflowAnalysis: 'False'
    #orchestratorConnection: 'service-connection-name' # Service connection to UiPath Orchestrator,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None

UiPath Deploy

Mit der UiPathDeploy-Aufgabe können Sie ein UiPath NuGet-Paket auf dem UiPath Orchestrator bereitstellen.

Wichtig:

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

Konfiguration

Verwenden Sie die folgende Tabelle, um die Eingaben von UiPath Deploy zu konfigurieren.

Argument	Beschreibung
Anzeigename (erforderlich)	Geben Sie einen Namen für Ihre Aufgabe ein.
Orchestrator-Verbindung (erforderlich)	Konfigurieren Sie die Dienstverbindung für den Zugriff auf UiPath Orchestrator-Dienste. Sie können eine Verbindung nur für diesen Schritt konfigurieren oder eine vorhandene globale Verbindung verwenden. Weitere Informationen finden Sie unter Konfigurieren der UiPath Orchestrator-Dienstverbindung.
Paket(e) (erforderlich)	Definieren Sie den Feed für Ihre UiPath NuGet-Pakete.
Automatisch einen Prozess erstellen	Wählen Sie diese Option aus, wenn Sie ein Paket bereitstellen möchten, ohne einen Prozess zu erstellen. Die Option ist standardmäßig ausgewählt. Wenn diese Option ausgewählt ist, müssen Sie den Parameter Entry Point Path konfigurieren.
Orchestrator-Ordner (erforderlich)	Geben Sie den Ordner an, in dem der Prozess bereitgestellt wird. Für klassische Ordner (veraltet) können Sie bestimmte Roboternamen verwenden. Für moderne Ordner können Sie bestimmte Benutzer- und Maschinennamen verwenden. Um Unterordner einzugeben, geben Sie sowohl den Namen des übergeordneten Ordners als auch den Namen des Unterordners ein. Zum Beispiel AccountingTeam\TeamJohn.
Umgebung	(Optional) Wenn Sie klassische Ordner (veraltet) verwenden, müssen Sie die Umgebung definieren, in der die Pakete bereitgestellt werden sollen. Sie können dieses Feld verwenden, um Pakete zu erstellen oder zu aktualisieren. Im folgenden Beispiel können Sie Ihre Umgebungen durch ein Komma getrennt in dieses Feld eintragen: testingEnvironment,productionEnvironment.
Einstiegspunktpfad(e) (erforderlich)	Geben Sie Einstiegspunktpfade an, um einen Prozess zu erstellen oder zu aktualisieren. Der Einstiegspunktpfad gibt den Dateipfad an, der mit dem Stammordner des Projekts beginnt. Bevor Sie die Einstiegspunktpfade konfigurieren, beachten Sie Folgendes: 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. Der Standardeinstiegspunkt ist auf Main.xaml festgelegt. Mehrere Einstiegspunkte können als „Main.xaml, EntryPoint2.xaml“ festgelegt werden. Für klassische Ordner (veraltet) können Sie für jede Umgebung nur einen Einstiegspunkt angeben. Für geschachtelte Ordner müssen Sie den Dateipfad wie folgt angeben:Folder01/Folder02/Main.xaml oder Folder01/Folder02/Entrypoint.xaml. Weitere Informationen finden Sie unter Orchestrator-Einstiegspunkte.
Ablaufverfolgungsstufe	Wählen Sie die Protokollierungsstufe aus der Dropdownliste aus.

YAML-Pipeline

Sie können eine Vorschau eines vollständig geparsten YAML-Dokuments für UiPath Deploy anzeigen.

- task: UiPathDeploy@2
  inputs:
    #orchestratorConnection: # Service connection to UiPath Orchestrator
    #packagesPath: '$(Build.ArtifactStagingDirectory)\Packages\ITAutomationProcess'
    #folderName: 'ITAutomation'
    #environments: 'AutomationRobots' # Optional,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None

UiPath Test

In der Regel führt die Aufgabe von UiPath Test einen vorhandenen Testsatz im Orchestrator aus. Darüber hinaus können Sie sie zum Packen, Bereitstellen und Ausführen von Testfällen verwenden, indem Sie den Pfad zu einem UiPath Testprojekt angeben. Die letztgenannte Option wird im Orchestrator als temporärer Testsatz angezeigt.

Nachdem die Aufgabe die Ausführung abgeschlossen hat, werden die Testergebnisse auf die Registerkarte Test in Azure DevOps hochgeladen. Sie können den Ausgabepfad der Testergebnisse im JUnit-Format angeben.

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

Konfiguration

Verwenden Sie die folgende Tabelle, um die Eingaben von UiPath Test zu konfigurieren.

Argument	Beschreibung
Anzeigename (erforderlich)	Geben Sie einen Namen für Ihre Aufgabe ein.
Testausführungsmethode auswählen	Wählen Sie den Test aus, den Sie ausführen möchten: Testsatz ausführen: Geben Sie einen vorhandenen Testsatz im Orchestrator an und führen Sie ihn aus. Tests im Projekt ausführen: Geben Sie ein Projekt an, stellen Sie das Paket bereit und führen Sie die Testfälle als Teil eines temporären Testsatzes aus.
Orchestrator-Verbindung (erforderlich)	Konfigurieren Sie die Dienstverbindung für den Zugriff auf UiPath Orchestrator-Dienste. Sie können eine Verbindung nur für diesen Schritt konfigurieren oder eine vorhandene globale Verbindung verwenden. Weitere Informationen finden Sie unter Konfigurieren der UiPath Orchestrator-Dienstverbindung.
Eingabeparameter	Geben Sie den Dateipfad zu einer JSON-Eingabedatei an, z. B. Input\jobParameters.json . Geben Sie das Argument type an, wenn Sie neue Eingabeargumente auf Testsatzebene erstellen. Andernfalls können Sie name und value verwenden.
Testsatz (erforderlich für die Methode zum Ausführen des Testsatzes)	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.
Testprojektpfad (erforderlich für die Methode zum Ausführen von Tests in einem Projekt)	Geben Sie den Testprojektspeicherort an, der als Teil eines temporären Testsatzes ausgeführt werden soll.
Umgebung (erforderlich für die Methode zum Ausführen von Tests in einem Projekt)	Wenn Sie klassische Ordner verwenden (veraltet), müssen Sie die Umgebung definieren, in der die Pakete bereitgestellt werden sollen. Sie können dieses Feld verwenden, um Pakete zu erstellen oder zu aktualisieren. Im folgenden Beispiel können Sie Ihre Umgebungen durch ein Komma getrennt in dieses Feld eintragen: testingEnvironment, productionEnvironment.
Orchestrator-Ordner (erforderlich)	Geben Sie den Ordner an, in dem der Prozess bereitgestellt wird. Für klassische Ordner (veraltet) können Sie bestimmte Roboternamen verwenden. Für moderne Ordner können Sie bestimmte Benutzer- und Maschinennamen verwenden. Um Unterordner einzugeben, geben Sie sowohl den Namen des übergeordneten Ordners als auch den Namen des Unterordners ein. Zum Beispiel AccountingTeam\TeamJohn.
Ausgabepfad der Testergebnisse	Geben Sie den Ausgabepfad der Testergebnisse im JUnit-Format an (z. B. Output\testResults.json).
Zeitüberschreitung	Geben Sie die Anzahl der zu wartenden Sekunden an, bevor die Anfrage abgebrochen wird.
Ablaufverfolgungsstufe	Wählen Sie die Protokollierungsstufe aus der Dropdownliste aus.
Roboterprotokolle anhängen	Wählen Sie diese Option aus, um Protokolle der INFO-Ebene vom ausführenden Roboter anzufügen. Standardmäßig ist dies nicht ausgewählt. Weitere Informationen finden Sie unter Roboterprotokolle.

YAML-Pipeline

Sie können eine Vorschau eines vollständig geparsten YAML-Dokuments für UiPath Test anzeigen.

-- task: UiPathTest@2
  inputs:
    #testTarget: TestProject # Options: TestProject, TestSet
    #orchestratorConnection: # Service connection to UiPath Orchestrator
    #testProjectPath: '$(Build.SourcesDirectory)\MobileAutomationTests' # Required only when testTarget = TestProject
    #testSet: 'MobileAutomationTests' # Required only when testTarget = TestSet
    #folderName: 'MobileAutomationTesting'
    #environment: 'TestingRobots' # Required only when testTarget = TestProject and the folder is a classic folder
    #testReportDestination: '$(Build.ArtifactStagingDirectory)\report.xml' # Optional
    #timeout: 200 # Optional, default = 3600s,
    #traceLevel: 'None' # Options: Critical, Error, Warning, Information, Verbose, None task: UiPathTest@2