- Vue d'ensemble (Overview)
- Démarrer
- Concepts
- Utilisation de la UiPath CLI
- UiPath pour les agents de codage
- Guides pratiques
- Revenus CI/CD
- Référence de commande
- Vue d'ensemble (Overview)
- Codes de sortie
- Options globales
- agent codé uip
- UiPath Docsai
- add-test-data-entity
- ajouter une file d'attente de données de test
- add-test-data-variation
- Analyser
- Construire
- créer-projet
- Différence
- recherche-activités
- Obtenir les règles de l'analyse
- récupérer-activité-xaml par défaut
- Récupérer les erreurs
- obtenir des cas de test manuels
- Obtenir les étapes de test manuelles
- Obtenir les versions
- exemple de workflow
- indiquer l'application
- indiquer l'élément
- inspecter-package
- install-data-fabric-entities
- installer-ou-Update-packages
- list-data-fabric-entités
- listes-exemples-workflow
- Créer un package
- restore
- Exécuter le fichier
- modèles-recherche
- Démarrer-Studio
- arrêter l'exécution
- UIA
- Traçages UIP
- Migration
- Référence et assistance
Guide de l'utilisateur de UiPath CLI
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.
| Ressource | Objectif |
|---|---|
| Projet | Créer, répertorier, mettre à jour, supprimer des projets Test Manager; définir ou supprimer le dossier Orchestrator par défaut. |
| Cas de test | Cré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 tests | Cré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écutions | Ré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ésultat | Téléchargez les résultats d'une exécution de test sous forme de rapport XML JUnit. |
| Rapport | Obtenez un rapport récapitulatif (nombre, taux de réussite, durée, cas ayant échoué) pour une exécution terminée. |
| pièce jointe | Télécharger les pièces jointes (captions d’écran, journaux, fichiers) capturées par les journaux de cas de test dans une exécution. |
| 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. |
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:
- 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 - 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. - ensembles de tests — regroupe les cas de test dans une suite exécutable avec
testsets createsuivi detestcases add. - exécution des ensembles de tests — le démarrage d'une exécution. Renvoie une
ExecutionIdque chaque commande en aval prend comme entrée. - attendre — bloquez le script jusqu'à ce que l'exécution atteigne un état terminal (
Passed,Failed,Cancelled). Utilisez--timeoutpour limiter l'attente. - 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). - 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 runsuivi deuip tm wait— voir Codes de sortie lors de l'exécution.waitquitte2au 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 viareport getouresult download, et non via le code de sortie de la commande d'exécution.
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.