Tester un package ou exécuter un ensemble de tests dans Test Manager

Tester un package ou exécuter un ensemble de tests dans Test Manager

Prérequis

1. Utilisez la dernière version de Test Manager.

2. Si vous faites référence à un ensemble de test existant à partir d’Orchestrator, importez l’ensemble de test dans Test Manager. Pour de plus amples informations, consultez la section Test Manager – Importer des ensembles de tests Orchestrator. Obtenez la clé de l'ensemble de tests après l'importation.

3. Créez un projet dans Test Manager et obtenez la clé du projet. Obtenez la clé du projet à partir de Test Manager > Tous les projets > Accéder au menu à trois points du projet > Modifier > Préfixe.

4. Créez un package ou un ensemble de test avec des cas de test automatisés. Obtenez la clé de l’ensemble de tests à partir de Test Manager > onglet Ensembles de tests > colonne Clé.

5. Obtenez les objets IDClient et CléSecrèteClient. Pour plus d'informations sur la façon d'obtenir l'IDClient et la CléSecrèteClient, reportez-vous à la section Enregistrement d'une application externe de la rubrique Exécution des intégrations CI/CD - Exécution des tâches CLI UiPath .

6. Exécutez le fichier uipcli.dll pour Windows/Linux/macOS.

7. Ajoutez les étendues d'application d'accès à l'API Test Manager requises. Pour plus d'informations sur les étendues de Test Manager, reportez-vous à la rubrique Intégrations CI/CD - Exécution des tâches CLI UiPath .

Utilisation de Test Manager avec CLI

Pour tester un package à l'aide de Test Manager, procédez comme suit : Exécutez la tâche de test à l'aide de uipcli test. Vous remarquerez une liste de sous-tâches disponibles. Spécifiez les paramètres requis et sélectionnez la sous-tâche d'exécution.

Pour utiliser Test Manager au lieu des tests Orchestrator, spécifiez le paramètre --projectKey dans la commande test run . La CLI exécutera automatiquement vos tests via Test Manager.

Paramètres de la commande test

