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.

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 :

  1. Cliquez sur File>New>Connector-Specific Property Template.
  2. La boîte de dialogue Connector-Specific Property Template s'affiche.
  3. 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.

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 :

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 :

  1. Cliquez sur l'onglet Value. Le panneau d'affichage des valeurs remplace le panneau d'affichage général.
  2. Sélectionnez le nom de la propriété dans l'écran Edit properties.
  3. 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 :

  1. Cliquez à l'aide du bouton droit de la souris sur le carré à gauche de l'en-tête de colonne Value.
  2. 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.
  3. 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 :

  1. Dans l'écran Available Properties, sélectionnez la propriété qui doit devenir dépendante.
  2. Dans la zone Select Property, utilisez le menu déroulant pour sélectionner la propriété qui conservera la valeur conditionnelle.
  3. 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 à)

  4. Dans la zone Conditional Value, entrez la valeur requise pour que la propriété dépendante soit incluse dans le modèle.
  5. 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.
  6. 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 :

Copyright IBM Corp. 2003, 2005