Configuration du connecteur

L'adaptateur iSeries utilise des propriétés standard de configuration et des propriétés spécifiques, indiquées dans les sections qui suivent.

Cette section aborde les points suivants :

Présentation de Connector Configurator

Connector Configurator vous permet de configurer le connecteur de votre adaptateur à utiliser avec ces courtiers d'intégration :

Connector Configurator vous permet de :

Le mode dans lequel vous exécutez Connector Configurator et le type de fichier de configuration que vous utilisez peuvent différer en fonction du courtier d'intégration que vous exécutez. Par exemple, si vous utilisez WMQI comme courtier, vous exécutez Connector Configurator directement, et non à partir de System Manager (voir Exécution de Configurator en mode autonome).

Les propriétés de configuration du connecteur incluent des propriétés de configuration standard (les propriétés communes à tous les connecteurs) et des propriétés spécifiques au connecteur (propriétés requises par le connecteur pour une technologie ou une application spécifique).

Dans la mesure où les propriétés standard sont utilisées par tous les connecteurs, vous n'avez pas besoin de définir ces propriétés de tout pièce ; Connector Configurator les incorpore à votre fichier de configuration dès que vous créez ce fichier. Cependant, vous devez définir la valeur de chaque propriété standard dans Connector Configurator.

L'intervalle des propriétés standard peut être différent pour tous les courtiers et toutes les configurations. Certaines propriétés ne sont disponibles que si vous attribuez une valeur spécifique à d'autres propriétés. La fenêtre des propriétés standard dans Connector Configurator affiche les propriétés disponibles pour votre configuration spécifique.

Cependant, pour les propriétés spécifiques au connecteur, vous devez d'abord définir les propriétés, puis leur attribuer une valeur. Pour ce faire, créez un modèle de propriétés spécifiques au connecteur pour votre adaptateur particulier. Il se peut qu'un modèle soit déjà configuré dans votre système, auquel cas vous pouvez l'utiliser. Dans le cas contraire, suivez les étapes dans la section Création d'un modèle pour configurer un nouveau modèle.

Remarque :
Connector Configurator s'exécute uniquement dans un environnement Windows. Si vous exécutez le connecteur dans un environnement UNIX, utilisez Connector Configurator dans Windows pour modifier le fichier de configuration, puis copiez le fichier dans votre environnement UNIX.

Démarrage de Connector Configurator

Vous pouvez démarrer et exécuter Connector Configurator dans l'un de ces deux modes :

Exécution de Configurator en mode autonome

Vous pouvez exécuter Connector Configurator en mode autonome et utiliser les fichiers de configuration indépendamment de votre courtier.

Pour ce faire, procédez comme suit :

