UiPath Documentation
uipath-cli
latest
false
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.

Guide de l'utilisateur de UiPath CLI

Horodatage UIP

uip tm est l'outil de Test Manager: il gère les projets de test, les cas de test, les ensembles de test, les exécutions, les résultats, les rapports et les pièces jointes sur un locataire UiPath Test Manager. Installez-le avec uip tools install tm, ou invoquez uip tm … et laissez l'installation automatique s'exécuter. Voir Outils pour le modèle d'installation et Outils uip pour la commande qui gère l'installation de l'outil.

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
ProjetCréer, répertorier, mettre à jour, supprimer des projets Test Manager; définir ou supprimer le dossier Orchestrator par défaut.
Cas de testCréer, répertorier, mettre à jour, supprimer des cas de test; lier ou dissocier les automatisations Orchestrator; lister l'historique des résultats; répertorier les ensembles de tests qui contiennent un cas de test; ajouter ou supprimer des cas de test d'un ensemble de test.
Ensembles de testsCréer, répertorier, mettre à jour, supprimer des ensembles de tests; répertorier les cas de test contenus; exécuter un ensemble de tests et renvoyer un ID d'exécution.
ExécutionsRépertorier les exécutions d'un ensemble de tests; répertorier les journaux de cas de test pour une exécution; réessayer les cas de test ayant échoué d'une exécution terminée.
RésultatTéléchargez les résultats d'une exécution de test sous forme de rapport XML JUnit.
RapportObtenez un rapport récapitulatif (nombre, taux de réussite, durée, cas ayant échoué) pour une exécution terminée.
pièce jointeTélécharger les pièces jointes (captions d’écran, journaux, fichiers) capturées par les journaux de cas de test dans une exécution.
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.

tm testcaselogs list-assertions réside sur la page du cas de test — voir testcases. Elle est enregistrée en tant que sous-commande testcaselogs distincte au moment du runtime, mais documentée avec les cas de test, car elle lit les artefacts d'assertion joints à un journal de cas de test.

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 suivi de testcases add.
  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. attendre — bloquez le script jusqu'à ce que l'exécution atteigne un état terminal (Passed, Failed, Cancelled). Utilisez --timeout pour limiter l'attente.
  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.

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.

Authentification et étendue

Chaque uip tm verbe résout le contexte du locataire et du projet via la session active. Voir Authentification pour la connexion; l'indicateur --tenant / -t sur chaque verbe remplace la valeur par défaut de la session pour cet appel. L’étendue du projet est résolue à partir de --project-key (ou dérivée de --test-set-key sur les verbes au niveau de l’exécution qui acceptent l’un ou l’autre).

Codes de sortie

Les codes de sortie CLI standard s'appliquent à chaque verbe. Un verbe ajoute un comportement spécifique au domaine:

  • 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.

Voir également

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

Connecter

Besoin d'aide ? Assistance

Vous souhaitez apprendre ? UiPath Academy

Vous avez des questions ? UiPath Forum

Rester à jour