UIP-TM

uip tm ist das Test Manager-Tool: Es verwaltet Testprojekte, Testfälle, Testsätze, Ausführungen, Ergebnisse, Berichte und Anhänge auf einem UiPath Test Manager-Mandanten. Installieren Sie es mit uip tools install tm oder rufen Sie uip tm … auf und lassen Sie die automatische Installation ausführen. Das Installationsmodell finden Sie unter Tools (Plugins) und unter UIP-Tools finden Sie den Befehl, der die Toolinstallation verwaltet.

tm ist das Befehlspräfix – niemals uip test-manager. Verwenden Sie die commandPrefix Spalte aus uip tools list zum Bestätigen.

Ressourcen

Jede Ressource hat eine eigene Referenzseite. Das auf jeder Seite festgelegte Verb stimmt mit den von uip tm registrierten Befehlen überein – führen Sie uip tm --help aus, um die vollständige Oberfläche Ihrer Installation zu bestätigen.

Ressource	Zweck
Projekt	Erstellen, Auflisten, Aktualisieren, Löschen von Test Manager-Projekten; Legen Sie den standardmäßigen Orchestrator-Ordner fest oder löschen Sie ihn.
Testfälle	Testfälle erstellen, auflisten, aktualisieren, löschen; Orchestrator-Automatisierungen verknüpfen oder die Verknüpfung aufheben; Listenergebnisverlauf; Testsätze auflisten, die einen Testfall enthalten; Testfälle zu einem Testsatz hinzufügen oder daraus entfernen.
Testsätze	Testsätze erstellen, auflisten, aktualisieren, löschen; Liste enthaltener Testfälle; Führen Sie einen Testsatz aus und geben Sie eine Ausführungs-ID zurück.
Ausführungen	Ausführungen für einen Testsatz auflisten; Testfallprotokolle für eine Ausführung auflisten; die fehlgeschlagenen Testfälle einer abgeschlossenen Ausführung wiederholen.
Ergebnis	Laden Sie die Ergebnisse einer Testausführung als JUnit-XML-Bericht herunter.
Melden	Rufen Sie einen Zusammenfassungsbericht (Anzahl, Erfolgsrate, Dauer, fehlgeschlagene Fälle) für eine abgeschlossene Ausführung ab.
Anhang	Laden Sie Anhänge (Screenshots, Protokolle, Dateien) herunter, die von Testfallprotokollen in einer Ausführung erfasst wurden.
Warten	Eine Testausführung abrufen, bis sie einen Endzustand erreicht; Gibt bei einer Zeitüberschreitung einen Exitcode ungleich Null zurück.

tm testcaselogs list-assertions befindet sich auf der Testfallseite – siehe Testfälle. Er wird zur Laufzeit als separater testcaselogs -Unterbefehl registriert, aber mit Testfällen dokumentiert, da er die an ein Testfallprotokoll angehängten Assertionsartefakte liest.

Zusammenfassung

uip tm <resource> <verb> [options]

Die Standardausgabe ist --output json. Alle uip tm -Verben berücksichtigen die vier globalen Optionen (--output, --output-filter, --log-level, --log-file).

Typischer Fluss

Test Manager-Ressourcen bilden eine Kette. Eine vollständige CI-Ausführung durchläuft sie normalerweise von Anfang bis Ende:

1. Projekt – einmalige Einrichtung. Erstellen Sie das Projekt (oder verwenden Sie ein vorhandenes wieder) und heften Sie optional einen standardmäßigen Orchestrator-Ordner an, damit spätere Befehle --folder-key weglassen können.
2. Testfälle – Erstellen Sie Testfälle und verknüpfen Sie jeden mit einem Orchestrator-Paket-Einstiegspunkt mit testcases link-automation. Das ist der Schritt, der sie ausführbar macht.
3. testsets – gruppieren Testfälle in einer ausführbaren Suite mit testsets create gefolgt von testcases add.
4. Testsätze ausgeführt – Starten Sie eine Ausführung. Gibt ein ExecutionId zurück, das jeder nachgelagerte Befehl als Eingabe verwendet.
5. Wait – Blockieren Sie das Skript, bis die Ausführung einen Endstatus erreicht (Passed, Failed, Cancelled). Verwenden Sie --timeout um die Wartezeit zu begrenzen.
6. Bericht/Ergebnis/Anhang – nach der Ausführung: eine strukturierte Zusammenfassung (report get), eine JUnit-XML-Datei für CI-Testdashboards (result download) und alle erfassten Artefakte (attachment download).
7. Ausführungswiederholung – optional: Wenn die Ausführung Fehler aufwies, die fehlerhaft sein können, führen Sie nur die fehlgeschlagenen Testfallprotokolle erneut aus.

Der gleiche Ablauf funktioniert spontan an einem Terminal: Jedes Verb gibt einen in sich geschlossenen JSON-Umschlag mit den IDs aus, die der nächste Schritt benötigt.

Authentifizierung und Scope

Jedes uip tm -Verb löst den Mandanten- und Projektkontext über die aktive Sitzung auf. Siehe Authentifizierung für die Anmeldung; Das Flag --tenant / -t für jedes Verb überschreibt den Sitzungsstandard für diesen einen Aufruf. Der Projekt-Scope wird von --project-key aufgelöst (oder von --test-set-key für Verben auf Ausführungsebene abgeleitet, die beides akzeptieren).

Exitcodes

Standard-CLI -Exitcodes gelten für jedes Verb. Ein Verb fügt ein domain-spezifisches Verhalten hinzu:

• uip tm testsets run gefolgt von uip tm wait – siehe Exitcodes bei der Ausführung. wait beendet 2 bei einer Zeitüberschreitung, sodass ein Skript bei einer Zeitüberschreitung entweder mit „Fertig stellen mit Fehlern“ oder mit einem sauberen Durchlauf ohne Parsen der JSON verzweigen kann. Die Erkennung von Testfehlern selbst erfolgt über report get oder result download, nicht über den Exitcode des Ausführungsbefehls.

Siehe auch

• Konzepte: So ist die UiPath CLI organisiert
• Sitzungen – wie Mandanten- und Projektkontext aufgelöst werden.
• Skriptmuster – Exit-Code-Verzweigung und JSON-Filterung für CI.
• Ausgabeformate – JSON-Umschlag und --output-filter.