Tester un package ou exécuter un ensemble de test

Prerequisites:

• Créer un package ou un ensemble de test.
• Exécutez le fichier CLI exe (pour l'héritage Windows) ou dll (pour Windows/Linux/macOS).
• Ajoutez les étendues d'application d'accès à l'API Orchestrator requises.

Pour tester un package, procédez comme suit :

1. Exécutez la tâche test à l'aide de uipcli test. Vous pouvez remarquer une liste des sous-tâches disponibles.
2. Spécifiez les paramètres requis et exécutez la sous-tâche run . Le tableau suivant décrit les paramètres requis :

Paramètre	Description
-P , or --project-path	Chemin d'accès au fichier du package de test que vous souhaitez tester.
-s , or --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.
--out	Le type du fichier des résultats \<binit|uipath\>.
-r , or --result_path	Le chemin de destination du fichier dans lequel vous souhaitez stocker les résultats.
-e , ou --environment ( Requis pour les dossiers classiques)	L'environnement dans lequel vous souhaitez déployer le package. Vous devez l’associer à l ’objet project path .
-w , or --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 .
-i , ou --input_path ( Requis si le workflow de point d'entrée comprend des paramètres d'entrée que vous souhaitez passer par la ligne de commande)	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.
--attachRobotLogs	Attache les journaux du robot pour chaque cas de test exécuté et un rapport de test JUnit.
--repositoryUrl	L'URL du référentiel où le projet est versionné.
--repositoryCommit	La validation du référentiel à partir duquel le projet a été créé.
--repositoryBranch	La branche du référentiel à partir de laquelle le projet a été créé.
--repositoryType	Type de référentiel système VCS.
--projectUrl	URL de l'idée Automation Hub.
--releaseNotes	Ajouter des notes de publication.
--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.
--disableBuiltInNugetFeeds	Désactivez les flux NuGet intégrés.
--retryCount	Nombre de nouvelles tentatives pour les cas de test ayant échoué (par défaut, aucune nouvelle tentative n’est définie).
-u , ou --username ( Requis si vous utilisez l' authentification de base , via un nom d'utilisateur et un mot de passe)	Le nom d'utilisateur utilisé pour l'authentification auprès d'Orchestrator. Vous devez l'associer au mot de passe correspondant.
-p , ou --password ( Requis si vous utilisez l' authentification de base , via un nom d'utilisateur et un mot de passe)	Le mot de passe utilisé pour l'authentification auprès d'Orchestrator. Vous devez l'associer au nom d'utilisateur correspondant.
-t , ou --token ( Requis si vous utilisez l'authentification basée sur jeton )	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 .
-a , ou --accountName ( Requis si vous utilisez l'authentification basée sur jeton )	Le nom du compte Orchestrator CloudRPA. Vous devez l'associer au jeton d'actualisation OAuth2 et à l' ID client .
-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.
-I , ou --applicationId ( Requis si vous utilisez l'authentification d'application externe )	ID d’application externe Vous devez l'associer au compte d'application, à l'ID d'application et à l'étendue de l'application.
-S , ou --applicationSecret ( Requis si vous utilisez l'authentification d'application externe )	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.
--applicationScope ( Facultatif pour l'authentification d'application externe )	La liste des étendues d'application, séparées par des espaces simples. Facultatif lors de l'utilisation de l'authentification d'application externe, les étendues par défaut sont automatiquement appliquées. 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
-o , or --organizationUnit	Le dossier Orchestrator dans lequel vous souhaitez exécuter les ensembles de tests.
--author	Auteur du paquet.
-l , or --language	La langue utilisée dans l'interface utilisateur d'Orchestrator.
--traceLevel	Afficher la trace des événements.
--identityURL ( Requis pour les déploiements PaaS ou MSI )	L'URL de votre serveur d'identité.
Orchestrator URL (pos. 0) ( Requis )	Il s'agit de l'URL de votre Orchestrator.
Orchestrator Tenant (pos. 1) ( Requis ) pour les déploiements SaaP. ( Facultatif ) pour les déploiements PaaS.	Locataire à l'intérieur duquel se trouve le package ou l'ensemble de test.
--ca-cert	One or more trusted root CA certificate files (PEM, DER, or PKCS#7) used when validating the Orchestrator and Identity Server TLS certificates. Repeat the flag or comma-separate multiple paths. See Trusting custom certificates for details.
--pinnedpubkey	Pin the server leaf certificate's public key. Format: sha256//<base64>. Checked in addition to standard certificate validation. See Trusting custom certificates for details.

Astuce :

For Orchestrator instances signed by a private Certificate Authority (such as UiPath Automation Suite), this command also accepts --ca-cert and --pinnedpubkey parameters. See Trusting custom certificates for scenarios and examples.

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 les étendues Orchestrator suivantes 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

Pour les opérations de Test Manager, consultez Tester un package ou exécuter un ensemble de test dans Test Manager qui utilise différentes étendues par défaut.

Utilisation :**

uipcli test run <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-P <project_json_path>] [-s <testset_name>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-e <environment>] [-o <folder_name>] [-l <language>] [--out <junit|uipath>] [--result_path <result_path>] [--timeout <seconds>] [--attachRobotLogs true] repositoryUrl <repository_url>] [--repositoryCommit <repository_commit>] [--repositoryBranch <repository_branch>] [--repositoryType <repository_type>] [--projectUrl <automation_hub_idea_url>] [--releaseNotes <release_notes>] [--disableBuiltInNugetFeeds] [--retryCount <number>]  [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identityUrl>]

Exemples  :

• uipcli test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json" "C:\userprofile\AutomationProjectWithTestCases\project.json"
• uipcli test run "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S '********' --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json"
• uipcli test run "https://automation-suite.base.url.com/" "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S '********' --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json"
• uipcli test run "https://cloud.uipath.com/" "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel Information -P "C:\userprofile\AutomationProjectWithTestCases\project.json" --author ExampleAuthor