Configuration des cibles

Les cibles représentent les emplacements où sont réceptionnés les documents sur le concentrateur. Ces documents peuvent provenir de participants de la communauté (pour être finalement remis au Gestionnaire de communauté) ou du Gestionnaire de communauté (pour être finalement remis aux participants).

Vous devez définir au moins une cible pour chaque type de transfert utilisé pour acheminer les documents qui seront envoyés au concentrateur. Par exemple, il doit exister une cible HTTP pour recevoir les documents envoyés par transfert HTTP ou HTTPS. Si les participants de votre communauté sont appelés à envoyer des documents via FTP, vous devez définir une cible FTP.

Le schéma ci-dessous illustre la configuration de quatre cibles chargées de traiter les documents entrant dans le concentrateur. Les documents provenant des participants sont traités par deux cibles, et ceux issus du Gestionnaire de communauté sont traités par deux autres cibles. (Notez que vous pouvez ajouter des modes de transfert à ceux pris en charge par défaut par WebSphere Business Integration Connect.)

Figure 21. Transferts et cibles associées


Pour configurer vos cibles, procédez comme suit :

  1. Cliquez sur Administrateur du concentrateur > Configuration du concentrateur > Cibles.
  2. Si vous entendez télécharger un transfert défini par l'utilisateur, exécutez la procédure suivante. Sinon, passez à l'étape 3.
    1. Cliquez sur Importer le type de transfert.
    2. Entrez le nom d'un fichier XML définissant le mode de transfert (ou naviguez jusqu'au fichier par le biais du bouton Parcourir).
    3. Cliquez sur Télécharger.

    Remarque : Dans la liste des cibles, vous pouvez également supprimer un type de transfert défini par l'utilisateur. Vous ne pouvez pas supprimer un transfert fourni par WebSphere Business Integration Connect. Vous ne pouvez pas non plus supprimer un transfert défini par l'utilisateur une fois qu'il a été utilisé pour la création d'une cible.

  3. Cliquez sur Créer la cible.
  4. Attribuez un nom à la cible. Par exemple, vous pourriez la nommer CibleHttp. Cette zone doit être renseignée. Le nom que vous entrez ici s'affichera dans la liste des cibles.
  5. Indiquez éventuellement l'état de la cible. L'état par défaut est Activé. Une cible activée est prête à accepter des documents. Une cible désactivée ne peut pas accepter de documents.
  6. Entrez éventuellement une description pour la cible.
  7. Sélectionnez un mode de transfert dans la liste. Il est à noter que si vous avez importé un mode transfert défini par l'utilisateur, il apparaît dans la liste.

La procédure indiquée s'applique à toutes les cibles. Toutefois, après avoir sélectionné une cible, de nouvelles zones s'affichent dans la page, qui varient en fonction du mode de transport choisi.

Vous trouverez ci-dessous les étapes supplémentaires à exécuter pour configurer la cible, en fonction du type de transfert auquel elle est associée. Après avoir fourni les informations relatives au type de transfert pour définir une cible HTTP/S ou une cible définie par l'utilisateur, vous pouvez modifier les points de configuration de la cible. Voir Modification des points de configuration.

Configuration d'une cible HTTP/S

Le composant Réceptionnaire intègre un servlet prédéfini appelé bcgreceiver qui est utilisé pour recevoir les messages HTTP/S POST. Or, pour pouvoir accéder aux messages reçus par le servlet, vous devez créer une cible HTTP.

La procédure suivante indique comment définir une cible HTTP/S :

  1. Indiquez éventuellement le type de passerelle. Le type de passerelle définit la nature de la transmission. Par exemple, si vous voulez tester un échange de document avant de le mettre en production, vous devez entrer Test. La valeur par défaut est Production.
  2. Indiquez l'identificateur URI de la cible HTTP/S. Le nom doit commencer par bcgreceiver. Par exemple, vous pouvez entrer bcgreceiver/submit. Les documents entrant dans le serveur via HTTP/S seront alors reçus dans bcgreceiver/submit.
  3. Modifiez les valeurs d'acheminement synchronisé (facultatif) :
    1. Dans la zone Délai de synchronisation maximal, indiquez le nombre de millisecondes durant lesquelles une connexion synchrone restera ouverte. La valeur par défaut est 600000.
    2. Pour la connexion au module d'intégration de système de synchronisation maximale, entrez le nombre maximal de connexions synchrones que le système autorisera. La valeur par défaut est 100 (pour le nombre maximal de connexions synchrones simultanées).
  4. Si vous souhaitez modifier les points de configuration, ou si vous configurez une cible pour un document AS2, cXML, RNIF ou SOAP qui sera impliqué dans un échange synchrone, reportez-vous à la section Modification des points de configuration.

Configuration d'une cible FTP

