Ajout d'un code personnalisé

Vous pouvez étendre un test en appelant un code Java personnalisé.

Votre code peut agir sur une ou plusieurs valeurs d'entrée du test et renvoyer à ce dernier des valeurs modifiées. Les valeurs d'entrée du code personnalisé se trouve dans des références ou des références de zone, qui doivent exister dans le test. Les références ou références de zone correspondant à des entrées de votre code doivent apparaître suivant un ordre séquentiel avant votre code. Vérifiez que le test contient les références ou références de zone requises comme entrées de votre code. Pour plus de détails sur la manière de créer des références et des références de zone, voir Création d'une référence ou d'une référence de zone.

Si votre code personnalisé utilise des fichiers JAR externes, vous aurez certainement besoin de modifier le chemin de compilation Java : voir Affichage et modification du chemin de compilation d'un projet Java. Dans certains cas, vous pouvez éviter de modifier le chemin de compilation manuellement en exécutant un test avant d'y ajouter votre code personnalisé. En effet, lors de la première exécution d'un test, certaines classes et bibliothèques requises pour la compilation sont ajoutées à votre chemin de compilation. Par exemple, vous pouvez importer les classes Hyades requises pour créer des événements personnalisés dans l'historique d'exécution si le test auquel vous avez ajouté votre code personnalisé a déjà été exécuté. Toutefois, si ce test n'a jamais été exécuté, des erreurs d'importation sont générées car les classes ne sont pas spécifiées dans le chemin de compilation du projet tant que le test n'a pas été exécuté.

Il se peut que votre code utilise des ressources externes : par exemple, une base de données SQL ou un produit de gestion des relations client. Si c'est le cas, vous devez configurer le code personnalisé de sorte qu'il fonctionne sur tous les ordinateurs sur lesquels votre test est déployé.

Le code personnalisé se trouve dans le dossier src du projet contenant les test(s) qui l'appellent. Par défaut, le code personnalisé est placé dans un package intitulé test, dans ce dossier. Par exemple, la figure suivante illustre la vue du navigateur de base de deux classes de code personnalisé. (Le navigateur n'affiche pas les fichiers source Java.)

Dans cet exemple, si vous ajoutez ces deux classes de code personnalisé à votre test et que vous choisissez de renvoyer une valeur au test (étape 9), l'option Remplacer à partir de répertorie ces deux classes comme illustré dans la figure ci-après.

Le package test contient également le code Java généré pour les tests du projet. Toutefois, à l'étape 3, vous pouvez choisir de placer un code personnalisé dans un package différent (par exemple, custom). Il est recommandé de séparer le code personnalisé du code généré, surtout si vous utilisez un système de contrôle des sources.

Pour ajouter un code personnalisé, procédez comme suit :

  1. Ouvrez le test et sélectionnez un élément (test, page ou demande).
  2. Cliquez sur Ajouter ou Insérer et sélectionnez Code personnalisé. Le bouton Ajouter permet d'ajouter le code personnalisé à la fin de l'élément sélectionné (test ou page de test). Le bouton Insérer permet de l'ajouter au dessus de la page ou de la demande de page sélectionnée.
  3. Vérifiez la zone Nom de classe.
    • Si le code que vous souhaitez appeler existe déjà, remplacez le nom de la classe par son nom. Si vous cliquez sur Afficher le code le code s'ouvre dans l'éditeur Java.
    • Si le code n'existe pas, choisissez un nom descriptif du code comme nom de classe. Si vous cliquez sur Générer le code un modèle de classe est généré pour la consignation des résultats et s'ouvre dans l'éditeur Java. S'il existe déjà une classe de ce nom, le système vous avertit qu'il sera écrasé et vous demande de vérifier si c'est bien ce que vous souhaitez.
  4. Sous la zone Arguments, cliquez sur Ajouter. La boîte de dialogue Code personnalisé s'ouvre et répertorie toutes les valeurs du test pouvant être utilisées comme entrées de votre code (références ou références de zone du test qui se trouvent avant le code).
  5. Sélectionnez toutes les entrées requises par votre code.
  6. Cliquez sur OK. La fenêtre se ferme, les références sélectionnées sont ajoutées dans la zone Arguments et la table Utilisé par intègre ces informations.
  7. Dans le test, suivant l'ordre séquentiel sous votre code personnalisé, recherchez une valeur que votre code renvoie au test.
  8. Mettez cette valeur en évidence : en maintenant le bouton gauche de la souris enfoncé, faites glisser la souris dessus.
  9. A l'aide du bouton droit de la souris, cliquez sur la valeur mise en évidence, sélectionnez Remplacer à partir de, puis sélectionnez le nom de classe de votre code personnalisé. Toutes les classes de code personnalisé que vous avez ajoutées à votre test sont répertoriées. Une fois que vous avez effectué votre sélection, la couleur de surbrillance de la valeur à renvoyer au test devient orange et la table Utilisé par intègre ces informations.
Conditions d'utilisation | Commentaires
(C) Copyright IBM Corporation 2005. All Rights Reserved.