Création d'un modèle de propriétés spécifiques au connecteur
Pour créer un fichier de configuration pour votre
connecteur, vous avez besoin d'un modèle de propriétés spécifiques au
connecteur et des propriétés standard fournies par le système.
Vous pouvez créer un nouveau modèle pour les propriétés spécifiques au
connecteur ou utiliser comme modèle une définition de connecteur existante.
- Pour créer un modèle, voir
Création d'un modèle.
- Pour utiliser un fichier existant, il vous suffit de modifier un
modèle existant et de l'enregistrer sous le nouveau nom. Vous pouvez
trouver des modèles existants dans le répertoire
\WebSphereAdapters\bin\Data\App.
Création d'un modèle
Cette section décrit comment créer des propriétés dans le
modèle, définir les valeurs et les caractéristiques générales de ces
propriétés et indiquer toutes les dépendances entre les propriétés. Ensuite,
vous pouvez utiliser le modèle comme base pour la création d'un
nouveau fichier de configuration du connecteur.
Pour créer un modèle dans Connector Configurator, procédez comme
suit :
- Cliquez sur File>New>Connector-Specific
Property Template.
- La boîte de dialogue Connector-Specific Property
Template s'affiche.
- Entrez le nom du nouveau modèle dans la zone
Name située sous Input a New
Template Name. Vous voyez de nouveau ce nom lorsque
vous ouvrez la boîte de dialogue pour créer un fichier de
configuration à partir d'un modèle.
- Pour afficher les définitions de propriétés spécifiques au
connecteur dans n'importe quel modèle, sélectionnez le nom de ce
modèle dans l'écran Template Name.
La liste des définitions de propriétés contenues dans ce modèle
apparaît dans l'écran Template Preview.
- Vous pouvez utiliser un modèle existant dont les définitions de
propriétés sont similaires à celles requises par votre connecteur
comme point de départ pour votre modèle. Si aucun des modèles
n'affiche les propriétés spécifiques au connecteur, vous devez en
créer un.
- Si vous prévoyez de modifier un modèle existant, sélectionnez le
nom de ce modèle dans la liste située dans le tableau
Template Name sous
Select the Existing Template to Modify: Find
Template.
- Ce tableau affiche les noms de tous les modèles disponibles.
Vous pouvez également rechercher un modèle.
Indication des caractéristiques générales
Lorsque vous cliquez sur Next pour
sélectionner un modèle, la boîte de dialogue
Properties - Connector-Specific Property
Template s'affiche. Cette boîte de dialogue contient des
onglets pour les caractéristiques générales des propriétés définies
et pour les restrictions liées aux valeurs. L'écran général
contient les zones suivantes :
- General:
Property Type
Property Subtype
Updated Method
Description
- Flags
Standard flags
- Custom Flag
Flag
Le Property Subtype peut être sélectionné si le
Property Type est String. Cette valeur facultative
entraîne la vérification de la syntaxe lors de l'enregistrement du fichier
de configuration. La valeur par défaut est un espace, ce qui signifie que la
propriété n'a reçu aucun sous-type.
Une fois que vous avez sélectionné les caractéristiques générales
de la propriété, cliquez sur l'onglet Value.
Indication de valeurs
L'onglet Value vous permet de
définir la longueur maximum, le nombre maximum de valeurs multiples,
une valeur par défaut ou un intervalle de valeurs pour la propriété. Il
autorise également les valeurs modifiables.
Pour ce faire, procédez comme suit :
- Cliquez sur l'onglet Value. Le panneau
d'affichage des valeurs remplace le panneau d'affichage général.
- Sélectionnez le nom de la propriété dans l'écran
Edit properties.
- Dans les zones relatives à la longueur
maximum et au nombre maximum de valeurs
multiples, entrez les valeurs de votre choix.
Pour créer une valeur de propriété, procédez comme suit :
- Cliquez à l'aide du bouton droit de la souris sur le carré à
gauche de l'en-tête de colonne Value.
- Dans le menu en incrustation, sélectionnez Add pour
afficher la boîte de dialogue Property Value. Selon le type de
propriété, vous pourrez entrer une valeur avec ou sans un intervalle.
- Entrez la nouvelle valeur de propriété et cliquez sur OK. La
valeur apparaît dans le panneau Value situé
dans la partie droite.
Le panneau Value contient un tableau
comprenant trois colonnes :
La colonne Value contient la valeur que
vous avez entrée dans la boîte de dialogue
Property Value et toutes les valeurs que
vous avez précédemment créées.
La colonne Default Value vous permet
d'indiquer n'importe quelle valeur comme valeur par défaut.
La colonne Value Range contient
l'intervalle que vous avez entré dans la boîte de dialogue
Property Value.
Une fois que vous avez créé une valeur et qu'elle apparaît
dans la grille, vous pouvez la modifier dans le tableau.
Pour modifier une valeur existante dans le tableau, sélectionnez
une ligne entière en cliquant sur le numéro de ligne. Ensuite,
cliquez avec le bouton droit dans la zone Value
et cliquez sur Edit Value.
Définition des dépendances
Une fois les modifications apportées aux onglets
General et Value,
cliquez sur Next. La boîte de dialogue
Dependencies - Connector-Specific Property
Template s'affiche.
Une propriété dépendante est une propriété qui est incluse dans le
modèle et utilisée dans le fichier de configuration
uniquement si la valeur d'une autre propriété
respecte une condition spécifique. Par exemple,
PollQuantity apparaît dans le modèle uniquement si JMS est
le mécanisme de transfert et que DuplicateEventElimination
a la valeur True.
Pour faire en sorte qu'une propriété soit dépendante et
définir la condition dont elle dépend, procédez comme suit :
- Dans l'écran Available Properties,
sélectionnez la propriété qui doit devenir dépendante.
- Dans la zone Select Property, utilisez
le menu déroulant pour sélectionner la propriété qui conservera la
valeur conditionnelle.
- Dans la zone Condition Operator,
sélectionnez l'une des valeurs suivantes :
== (égal à)
!= (différent de)
> (supérieur à)
< (inférieur à)
>= (supérieur ou égal à)
<= (inférieur ou égal à)
- Dans la zone Conditional Value, entrez
la valeur requise pour que la propriété dépendante soit incluse
dans le modèle.
- La propriété dépendante est mise en évidence dans l'écran
Available Properties ; cliquez sur
une flèche pour la déplacer vers l'écran Dependent
Property.
- Cliquez sur Finish. Connector
Configurator stocke les informations que vous avez entrées sous la
forme d'un document XML, sous \data\app dans le répertoire
\bin où vous avez installé Connector Configurator.
Configuration des noms de chemins
Voici quelques règles générales pour la configuration des noms de chemins :
- Sous Windows et UNIX, un nom de fichier est limité à 255 caractères.
- Sous Windows, le nom de chemin absolu doit respecter le format
[Unité:][Répertoire]\nom_de_fichier.
Par exemple C:\WebSphereAdapters\bin\Data\Std\StdConnProps.xml
Sous UNIX, le premier caractère doit être /.
- Un nom de file d'attente ne doit pas comporter d'espaces, ni à
l'intérieur ni à la fin.