La procédure suivante indique comment définir une cible FTP :

  1. Dans la zone Répertoire principal FTP, indiquez le répertoire racine du serveur FTP. Pour plus d'informations sur la configuration d'un répertoire pour un serveur FTP, reportez-vous à la section Configuration du serveur FTP pour la réception de documents.
  2. Entrez éventuellement une valeur dans la zone Intervalle de fichier non modifié pour indiquer le nombre de secondes durant lesquelles la taille du fichier ne devra pas changer tant que le Gestionnaire de documents n'aura pas récupéré le document pour traitement. La valeur par défaut est 3 secondes.
  3. Entrez éventuellement une valeur dans la zone Nombre d'unités d'exécution pour indiquer le nombre de documents que le Gestionnaire de documents traitera simultanément. Il est recommandé de conserver la valeur par défaut (1).
  4. Entrez éventuellement une valeur dans la zone Exclure l'extension de fichier pour indiquer les types de documents que le Gestionnaire de documents devra ignorer (c'est-à-dire, exclure du traitement) s'il trouve des documents correspondants dans le répertoire FTP. Par exemple, si vous souhaitez que le Gestionnaire de documents ignore les fichiers d'un tableur, indiquez l'extension correspondante. Par défaut, aucun type de fichier n'est exclu.

Configuration d'une cible SMTP

La procédure suivante indique comment définir une cible SMTP (POP3) :

  1. Indiquez éventuellement le type de passerelle. La valeur par défaut est Production.
  2. Indiquez l'emplacement du serveur POP3 où le courrier est remis.
  3. Indiquez un numéro de port (facultatif). Si vous n'en indiquez pas, c'est la valeur 110 qui est utilisée.
  4. Indiquez l'ID utilisateur et le mot de passe requis pour accéder au serveur de courrier, dans la mesure où ceux-ci sont obligatoires.
  5. Entrez éventuellement une valeur dans la zone Délai d'inactivité pour indiquer le nombre de secondes durant lesquelles la cible vérifiera la présence de documents sur le serveur POP3. Cette zone doit être renseignée. La valeur par défaut est 1 ms.
  6. Entrez éventuellement une valeur dans la zone Nombre d'unités d'exécution pour indiquer le nombre de documents que le Gestionnaire de documents traitera simultanément. Il est recommandé de conserver la valeur par défaut (1).
  7. Sélectionnez éventuellement l'heure de la journée (heures et minutes) à laquelle la cible SMTP doit vérifier la présence de documents sur le serveur POP3.
  8. Sélectionnez éventuellement les jours de la semaine où l'interrogation du serveur doit avoir lieu. Par défaut, l'interrogation est quotidienne.
  9. Sélectionnez éventuellement les jours du mois où l'interrogation doit avoir lieu. Par défaut, l'interrogation est quotidienne.

Configuration d'une cible JMS

La procédure suivante indique comment définir une cible JMS :

  1. Indiquez éventuellement le type de passerelle. La valeur par défaut est Production.
  2. Indiquez l'URL du fournisseur JMS. Celui-ci doit correspondre à la valeur indiquée lors de la configuration de WebSphere Business Integration Connect pour JMS, comme décrit à la section Configuration du concentrateur pour le protocole de transfert JMS.
  3. Indiquez l'ID utilisateur et le mot de passe requis pour accéder à la file d'attente JMS, dans la mesure où ceux-ci sont obligatoires.
  4. Renseignez la zone Nom de file d'attente JMS. Cette zone doit être renseignée.
  5. Précisez le nom de la fabrique JMS. Cette zone doit être renseignée.
  6. Indiquez le module URL du fournisseur (facultatif).
  7. Précisez le nom de la fabrique JNDI. Si vous n'en indiquez pas, c'est la valeur value com.sun.jndi.fscontext.RefFSContextFactory qui est utilisée. Cette zone doit être renseignée.
  8. Entrez éventuellement une valeur dans la zone Délai d'inactivité pour indiquer le nombre de secondes durant lesquelles la cible vérifiera la présence de documents dans la file d'attente JMS. Cette zone doit être renseignée.
  9. Entrez éventuellement une valeur dans la zone Nombre d'unités d'exécution pour indiquer le nombre de documents que le Gestionnaire de documents traitera simultanément. Il est recommandé de conserver la valeur par défaut (1).

Par exemple, si vous vouliez configurer une cible JMS analogue à celle de l'exemple du "Etapes préalables à la configuration du concentrateur", vous devriez indiquer les valeurs suivantes :

  1. CibleJMS dans la zone Nom de la cible ;
  2. Spécifiez file:/C:/TEMP/JMS/JMS dans la zone URL du fournisseur JMS ;
  3. enFA dans la zone Nom de file d'attente JMS ;
  4. ConcWBIC dans la zone Nom de la fabrique JMS.

