Création d'un test

Vous pouvez créer un test à ajouter à une catégorie existante et à un ensemble de tests.

Pourquoi et quand exécuter cette tâche

Cette section explique comment créer un test dans une catégorie existante et définir des tests (par exemple, l'ensemble de tests Files d'attente dans la catégorie Tests des gestionnaires de files d'attente) dans IBM® MQ Explorer. Ces instructions expliquent comment définir le test dans un environnement de développement Eclipse. Pour plus d'informations sur l'écriture de la source de test Java™, voir Interface WMQTest.

Si vous voulez créer un ensemble ou une catégorie de tests au lieu d'utiliser un ensemble ou une catégorie de tests ou si vous avez créé des objets à administrer dans IBM MQ Explorer et que vous écrivez des tests pour les nouveaux objets, voir Création de catégories et d'ensembles de tests et de types d'objets.

Création d'un projet Eclipse enfichable devant contenir le nouveau test

Avant de commencer

Vérifiez que vous avez installé les outils Eclipse Graphical Editing Framework (GEF). Pour plus d'informations, voir Installation d'IBM MQ Explorer dans les environnements Eclipse.

Pourquoi et quand exécuter cette tâche

Créez puis configurez un nouveau projet de plug-in devant contenir le nouveau test :

Procédure

  1. Ouvrez la perspective de développement de plug-in.
  2. Dans la vue Package Explorer, effectuez un clic droit, puis cliquez sur Nouveau > Projet enfichable (plug-in). L'assistant Nouveau projet de plug-in s'affiche.
  3. Dans la zone Nom du projet, entrez un nom pour le projet devant contenir vos nouveaux tests.
  4. Cliquez sur Suivant.
  5. Editez les détails dans les zones Version, Nom et Fournisseur, puis cliquez sur Terminer.

    La valeur de la zone ID peut être différente de la valeur entrée dans la zone Nom de la page précédente de l'assistant. Le nom de projet n'est utilisé qu'en phase de développement ; l'ID plug-in permet à Eclipse de charger et d'identifier le plug-in.

    Le nouveau projet enfichable (plug-in) s'affiche dans la vue Package Explorer et le fichier manifeste du plug-in est automatiquement ouvert.
  6. Dans l'éditeur de manifeste de plug-in, cliquez sur l'onglet Dépendances. Deux dépendances sont déjà répertoriées dans la sous-fenêtre Plug-in requis.
  7. Dans la sous-fenêtre Plug-in requis, ajoutez les plug-in suivants :
    • com.ibm.mq.explorer.tests
    • com.ibm.mq.explorer.ui
    • com.ibm.mq.pcf.event
    • com.ibm.mq.runtime
    • org.eclipse.core.resources

    Si les plug-in de la liste ne sont pas disponibles, installez les outils Eclipse Graphical Editing Framework (GEF). Pour plus d'informations, voir Installation d'IBM MQ Explorer dans les environnements Eclipse.

  8. Sauvegardez le fichier MANIFEST.MF.

Résultats

Le projet de plug-in est prêt à contenir les tests

Définition d'un nouveau test

Pourquoi et quand exécuter cette tâche

Les instructions ci-après indiquent comment définir un nouveau test dans un ensemble de tests existant (par exemple, dans l'ensemble de tests Files d'attente), dans la catégorie existante Tests des gestionnaires de files d'attente Pour plus d'informations sur la création d'ensembles de tests dans la catégorie Tests des gestionnaires de files d'attente, sur la création de catégories de tests ou sur la définition de nouveaux types d'objet à soumettre aux tests, voir Création de catégories de tests, d'ensembles de tests et de types d'objet.

Configurez votre plug-in pour contenir un nouveau test :

Procédure

  1. Assurez-vous que le fichier plugin.xml ou MANIFEST.MF est ouvert dans l'éditeur de manifeste de plug-in.
  2. Dans l'éditeur de manifeste de plug-in, cliquez sur l'onglet Extensions pour afficher la page Extensions.
  3. Cliquez sur Ajouter....
    L'assistant Nouvelle extension s'affiche.
  4. Sélectionnez le point d'extension com.ibm.mq.explorer.tests.Tests, puis cliquez sur Terminer.
    La nouvelle extension de tests est ajoutée dans la sous-fenêtre Toutes les extensions dans l'éditeur de manifeste de plug-in.
  5. Cliquez sur le nouveau test pour le mettre en évidence, puis entrez ses détails dans le tableau suivant :
    Attribut Description Valeur exemple
    id Identificateur unique du test. com.ibm.mq.explorer.tests.samples.QueueNames
    name Nom significatif du test. My Queues Test
    class Classe Java contenant le test. N'entrez pas cette valeur maintenant ; vous pourrez le faire automatiquement lors de la création de la classe. com.ibm.mq.explorer.tests.samples.QueueNames
    testset Catégorie à laquelle le test appartient. La valeur exemple indiquée associe le test à la catégorie Tests des gestionnaires de files d'attente. com.ibm.mq.explorer.tests.samples.wmq
    testsubset Sous-catégorie à laquelle appartient le test. L'exemple de valeur présentée associe le test à la sous-catégorie Queues. queues
    description Description des vérifications effectuées par le test. Checks queue names against simple naming conventions.
    furtherinfo Emplacement du document HTML ou XHTML qui contient un complément d'information sur le test. Ce document s'affiche dans IBM MQ Explorer lorsque vous cliquez deux fois sur le test dans la boîte de dialogue Exécution des tests ou un résultat de test dans la vue Résultats des tests. Pour plus d'informations, voir Documentation sur le test doc/QueueNamesInfo.html (Emplacement du fichier par rapport au fichier plugin.xml.)
  6. Sauvegardez le fichier de l'éditeur de manifeste de plug-in.

Résultats

Le projet enfichable (plug-in) est désormais configuré pour contenir un nouveau test. Vous devez ensuite écrire le test.

Définissez chaque nouveau test à écrire.

Ecriture d'un nouveau test

Pourquoi et quand exécuter cette tâche

Créez une nouvelle classe Java contenant le test :

Procédure

  1. Dans le panneau Informations sur les éléments d'extension, cliquez sur le libellé de la zone class qui est souligné.
    L'assistant d'édition des attributs Java s'ouvre.
  2. Assurez-vous que seule la case Méthodes abstraites héritées est cochée, puis cliquez sur Terminer. Le fichier classe Java s'ouvre dans l'éditeur Java.
  3. Sauvegardez le fichier de l'éditeur de manifeste de plug-in. Notez que la valeur de la zone de classe est automatiquement insérée.
  4. Modifiez la source Java.
  5. Documentez le test dans un fichier XHTML ou HTML valide. Enregistrez le fichier avec le nom et l'emplacement spécifiés dans l'attribut furtherinfo du fichier plugin.xml. L'emplacement du fichier XHTML peut être local (stocké dans le même plug-in que le test ; par exemple, dans un sous-dossier doc) ou distant (stocké sur un serveur Web).

Résultats

Vous avez terminé l'écriture du test et la configuration du plug-in contenant le test. Exportez ensuite le plug-in et déployez-le pour le tester.

Ecrivez un nouveau test pour chaque test défini dans le fichier plugin.xml.

Déploiement du nouveau test

Pourquoi et quand exécuter cette tâche

Exportez le plug-in qui contient le test (ou l'ensemble de tests) vers le système de fichiers, puis redémarrez IBM MQ Explorer pour charger le plug-in et exécuter les tests :

Procédure

  1. Dans la vue Package Explorer, cliquez avec le bouton droit de la souris sur le projet de plug-in com.ibm.mq.explorer.tests.samples, puis cliquez sur Exporter.... La boîte de dialogue Exporter... s'ouvre.
  2. Dans la perspective Développement de plug-in, cliquez sur l'option Plug-in et fragments déployables pour la mettre en évidence, puis cliquez sur Suivant.
  3. Dans la zone Répertoire, entrez l'emplacement du plug-in IBM MQ Explorer Tests. L'emplacement est CHEMIN_INSTALLATION_MQ\eclipse, où CHEMIN_INSTALLATION_MQ est le répertoire de niveau supérieur dans lequel IBM MQ est installé.
  4. Sélectionnez votre plug-in dans Plug-in et fragments disponibles, puis cliquez sur Terminer.
  5. Redémarrez Eclipse et passez à la perspective IBM MQ Explorer.

Résultats

Vous avez déployé votre nouveau plug-in. Vous pouvez maintenant exécuter vos nouveaux tests.