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; Listen Sie Testsätze auf, die einen Testfall enthalten.
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 auflisten und filtern; Eine vorhandene Ausführung erneut ausführen; 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.
Anforderungen	Erstellen, Auflisten, Abrufen, Aktualisieren, Löschen und Exportieren von Anforderungen; Liste verknüpfter Testfall-IDs; Testfalllinks hinzufügen oder entfernen; Anforderungen nach Testausführung auflisten.
benutzerdefiniertes Feld	Verwalten Sie benutzerdefinierte Felddefinitionen, deren Anzeigebeschriftungen und zulässige Werte.
Objektbeschriftung	Beschriftungen für Test Manager-Objekte (Testfälle, Anforderungen) hinzufügen, entfernen und auflisten.
Benutzer	Rufen Sie Profilinformationen für den aktuell authentifizierten Test Manager-Benutzer ab.
Testschrittprotokoll	Listen Sie das Ausführungsprotokoll auf Schrittebene für ein manuelles oder gemischtes Testfallprotokoll auf.

testcaselog -Verben (start, finish, list-assertions) werden zur Runtime als separater testcaselog -Unterbefehl registriert, aber auf der Seite Testfälle dokumentiert, da sie direkt mit Testfallprotokollen arbeiten, die von einer Ausführung erzeugt wurden.

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 Sie Testfälle in einer ausführbaren Suite mit testsets create.
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.

Für manuelle oder gemischte Ausführungen fügt der erweiterte Ablauf Folgendes hinzu: testcaselog starten / beenden – markieren Sie einzelne Testfallprotokolle als gestartet und abgeschlossen; und teststeplog list – Rufen Sie Details zu Bestehen/Fehlschlagen auf Schrittebene ab. Anforderung verknüpft Testfälle mit Anforderungen für die Rückverfolgbarkeitsberichterstattung und objectlabel / customfield bietet eine Metadatenverwaltung für alle Entitätstypen.

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.