Personnalisation de l'outil de formatage d'importation exemple

Si vous avez importé des données à partir de Microsoft Excel ou de Microsoft Word ou si vous personnalisez l'outil de formatage d'importation exemple, vous devez déterminer les modifications à effectuer. Cette rubrique décrit les modifications possibles, ainsi que les classes, interfaces et méthodes à utiliser pour implémenter celles-ci dans le code Java.

Pour créer un outil de formatage d'importation personnalisé, des connaissances en programmation Java sont requises.

Vous pouvez modifier :

Type de source

Le type de source indique le format des données source à transformer en script de test Manual Tester. L'utilisateur sélectionne les informations relatives au type de source dans la première page de l'assistant d'importation. Sélectionnez le type de source de l'outil de formatage d'importation personnalisé en fonction des données existantes à transformer en scripts Manual Tester.

Si les données source ne sont pas au format Microsoft Excel, Microsoft Word ou TestManager ManualTest, vous devez créer un nouveau type de source. Si elles sont dans l'un de ces formats, vous pouvez utiliser l'un des types de source inclus dans Manual Tester ou en créer un autre. Pour déterminer s'il convient de créer un type de source, générez l'outil de formatage d'importation exemple avec l'un des types de source existants, Microsoft Excel par exemple. Importez une partie des données source.

Si le script de test obtenu ne répond pas à vos besoins, par exemple s'il n'inclut pas toutes les données à importer, vous devez créer un autre type de source et modifier la page de configuration et l'action Terminer.

S'il répond à vos attentes, il n'est pas nécessaire de créer un autre type de source. Vous pouvez alors utiliser le type de source existant et modifier uniquement la page de configuration et l'action Terminer.
Remarque : Si vous utilisez un type de source existant, vous devez supprimer le type de source exemple contenu dans l'outil de formatage d'importation exemple.

Page de configuration

Il s'agit de la deuxième page de l'assistant d'importation. La page de configuration de l'outil de formatage d'importation contient des zones d'entrée permettant de collecter les données fournies par l'utilisateur lors de l'importation des fichiers. La classe de l'action Terminer transforme les données d'importation en script de test Manual Tester. Vous pouvez définir les données collectées et les objets fenêtre de contrôle d'interface graphique qui s'affichent lors de la modification du code de la page de configuration dans l'outil de formatage d'importation exemple.
Remarque : Des informations supplémentaires concernant les objets fenêtre SWT sont disponibles sur le site Web Eclipse (http://www.eclipse.org).

La page de configuration doit implémenter l'interface IMTAImportConfigPage contenant les méthodes qui ajoutent la page de configuration dans l'assistant d'importation.

La page de configuration est spécifiée dans le fichier plugin.xml qui la relie à l'outil de formatage d'importation.

L'outil de formatage d'importation fournit une page de configuration exemple, ExampleImportConfigPage, directement utilisable. Dans cet exemple, la création et le contrôle des objets fenêtre d'interface graphique appartiennent à une classe distincte, ExampleConfigPage, dans un souci de clarté. Vous n'êtes pas tenu de fractionner la fonctionnalité de la page de configuration dans des classes distinctes.

Interface et méthodes Description
Interface IMTAImportConfigPage  
  • setWizardPage(IWizardPage)
Spécifie la page de configuration devant être utilisée par l'assistant d'entrée. La page de configuration met en cache la valeur IWizardPage afin d'envoyer une notification à l'assistant lorsque toutes les valeurs qu'elle contient sont valides.
  • createConfigPageControls(Composite)
Crée les objets fenêtre de contrôle d'interface graphique qui apparaissent dans la page de configuration.
  • getConfigSettings()
Cette méthode est appelée lorsque vous cliquez sur le bouton Terminer. Elle renvoie des informations transmises à la méthode initialize() de l'action Terminer.

Action Terminer

La classe de l'action Terminer transforme les données importées en script de test Manual Tester. Elle est appelée lorsque vous cliquez sur le bouton Terminer. Elle accepte comme entrée les informations contenues dans la page de configuration et traite les données d'importation en créant à chaque fois une instruction RMT.

L'action Terminer de l'importation doit implémenter l'interface IMTAImportSource qui initialise et demande des instructions mais aussi nettoie l'opération d'importation.

Cette action est spécifiée dans le fichier plugin.xml qui la relie à l'outil de formatage d'importation.

Tableau 1. Interfaces de la page de configuration
Interface et méthodes Description
Interface IMTAImportSource  
  • initialize(IMATImportSourceConfigSettings)
Première méthode appelée dans l'action Terminer. Elle transmet à cette dernière les informations définies dans la méthode get(ConfigSettings() de la page de configuration.
  • destroy()
Dernière méthode appelée dans l'action Terminer. Elle libère les ressources allouées.
  • getCurrentDocumentPath()
Renvoie le fichier importé.
  • getStatements()
Renvoie un itérateur Java qui renvoie une instruction de haut niveau à chaque fois. Chaque appel Iterator.next() renvoie une interface IMATImportNode.
  • getLastError()
Renvoie la dernière erreur survenue afin qu'elle soit communiquée à l'utilisateur.
Interface IMTAImportNode Définit l'instruction Manual Test renvoyée par la méthode getStatements().
  • getType()
Renvoie le type de l'instruction qui peut être l'un des suivants :
  • IMTAImportNode.TYPE_STEP - étape
  • IMTAImportNode.TYPE_BLOCK - groupe
  • IMTAImportNode.TYPE_VP - point de vérification
  • IMTAImportNode.TYPE_TESTCASE - point de rapport
  • getName()
Renvoie le nom de l'instruction qui apparaît dans la vue Structure. Si cette méthode renvoie la valeur null, la vue Structure affiche les 32 premiers caractères de la description.
  • getDescription()
Renvoie la description de l'instruction qui apparaît dans la vue Editeur. Cette méthode peut renvoyer la valeur null.
  • getAttachments()
Renvoie un tableau de chaînes, chacune d'entre elles correspondant au chemin de fichier complet d'une pièce jointe.
  • getChildren()
Si le type d'instruction est un bloc et que le bloc a des enfants, cet élément renvoie un itérateur Java. Sinon, il renvoie la valeur null. Renvoie une instruction à chaque fois. En d'autres termes, chaque appel Iterator.next() renvoie une interface IMTAImportNode.
  • destroy()
Cette méthode est appelée une fois que toutes les informations ont été extraites. Elle libère les ressources allouées.
Commentaires
(C) Copyright IBM Corporation 2004, 2005. All Rights Reserved.