Création d'un test

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

A propos de cette tâche

Ces instructions décrivent comment créer un nouveau test dans une catégorie et un ensemble de tests existants (par exemple, le jeu 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 l' interface WMQTest.

Si vous souhaitez créer un ensemble ou une catégorie de tests au lieu d'utiliser un ensemble ou une catégorie existante, 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 de test, d'ensembles de tests et de types d'objet.

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 des environnements Eclipse.

A propos de cette tâche

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

Procédure

  1. Ouvrez la perspective Développement de plug-in .
  2. Dans la vue Explorateur de packages, cliquez avec le bouton droit de la souris, puis cliquez sur Nouveau > Projet de plug-in. L'assistant Nouveau projet de plug-in s'affiche.
  3. Dans la zone Nom du projet , entrez un nom pour le projet qui contient vos nouveaux tests.
  4. Cliquez sur Suivant.
  5. Editez les détails dans les zones Version, Nomet 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. Ajoutez les plug-in suivants au panneau Plug-in requis :
    • 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 des environnements Eclipse.

  8. Sauvegardez le manifeste .Fichier MF .

Résultats

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

Définition d'un nouveau test

A propos de 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 de nouveaux ensembles de tests dans la catégorie Tests du gestionnaire de files d'attente, la création de nouvelles catégories ou la définition de nouveaux types d'objet à tester, voir Création de nouvelles catégories, d'ensembles de tests et de types d'objet.

Configurez votre plug-in pour contenir un nouveau test :

Procédure

  1. Vérifiez que le fichier plugin.xml ou MANIFEST.Le fichier 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. Mettez en évidence 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
    nom Nom significatif du test. My Queues Test
    classe Classe Java qui contient 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. L'exemple de valeur indiqué associe le test à la catégorie Queue manager tests. 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écuter des tests ou lorsque vous obtenez un résultat de test dans la vue Résultats du test. Pour plus d'informations, voir Documentation de 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

A propos de cette tâche

Créez une nouvelle classe Java qui contient le test:

Procédure

  1. Dans le panneau Détails de l'élément d'extension , cliquez sur le libellé de la zone class , qui est souligné.
    L'assistant de l'éditeur d'attribut Java s'ouvre.
  2. Vérifiez que seule la case Méthodes abstraites héritées est cochée, puis cliquez sur Terminer. Le fichier de 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. Editez 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

A propos de cette tâche

Exportez le plug-in qui contient votre test (ou ensemble de tests) vers le système de fichiers, puis redémarrez IBM MQ Explorer afin que le nouveau plug-in soit chargé et que vous puissiez exécuter les tests:

Procédure

  1. Dans la vue Explorateur de packages, cliquez avec le bouton droit de la souris sur le projet de plug-in, com.ibm.mq.explorer.tests.samples, puis cliquez sur Exporter .... L' Exportation... le dialogue s'ouvre.
  2. Dans la perspective Développement de plug-in , cliquez sur Plug-in et fragments déployables pour le 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ù MQ_INSTALLATION_PATH représente le répertoire de haut niveau dans lequel IBM MQ est installé.
  4. Sélectionnez votre plug-in dans Plug-ins et fragments disponibles, puis cliquez sur Terminer.
  5. Redémarrez Eclipseet passez à la perspective IBM MQ Explorer .

Résultats

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