Horodatage UIP

Manage Test Manager projects, test cases, test sets, executions, schedules, defects, requirements, custom fields, labels, results, and attachments using the `uip tm` tool.

uip tm is the Test Manager tool: it manages test projects, test cases, test sets, executions, schedules, defects, requirements, results, reports, and attachments on a UiPath Test Manager tenant. Install it with uip tools install tm, or invoke uip tm … and let auto-install run. See Tools (plugins) for the install model and uip tools for the command that manages tool installation.

tm est le préfixe de la commande — jamais uip test-manager. Utilisez la colonne commandPrefix de uip tools list pour confirmer.

Ressources

Chaque ressource a sa propre page de référence. Le verbe défini sur chaque page correspond aux commandes enregistrées par uip tm — exécutez uip tm --help pour confirmer la surface complète de votre installation.

Ressource	Objectif
Projet	Create, list, update, delete Test Manager projects; get or set the tenant default project; set or clear the default Orchestrator folder; list owners; read and update project settings; export and import a project.
autorisations-projet	Read the permissions you hold on a Test Manager project.
Migration	Inspect and download the migration jobs behind project export and project import, and list or download migration schemas.
Cas de test	Create, bulk-create, clone, list, get, update, delete, and export test cases; manage manual test steps and parameters; link or unlink Orchestrator automations; assign test cases to test sets statically or dynamically by label; list result history, test sets, requirements, packages, and Studio projects for a test case.
Créer un package	Regroupez un projet de test Playwight externe dans un package d’automatisation .nupkg, en créant et en liant automatiquement ses cas de test.
Ensembles de tests	Create, clone, list, get, update, delete test sets; list contained test cases and dynamic assignments; set execution order, execution target, folder, and robot; read and update settings; assign a user; run a test set and return an execution ID.
Exécuter	Run every test in a package already uploaded to Orchestrator, wait for the results, and write a report; exits non-zero when a test fails.
Planifications (Schedules)	Create, list, update, enable, disable, and delete recurring test set schedules; list upcoming runs.
Exécutions	List and filter executions; re-run an existing execution; retry the failed test cases of a finished execution; finish, cancel, delete, and export executions; set the reporting date; get aggregated stats.
Journaux de cas de test	Start, finish, list, get, cancel, and assign test case logs; override a result; read assertions and robot logs.
Journal des étapes de test	Répertorie le journal d’exécution au niveau des étapes pour un journal de cas de test manuel ou mixte.
Attendre	Interroger une exécution de test jusqu'à ce qu'elle atteigne un état terminal; renvoie un code de sortie non nul en cas de délai d'expiration.
Résultat	Téléchargez les résultats d'une exécution de test sous forme de rapport XML JUnit.
Rapport	Get a summary report (counts, pass rate, duration, failed cases) for a completed execution; export an execution report file.
exporter-tâches	Check the asynchronous file export jobs that testcases export and report export start.
pièce jointe	Upload, list, get, update, delete, and download attachments (screenshots, logs, files) on Test Manager objects.
Défauts (Defects)	Create, list, get, update, and delete defects raised from failed test results; read related objects, the linked external issue, and defect attachments.
Prérequis	Create, list, get, update, delete, and export requirements; manage test case links; generate test cases from a requirement, evaluate requirements, and find obsolete test cases with AI.
Invites	List, get, and create entries in the project prompt library that steers AI test generation and evaluation.
Champ personnalisé	Gérez les définitions de champs personnalisés, leurs libellés d’affichage et les valeurs autorisées.
Libellé Objet	Add, remove, get, and list labels on Test Manager objects.
Utilisateur (User)	Obtenez les informations de profil de l'utilisateur de Test Manager actuellement authentifié.
scénarios-perf	Create, run, and delete performance scenarios (dry run or full load test); check performance testing licenses; see also load-groups, execution data, and report.

Synthèse

uip tm <resource> <verb> [options]

La sortie par défaut est --output json. Tous les verbes uip tm respectent les quatre options globales (--output, --output-filter, --log-level, --log-file).

Flux typique

Les ressources de Test Manager forment une chaîne. Une exécution de CI complète la parcourt normalement de bout en bout:

1. projet — configuration unique. Créez le projet (ou réutilisez un projet existant) et épinglez éventuellement un dossier Orchestrator par défaut afin que les commandes ultérieures puissent omettre --folder-key
2. testcases — créer des cas de test et lier chacun à un point d'entrée de package Orchestrator avec testcases link-automation. Il s'agit de l'étape qui les rend exécutables.
3. ensembles de tests — regroupe les cas de test dans une suite exécutable avec testsets create.
4. exécution des ensembles de tests — le démarrage d'une exécution. Renvoie une ExecutionId que chaque commande en aval prend comme entrée.
5. wait — block the script until the execution reaches a terminal state (Finished or Cancelled). Use --timeout to cap the wait.
6. rapport/résultat/ pièce jointe — après l'exécution: un résumé structuré (report get), un fichier XML JUnit pour les tableaux de bord de test CI (result download) et tous les artefacts capturés (attachment download).
7. réessai des exécutions — facultatif: si l'exécution a rencontré des échecs qui peuvent être défectueux, réexécutez uniquement les journaux de cas de test ayant échoué en place.

For manual or mixed runs, the extended flow adds: testcaselog start / finish — mark individual test case logs as started and finished; and teststeplog list — retrieve step-level pass/fail detail. requirements links test cases to requirements for traceability reporting, defects tracks bugs raised from failed results, and objectlabel / customfield provide metadata management across all entity types.

For an existing Playwright test project, pack collapses steps 2 and 3 into one command: pointing it at the project root with --project-key packages the suite and auto-creates and auto-links matching test cases in a single call. A Playwright test case that pack created and linked must never be linked again with testcases link-automation — see pack.

For a package already uploaded to Orchestrator, run collapses steps 2 through 6 into one command: uip tm run --type package runs every test case in the package, waits, writes a report, and exits non-zero when a test fails — see run. To run a test set on a recurring cadence instead of from a pipeline, create a schedule — see schedules.

Le même flux fonctionne ad-hoc au niveau d'un terminal: chaque verbe imprime une enveloppe JSON autonome avec les ID dont l'étape suivante a besoin.

Run without a project

If you run tests without specifying a project, Test Manager stores the results in the default project of your tenant. For more information, refer to Default project for execution results.

Authentification et étendue

Every uip tm verb resolves tenant and project context through the active session. Refer to Authentication for sign-in. Project-scoped verbs take --project-id or --project-key. When you pass both, --project-id is used. Verbs that take an object key such as --test-set-key DEMO:42 can also derive the project from the key's prefix.

Codes de sortie

Standard CLI exit codes apply to every verb. Two verbs add domain-specific behavior:

• uip tm testsets run suivi de uip tm wait — voir Codes de sortie lors de l'exécution. wait quitte 2 au moment du délai d'attente, de sorte qu'un script peut se ramifier sur le délai d'attente vs. terminer avec des échecs vs. passage propre sans analyser JSON. La détection de l'échec du test se produit via report get ou result download, et non via le code de sortie de la commande d'exécution.
• uip tm run — exits 1 when a test fails or reports no result, no test runs, or the run is cancelled, and 4 when --timeout elapses. See run.

Voir également

• Concepts: comment UiPath CLI est organisée
• Sessions — la façon dont le locataire et le contexte du projet sont résolus.
• Modèles de script — ramification-code de sortie et filtrage JSON pour CI.
• Formats de sortie - Enveloppe JSON et --output-filter.