Paramètre	Description	Requis
Orchestrator URL (pos. 0)	Il s’agit de l’URL de votre Orchestrator.	Oui (Yes)
Orchestrator Tenant (pos. 1)	Le locataire à l’intérieur duquel se trouve le projet Test Manager. Obligatoire lorsque vous ciblez Automation Cloud. Facultatif pour Automation Suite et la version autonome d'Orchestrator (MSI local), où le locataire fait partie de l'URL.	Voir la description
-P, --project-path	Le chemin d'accès au fichier de package de test que vous souhaitez tester	Non (No)
--projectKey	La clé du projet affichée dans Test Manager > onglet Tableau de bord > Projets > Tous les projets. La clé du projet est le préfixe de toutes les clés d'objet.	Oui (pour Test Manager)
--testsetkey	La clé de l’ensemble de tests affichée dans le Test Manager Test Manager > onglet Ensembles de tests > colonne Clé. Assurez-vous que l'ensemble de tests inclut la version la plus récente des cas de test. Si le projet ne dispose d’aucun dossier par défaut défini, veillez à attribuer un dossier de test au niveau de l’ensemble de tests.	Non (No)
-s, --testset	Le nom affiché pour l'ensemble de tests que vous souhaitez exécuter. Assurez-vous que l'ensemble de tests inclut la version la plus récente des cas de test. Si le projet ne dispose d’aucun dossier par défaut défini, veillez à attribuer un dossier de test au niveau de l’ensemble de tests.	Non (No)
--out	Le type du fichier des résultats	Non (No)
-r, --result_path	Le chemin d'accès de destination du fichier dans lequel vous souhaitez stocker les résultats	Non (No)
-e, --environment	L'environnement dans lequel vous souhaitez déployer le package. Vous devez l’associer à l’ project path	Requis pour les dossiers classiques
-w, --timeout	Le temps (en secondes) pendant lequel vous souhaitez attendre que l'ensemble de tests s'exécute. La valeur par défaut est de 7 200 secondes.	Non (No)
-i, --input_path	Le chemin complet d’accès à un fichier d’entrée json. Voir Format JSON des paramètres d'entrée pour plus de détails sur la structure du fichier.	Requis si le workflow de point d'entrée comprend des paramètres d'entrée
--attachRobotLogs	Attache les journaux du robot pour chaque cas de test exécuté et un rapport de test JUnit.	Non (No)
--repositoryUrl	L'URL du référentiel dans lequel le projet est versionné	Non (No)
--repositoryCommit	La validation du référentiel à partir duquel le projet a été généré	Non (No)
--repositoryBranch	La branche du référentiel à partir duquel le projet a été généré	Non (No)
--repositoryType	Type de référentiel système VCS	Non (No)
--projectUrl	URL de l’idée Automation Hub	Non (No)
--releaseNotes	Ajouter des notes de publication	Non (No)
--author	Auteur du paquet.	Non (No)
--nugetConfigFilePath	Chemin d'accès au fichier NuGet.Config contenant les flux. La balise <clear /> du fichier spécifié sera ignorée et seules les sources seront prises en compte.	Non (No)
--disableBuiltInNugetFeeds	Désactiver les flux NuGet intégrés	Non (No)
--excludeConfiguredSources	Exclut les flux intégrés et les sources NuGet configurées au niveau de l'utilisateur et de la machine sur l'hôte exécutant la CLI. La CLI résout les packages uniquement à partir des flux définis dans --nugetConfigFilePath. Voir Gestion des flux NuGet.	Non (No)
--retryCount	Nombre de nouvelles tentatives pour les cas de test ayant échoué	Non (No)
-u, --username	Le nom d'utilisateur utilisé pour l'authentification auprès d'Orchestrator. Vous devez l'associer au mot de passe correspondant	Requis pour l’authentification de base
-p, --password	Le mot de passe utilisé pour l'authentification auprès d'Orchestrator. Vous devez l'associer au nom d'utilisateur correspondant	Requis pour l’authentification de base
-t, --token	Le jeton d’actualisation OAuth2 utilisé pour l’authentification auprès d’Orchestrator. Vous devez l’associer au nom du compte et à l’ID client	Requis pour l’authentification basée sur jeton
-a, --accountName	Le nom du compte Orchestrator CloudRPA. Vous devez l’associer au jeton d’actualisation OAuth2 et à l’ID client	Requis pour l’authentification basée sur jeton
-A, --accountForApp	Le nom du compte Orchestrator CloudRPA (nom de l’organisation). Vous devez l’associer à l ’ID d’application, à la clé secrète de l’application et à l’ étendue de l’application pour une application externe	Non (No)
-I, --applicationId	ID d’application externe Vous devez l'associer au compte d'application, à l'ID d' application et à l'étendue de l'application	Requis pour l’authentification d’application externe
-S, --applicationSecret	La clé secrète de l'application externe. Vous devez l'associer au compte d' application, à l'ID d' application et à l'étendue de l'application	Requis pour l’authentification d’application externe
--applicationScope	La liste des étendues d'application, séparées par des espaces simples. Vous devez l’associer à l’ID d’application, à la clé secrète de l’ application et à l’étendue de l’application pour l’application externe	Facultatif pour l'authentification d'application externe. Utilisation des étendues par défaut en l’absence d’indication contraire
-o, --organizationUnit	Le dossier Orchestrator dans lequel vous souhaitez exécuter les ensembles de test	Non (No)
-l, --language	La langue utilisée dans l’interface utilisateur d’Orchestrator	Non (No)
--traceLevel	Afficher le traçage des événements	Non (No)
--identityUrl	L'URL de votre Identity Server. Requis lorsque Orchestrator s'exécute sur UiPath Automation Suite ou sur la version autonome d'Orchestrator (MSI local). Non nécessaire pour Automation Cloud — la CLI résout le serveur d'identité à partir de l'URL du cloud.	Non (No)
--ca-cert	Fichier(s) CA racine approuvé(s) (PEM, DER ou PKCS#7) pour le certificat TLS Orchestrator/Identity. Répétez ou séparez par des virgules. Voir Approbation des certificats personnalisés.	Non (No)
--pinnedpubkey	Épingler la clé publique de la feuille (sha256//<base64>). Voir Approbation des certificats personnalisés.	Non (No)

Astuce :

Pour les instances Orchestrator signées par une autorité de certification privée (telle qu'UiPath Automation Suite), cette commande accepte également les paramètres --ca-cert et --pinnedpubkey . Voir Approbation de certificats personnalisés pour des scénarios et des exemples.

Remarque : Étendues d'application par défaut pour les tests

Lorsque vous utilisez l'authentification d'application externe sans spécifier le paramètre --applicationScope , la CLI applique automatiquement ces étendues de Test Manager par défaut :

TM.Projects TM.TestSets TM.TestExecutions

En plus des étendues OU par défaut :

OR.Assets OR.BackgroundTasks OR.Execution OR.Folders OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read

Exemples d'utilisation

Exécuter un ensemble de tests existant dans Test Manager

# Windows
uipcli test run "https://cloud.uipath.com/" "TenantName" `
  --projectKey "MyTestProject" `
  --testsetkey "MyTestSet" `
  -A "organizationName" `
  -I "becc663c-8f1e-409a-a75f-c00330d80bc8" `
  -S '********' `
  --applicationScope "OR.Folders OR.Execution TM.Projects TM.TestSets TM.TestExecutions" `
  -o "FolderName" `
  --out "junit" `
  --result_path "C:\TestResults"
  --author ExampleAuthor

# Linux/macOS
uipcli test run "https://cloud.uipath.com/" "TenantName" \
  --projectKey "MyTestProject" \
  --testsetkey "MyTestSet" \
  -A "organizationName" \
  -I "becc663c-8f1e-409a-a75f-c00330d80bc8" \
  -S '********' \
  --applicationScope "OR.Folders OR.Execution TM.Projects TM.TestSets TM.TestExecutions" \
  -o "FolderName" \
  --out "junit" \
  --result_path "./test-results"
  --author ExampleAuthor

Créer et exécuter un ensemble de tests temporaire à partir d'un projet

Les ensembles de test temporaires sont des ensembles de test temporaires créés à la volée à partir de votre chemin de projet.

uipcli test run "https://cloud.uipath.com/" "TenantName" \
  --projectKey "MyTestProject" \
  -P "./MyTestProject/project.json" \
  -e "TestEnvironment" \
  -A "organizationName" \
  -I "becc663c-8f1e-409a-a75f-c00330d80bc8" \
  -S '********' \
  --applicationScope "OR.Folders OR.Execution TM.Projects TM.TestSets TM.TestExecutions" \
  -o "FolderName" \
  --out "uipath" \
  --result_path "./test-results"

Exécuter des tests avec des remplacements de paramètres

uipcli test run "https://cloud.uipath.com/" "TenantName" \
  --projectKey "MyTestProject" \
  --testsetkey "MyTestSet" \
  -i "./test-parameters.json" \
  -A "organizationName" \
  -I "becc663c-8f1e-409a-a75f-c00330d80bc8" \
  -S '********' \
  --applicationScope "OR.Folders OR.Execution TM.Projects TM.TestSets TM.TestExecutions" \
  -o "FolderName" \
  --out "junit" \
  --result_path "./test-results"

Exécuter des tests avec des journaux de robot en pièce jointe

uipcli test run "https://cloud.uipath.com/" "TenantName" \
  --projectKey "MyTestProject" \
  --testsetkey "MyTestSet" \
  --attachRobotLogs true \
  -A "organizationName" \
  -I "becc663c-8f1e-409a-a75f-c00330d80bc8" \
  -S '********' \
  --applicationScope "OR.Folders OR.Execution TM.Projects TM.TestSets TM.TestExecutions" \
  -o "FolderName" \
  --out "junit" \
  --result_path "./test-results"

Types de rapport

Test Manager prend en charge deux formats de sortie :

Format	Description	Cas d'utilisation
junit	Format XML JUnit	Intégration CI/CD (Jenkins, Azure DevOps, GitHub Actions)
uipath	Format natif UiPath	Rapports d'exécution détaillés avec des données spécifiques à Test Manager

Migration depuis les tests Orchestrator

Avant (test d'Orchestrator)

uipcli test run "https://cloud.uipath.com/" "TenantName" \
  -s "MyTestSet" \
  -u "username" \
  -p "password" \
  -o "FolderName" \
  -P "./project.json"

Après (Test Manager)

uipcli test run "https://cloud.uipath.com/" "TenantName" \
  --projectKey "MyTestProject" \
  --testsetkey "MyTestSet" \
  -A "organizationName" \
  -I "becc663c-8f1e-409a-a75f-c00330d80bc8" \
  -S '********' \
  --applicationScope "OR.Folders OR.Execution TM.Projects TM.TestSets TM.TestExecutions" \
  -o "FolderName" \
  --out "junit" \
  --result_path "./results"

Principales différences

1. Ajoutez le paramètre --projectKey pour activer Test Manager
2. Utiliser --testsetkey au lieu de -s pour l'identification de l'ensemble de tests
3. Test Manager nécessite une authentification OAuth
4. Spécifiez le format de sortie avec --out et la destination avec --result_path

Meilleures pratiques

Configuration de Test Manager

• Créez des projets Test Manager dédiés pour différentes applications ou équipes
• Utilisez des clés de projet et des clés d'ensemble de test significatives pour une identification facile
• Organiser les ensembles de tests par objectif (régression, fumée, intégration, etc.)

Gestion des paramètres

• Utiliser des fichiers de paramètres (-i) pour les configurations spécifiques à l'environnement
• Stockez les paramètres sensibles dans les clés secrètes CI/CD, pas dans les fichiers de paramètres
• Documentez les paramètres requis dans les descriptions de votre ensemble de tests

Logique de nouvelle tentative

• Utilisez --retryCount pour les tests factices qui peuvent échouer par intermittence
• Définissez les valeurs --timeout appropriées en fonction de la durée du test
• Surveillez les schémas de nouvelles tentatives pour identifier et corriger les tests instables

Rapports

• Utiliser le format junit pour l’intégration du pipeline CI/CD
• Utilisez le format uipath pour une analyse détaillée dans Test Manager
• Activer --attachRobotLogs pour le débogage des échecs de test

Intégration CI/CD

• Configurer l'authentification de Test Manager à l'aide de variables d'environnement sécurisées
• Configurez l’exécution automatisée de tests sur des validations de code ou des demandes pull
• Archiver les rapports de test en tant qu’artefacts de création pour l’historique de suivi