Configuration de scripts de test dans Micro Focus ALM

Vous devez configurer le script de test que vous avez créé dans Micro Focus Application Lifecycle Management (ALM) pour exécuter les tests de l'UI Web.

Vous devez avoir effectué les tâches suivantes :

Vous pouvez naviguer vers le répertoire alm pour copier le contenu du fichier modèle. Le répertoire alm se trouve dans le répertoire d'installation de Test UI. Le nom du fichier modèle est WebUI_ALM_Windows.txt et vous pouvez accéder au fichier à partir de l'emplacement suivant :

Installation_dir\IBM\DevOpsTest\alm

Par exemple, C:\Program Files\IBM\DevOpsTest\alm

Vous devez fournir les valeurs pour les paramètres obligatoires suivants :
  • Espace de travail
  • Projet
  • NomDuJeuDeTest
Si vous incluez ces paramètres obligatoires dans un fichier de configuration et utilisez le paramètre ConfigFile pour spécifier le chemin d'accès complet du fichier, alors ces paramètres ne sont pas nécessaires.
Important:

Vous devez entrer les valeurs des paramètres entre les guillemets doubles. Si les valeurs du paramètre contiennent des guillemets doubles, alors les valeurs doivent être enfermées dans d'autres guillemets doubles. Par exemple, si vous souhaitez ajouter une étiquette pour un résultat de test comme "perf mon", alors vous devez entrer la valeur du paramètre dans le script comme suit :

