Vous pouvez définir des assistants pour les
enregistreurs et les clients.
L'assistant Nouvelle session
d'enregistrement est exécuté selon la séquence suivante :
- Le fichier de session d'enregistrement est sélectionné.
- Le client est sélectionné.
- La méthode d'enregistrement est sélectionnée.
- Les pages de l'assistant de client sont affichées.
- Les pages de l'assistant d'enregistreur sont affichées.
Les étapes 4 et 5 peuvent être combinées dans une même étape. Les étapes 4 et 5 représentent des ajouts d'extension.
Déclarez un assistant pour chaque client et enregistreur que vous définissez.
Un client ou un enregistreur pour lequel aucun assistant n'est déclaré n'est pas
disponible dans l'interface utilisateur et ne peut être démarré qu'avec un fichier de
configuration d'enregistrement ou par programmation.
A la fin de l'exécution de l'assistant Nouvelle session
d'enregistrement, cet assistant génère une configuration de session
d'enregistrement qui contient une configuration de client et une ou plusieurs
configurations d'enregistreur. La configuration de session d'enregistrement permet de
lancer une session d'enregistrement et d'instancier les enregistreurs et clients
correspondants.
Plusieurs types d'assistant peuvent être définis, suivant la manière dont vous avez
défini les enregistreurs et les clients :
- Si vous n'avez défini qu'un enregistreur et que vous prévoyez d'utiliser un
client fourni avec le produit, définissez un assistant d'enregistreur.
- Si vous avez défini un ou plusieurs types de client et un ou plusieurs types
d'enregistreur et que vous souhaitez combiner les clients et les enregistreurs de
différentes manières, définissez un assistant pour chaque client et pour chaque
enregistreur.
- Si vous avez défini un seul type d'enregistreur et un seul type de client à utiliser ensemble,
pensez à définir un unique assistant qui les configure tous les deux.
Informations supplémentaires sur l'assistant Nouvelle session d'enregistrement :
- L'étape de sélection de la méthode d'enregistrement n'est affichée que si plusieurs
méthodes d'enregistrement sont disponibles pour le client sélectionné à l'étape 2.
- Les assistants qui configurent à la fois des enregistreurs et des clients sont
prioritaires par rapport aux assistants distincts pour les clients et les enregistreurs.
Pour définir un assistant de client, procédez comme suit :
- Déclarez un nouvel assistant de client dans le fichier plugin.xml en utilisant
le point d'extension com.ibm.rational.test.lt.recorder.ui.clientWizard.
- Spécifiez l'ID client configuré par l'assistant de client.
- Spécifiez éventuellement une classe d'implémentation. Si vous ne spécifiez pas de
classe, l'assistant ne possède pas de page de configuration. Si vous spécifiez une classe,
elle doit étendre la classe com.ibm.rational.test.lt.recorder.ui.wizards.NewClientWizard.
Les remarques suivantes s'appliquent aux implémentations de NewClientWizard :
- Cette classe étend la classe JFace Wizard et doit donc étendre des méthodes
standard telles que addPages().
- La classe reçoit en entrée une configuration de client vide, typée avec
l'ID de client sélectionné par l'utilisateur à l'étape 2.
- La classe définit les options de configuration du client, lesquelles sont disponibles
via la méthode getClientConfiguration(). Cette configuration est généralement réalisée
dans la méthode doPerformFinish().
Pour définir un assistant d'enregistreur, procédez comme suit :
- Déclarez un nouvel assistant d'enregistreur dans le fichier plugin.xml en utilisant le
point d'extension com.ibm.rational.test.lt.recorder.ui.recorderClientWizard et
l'élément recordersWizard.
- Spécifiez un ou plusieurs ID enregistreur configurés par l'assistant d'enregistreur.
Si l'assistant
d'enregistreur déclare des configurations pour plusieurs enregistreurs, examinez
l'attribut performsRecorderSelection. Cet attribut indique si l'assistant permet à
l'utilisateur de choisir les enregistreurs à utiliser ou si l'enregistreur à utiliser est
choisi par l'infrastructure. Selon les circonstances, l'assistant est ensuite appelé
avec l'ID d'enregistreur sélectionné par l'utilisateur.
Dans le premier cas, l'étape de sélection de la méthode
d'enregistrement est toujours affichée, tandis que dans le second, elle peut être
sautée. Dans le premier cas, l'assistant peut activer plusieurs enregistreurs, tandis que dans le
second, un seul enregistreur est activé. Choisissez la première option si vous devez
activer plusieurs enregistreurs dans une session d'enregistrement.
- Spécifiez une classe d'implémentation. Cette étape n'est facultative que si vous avez
associé l'assistant à un unique enregistreur ou que l'attribut
performsRecorderSelection est false. Si vous ne spécifiez pas de classe, l'assistant ne possède pas de page de
configuration. Si vous fournissez une classe,
elle doit étendre la classe com.ibm.rational.test.lt.recorder.ui.wizards.NewRecordersWizard.
A propos des implémentations de NewRecordersWizard :
- Cette classe étend la classe JFace Wizard et doit donc étendre des méthodes
standard telles que addPages().
- Si l'attribut performsRecorderSelection est true, la classe reçoit Null dans
sa méthode initialize() et elle doit appeler setRecorderConfigurations() à
partir de sa méthode doPerformFinish(), avec les configurations d'enregistreur de chaque
enregistreur à inclure dans la session d'enregistrement.
- Si performsRecorderSelection est false, la classe reçoit dans sa méthode
initialize() une configuration d'enregistreur
vide, typée avec l'ID d'enregistreur sélectionné à l'étape 3, et elle doit remplir la configuration d'enregistreur vide
avec les options d'enregistreur dans sa méthode doPerformFinish().
Pour définir un assistant qui configure un client et un ou plusieurs enregistreurs
ensemble :
- Déclarez un nouvel assistant d'enregistreur et de client dans le fichier plugin.xml en utilisant le
point d'extension com.ibm.rational.test.lt.recorder.ui.recorderClientWizard et
l'élément combinedWizard.
- Spécifiez l'ID de client à configurer par cet assistant.
- Spécifiez un ou plusieurs ID d'enregistreur à configurer par cet assistant.
- Si cet assistant
déclare des configurations pour plusieurs enregistreurs, examinez
l'attribut performsRecorderSelection.
Cet attribut indique si l'assistant permet à
l'utilisateur de choisir les enregistreurs à utiliser ou si l'enregistreur à utiliser est
choisi par l'infrastructure ; selon les circonstances, l'assistant avec l'ID d'enregistreur
sélectionné par l'utilisateur est alors appelé.
Dans le premier cas, l'étape de sélection de la méthode
d'enregistrement est toujours affichée, tandis que dans le second, elle peut être
sautée. Dans le premier cas, l'assistant peut activer plusieurs enregistreurs, tandis que dans le
second, un seul enregistreur est activé. Choisissez la première option si vous devez
activer plusieurs enregistreurs dans une session d'enregistrement.
- Spécifiez une classe d'implémentation. Cette étape n'est facultative que si vous avez
associé l'assistant à un unique enregistreur ou que l'attribut
performsRecorderSelection est false. Si vous ne spécifiez pas de classe, l'assistant ne possède pas de page de
configuration. Si vous fournissez une classe,
elle doit étendre la classe com.ibm.rational.test.lt.recorder.ui.wizards.NewRecorderClientWizard.
A propos des implémentations de NewRecorderClientWizard :
- Cette classe étend la classe JFace Wizard et doit donc étendre des méthodes
standard telles que addPages().
- Si l'attribut performsRecorderSelection est true, la classe reçoit une configuration d'enregistreur
Null dans
sa méthode initialize() et elle doit appeler setRecorderConfigurations() à
partir de sa méthode doPerformFinish(), avec les configurations d'enregistreur de chaque
enregistreur à inclure dans la session d'enregistrement.
- Si performsRecorderSelection est false, la classe reçoit dans sa méthode
initialize() une configuration d'enregistreur
vide, typée avec l'ID d'enregistreur sélectionné à l'étape 3, et elle doit remplir la configuration d'enregistreur vide
avec les options d'enregistreur dans sa méthode doPerformFinish().
- Une configuration de client, typée avec
l'ID de client sélectionné à l'étape 2, est passée à la méthode initialize() de la
classe. La classe doit renseigner la configuration de client avec les options client de sa
méthode doPerformFinish().