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

Gérez les projets Test Manager, les cas de test, les ensembles de test, les exécutions, les défauts, les exigences, les champs personnalisés, les libellés, les résultats et les pièces jointes à l’aide de l’outil « uip tm ».

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 planifications, les défauts, les exigences, 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; obtenir ou définir le projet par défaut du locataire; définir ou supprimer le dossier Orchestrator par défaut; propriétaires de liste; lire et mettre à jour les paramètres du projet; exporter et importer un projet.
autorisations-projetLisez les autorisations dont vous disposez sur un projet Test Manager.
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 testCréer, créer en bloc, cloner, répertorier, obtenir, mettre à jour, supprimer et exporter des cas de test; gérer les étapes et les paramètres de test manuels; lier ou dissocier les automatisations Orchestrator; attribuer des cas de test aux ensembles de test de manière statique ou dynamique par libellé; Répertorier l'historique des résultats, les ensembles de test, les exigences, les packages et les projets Studio pour un cas de test.
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 testsCréer, cloner, répertorier, obtenir, mettre à jour, supprimer des ensembles de tests; répertorier les cas de test et les affectations dynamiques contenus; définir l'ordre d'exécution, la cible d'exécution, le dossier et le robot; lire et mettre à jour les paramètres; affecter un utilisateur; exécuter un ensemble de tests et renvoyer un ID d'exécution.
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écutionsRépertorier et filtrer les exécutions; réexécuter une exécution existante; réessayer les cas de test ayant échoué d’une exécution terminée; terminer, annuler, supprimer et exporter les exécutions; définir la date de signalement; obtenir des statistiques agrégées.
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âchesVérifiez les tâches d'exportation de fichiers asynchrones démarrées par testcases export et report export .
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)Créer, répertorier, obtenir, mettre à jour et supprimer les défauts déclenchés à partir des résultats de tests échoués; lire les objets connexes, le problème externe lié et les pièces jointes des défauts.
PrérequisCréer, répertorier, obtenir, mettre à jour, supprimer et exporter les exigences; gérer les liens de cas de test; générer des cas de test à partir d’une exigence, évaluer les exigences et trouver des cas de test obsolètes grâce à l’IA.
InvitesRépertoriez, obtenez et créez des entrées dans la bibliothèque d’invites du projet qui pilote la génération et l’évaluation des tests d’IA.
Champ personnaliséGérez les définitions de champs personnalisés, leurs libellés d’affichage et les valeurs autorisées.
Libellé ObjetAjoutez, supprimez, obtenez et répertoriez des libellés sur les objets Test Manager.
Utilisateur (User)Obtenez les informations de profil de l'utilisateur de Test Manager actuellement authentifié.
scénarios-perfCréer, exécuter et supprimer des scénarios de performances (exécution d’essai ou test à charge complète); vérifier les licences de test de performance; consultez également les sections groupes de charge, données d'exécution et rapport.

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. attendre - bloquez le script jusqu'à ce que l'exécution atteigne un état terminal (Finished ou 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.

Pour les exécutions manuelles ou mixtes, le flux étendu ajoute: testcaselog start / endpoint — marquez les journaux de cas de test individuels comme commencé et terminé; et teststeplog list — récupère les détails de réussite/d’échec au niveau de l’étape. lie les cas de test aux exigences en matière de rapports de traçabilité, defects suit les bogues déclenchés à partir de résultats ayant échoué et la gestion des métadonnées dans tous les types d'entités est fournie.

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.

Pour un package déjà téléchargé dans Orchestrator, run réduit les étapes 2 à 6 en une seule commande: uip tm run --type package exécute chaque cas de test dans le package, attend, rédige un rapport et quitte non zéro lorsqu'un test échoue — voir exécuter. Pour exécuter un ensemble de tests à une cadence récurrente plutôt qu'à partir d'un pipeline, créez une planification — voir planifications.

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.

Exécuter sans projet​

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​

Chaque uip tm verbe résout le contexte du locataire et du projet via la session active. Reportez-vous à l'Authentification pour la connexion. Les verbes au niveau du projet prennent --project-id ou --project-key. Lorsque vous transmettez les deux, --project-id est utilisé. Les verbes qui prennent une clé d'objet telle que --test-set-key DEMO:42 peuvent également dériver le projet à partir du préfixe de la clé.

Codes de sortie​

Les codes de sortie CLI standard s'appliquent à chaque verbe. Deux verbes ajoutent 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.
  • uip tm run — quitte 1 lorsqu'un test échoue ou ne rapporte aucun résultat, aucune exécution de test ou l'exécution est annulée, et 4 lorsque --timeout s'étend. Voir Exécuter.

Voir également​

  • Ressources​
  • Synthèse​
  • Flux typique​
  • Exécuter sans projet​
  • 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