- Vue d'ensemble (Overview)
- Démarrer
- Concepts
- Utilisation de la UiPath CLI
- Guides pratiques
- Revenus CI/CD
- Référence de commande
- Vue d'ensemble (Overview)
- Codes de sortie
- Options globales
- agent codé uip
- encodeur UIP
- uip ancrage dans le contexte
- UiPath Docsai
- Fonction UiP
- garde-fous UiP
- configuration llm uip
- uip llm-passerelle
- Création uip maestro
- Registre Maestro uip
- uip model-hub
- Tâches (Jobs)
- Dossiers
- Processus
- ROI du processus
- Paquets
- Machines
- Utilisateurs
- Rôles
- Licences
- Flux
- Pièces jointes (Attachments)
- Sessions
- Calendriers
- magasins d'informations d’identification
- journaux-audit
- paramètres
- Actifs
- Compartiments
- Compartiment-fichiers
- Bibliothèques
- Files d'attente (Queues)
- ROI de la file d'attente
- éléments de la file d'attente
- Déclencheurs (Triggers)
- Webhooks
- Activités - Rechercher
- activités get-Default-xaml
- Analyser
- liste règles-analyseurs
- Construire
- Nettoyage
- Installation de entités data-fabrics
- liste des entités data-fabrics
- Diff de fichiers
- Get-Library-Object-Repository
- Récupérer le référentiel d'objets
- Init
- liste des instances
- Créer un package
- Vérification des paquets
- Installation des paquets
- Versions de paquets
- Publier
- Distant
- restore
- exécuter, déboguer et amp; Exécution
- paramètres
- Début de Studio
- Recherche de modèles
- entité ajoutée aux données de test
- Ajouter une file d'attente de données de test
- variation d'ajout de données de test
- TM
- UIA
- Valider
- exemples de workflow - Obtenir
- liste d'exemples de workflow
- tâches UIP
- pièce jointe
- Champ personnalisé
- Défauts (Defects)
- Exécutions
- exporter-tâches
- Migration
- Libellé Objet
- Créer un package
- scénarios-perf
- groupes-de-charge-scénarios-perf
- données d’exécution de perf-scenario
- rapport de scénarios de performances
- Projet
- autorisations-projet
- Invites
- Rapport
- Prérequis
- Résultat
- Exécuter
- Planifications (Schedules)
- Journaux de cas de test
- Cas de test
- Ensembles de tests
- Journal des étapes de test
- Utilisateur (User)
- Attendre
- Traçages UIP
- Commentaires sur les traces UIP
- Migration
- Référence et assistance
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.
| Ressource | Objectif |
|---|---|
| Projet | Cré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-projet | Lisez les autorisations dont vous disposez sur un projet Test Manager. |
| Migration | Inspectez 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 test | Cré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 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 | Cré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écuter | Exé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écutions | Ré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 test | Dé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 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 | Obtenir 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âches | Vérifiez les tâches d'exportation de fichiers asynchrones démarrées par testcases export et report export . |
| pièce jointe | Charger, 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érequis | Cré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. |
| Invites | Ré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é Objet | Ajoutez, 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-perf | Cré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:
- 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 create. - 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 (
FinishedouCancelled). 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.
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 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.uip tm run— quitte1lorsqu'un test échoue ou ne rapporte aucun résultat, aucune exécution de test ou l'exécution est annulée, et4lorsque--timeouts'étend. Voir Exécuter.
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.