Configuration d'une cible Système de fichiers

La procédure suivante indique comment définir une cible Système de fichiers :

  1. Indiquez éventuellement le type de passerelle. La valeur par défaut est Production.
  2. Entrez une valeur dans la zone Répertoire principal du document pour indiquer le répertoire dans lequel les documents seront reçus.
  3. Renseignez éventuellement la zone Intervalle de sondage pour indiquer la fréquence de recherche de nouveaux documents dans le répertoire. Si vous n'indiquez aucune valeur, le répertoire sera interrogé toutes les 5 secondes.
  4. Entrez éventuellement une valeur dans la zone Intervalle de fichier non modifié pour indiquer le nombre de secondes durant lesquelles la taille du fichier ne devra pas changer tant que le Gestionnaire de documents n'aura pas récupéré le document pour traitement. La valeur par défaut est 3 secondes.
  5. Entrez éventuellement une valeur dans la zone Nombre d'unités d'exécution pour indiquer le nombre de documents que le Gestionnaire de documents traitera simultanément. Il est recommandé de conserver la valeur par défaut (1).

Modification des points de configuration

Pour certains protocoles métier (RosettaNet, cXML, SOAP et AS2) qui seront impliqués dans les échanges synchrones, vous devez spécifier un récupérateur pour le point de configuration SyncCheck. Vous pouvez également modifier la façon dont une cible HTTP/S ou une cible définie par l'utilisateur traite les documents en appliquant un récupérateur défini par l'utilisateur téléchargé (ou un processus fourni par le système) aux autres points de configuration de la cible.

Pour appliquer un récupérateur écrit par l'utilisateur à ces points de configuration, vous devez d'abord télécharger le récupérateur, comme décrit dans la section Téléchargement de récupérateurs définis par l'utilisateur. Vous pouvez également utiliser un récupérateur fourni par le système, déjà disponible et qu'il n'est pas nécessaire de télécharger.

Pour modifier les points de configuration, procédez comme suit :

  1. Si vous êtes sur le point de créer une cible, passez à l'étape 2. Si vous modifiez une configuration cible, cliquez sur Administrateur du concentrateur > Configuration du concentrateur > Cibles. Cliquez ensuite sur l'icône symbolisant une loupe située en regard de la cible. cliquez enfin sur .
  2. Si vous spécifiez un récupérateur pour des transactions synchrones AS2, cXML, SOAP ou RNIF, exécutez les actions suivantes :
    1. Sélectionnez SyncCheck dans la liste Récupérateurs des points de configuration.
    2. Ajoutez le récupérateur approprié à la liste des récupérateurs appropriés en sélectionnant le récupérateur dans la liste des récupérateurs disponibles et cliquez sur Ajouter.

      Répétez cette étape si vous voulez ajouter d'autres récupérateurs à la liste. N'oubliez pas que pour les cibles, les récupérateurs sont appelés dans leur ordre d'apparition dans la liste des récupérateurs configurés. Le premier récupérateur disponible traite la requête et les récupérateurs suivants de la liste ne sont pas appelés. Il est très judicieux de répertorier le récupérateur spécifique SyncCheck (par exemple, com.ibm.bcg.server.sync.As2SyncHdlr pour les transactions AS2) avant de répertorier le récupérateur par défaut SyncCheck.

    3. Si vous avez terminé la définition des récupérateurs pour cette cible, cliquez sur Sauvegarder. Sinon, passez à l'étape 3.
  3. Dans la liste Récupérateurs des points de configuration, sélectionnez le point de configuration à modifier. Les points de configuration qui peuvent être modifiés sont Preprocess, SyncCheck et Postprocess.

    Figure 22. Récupérateurs des points de configuration cible


  4. Exécutez une ou plusieurs des étapes ci-après pour chaque récupérateur que vous souhaitez modifier.
    1. Ajoutez un récupérateur en le sélectionnant dans la liste des récupérateurs disponibles et en cliquant sur Ajouter. Le récupérateur passe dans la liste des récupérateurs configurés.
    2. Supprimez un récupérateur en le sélectionnant dans la liste des récupérateurs configurés et en cliquant sur Supprimer. Le récupérateur passe dans la liste des récupérateurs disponibles.
    3. Pour modifier l'ordre du récupérateur dans la liste, sélectionnez-le dans la liste et cliquez sur le bouton de déplacement vers le haut ou déplacement vers le bas.
    4. Pour exécuter un récupérateur plusieurs fois, sélectionnez-le, puis cliquez sur Répéter.
    5. Pour configurer le récupérateur, sélectionnez-le dans la liste des récupérateurs configurés et cliquez sur Configurer. La liste des attributs pouvant être configurés s'affiche.
  5. Cliquez sur Sauvegarder.

Copyright IBM Corp. 1997, 2004