Exécution de tests d'interface utilisateur dans un pipeline Azure DevOps

Après avoir créé les tests dans IBM® Rational® Functional Tester pour l'application que vous testez et après avoir installé IBM Rational Test Workbench dans votre organisation, vous pouvez exécuter les tests dans les pipelines Azure DevOps.

Vous devez avoir effectué les tâches suivantes :

Installé le IBM Rational Test Workbench dans votre organisation. Voir Installation du IBM Rational Test Workbench.
A installé un agent dans votre pipeline. Voir agents Azure Pipelines.
Création de scénarios de test sous les plans de test si vous souhaitez afficher les résultats des exécutions de test sur le tableau de bord des plans de test.

Après avoir ajouté le IBM Rational Test Workbench dans votre organisation Azure DevOps, vous pouvez utiliser un pipeline existant ou en créer un nouveau pour ajouter Rational Functional Tester des tâches de test. Vous pouvez installer un agent ou utiliser celui que vous avez installé dans votre pool d'agents par défaut. Vous pouvez ajouter les Rational Functional Tester tests à votre tâche pour le travail de l'agent, configurer la tâche, puis exécuter la tâche dans le pipeline Azure DevOps.

Si vous avez créé des cas de test sous des plans de test dans votre projet Azure DevOps, vous pouvez fournir les détails de l'URL Azure DevOps, du plan de test, du cas de test et de votre jeton d'accès personnel (PAT) pendant que vous configurez la tâche de test dans un pipeline afin que vous puissiez afficher les résultats de l'exécution du test sur votre tableau de bord Plan de test.

Ouvrez votre page Organisation dans Azure DevOps et effectuez les étapes suivantes :
1. Cliquez sur le projet que vous souhaitez utiliser.
2. Initialisez le référentiel en procédant comme suit :
  1. Cliquez sur Repos dans le volet de gauche.
  2. Cliquez sur Initialiser dans la section Initialiser avec un README ou gitignore.
    Note: Cochez la case Ajouter un fichier README si elle n'est pas sélectionnée.
3. Cliquez sur Pipelines dans le volet de gauche.
4. Cliquez sur Créer un pipeline.
5. Cliquez sur Utiliser l'éditeur classique pour créer un pipeline sans YAML.
6. Vérifiez le projet, le référentiel et la branche pour les builds manuels et programmés, puis cliquez sur Continuer.
7. Cliquez sur Travail vide.
Sélectionnez Pipeline et suivez les étapes suivantes :
1. Modifiez le nom du pipeline de construction si nécessaire.
2. Sélectionnez le pool d'agents pour votre pipeline de build.
  
  Vous pouvez utiliser l'agent du pool d'agents par défaut ou utiliser celui que vous avez installé.
3. Sélectionnez la spécification de l'agent pour l'agent si nécessaire.
Ajoutez une tâche au travail de l'agent en procédant comme suit :
1. Cliquez sur l'icône Ajouter une tâche pour le travail d'agent.
  
  Le volet Ajouter des tâches s'affiche.
2. Rechercher les tâches IBM définies dans IBM Rational Test Workbench.
  Les tâches que vous pouvez sélectionner sont affichées.
  
  Selon le type de test que vous avez créé en Rational Functional Tester, vous pouvez sélectionner le type de tâche.
  Vous devez utiliser le tableau suivant pour identifier la tâche que vous devez sélectionner :
  Type de test Tâche à sélectionner
  
  Suites AFT
  
  Tests Web UI
  
  Tests composés
  
  IBM Rational Functional Tester Tâche
3. Sélectionnez l'option Tâche Rational Functional Tester, puis cliquez sur Ajouter pour ajouter la tâche au travail de l'agent.
  
  La tâche sélectionnée est ajoutée au travail de l'agent et s'affiche avec un avertissement indiquant que certains paramètres nécessitent une attention particulière. Vous devez configurer les paramètres mentionnés à l'Étape 4.
  Vous pouvez également supprimer les tâches qui ne sont pas requises dans votre travail. Sélectionnez les tâches de la liste que vous souhaitez supprimer. Vous pouvez ensuite cliquer avec le bouton droit sur les tâches et cliquer sur Supprimer la ou les tâches sélectionnées pour les supprimer.

