Création de catégories de tests, d'ensembles de tests et de types d'objet

Vous pouvez créer des catégories de test, des ensembles de tests dans une catégorie existante et des sous-ensembles dans un ensemble de tests existant. Vous pouvez aussi définir de nouveaux types d'objet pour lesquels vous pouvez créer des tests.

Pourquoi et quand exécuter cette tâche

Tous les tests fournis avec IBM® MQ Explorer sont regroupés dans la catégorie Tests des gestionnaires de files d'attente. Dans la catégorie Tests des gestionnaires de files d'attente, chaque test est associé à un ensemble de tests spécifique (par exemple, Files d'attente, Canaux). Les ensembles de tests permettent d'effectuer des sélections par défaut dans la boîte de dialogue Exécution des tests, en fonction du type de dossier ou d'objet affiché dans la vue Navigateur à partir de laquelle vous avez ouvert la boîte de dialogue Exécution des tests. Les ensembles de tests permettent également d'indiquer les tests à exécuter dans les ensembles de tests par défaut.

Pour afficher ces catégories et ces ensembles de tests, ouvrez la boîte de dialogue Exécution des tests (cliquez avec le bouton droit de la souris sur un dossier de la vue Navigateur, puis cliquez sur Tests > Tests personnalisés) et vérifiez les configurations de test de la page Tests de la boîte de dialogue.

Vous pouvez créer des catégories (à l'instar de Tests des gestionnaires de files d'attente). Vous pouvez également créer des ensembles de tests (à l'instar de Files d'attente) dans une catégorie, voire des sous-ensembles de tests dans un ensemble de tests existant.

Si vous créez des types d'objet et des dossiers à afficher dans la vue Navigateur d'IBM MQ Explorer et que vous souhaitez créer des tests qui vérifient les définitions des nouveaux types d'objet, vous pouvez définir les nouveaux types d'objet pour qu'ils s'affichent sous forme d'options dans la page Objets de la boîte de dialogue Exécution des tests.

Pour obtenir des instructions sur la création de tests dans un ensemble de tests existant dans la catégorie Tests des gestionnaires de files d'attente, voir Création d'un test. Les instructions ci-après indiquent comment créer des catégories et des ensembles de tests et définir de nouveaux types d'objet :

Exécutez les tâches suivantes dans la perspective Développement de plug-in.

Création d'un ensemble de tests dans une catégorie existante (com.ibm.mq.explorer.tests.Testset)

Pourquoi et quand exécuter cette tâche

Pour créer un ensemble de tests dans une catégorie existante (fournie avec le produit, comme la catégorie Tests des gestionnaires de files d'attente) :

Procédure

  1. Dans la page Extensions du fichier plugin.xml, ajoutez l'extension com.ibm.mq.explorer.tests.Testset dans la sous-fenêtre All extensions.
  2. Configurez le nouvel ensemble de tests en fonction des détails présentés dans le tableau ci-dessous.
    Attribut Description Valeur exemple
    categoryId Identificateur unique de la catégorie dans laquelle vous créez l'ensemble de tests. com.ibm.mq.explorer.tests.coretests.wmq
    id Identificateur unique de la catégorie que vous créez. com.ibm.mq.explorer.tests.samples.NewCategory
    name Nom significatif de la catégorie. My New Category
    description Brève description de la catégorie. This is my first new category.
    icon Icône facultative représentant la catégorie. icons/newcat.gif (Emplacement du fichier d'icône par rapport au fichier plugin.xml.)
    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. doc/MyObject.html (Emplacement du fichier HTML ou XHTML par rapport au fichier plugin.xml file.)
  3. Sauvegardez le fichier plugin.xml.

Résultats

Vous venez de créer un ensemble de tests dans une catégorie existante.

Création d'une catégorie et un ensemble de tests (com.ibm.mq.explorer.tests.TestCategorys)

Pourquoi et quand exécuter cette tâche

Si vous créez une catégorie, vous pouvez y créer des ensembles de tests à l'aide d'une même extension (vous n'avez pas besoin d'utiliser l'extension distincte com.ibm.mq.explorer.tests.Testset).

Pour créer une catégorie :

Procédure

  1. Dans la page Extensions du fichier plugin.xml, ajoutez l'extension com.ibm.mq.explorer.tests.TestCategorys dans la sous-fenêtre All Extensions.
  2. Configurez la nouvelle catégorie en fonction des détails présentés dans le tableau ci-dessous.
    Attribut Description Valeur exemple
    id Identificateur unique de la catégorie que vous créez. com.ibm.mq.explorer.tests.samples.NewCategory
    name Nom significatif de la catégorie. My New Category
    description Brève description de la catégorie. This is my first new category.
    icon Icône facultative représentant la catégorie. icons/newcat.gif (Emplacement du fichier d'icône par rapport au fichier plugin.xml.)
    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. doc/MyObject.html (Emplacement du fichier HTML ou XHTML par rapport au fichier plugin.xml file.)
  3. Sauvegardez le fichier plugin.xml.

Résultats

Vous avez créé une catégorie.

Que faire ensuite

Pour créer un ensemble de tests dans cette catégorie :

  1. Cliquez avec le bouton droit de la souris sur la catégorie, puis cliquez sur New > testset pour ajouter un nouvel ensemble de tests dans la sous-fenêtre All Extensions.
  2. Configurez le nouvel ensemble de tests en fonction des détails présentés dans le tableau de la rubrique Création d'un ensemble de tests dans une catégorie existante. Vous ne définissez pas d'attribut categoryID car vous créez l'ensemble de tests dans la nouvelle catégorie.
  3. Sauvegardez le fichier plugin.xml.

Vous avez créé un ensemble de tests dans la nouvelle catégorie.

Définition d'un nouveau type d'objet à tester (com.ibm.mq.explorer.tests.ContextGroup)

Pourquoi et quand exécuter cette tâche

Si vous avez créé des types d'objet à afficher dans la vue Navigateur d'IBM MQ Explorer et que vous voulez créer des tests pour vérifier les définitions des nouveaux types d'objet, vous devez définir les types d'objet en utilisant l'extension com.ibm.mq.explorer.tests.ContextGroup. Cette extension affiche un nouveau groupe de haut niveau dans la boîte de dialogue Exécution des tests, dans la page Objets des groupes Gestionnaires de files d'attente, Clusters et Groupes de partage de files d'attente fournis.

Pour définir un nouveau type d'objet, procédez comme suit :

Procédure

  1. Dans la page Extensions du fichier plugin.xml, ajoutez l'extension com.ibm.mq.explorer.tests.ContextGroup à la sous-fenêtre All Extensions.
  2. Configurez le nouveau groupe en fonction des détails présentés dans le tableau ci-dessous.
    Attribut Description Valeur exemple
    groupId Identificateur unique du groupe que vous créez. com.ibm.mq.explorer.tests.samples.NewGroup
    name Nom significatif du groupe. My New Group
    description Brève description du groupe. This is my first new group.

    Vous avez défini le nouveau groupe. Définissez ensuite le critère permettant d'identifier le groupe auquel un objet appartient.

  3. Dans la sous-fenêtre All Extensions, cliquez avec le bouton droit de la souris sur le groupe, sélectionnez Nouveau, puis sélectionnez le type de critère à utiliser en fonction des informations du tableau suivant :
    Type de critère Description Valeur exemple
    instanceOf L'objet doit utiliser une instance d'une classe qualifiée complète spécifique. com.ibm.mq.explorer.clusterplugin.internal.objects.ClusterObject
    objectType L'attribut objectType de l'objet doit être associé à une valeur spécifique. Vous pouvez également préciser si cette valeur doit correspondre exactement au critère. com.ibm.mq.explorer.queuemanager
    objectId L'attribut objectId de l'objet doit être associé à une valeur spécifique. Vous pouvez également préciser si cette valeur doit correspondre exactement au critère. com.ibm.mq.explorer.queuemanager
  4. Sauvegardez le fichier plugin.xml.

Résultats

Vous venez de définir le nouveau groupe d'objets à tester.