- Überblick
- UiPath-CLI
- Azure DevOps-Erweiterung
- Jenkins-Plugin

Benutzerhandbuch zu CI/CD-Integrationen
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.
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:
|
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:
|
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 mit . |
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:
|
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 {
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'
)
}
}
}
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:
Parameter | Erforderliches Format | Beispiel |
---|---|---|
String | Setzen Sie den Wert in Anführungszeichen. | 'string value' |
Int32 | Geben Sie den Wert wie bei einem Integer an. | 11 |
Boolescher | Geben Sie den Wert entweder als true oder false an.
| true |
Double | Geben Sie einen Gleitkommawert an. | 3.5 |
DateTime | Geben Sie eine gültige JSON-Darstellung an. | "2012-04-23T18:25:43.511Z" |
Array | Geben Sie Werte als gültiges JSON an. | [1,1,2,3,5,8] oder ["firstString", "secondString"] |
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'
}