Type de test	Tâche à sélectionner
Suites AFT Tests Web UI Tests composés	IBM Rational Functional Tester Tâche

Configurez les paramètres en procédant comme suit :

Sélectionnez la version de la tâche dans la liste si nécessaire.

Suivez l'action de la tâche Web UI en vous référant au tableau suivant :

Note: Tous les les champs obligatoires sont marqués d'un astérisque (*) dans l'interface utilisateur.

Note:

Vous devez fournir les valeurs des champs obligatoires suivants :

Workspace Location
Project Name
Test Suite Name

Si vous incluez ces paramètres obligatoires dans un fichier de configuration et utilisez le champ Configuration File pour spécifier le chemin d'accès complet au fichier, ces valeurs ne sont pas obligatoires.


Champ	Description	Action
Afficher le nom	Affiche le nom de la tâche sélectionnée.	Entrez le nom de la tâche.
Type de cas de test	Le type de test à exécuter.	Sélectionnez Web UI dans la liste Testcase Type.
Chemin du produit	Le chemin complet vers Rational Functional Tester. Ce chemin doit exister sur l'ordinateur de l'agent.	Entrez le chemin complet de Rational Functional Tester.
Importer	Le chemin d'accès complet au dossier du projet qui est cloné à partir d'un système de contrôle de code source ou d'un référentiel distant.	Entrez le chemin d'accès complet au dossier du projet qui est cloné à partir d'un système de contrôle de code source ou d'un référentiel distant. Lorsque vous utilisez cette option, vous pouvez spécifier un nom pour le nouvel espace de travail à créer pour exécuter les actifs de test importés.
IMShared Path	Le chemin d'accès au dossier IMShared sur votre ordinateur local.	Entrez le chemin d'accès complet à l'emplacement du dossier IBMIMShared. Par exemple, C:\Program Files\IBM\IBMIMShared
Emplacement de l'espace de travail	Le chemin complet vers l'espace de travail Eclipse.	Entrez le chemin complet de l'espace de travail Eclipse.
Nom du projet	Le nom du projet contenant le test.	Entrez le nom du projet contenant le test.
Nom de la suite de tests	Le nom d'un test dans le projet à utiliser. Un test peut être un test d'interface utilisateur Web, un calendrier de performances, un test composé ou des suites AFT.	Entrez le nom du test que vous souhaitez exécuter.
Arguments VM	Arguments de machine virtuelle Java™ à transmettre.	Entrez les arguments de la machine virtuelle Java™. Note: Vous pouvez ajouter plusieurs fichiers d'arguments de machine virtuelle séparés par une `virgule`.
Étiquettes	L'option d'ajouter des étiquettes aux résultats du test lorsque le test est terminé.	Saisissez les étiquettes à ajouter aux résultats du test lorsque le test est terminé. Vous pouvez ajouter plusieurs étiquettes à un résultat de test séparées par une virgule. Par exemple, label1, label2 Lorsque vous exécutez des ressources de test, les mêmes étiquettes s'affichent sur l'interface utilisateur Tester le rapport statistique dans Rational Functional Tester. Si vous avez défini Publier le résultat après l'exécution sur Toujours ou Invite dans les Rational Functional Tester préférences (Fenêtre > Préférences > Test > Rational Test Automation Server) et utilisez l'option Étiquettes, puis la page Résultats de Rational Test Automation Server affiche la même étiquette pour l'actif de test spécifique. Note: Lorsque vous exécutez des tests en utilisant des guillemets doubles ("") pour le champ Labels, les étiquettes dans le résultat du test n'incluent pas les guillemets doubles. Pour contourner ce problème, vous devez créer un fichier de configuration de ligne de commande, puis exécuter le test en utilisant le champ Configuration File. Lorsque vous utilisez le champ Configuration File pour exécuter des tests, les étiquettes fournies dans le fichier de configuration ont priorité sur les étiquettes fournies dans le champ Labels.
Fichier Var	Le chemin d'accès complet au fichier XML qui contient les paires nom de variable et valeur.	Entrez le chemin complet vers l'emplacement du fichier variable.
Remplacer l'ensemble de données	Pour un test, la valeur par défaut est le jeu de données spécifié dans l'éditeur de test.	Utilisez l'option `Remplacer l'ensemble de données` pour remplacer les valeurs de l'ensemble de données lors d'une exécution de test. Si un test est associé à un ensemble de données, vous pouvez remplacer l'ensemble de données au moment de l'exécution tout en lançant l'exécution à partir de la ligne de commande. Note: Vous devez utiliser l'option `Remplacer l'ensemble de données` pour remplacer les valeurs de l'ensemble de données lors d'une exécution de test. Vous devez vous assurer que les ensembles de données d'origine et nouveaux se trouvent dans le même espace de travail et ont les mêmes noms de colonne. Vous devez également inclure le chemin d'accès au jeu de données. Par exemple, `/project_name/ds_path/ds_filename.csv:/project_name/ds_path/new_ds_filename.csv`. Vous pouvez échanger plusieurs ensembles de données enregistrés dans un projet différent en ajoutant plusieurs chemins d'accès à l'ensemble de données séparés par un `point-virgule (;)`. Par exemple, `/project_name1/ds_path/ds_filename.csv:/project_name1/ds_path/new_ds_filename.csv; /project_name2/ds_path/ds_filename.csv:/project_name2/ds_path/new_ds_filename.csv`
Fichier de configuration	Le fichier complet chemin d'accès à un fichier contenant les paramètres d'une exécution de test.	Entrez le chemin d'accès complet du fichier contenant les paramètres d'une exécution de test.
Résultats	Le nom du fichier de résultats. Le nom par défaut du fichier de résultats est le nom du test suivi d'un horodatage.	Entrez un nom de dossier relatif au projet pour stocker les résultats du test. Par exemple, -results folder/resultname.
Écraser	Détermine si un fichier de résultats portant le même nom est écrasé. La valeur par défaut `false` indique que le nouveau fichier de résultats est créé.	Définissez la valeur sur `true` pour écraser le fichier existant et conserver le même nom de fichier.
Exporter les statistiques	Le chemin complet pour exporter le rapport au format spécifié dans le champ Export stats format.	Saisissez les valeurs séparées par une virgule pour exporter ces valeurs au format CSV.
Exporter la liste des rapports statistiques	L'option permettant de répertorier les rapports que vous souhaitez exporter à la place des rapports par défaut ou les rapports sélectionnés sous Préférences.	Entrez la liste des ID de rapport séparés par une virgule.
Exporter les statistiques au format html	La possibilité d'afficher et d'analyser les résultats sur un navigateur Web sans utiliser l'atelier de test.	Vous pouvez fournir le chemin d'accès complet à un répertoire pour exporter les résultats d'analyse Web. Si vous exécutez plusieurs tests, ne fournissez pas de valeur dans ce champ.
Commentaires de l'utilisateur	L'option pour ajouter et afficher vos commentaires dans le rapport.	Saisissez le texte entre guillemets doubles pour l'afficher dans la ligne Commentaires de l'utilisateur du rapport. Note: Lorsque vous exécutez des tests en utilisant des guillemets doubles ("") pour le champ User Comments, la ligne User Comments d'un rapport ne contient pas de guillemets doubles. Pour contourner ce problème, vous devez créer un fichier de configuration de ligne de commande, puis exécuter le test en utilisant le champ Configuration File.
Saisie de protocole	La possibilité d'exécuter un test d'interface utilisateur Web en parallèle sur différents navigateurs.	Entrez les navigateurs sur lesquels vous souhaitez exécuter le test Web UI en parallèle.
Exporter le rapport	L'option d'exportation du rapport unifié vers d'autres formats de fichier tels que PDF, XML et HTML.	Entrez les détails suivants dans le champ de texte : type=<type de rapport>;format=<type de fichier>;folder=<dossier de destination path>;filename=<nom du fichier exporté>
Format des statistiques d'exportation	L'option pour spécifier un format pour le rapport que vous souhaitez exporter.	Spécifiez un format pour le rapport que vous souhaitez exporter. Vous devez utiliser le paramètre Export stats avec le paramètre Export stats format. Vous devez utiliser au moins l'un des formats suivants : `simple.csv` `full.csv` `simple.json` `full.json` `csv` `json` Par exemple , `Export stats = <local_dir_path> Export stats format = json` Vous pouvez ajouter plusieurs formats pour le rapport séparés par une virgule (,). Si vous souhaitez exporter à la fois les rapports simples et complets au format `json` ou `csv`, vous pouvez spécifier `json` ou `csv` comme format dans le champ. Les rapports sont enregistrés à l'emplacement spécifié dans le champ Export stats.
publier	La possibilité de publier les résultats des tests sur Rational Test Automation Server.	Spécifiez l'URL du serveur et le nom du projet pour publier les résultats des tests sur Rational Test Automation Server. Vous devez fournir l'URL et le jeton d'utilisateur hors ligne du serveur dans Window > Preferences > Test > Rational Test Automation Server sur Rational Functional Tester avant d'utiliser le paramètre publish dans le script de test. Utilisez les arguments suivants avec le paramètre publish : Pour spécifier le nom du projet, utilisez l'un des formats suivants : serverURL #project.name=projectName&teamspace.name=name_of_the_teamspace serverURL #project.name=projectName&teamspace.alias=name_of_the_teamspace_alias Vous devez considérer les points suivants en fournissant les valeurs : Si le nom du projet n'est pas spécifié, la valeur du paramètre Project Name est utilisée. Si vous avez un projet portant le même nom dans différents espaces d'équipe, vous pouvez ajouter soit le &teamspace.name=`name_of_the_teamspace` ou &teamspace.alias==`name_of_the_teamspace_alias` choix. Par exemple : `Workspace Location = C:/Users/IBM/rationalsdp/workspace1 Project Name = proj1 Test Suite Name = Tests/testHttp.testsuite publish = https://localhost:5443#project.name=test&teamspace.name=ts1` Où : https://localhost:5443 est l'URL du serveur. test est le nom du projet. ts1 est le nom de l'espace d'équipe. Si le nom du projet ou de l'espace d'équipe contient un caractère spécial, alors vous devez le remplacer par `%<Hex_value_of_special_character>`. Par exemple, si le nom de l'espace d'équipe est `Espace d'équipe initial`, vous devez le fournir sous la forme `Intial%20Team%20Space`. Où, %20 est la valeur hexadécimale du caractère espace. Vous ne devez pas inclure les guillemets doubles ("") lorsque vous fournissez la valeur du champ Publish. Pour éviter la publication de rapports, utilisez no. Vous pouvez utiliser l'option no si vous ne souhaitez pas publier les résultats du test après l'exécution. Cette option est utile si les préférences du produit sont définies pour publier les résultats, mais que vous ne souhaitez pas les publier. Par exemple : `Workspace Location = C:/Users/IBM/rationalsdp/workspace1 Project Name = proj1 Test Suite Name = Tests/testHttp.testsuite publish = no` Si vous n'utilisez pas le champ Config File pour exécuter les tests, les valeurs fournies dans le champ Publish ont toujours priorité sur les options Résultats définies dans les préférences du produit (Fenêtre > Préférences > Test > Rational Test Automation Server > Résultats). La section Informations sur les rapports de la fenêtre Sortie affiche les noms du rapport ainsi que ses URL correspondantes dans les conditions suivantes : Lorsque vous avez configuré l'URL de Rational Test Automation Server dans les préférences de Rational Functional Tester (Window > Preferences > Test > Rational Test Automation Server. Lorsque vous définissez Publier le résultat après exécution sur Toujours ou Invite dans les préférences de Rational Functional Tester (Fenêtre > Préférences > Test > Rational Test Automation Server > Résultats ).
publish_for	La possibilité de publier les résultats des tests sur Rational Test Automation Server en fonction de l'état d'achèvement des tests.	Spécifiez l'option de publication des résultats des tests sur Rational Test Automation Server en fonction de l'état d'achèvement des tests. Vous devez utiliser le paramètre publish_for avec le paramètre publish. Voici les options disponibles que vous pouvez utiliser pour le paramètre publish_for : ALL - Il s'agit de l'option par défaut. Vous pouvez utiliser cette option pour publier les résultats des tests pour tout verdict d'exécution de texte. PASS - Vous pouvez utiliser cette option pour publier les résultats des tests qui ont réussi. FAIL - Vous pouvez utiliser cette option pour publier les résultats des tests qui ont échoué. ERROR – Vous pouvez utiliser cette option pour publier les résultats des tests contenant des erreurs. INCONCLUSIVE - Vous pouvez utiliser cette option pour publier les résultats des tests non concluants. Vous pouvez ajouter plusieurs paramètres séparés par une virgule. Par exemple : `Workspace Location = C:/Users/IBM/rationalsdp/workspace1 Project Name = proj1 Test Suite Name = Tests/testHttp.testsuite publish = https://localhost:5443#project.name=test&teamspace.name=ts1 publish_for = FAIL,ERROR`
publier des rapports	La possibilité de publier les résultats des tests dans Rational Test Automation Server.	Spécifiez l'option de publication des résultats de test dans Rational Test Automation Server. Les valeurs que vous pouvez utiliser avec publishreports sont les suivantes : FT - Il s'agit d'un identifiant pour le rapport de test fonctionnel. Vous pouvez utiliser cette valeur pour publier le rapport unifié s'il est disponible pour le test sélectionné. Voir Rapports unifiés. STATS - Il s'agit d'un identifiant pour le rapport statistique. Vous pouvez utiliser cette valeur pour publier le rapport d'analyse Web s'il est disponible pour le test sélectionné. Voir Rapport de statistique de test d'interface utilisateur. TESTLOG - Il s'agit d'un identifiant pour le journal de test. Vous pouvez utiliser cette valeur pour publier le journal de test s'il est disponible pour le test sélectionné. Voir Présentation des journaux. Vous devez utiliser le paramètre publishreports avec le paramètre publish. Par exemple : `Workspace Location = C:/Users/IBM/rationalsdp/workspace1 Project Name = proj1 Test Suite Name = Tests/testHttp.testsuite publish = https://localhost:5443#project.name=test&teamspace.name=ts1 publishreports = STATS, TESTLOG` Les valeurs spécifiées ici remplacent les valeurs sélectionnées dans Fenêtre > Préférences > Test > Rational Test Automation Server > Résultats sur Rational Functional Tester. Vous pouvez préfixer la valeur avec ! pour publier les rapports à l'exception de celui spécifié dans le script de test. Par exemple, `Workspace Location = C:/Users/IBM/rationalsdp/workspace1 Project Name = proj1 Test Suite Name = Tests/testHttp.testsuite publish = https://localhost:5443#project.name=test&teamspace.name=ts1 publishreports = !TESTLOG` Tous les rapports sauf le rapport TESTLOG sont publiés sur Rational Test Automation Server après l'exécution de la commande.
URL du projet Azure DevOps	L'URL du projet de test dans l'organisation sur le serveur Azure DevOps. Note: Vous devez entrer les détails de cette option si vous avez créé des scénarios de test sous Plans de test dans votre projet Azure et que vous souhaitez afficher les résultats des tests sur le tableau de bord des plans de test.	Saisissez l'URL du projet de test dans l'organisation sur le serveur Azure DevOps au format suivant : https://<host>/<orgname>/<projectName> Vous devez utiliser cette option avec les options suivantes : Azure DevOps PAT Nom du plan de test Nom du cas de test
Azure DevOps PAT	Votre jeton d'accès personnel (PAT) du serveur Azure où le projet de test qui contient le plan de test est hébergé. Vous pouvez également ajouter votre jeton à une variable secrète et spécifier le nom de la variable sous la forme suivante : `$(variable_name)` Note: Le jeton doit avoir un accès en lecture et en écriture.	Entrez votre jeton d'accès personnel. Vous devez utiliser cette option avec les options suivantes : URL du projet Azure DevOps Nom du plan de test Nom du cas de test
Nom du plan de test	Le nom du plan de test dans le serveur Azure.	Entrez le nom du plan de test. Vous devez utiliser cette option avec les options suivantes : URL du projet Azure DevOps PAT Azure DevOps Nom du cas de test
Nom du scénario de test	Le nom du scénario de test sur le serveur Azure.	Entrez le nom du scénario de test. Vous devez utiliser cette option avec les options suivantes : URL du projet Azure DevOps PAT Azure DevOps Nom du plan de test

Développez Options de contrôle et configurez les paramètres de votre tâche si nécessaire.
Développez Variables de sortie et configurez les paramètres de votre tâche si nécessaire.

Sélectionnez les options suivantes :
1. Cliquez sur Enregistrer pour enregistrer les paramètres configurés pour la tâche.
  
  Note: La tâche n'est pas mise en file d'attente pour une exécution.
  Vous pouvez enregistrer la tâche dans un pipeline de build et choisir d'exécuter le build ultérieurement.
2. Cliquez sur Enregistrer la & file d'attente pour enregistrer les configurations et mettre l'exécution en file d'attente dans le pipeline.
  
  La boîte de dialogue Exécuter le pipeline s'affiche.
Effectuez les étapes suivantes :
1. Entrez un commentaire pour le test dans le champ Enregistrer le commentaire.
2. Sélectionnez l'agent que vous avez configuré pour le test dans la liste Pool d'agents.
3. Sélectionnez la spécification de l'agent dans la liste Spécification de l'agent pour l'agent si nécessaire.
4. Sélectionnez la branche dans la liste Branch/tag.
5. Ajoutez les variables et les demandes pour la tâche exécutée à partir du volet Options avancées si nécessaire.
6. Cochez la case Activer les diagnostics système pour une vue détaillée du journal.
7. Cliquez sur Enregistrer et exécuter.
  
  La page résumé du pipeline affiche la progression de l'exécution de la tâche.

Vous avez exécuté les tests pour l'application que vous êtes en train de tester dans le pipeline Azure DevOps.

Vous pouvez ouvrir la tâche pour afficher les journaux des tâches à partir de la page résumé du pipeline.
Vous pouvez cliquer sur Plans de test pour afficher le résultat du test si vous avez spécifié les valeurs pour Azure DevOps Project URL, Azure DevOps PAT, Test Plan Name et Test Case Name.
Vous devez cliquer sur la tâche pour ouvrir la page Tâche afin d'afficher les résultats du test.
Vous pouvez accéder aux URL des rapports pour afficher les informations d'exécution des tests à tout moment. Les URL de rapport sont les IBM Rational Test Automation Server URL où les rapports sont stockés.
Dans Rational Functional Tester, si l'URL Rational Test Automation Server est configurée dans Window > Preferences > Test > Rational Test Automation Server et Publier le résultat après l'exécution est défini sur Toujours dans Fenêtre > Préférences > Test > Rational Test Automation Server > Résultats, puis les journaux de la page Tâche également affiche les noms du rapport publié avec ses URL correspondantes.