Vous pouvez choisir d'exécuter Connector Configurator en mode autonome pour créer le fichier, puis de vous connecter à System Manager afin de l'enregistrer dans un projet System Manager (voir Remplissage d'un fichier de configuration).

Exécution de Configurator à partir de System Manager

Vous pouvez exécuter Connector Configurator à partir de System Manager.

Pour exécuter Connector Configurator, procédez comme suit :

  1. Ouvrez System Manager.
  2. Dans la fenêtre System Manager, développez l'icône Integration Component Libraries et mettez en évidence Connecteurs.
  3. Dans la barre de menus de System Manager, cliquez sur Outils>Connector Configurator. La fenêtre Connector Configurator affiche la boîte de dialogue New Connector.
  4. Lorsque vous cliquez sur le menu déroulant en regard de System Connectivity Integration Broker, vous pouvez sélectionner ICS, WebSphere Message Brokers ou WAS, en fonction de votre courtier.

Pour modifier un fichier de configuration existant, procédez comme suit :

Création d'un modèle de propriété spécifique 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 :

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. Sélectionnez la propriété dans la liste Edit properties et cliquez dessus avec le bouton droit.
  2. Dans la boîte de dialogue, cliquez sur Add.
  3. Entrez le nom de 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.

Création d'un nouveau fichier de configuration

Lorsque vous créez un fichier de configuration, vous devez lui attribuer un nom et sélectionner un courtier d'intégration.

Vous devez également sélectionner un courtier d'intégration. Le courtier que vous sélectionnez détermine les propriétés qui apparaîtront dans le fichier de configuration. Pour sélectionner un courtier, procédez comme suit :

Création d'un fichier de configuration à partir d'un modèle spécifique au connecteur

Une fois que vous avez créé un modèle spécifique au connecteur, vous pouvez l'utiliser pour créer un fichier de configuration :

  1. Cliquez sur File>New>Connector Configuration.
  2. La boîte de dialogue New Connector contient les zones suivantes :
  3. Un écran de configuration apparaît pour le connecteur que vous configurez. La barre de titre contient le nom du courtier d'intégration et du connecteur. Vous pouvez entrer les valeurs de toutes les zones pour terminer la définition maintenant, ou enregistrer le fichier et renseigner les zones ultérieurement.
  4. Pour enregistrer le fichier, cliquez sur File>Save>To File ou sur File>Save>To Project. Pour exécuter un enregistrement dans un projet, System Manager doit être en cours d'exécution.

    Si vous enregistrez un fichier, la boîte de dialogue Save File Connector apparaît. Sélectionnez *.cfg comme type de fichier, vérifiez dans la zone File Name que le nom est correctement orthographié et que sa casse est correcte, accédez au répertoire dans lequel vous souhaitez enregistrer le fichier et cliquez sur Save. L'écran d'état affiché dans le panneau de message de Connector Configurator indique que le fichier de configuration a été créé.
    Important :
    Le nom et le chemin du répertoire que vous avez définis ici doivent correspondre au nom et au chemin du fichier de configuration du connecteur que vous indiquez dans le fichier de démarrage du connecteur.
  5. Pour remplir la définition du connecteur, entrez des valeurs dans les zones de chacun des onglets de la fenêtre Connector Configurator, comme décrit plus loin dans ce chapitre.

Utilisation d'un fichier existant

Vous disposez peut-être d'un fichier existant dans un ou plusieurs des formats suivants :

Bien que certaines de ces sources de fichier puissent contenir tout ou partie des propriétés spécifiques au connecteur, le fichier de configuration du connecteur ne sera pas complet tant que vous n'aurez pas ouvert le fichier et défini les propriétés, comme décrit plus loin dans ce chapitre.

Pour utiliser un fichier existant afin de configurer un connecteur, vous devez ouvrir le fichier dans Connector Configurator, réviser la configuration et enregistrer de nouveau le fichier.

Pour ouvrir un fichier *.txt, *.cfg ou *.in dans un répertoire, procédez comme suit :

  1. Dans Connector Configurator, cliquez sur File>Open>From File.
  2. Dans la boîte de dialogue Open File Connector, sélectionnez l'un des types de fichier suivants pour afficher les fichiers disponibles :
  3. Dans l'écran du répertoire, accédez au fichier de définition du connecteur approprié, sélectionnez-le et cliquez sur Open.

Pour ouvrir une configuration de connecteur à partir d'un projet System Manager, procédez comme suit :

  1. Démarrez System Manager. Vous pouvez ouvrir une configuration dans System Manager ou l'y enregistrer uniquement si vous avez démarré System Manager.
  2. Démarrez Connector Configurator.
  3. Cliquez sur File>Open>From Project.

Remplissage d'un fichier de configuration

Lorsque vous ouvrez un fichier de configuration ou un connecteur à partir d'un projet, la fenêtre Connector Configurator affiche l'écran de configuration qui contient les valeurs et les attributs courants.

Le titre de l'écran de configuration affiche le courtier d'intégration et le nom du connecteur, comme indiqué dans le fichier. Vérifiez que votre courtier est correct. Dans le cas contraire, modifiez la valeur du courtier avant de configurer le connecteur. Pour ce faire, procédez comme suit :

  1. Dans l'onglet Standard Properties, sélectionnez la zone de valeur pour la propriété BrokerType. Dans le menu déroulant, sélectionnez la valeur ICS, WMQI ou WAS.
  2. L'onglet Standard Properties affiche les propriétés associées au courtier sélectionné. Vous pouvez enregistrer le fichier maintenant ou renseigner les autres zones relatives à la configuration, comme décrit dans Indication des définitions d'objet métier prises en charge.
  3. Une fois la configuration terminée, cliquez sur File>Save>To Project ou sur File>Save>To File.

    Si vous enregistrez dans un fichier, sélectionnez *.cfg comme extension, sélectionnez l'emplacement correct pour le fichier et cliquez sur Save.

    Si plusieurs configurations de connecteur sont ouvertes, cliquez sur Save All to File pour enregistrer toutes les configurations dans un fichier ou cliquez sur Save All to Project pour enregistrer toutes les configurations du connecteur dans un projet System Manager.

    Avant d'enregistrer le fichier, Connector Configurator vérifie que vous avez défini des valeurs pour toutes les propriétés standard requises. Si vous n'avez pas défini de valeur pour l'une des propriétés standard requises, Connector Configurator affiche un message indiquant l'échec de la validation. Vous devez attribuer une valeur à la propriété pour pouvoir enregistrer le fichier de configuration.

Définition des propriétés du fichier de configuration

Lorsque vous créez et que vous nommez un nouveau fichier de configuration du connecteur, ou que vous ouvrez un fichier de configuration existant du connecteur, Connector Configurator affiche un écran de configuration avec des onglets pour les catégories des valeurs de configuration requises.

Connector Configurator requiert des valeurs pour les propriétés dans ces catégories pour les connecteurs s'exécutant sur tous les courtiers :

Remarque :
Pour les connecteurs utilisant la messagerie JMS, une catégorie supplémentaire peut s'afficher ; elle est associée à la configuration des gestionnaires de données qui convertissent les données en objets métier.

Pour les connecteurs qui s'exécutent sur ICS, des valeurs sont également requises pour ces propriétés :

Important :
Connector Configurator accepte des valeurs de propriété dans des jeux de caractères anglais et des jeux de caractères qui n'existent pas en anglais. Cependant, les noms des propriétés standard et des propriétés spécifiques au connecteur ainsi que les noms des objets métier pris en charge doivent uniquement utiliser le jeu de caractères anglais.

Les différences entre les propriétés standard et les propriétés spécifiques au connecteur sont les suivants :

Les zones relatives aux propriétés standard et aux propriétés spécifiques au connecteur sont codées en couleur pour indiquer les éléments configurables :

Configuration des propriétés standard du connecteur

Les propriétés de configuration standard fournissent des informations utilisées par tous les connecteurs. Voir Annexe. Propriétés de configuration standard pour les connecteurs pour plus d'informations sur ces propriétés.

Important :
Ce connecteur prenant en charge tous les courtiers d'intégration, les propriétés de configuration de tous les courtiers lui sont applicables.

Vous devez définir au moins les propriétés standard de configuration du connecteur avant de l'exécuter :

Pour modifier la valeur d'une propriété standard, procédez comme suit :

  1. Cliquez dans la zone dont vous souhaitez définir la valeur.
  2. Entrez une valeur ou sélectionnez-en une dans le menu déroulant le cas échéant.
  3. Une fois que vous avez entré toutes les valeurs pour les propriétés standard, vous pouvez exécuter les opérations suivantes :
Propriétés spécifiques au connecteur

Les propriétés de configuration spécifiques au connecteur fournissent des informations requises par le connecteur au moment de l'exécution. Les propriétés spécifiques au connecteur permettent également de modifier les informations statiques ou logiques dans l'agent du connecteur sans devoir le recoder et le recompiler.

Le Tableau 2 dresse la liste des propriétés de configuration spécifiques au connecteur. Pour obtenir des explications sur les propriétés, voir la section suivante.

Tableau 2. les propriétés spécifiques au connecteur.
Nom Valeurs possibles Valeur par défaut Obligatoire ?
ApplicationName iSeriesAdapter Aucun Oui
UseDefaults valeur par défaut Aucun Oui
MessageFileName BIA_iSeriesAdapter.txt BIA_iSeriesAdapter.txt Non
PollQuantity un entier supérieur à 1 1 Non
ApplicationName

Nom unique devant être précisé pour chaque connecteur.

UseDefaults

Par exemple, certains paramètres d'entrée d'un programme peuvent être des constantes. Ces attributs peuvent donc être conçus pour avoir des valeurs par défaut. En l'absence de valeur par défaut, et si la propriété UseDefaults est définie sur true, l'adaptateur génère une erreur et émet un message d'erreur VerbProcessingFailedException. Si UseDefaults n'est pas défini ou s'il est défini sur false, et en l'absence de valeurs par défaut, l'adaptateur génère une chaîne de longueur MaxLength complétée d'espaces vides pour les valeurs de l'attribut.

MessageFileName

Nom et chemin du fichier de message d'erreur, s'il n'est pas situé à l'emplacement standard de message %CROSSWORLDS%\ connectors\messages. Si le nom de fichier du message n'est pas un chemin qualifié complet, il est supposé que le fichier figure dans le répertoire indiqué par la variable d'environnement HOME ou par le paramètre de démarrage user.home. S'il n'existe pas de fichier de message de connecteur, le fichier BIA_iSeriesAdapter.txt est utilisé comme fichier de message.

PollQuantity

PollQuantity est un entier supérieur à 1, qui indique le nombre d'éléments à interroger à partir des files d'attente de données. Notez que si n est précisé par PollQuantity, alors chaque file d'attente configurée à l'aide des méta-objets est interrogée n fois. La valeur par défaut est 1.

Définition de propriétés de configuration spécifiques à l'application

Pour les propriétés de configuration spécifiques à l'application, vous pouvez ajouter ou modifier les noms des propriétés, définir des valeurs, supprimer une propriété et chiffrer une propriété. La longueur par défaut d'une propriété est de 255 caractères.

  1. Cliquez avec le bouton droit dans la partie supérieure gauche de la grille. Une barre de menus contextuelle apparaît. Cliquez sur Add pour ajouter une propriété. Pour ajouter une propriété enfant, cliquez avec le bouton droit sur le numéro de la ligne parent et cliquez sur Add child.
  2. Entrez une valeur pour la propriété ou la propriété enfant.
  3. Pour chiffrer une propriété, cochez la case Encrypt.
  4. Vous pouvez enregistrer ou ignorer les modifications, comme décrit pour Configuration des propriétés standard du connecteur.

La zone Update Method affichée pour chaque propriété indique si le redémarrage d'un composant ou d'un agent est nécessaire à l'activation des valeurs modifiées.

Important :
La modification du nom prédéfini d'une propriété de connecteur spécifique à l'application peut entraîner l'échec d'un connecteur. Le connecteur peut nécessiter certains noms de propriété pour se connecter à une application ou s'exécuter correctement.
Chiffrement des propriétés du connecteur

Pour chiffrer les propriétés spécifiques à l'application, cochez la case Encrypt dans la fenêtre des propriétés spécifiques au connecteur. Pour déchiffrer une valeur, décochez la case Encrypt, entrez la valeur appropriée dans la boîte de dialogue Verification et cliquez sur OK. Si la valeur entrée est correcte, elle est déchiffrée et s'affiche.

Le guide d'utilisateur de l'adaptateur pour chaque connecteur contient la liste et la description de chaque propriété ainsi que sa valeur par défaut.

Si une propriété a plusieurs valeurs, la case Encrypt apparaît pour la première valeur de la propriété. Lorsque vous sélectionnez Encrypt, toutes les valeurs de la propriété sont chiffrées. Pour déchiffrer plusieurs valeurs d'une propriété, décochez la case Encrypt pour la première valeur de la propriété, puis entrez la nouvelle valeur dans la boîte de dialogue Verification. Si la valeur entrée est une correspondance, toutes les valeurs multiples sont déchiffrées.

Méthode de mise à jour

Reportez-vous aux descriptions des méthodes de mise à jour contenues dans l'annexe Propriétés de configuration standard pour les connecteurs dans Présentation des valeurs des propriétés de configuration.

Indication des définitions d'objet métier prises en charge

Utilisez l'onglet Supported Business Objects dans Connector Configurator pour indiquer les objets métier que le connecteur utilisera. Vous devez indiquer les objets métier génériques et les objets métier spécifiques à l'application, et indiquer les associations pour les mappes entre les objets métier.

Remarque :
Certains connecteurs nécessitent que des objets métier soient indiqués comme étant pris en charge pour pouvoir exécuter la notification des événements ou une configuration supplémentaire (à l'aide des méta-objets) avec leurs applications. Pour plus d'informations, voir Connector Development Guide for C++ ou Connector Development Guide for Java.
Si ICS est votre courtier

Pour indiquer qu'une définition d'objet métier est prise en charge par le connecteur ou modifier les paramètres de prise en charge d'une définition d'objet métier existante, cliquez sur l'onglet Supported Business Objects et utilisez les zones suivants :

Nom de l'objet métier

Pour indiquer qu'une définition d'objet métier est prise en charge par le connecteur, avec System Manager en cours d'exécution, procédez comme suit :

  1. Cliquez dans une zone vide de la liste Business Object Name. Une boîte à liste déroulante affiche toutes les définitions d'objet métier qui existent dans le projet System Manager.
  2. Cliquez sur un objet métier pour l'ajouter.
  3. Définissez la zone Agent Support (décrite plus bas) pour l'objet métier.
  4. Dans le menu File de la fenêtre Connector Configurator, cliquez sur Save to Project. La définition révisée du connecteur, qui contient la prise en charge sélectionnée pour la définition de l'objet métier ajouté, est enregistrée dans un projet ICL (Integration Component Library) de System Manager.

Pour supprimer un objet métier dans la liste des objets métier pris en charge :

  1. Pour sélectionner la zone d'un objet métier, cliquez sur le numéro situé à gauche de l'objet métier.
  2. Dans le menu Edit de la fenêtre Connector Configurator, cliquez sur Delete Row. L'objet métier est supprimé de la liste.
  3. Dans le menu File, cliquez sur Save to Project.

La suppression d'un objet métier dans la liste des objets métier pris en charge modifie la définition du connecteur et rend l'objet métier supprimé inutilisable dans cette implémentation du connecteur. Elle n'affecte pas le code du connecteur et ne supprime pas la définition de l'objet métier dans System Manager.

Prise en charge de l'agent

Si un objet métier dispose de la prise en charge de l'agent, le système tente d'utiliser cet objet métier pour fournir des données à une application via l'agent du connecteur.

En général, les objets métier spécifiques à l'application pour un connecteur sont pris en charge par l'agent de ce connecteur, mais les objets métier génériques ne le sont pas.

Pour indiquer que l'objet métier est pris en charge par l'agent du connecteur, cochez la case Agent Support. La fenêtre Connector Configurator ne valide pas vos sélections pour Agent Support.

Niveau de transaction maximum

Le niveau de transaction maximum d'un connecteur correspond au niveau de transaction le plus élevé pris en charge par le connecteur.

Pour la plupart des connecteurs, Best Effort est la seule valeur possible.

Vous devez redémarrer le serveur pour que les modifications prennent effet.

Si votre courtier est un courtier de messages WebSphere

Si vous utilisez le mode autonome (non connecté à System Manager), vous devez entrer manuellement le nom de l'objet métier.

Si System Manager est en cours d'exécution, vous pouvez cocher la case située sous la colonne Business Object Name dans l'onglet Supported Business Objects. Une boîte de dialogue mixte affiche la liste des objets métier disponibles dans le projet Integration Component Library auquel le connecteur appartient. Dans cette liste, sélectionnez l'objet métier de votre choix.

La zone Message Set ID est facultative pour WebSphere Business Integration Message Broker 5.0, et sa valeur ne doit pas nécessairement être unique le cas échéant. Cependant, pour WebSphere MQ Integrator et Integrator Broker 2.1, vous devez indiquer un ID unique.

Si WAS est votre courtier

Lorsque vous sélectionnez WebSphere Application Server comme type de courtier, Connector Configurator ne nécessite pas les ID d'ensemble de messages. L'onglet Supported Business Objects contient la colonne Business Object Name pour les objets métier pris en charge uniquement.

Si vous utilisez le mode autonome (non connecté à System Manager), vous devez entrer manuellement le nom de l'objet métier.

Si System Manager est en cours d'exécution, vous pouvez cocher la case située sous la colonne Business Object Name dans l'onglet Supported Business Objects. Une boîte de dialogue mixte affiche la liste des objets métier disponibles dans le projet Integration Component Library auquel le connecteur appartient. Dans cette liste, sélectionnez l'objet métier de votre choix.

Mappes associées (ICS uniquement)

Chaque connecteur prend en charge la liste des définitions des objets métier et leurs mappes associées actives dans WebSphere InterChange Server. Cette liste apparaît lorsque vous sélectionnez l'onglet Associated Maps.

La liste des objets métier contient l'objet métier spécifique à l'application pris en charge par l'agent et l'objet générique correspondant que le contrôleur envoie à la collaboration de souscription. L'association d'une mappe détermine la mappe qui sera utilisée pour transformer l'objet métier spécifique à l'application en objet métier générique, ou inversement.

Si vous utilisez des mappes uniquement définies pour des objets métier source et cible spécifiques, les mappes sont déjà associées aux objets métier appropriés lorsque vous affichez l'écran, et vous n'avez pas besoin de (ou ne pouvez pas) les modifier.

Si plusieurs mappes sont disponibles pour un objet métier pris en charge, vous devez lier de manière explicite cet objet métier à la mappe qu'il doit utiliser.

L'onglet Associated Maps affiche les zones suivantes :

Ressources (ICS)

L'onglet Resource vous permet de définir une valeur qui détermine si l'agent du connecteur gérera plusieurs processus simultanément, et dans quelle mesure, à l'aide du parallélisme de l'agent du connecteur.

Tous les connecteurs ne prennent pas en charge cette fonction. Si vous exécutez un agent de connecteur conçu dans Java pour être multithread, nous vous recommandons de ne pas utiliser cette fonction dans la mesure où il est généralement plus efficace d'utiliser plusieurs unités d'exécution plutôt que plusieurs processus.

Messagerie (ICS)

Les propriétés de messagerie sont disponibles uniquement si vous avez défini MQ comme la valeur de la propriété standard DeliveryTransport et ICS comme le type de courtier. Ces propriétés affectent la manière dont le connecteur utilisera les files d'attente.

Définition des valeurs du fichier de trace ou du fichier journal

Lorsque vous ouvrez le fichier de configuration ou le fichier de définitions d'un connecteur, Connector Configurator utilise les valeurs de journalisation et de trace de ce fichier comme valeurs par défaut. Vous pouvez modifier ces valeurs dans Connector Configurator.

Pour modifier les valeurs de journalisation et de trace, procédez comme suit :

  1. Cliquez sur l'onglet Trace/Log Files.
  2. Pour la journalisation ou la fonction de trace, vous pouvez écrire des messages à l'un des composants suivants :

Gestionnaires de données

La section des gestionnaires de données est disponible pour la configuration uniquement si vous avez indiqué une valeur JMS pour ContainerManagedEvents. Tous les adaptateurs n'utilisent pas les gestionnaires de données.

Pour connaître les valeurs à utiliser pour ces propriétés, reportez-vous aux descriptions sous ContainerManagedEvents dans l'Annexe A, Propriétés standard. Pour plus d'informations, voir Connector Development Guide for C++ ou Connector Development Guide for Java.

Enregistrement du fichier de configuration

Une fois que vous avez configuré votre connecteur, enregistrez son fichier de configuration. Connector Configurator enregistre le fichier dans le mode courtier que vous avez sélectionné pendant la configuration. La barre de titre de Connector Configurator affiche toujours le mode courtier (ICS, WMQI ou WAS) en cours d'utilisation.

Le fichier est enregistré en tant que document XML. Pour enregistrer le document XML, vous avez trois possibilités :

Pour plus d'informations sur l'utilisation des projets dans System Manager et sur le déploiement, voir les guides d'implémentation suivants :

Modification d'un fichier de configuration

Vous pouvez modifier les paramètres du courtier d'intégration pour un fichier de configuration existant. Cela vous permet d'utiliser le fichier comme modèle pour la création d'un nouveau fichier de configuration que vous pouvez utiliser avec un autre courtier.

Remarque :
Vous devrez modifier d'autres propriétés de configuration ainsi que la propriété du mode courtier si vous changez de courtiers d'intégration.

Pour modifier votre sélection de courtier dans un fichier de configuration existant (facultatif) :

Exécution de la configuration

Une fois que vous avez créé un fichier de configuration pour un connecteur et que vous l'avez modifié, assurez-vous que le connecteur peut localiser le fichier de configuration lorsqu'il démarre.

Pour ce faire, ouvrez le fichier de démarrage utilisé pour le connecteur et vérifiez que le nom de fichier et l'emplacement utilisés pour le fichier de configuration du connecteur correspondent exactement au nom attribué au fichier et au répertoire ou au chemin d'accès dans lequel vous l'avez placé.

Utilisation de Connector Configurator en environnement globalisé

Connector Configurator est globalisé et peut gérer la conversion des caractères entre le fichier de configuration et le courtier d'intégration. Connector Configurator utilise le codage natif. Lorsqu'il écrit dans le fichier de configuration, il utilise le codage UTF-8.

Connector Configurator prend en charge les caractères qui n'existent pas en anglais dans :

La liste déroulante pour les propriétés de configuration standard CharacterEncoding et Locale affiche uniquement un sous-ensemble des valeurs prises en charge. Pour ajouter d'autres valeurs à cette liste, vous devez modifier manuellement le fichier \Data\Std\stdConnProps.xml dans le répertoire produit.

Par exemple, pour ajouter l'environnement local en_GB à la liste des valeurs pour la propriété Locale, ouvrez le fichier stdConnProps.xml et ajoutez la ligne en caractère gras comme indiqué ci-dessous :

<Property name="Locale" 
 isRequired="true" 
 updateMethod="component restart">
                 <ValidType>String</ValidType>
             <ValidValues>
                                 <Value>ja_JP</Value>
                                 <Value>ko_KR</Value>
                                 <Value>zh_CN</Value>
                                 <Value>zh_TW</Value>
                                 <Value>fr_FR</Value>
                                 <Value>de_DE</Value>
                                 <Value>it_IT</Value>
                                 <Value>es_ES</Value>
                                 <Value>pt_BR</Value>
                                 <Value>en_US</Value>
                                 <Value>en_GB</Value>
                    <DefaultValue>en_US</DefaultValue>
             </ValidValues>
     </Property>

Démarrage du connecteur

Vous devez démarrer un connecteur de manière explicite à l'aide du script de démarrage du connecteur. Sous Windows, le script de démarrage doit résider dans le répertoire d'exécution du connecteur :

ProductDir\connectors\connName

connName identifie le connecteur.

Sous UNIX, le script de démarrage doit résider dans le répertoire UNIX ProductDir/bin.

Le nom du script de démarrage dépend de la plateforme du système d'exploitation, comme le montre le tableau 3.

Tableau 3. Script de démarrage pour un connecteur
Système d'exploitation Script de démarrage
Systèmes UNIX connector_manager
Windows start_connName.bat

Lorsque le script de démarrage s'exécute, il va chercher par défaut le fichier de configuration dans le Productdir (voir commandes ci-dessous). Il s'agit du répertoire dans lequel vous placez le fichier de configuration.

Remarque :
Si l'adaptateur utilise le transfert JMS, vous avez besoin d'un fichier de configuration local .

Pour appeler le script de démarrage du connecteur, utilisez l'une des méthodes suivantes :

Pour plus d'informations sur le démarrage d'un connecteur, notamment sur les options de lancement à partir de la ligne de commande, reportez-vous à l'un des documents suivants :

Arrêt du connecteur

La méthode pour arrêter un connecteur dépend de la manière dont il a été démarré, comme suit :

Création de plusieurs instances de connecteur

La création de plusieurs instances d'un connecteur revient pratiquement à créer un connecteur personnalisé. Vous pouvez configurer votre système de sorte qu'il crée et exécute plusieurs instances d'un connecteur en suivant les étapes ci-dessous. Vous devez :

Création d'un répertoire

Vous devez créer un répertoire pour chaque instance de connecteur. Vous devez attribuer le nom suivant à ce répertoire de connecteur :

ProductDir\connectors\connectorInstance

connectorInstance identifie de manière unique l'instance de connecteur.

Si le connecteur possède des méta-objets qui lui sont spécifiques, vous devez créer un méta-objet pour l'instance de connecteur. Si vous enregistrez le méta-objet en tant que fichier, créez le répertoire suivant et stockez le fichier dedans :

ProductDir\repository\connectorInstance
Création de définitions d'objet métier

Si les définitions d'objet métier pour chaque instance du connecteur n'existent pas déjà dans le projet, vous devez les créer.

  1. Si vous devez modifier les définitions d'objet métier associées au connecteur initial, copiez les fichiers appropriés et utilisez Business Object Designer pour les importer. Vous pouvez copier n'importe quel fichier pour le connecteur initial. Vous devez simplement les renommer si vous les modifiez.
  2. Les fichiers pour le connecteur initial doivent résider dans le répertoire suivant :
    ProductDir\repository\initialConnectorInstance
    Tous les fichiers supplémentaires que vous créez doivent être placés dans le sous-répertoire connectorInstance approprié de ProductDir\repository.
Création d'une définition de connecteur

Vous devez créer un fichier de configuration (définition du connecteur) pour l'instance du connecteur dans Connector Configurator. Pour ce faire, procédez comme suit :

  1. Copiez le fichier de configuration du connecteur initial (définition du connecteur) et renommez-le.
  2. Assurez-vous que chaque instance du connecteur répertorie correctement ses objets métier pris en charge (et tous les méta-objets associés).
  3. Personnalisez toutes les propriétés du connecteur le cas échéant.
Création d'un script de démarrage

Pour créer un script de démarrage, procédez comme suit :

  1. Copiez le script de démarrage du connecteur initial et attribuez-lui un nom incluant le nom du répertoire du connecteur :

    dirname

  2. Placez ce script de démarrage dans le répertoire du connecteur créé à la section Création d'un répertoire.
  3. Créez un raccourci pour le script de démarrage (Windows uniquement).
  4. Copiez le texte du raccourci du connecteur et modifiez le nom du connecteur initial (dans la ligne de commande) de sorte qu'il corresponde au nom de la nouvelle instance du connecteur.

A présent, vous pouvez exécuter simultanément les deux instances du connecteur sur votre serveur d'intégration.

Pour plus d'informations sur la création de connecteurs personnalisés, voir Connector Development Guide for C++ or for Java.

Copyright IBM Corp. 2003, 2005