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 :
Pour les connecteurs qui s'exécutent sur ICS, des valeurs sont également requises pour ces propriétés :
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 :
Pour modifier la valeur d'une propriété standard, procédez comme suit :
Pour plus d'informations sur une propriété standard donnée, cliquez sur l'entrée correspondante dans la colonne Description, dans la feuille à onglets Standard Properties. Si Extended Help est installé, un bouton flèche apparaît sur la droite. Un clic sur ce bouton ouvre une fenêtre d'aide, qui affiche des détails concernant la propriété standard.
Les fichiers Extended Help sont installés dans le répertoire <ProductDir>\bin\Data\Std\Help\<RegionalSetting>\.
Vous pouvez ajouter ou modifier des noms, définir des valeurs, supprimer une propriété spécifique ou la chiffrer. La longueur par défaut d'une propriété est de 255 caractères.
Si les fichiers Extended Help sont installés et que la propriété AdapterHelpName n'est pas renseignée, Connector Configurator pointera sur les fichiers Extended Help spécifiques au connecteur, dans le répertoire <ProductDir>\bin\Data\App\Help\<RegionalSetting>\. Sinon, Connector Configurator pointera sur les fichiers Extended Help spécifiques au connecteur, dans le répertoire <ProductDir>\bin\Data\App\Help\<AdapterHelpName>\<RegionalSetting>\. Voir la propriété AdapterHelpName, décrite dans l'annexe Propriétés standard.
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.
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.
Reportez-vous aux descriptions des méthodes de mise à jour, dans l'annexe Propriétés standard, sous Présentation des valeurs des propriétés de configuration.
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.
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 :
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 :
Pour supprimer un objet métier dans la liste des objets métier pris en charge :
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.
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.
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 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.
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.
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 :
Il s'agit des objets métier pris en charge par ce connecteur, comme indiqué dans l'onglet Supported Business Objects. Si vous indiquez des objets métier supplémentaires dans l'onglet Supported Business Objects, ils sont reflétés dans cette liste une fois que vous avez enregistré les modifications en sélectionnant Save to Project dans le menu File de la fenêtre Connector Configurator.
L'écran affiche toutes les mappes installées sur le système à utiliser avec les objets métier pris en charge du connecteur. L'objet métier source pour chaque mappe s'affiche à gauche du nom de la mappe, dans l'écran Business Object Name.
Dans certains cas, vous devrez peut-être lier de manière explicite une mappe associée.
Une liaison explicite est requise uniquement lorsque plusieurs mappes existent pour un objet métier pris en charge spécifique. Lorsque ICS s'amorce, il tente de lier automatiquement une mappe à chaque objet métier pris en charge pour chacun des connecteurs. Si plusieurs mappes prennent le même objet métier comme entrée, le serveur tente de localiser et de lier une mappe qui correspond au sur-ensemble des autres.
Si aucune mappe n'est le sur-ensemble des autres, le serveur ne peut pas lier l'objet métier à une seule mappe et vous devrez définir la liaison de manière explicite.
Pour lier une mappe de manière explicite, procédez comme suit :
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.
l'onglet Messaging vous permet de configurer les propriétés de messagerie. 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.
Avant de valider une file d'attente de messages, vous devez :
Pour valider la file d'attente, vous utiliserez le bouton Validate à droite des zones Messaging Type et Host Name, dans l'onglet Messaging.
l'onglet Security du Connector Configurator permet de définir le niveau de confidentialité d'un message. Cette propriété n'est utilisable que si la propriété DeliveryTransport est définie sur JMS.
Par défaut, Privacy est désactivé. Pour l'activer, cochez la case Privacy.
Le Keystore Target System Absolute Pathname (Chemin absolu du magasin de clés du système cible) est :
Ce chemin et le fichier qu'il indique doivent être sur le système qui vous servira à démarrer le connecteur, c'est-à-dire le système cible.
Vous pouvez utiliser le bouton Browse à droite, à condition que le système cible soit le seul en cours de fonctionnement. Ce bouton est désactivé jusqu'à ce que Privacy soit activé et que le Target System de la barre de menus soit défini sur Windows.
Le Message Privacy Level peut être défini comme suit pour les trois catégories de messages (All Messages, All Administrative Messages, et All Business Object Messages) :
La fonction Key Maintenance permet de générer, importer et exporter des clés publiques pour le serveur et l'adaptateur.
Avant d'importer un certificat dans le magasin de clés de l'adaptateur, vous devez l'exporter depuis le magasin de clés du serveur. Pour cela, sélectionnez Export Adapter Public Key, ce qui ouvre la fenêtre correspondante.
Lorsque vous sélectionnez Import Server Public Key, la boîte de dialogue correspondante s'ouvre.
La fonction Adapter Access Control n'est activée que si DeliveryTransport est définie sur IDL. Par défaut l'adaptateur se connecte avec l'identité d'invité (guest). Si la case Use guest identity n'est pas cochée, les zones Adapter Identity et Adapter Password sont accessibles.
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 :
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.