UiPath Documentation
uipath-cli
latest
false
Guide de l'utilisateur de UiPath CLI
Important :
Ce contenu a été traduit à l'aide d'une traduction automatique. La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.

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.

RessourceObjectif
ProjetCreate, 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-projetRead the permissions you hold on a Test Manager project.
MigrationInspectez et téléchargez les tâches de migration derrière project export et project import, et répertoriez ou téléchargez les schémas de migration.
Cas de testCreate, 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 packageRegroupez 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 testsCreate, 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écuterExécutez chaque test d'un package déjà téléchargé dans Orchestrator, attendez les résultats et rédigez un rapport; quitte non zéro lorsqu'un test échoue.
Planifications (Schedules)Créer, répertorier, mettre à jour, activer, désactiver et supprimer des planifications d’ensembles de tests récurrentes; Lister les exécutions à venir
ExécutionsList 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 testDémarrer, terminer, répertorier, obtenir, annuler et attribuer des journaux de cas de test; remplacer un résultat; lire les assertions et les journaux du robot.
Journal des étapes de testRépertorie le journal d’exécution au niveau des étapes pour un journal de cas de test manuel ou mixte.
AttendreInterroger 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ésultatTéléchargez les résultats d'une exécution de test sous forme de rapport XML JUnit.
RapportObtenir un rapport récapitulatif (nombre, taux de réussite, durée, cas ayant échoué) pour une exécution terminée; exporter un fichier de rapport d'exécution.
exporter-tâchesCheck the asynchronous file export jobs that testcases export and report export start.
pièce jointeCharger, répertorier, obtenir, mettre à jour, supprimer et télécharger des pièces jointes (capture d'écran, journaux, fichiers) sur les objets Test Manager.
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érequisCreate, 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.
InvitesList, 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é ObjetAdd, 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-perfCreate, 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]
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.

Pour un projet de test Playwright existant, compressez les étapes 2 et 3 en une seule commande: en la pointant à la racine du projet avec --project-key empaquète la suite et crée et lie automatiquement les cas de test correspondants dans un seul appel. Un cas de test Playwright qui a été créé et associé ne doit jamais être à nouveau lié avec testcases link-automation — voir 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​

Si vous exécutez des tests sans spécifier de projet, Test Manager stocke les résultats dans le projet par défaut de votre locataire. Pour de plus amples informations, reportez-vous à Projet par défaut pour les résultats d'exécution.

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​

  • Ressources​
  • Synthèse​
  • Flux typique​
  • Run without a project​
  • Authentification et étendue​
  • Codes de sortie​
  • Voir également​

Cette page vous a-t-elle été utile ?

Connecter

Besoin d'aide ? Assistance(opens in new window)

Vous souhaitez apprendre ? UiPath Academy(opens in new window)

Vous avez des questions ? UiPath Forum(opens in new window)

Rester à jour