Étiquettes = ""perf mon""
  1. Connectez-vous au portail Micro Focus ALM, si vous n'êtes pas déjà connecté.
    Le tableau de bord Micro Focus ALM est affiché.
  2. Développez Testing depuis le volet de gauche, puis cliquez sur Plan de test.
  3. Sélectionnez un script de test du dossier que vous souhaitez configurer.
  4. Cliquez sur l'onglet Script de test.
  5. Collez le contenu du fichier WebUI_ALM_Windows.txt que vous avez copié dans l'espace prévu dans l'onglet Script de test.
  6. Entrez les valeurs de paramètre requises pour votre test dans le script en vous référant au tableau suivant :
    Paramètre Description
    Obligatoire
    Espace de travail Utilisez ce paramètre pour entrer le chemin complet de l'espace de travail Eclipse.
    Projet Utilisez ce paramètre pour entrer le nom du projet qui a des actifs de test.
    NomDuJeuDeTest Utilisez ce paramètre pour entrer le nom des actifs de test.
    Par exemple,
    Espace de travail = "C:/Users/IBM/devopstest/workspace1" Projet = "proj1" NomSuiteTest = "Tests/testHttp.testsuite"
    Facultatif
    FichierConfig Utilisez ce paramètre pour fournir le chemin complet vers un fichier de configuration qui contient les paramètres pour une exécution de test.
    ExporterRapport Utilisez cette option pour exporter le rapport unifié des tests UIP vers des formats de fichiers tels que PDF, HTML et XML.
    Note: Le fichier XML exporté est un fichier XML JUnit. Vous pouvez afficher ce fichier dans les applications qui prennent en charge les formats de rapport JUnit.

    La syntaxe de la commande est la suivante :

    exportReport "type=<typederapport>;format=<type de fichier1,type de fichier2,type de fichier3>;dossier<chemin du dossier de destination>;nomdefichier=<nom du fichier exporté>

    Par exemple, pour exporter le rapport uniquement au format pdf, vous pouvez utiliser

    exportReport "type=unifié;format=pdf;dossier=Exportedreport102;nomdefichier=testreport

    Si vous souhaitez exporter le rapport dans plusieurs formats, vous pouvez spécifier les formats de fichier en tant que valeurs séparées par des virgules. La valeur du type de fichier peut être en majuscules ou en minuscules.

    Par exemple, pour exporter le rapport dans tous les formats pris en charge, vous pouvez utiliser exportReport "type=unified;format=pdf,xml,html;folder=Exportedreport102;filename=testreport

    Le rapport dans différents formats de fichiers utilise le même nom de fichier qui est spécifié dans la commande.
    ExporterStatRapportliste Utilisez ce paramètre pour fournir une liste séparée par des virgules de chemins absolus vers des fichiers de format de rapport personnalisés (.view files) que vous pouvez utiliser pour exporter des données de rapport statistique avec ExportStatsFile.
    ExporterFichierStatistiques Utilisez ce paramètre pour fournir le chemin complet vers un répertoire que vous pouvez utiliser pour stocker les données de rapport statistique exportées.
    ExporterStatsHtml Utilisez ce paramètre pour fournir le chemin complet vers un répertoire que vous pouvez utiliser pour exporter les résultats d'analyse web. Les résultats sont exportés vers le répertoire spécifié. Vous pouvez analyser les résultats sur un navigateur web sans ouvrir Test UI.
    Partage de localisation IM Utilisez ce paramètre pour entrer le chemin complet vers l'emplacement IMSharedLocation.
    Libellés Utilisez ce paramètre pour ajouter des étiquettes aux résultats de test lorsque l'exécution du test est terminée. Vous pouvez ajouter plusieurs étiquettes à un résultat de test séparées par une virgule (,).
    Par exemple, 
    Espace de travail = ""C:/Users/IBM/devopstest/workspace1"" Projet = ""proj1"" NomSuiteDeTest = ""Tests/testHttp.testsuite"" Étiquettes = ""label1, label2""

    Lorsque vous exécutez des actifs de test, les étiquettes que vous avez ajoutées sont affichées sur le Rapport Statistique de Test UI dans Test UI.

    La page des Résultats de DevOps Test Hub affiche l'étiquette que vous avez ajoutée dans le paramètre Étiquettes pour l'actif de test spécifique dans la condition suivante :

    • Lorsque vous définissez Publier le résultat après exécution comme Toujours ou Inviter dans les préférences de Test UI (Windows > Préférences > Test > DevOps Test Hub > Résultats).

    Note:
    • Lorsque vous exécutez des tests en utilisant les guillemets doubles ("") pour le paramètre Étiquettes, alors 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 en ligne de commande, puis exécuter le test en utilisant le paramètre ConfigFile.
    • Lorsque vous utilisez le paramètre ConfigFile pour exécuter des tests, alors les étiquettes fournies dans le fichier de configuration prennent le pas sur les étiquettes fournies dans le script de test.
    ÉcraserLeFichierDeRésultats Définissez cette valeur de paramètre à true ou false pour déterminer si un fichier de résultat portant le même nom doit être écrasé ou non.

    La valeur par défaut est vrai.
    Publication Utilisez cette option pour publier les résultats de test sur DevOps Test Hub depuis Microfocus ALM.

    Vous devez fournir l'URL et le jeton d'utilisateur hors ligne du serveur dans Fenêtre > Préférences > Test > DevOps Test Hub de Test UI avant d'utiliser le paramètre Publier dans le script de test.

    Utilisez les arguments suivants avec le paramètre Publier :

    • Pour spécifier le nom du projet, utilisez l'un des formats suivants :

      • serverURL#nom_du_projet=nomDuProjet&nom_de_l'espace_d'équipe=nom_de_l'espace_d'équipe

      • serverURL#nom_du_projet=nomDuProjet&alias_de_l'espace_d'équipe=nom_de_l'alias_de_l'espace_d'équipe

      Vous devez prendre en compte les points suivants lors de la fourniture du nom du projet :

      • Si le nom du projet n'est pas spécifié, alors la valeur du paramètre Projet est utilisée.

      • Si vous avez un projet avec le même nom dans différents espaces d'équipe, alors vous pouvez ajouter soit l'option &teamspace.name=nom_de_l'espace_d'équipe soit l'option &teamspace.alias==nom_de_l'alias_de_l'espace_d'équipe.

        A. La valeur de paramètre envoyée au script CGI est renvoyée dans la page de la réponse, incorporée au code HTML. 
        Espace de travail = "C:/Users/IBM/devopstest/workspace1" Projet = "proj1" NomSuiteTest = "Tests/testHttp.testsuite" Publier = "https://localhost:5443/test#project.name=test&teamspace.name=ts1"
        Où :

        • https://localhost:5443/test 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 %<Valeur_hexadécimale_du_caractère_spécial>.

        Par exemple, si le nom de l'espace d'équipe est Initial Team Space, alors vous devez le fournir comme Intial%20Team%20Space.

        Où, %20 est la valeur hexadécimale du caractère espace.

    • Pour éviter la publication de rapports, utilisez non.

      Vous pouvez utiliser l'option non 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.

      A. La valeur de paramètre envoyée au script CGI est renvoyée dans la page de la réponse, incorporée au code HTML.
      Espace de travail = "C:/Users/IBM/devopstest/workspace1" Projet = "proj1" NomSuiteDeTest = "Tests/testHttp.testsuite" Publier = "non"

    Si vous n'utilisez pas le paramètre Fichier de configuration pour exécuter les tests, alors les valeurs fournies dans le script de test prennent toujours le pas sur les options Résultats définies dans les préférences du produit (Fenêtre > Préférences > Test > DevOps Test Hub > 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 DevOps Test Hub dans les préférences de Test UI (Fenêtre > Préférences > Test > DevOps Test Hub.

    • Lorsque vous définissez Publier le résultat après exécution comme Toujours ou Invitation dans les préférences de Test UI (Fenêtre > Préférences > Test > DevOps Test Hub > Résultats).
    Publier_pour

    Utilisez ce paramètre pour publier les résultats de test sur DevOps Test Hub à partir de Micro Focus ALM en fonction du statut d'achèvement des tests. Vous devez utiliser le paramètre Publish_for en conjonction avec le paramètre Publish.

    Voici les options disponibles que vous pouvez utiliser pour le paramètre Publish_for :

    • TOUT - C'est l'option par défaut. Vous pouvez utiliser cette option pour publier les résultats de test pour tout verdict d'exécution de texte.
    • PASS - Vous pouvez utiliser cette option pour publier les résultats des tests qui ont été réussis.
    • ÉCHEC - Vous pouvez utiliser cette option pour publier les résultats des tests qui ont échoué.
    • ERREUR - Vous pouvez utiliser cette option pour publier les résultats des tests qui comprenaient des erreurs.
    • NON CONCLUANT - 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.
    A. La valeur de paramètre envoyée au script CGI est renvoyée dans la page de la réponse, incorporée au code HTML. 
    Espace de travail = "C:/Users/IBM/devopstest/workspace1" Projet = "proj1" NomSuiteTest = "Tests/testHttp.testsuite" Publier = "https://localhost:5443/test#project.name=test&teamspace.name=ts1" Publier_pour = "FAIL,ERROR"
    Publierdesrapports Utilisez cette option pour publier les résultats de test dans DevOps Test Hub. Les valeurs que vous pouvez utiliser avec Publishreports sont les suivantes :
    • FT - C'est 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 - C'est un identifiant pour le rapport de statistiques. 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 - C'est 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 en conjonction avec le paramètre Publish.

    A. La valeur de paramètre envoyée au script CGI est renvoyée dans la page de la réponse, incorporée au code HTML. 
    Espace de travail = "C:/Users/IBM/devopstest/workspace1" Projet = "proj1" NomSuiteTest = "Tests/testHttp.testsuite" Publier = "https://localhost:5443/test#project.name=test&teamspace.name=ts1" PublierRapports = "STATS, TESTLOG"

    Les valeurs spécifiées ici remplacent les valeurs sélectionnées dans Fenêtre > Préférences > Test > DevOps Test Hub > Résultats de Test UI.

    Vous pouvez préfixer la valeur avec ! pour publier les rapports à l'exception de celui spécifié dans le script de test.

    Par exemple, 
    Espace de travail = "C:/Users/IBM/devopstest/workspace1" Projet = "proj1" NomSuiteTest = "Tests/testHttp.testsuite" Publier = "https://localhost:5443/test#project.name=test&teamspace.name=ts1" PublierRapports = "!TESTLOG"

    Tous les rapports sauf le rapport TESTLOG sont publiés sur DevOps Test Hub après l'exécution de la commande.
    Entrée de protocole
    Utilisez cette option avec des arguments supplémentaires comme suit :
    • Pour exécuter un test UI Web en parallèle sur différents navigateurs :

      EntréeDeProtocole = "tous.les.objectifs.disponibles.en.parallèle=tous"

      ProtocolInput = "tous.les.objectifs.disponibles.en.parallèle=chrome,ff,ie"

      Note: Si vous utilisez l'option Entrée de protocole, vous ne devez pas utiliser les arguments équivalents suivants VMArgs : 
      VMArgs "-Dall.available.targets.in.parallel=tous" VMArgs "-Dall.available.targets.in.parallel=navigateur1,navigateur2,navigateur3"

    • Pour spécifier les préférences de l'interface utilisateur Web, telles que la mise en évidence de l'élément de la page et la capture d'écrans :

      Par exemple, ProtocolInput = "webui.surligner=<valeur>;webui.rapport.capturesdécran=<valeur>" où webui.highlight spécifie si l'élément de la page doit être mis en évidence et webui.rapport spécifie si les écrans doivent être capturés lors de la lecture du test dans le navigateur.

    Silencieux

    Utilisez ce paramètre pour désactiver toute sortie de message du lanceur et revenir à l'invite de commande lorsque l'exécution ou la tentative est terminée.
    FichierRésultats Utilisez ce paramètre pour donner un nom différent au fichier de résultat.

    Le nom par défaut du fichier de résultat est le nom du test ou de l'horaire avec un horodatage ajouté.
    CommentairesUtilisateur Utilisez ce paramètre pour afficher les commentaires que vous avez ajoutés dans la ligne UserComments d'un rapport.
    Note:
    • Lorsque vous exécutez des tests en utilisant les guillemets doubles ("") pour le paramètre UserComments, alors la ligne UserComments d'un rapport ne contient pas de guillemets doubles.
    • Pour contourner ce problème, vous devez créer un fichier de configuration en ligne de commande, puis exécuter le test en utilisant le paramètre ConfigFile.
    FichierVar Utilisez ce paramètre pour fournir un chemin complet vers le fichier XML qui contient les paires de noms de variables et de valeurs.
    VMArgs Utilisez ce paramètre pour passer des arguments de la machine virtuelle Java™.
  7. Cliquez sur l'icône Enregistrer.
Vous avez configuré le script de test en ajoutant les valeurs de paramètre requises pour l'exécution du test.
Vous pouvez exécuter des actifs de test à partir de Micro Focus ALM. Voir Exécution de tests depuis Micro Focus ALM.