Configuration de votre environnement pour l'échange de messages

Effectuer les configurations et paramètrages suivants pour établir une communication entre WebSphere Data Interchange et Business Integration Connect :

Configuration de l'intercommunication WebSphere MQ

La première étape de la configuration de l'environnement consiste à configurer l'intercommunication WebSphere MQ. Le terme intercommunication signifie envoyer des messages d'un gestionnaire de files d'attente à un autre. La première étape consiste à définir un gestionnaire de files d'attente (et ses objets associés) pour les systèmes WebSphere Data Interchange et Business Integration Connect. Si vous avez l'intention d'envoyer des messages dans les deux directions, vous devez définir un gestionnaire de files d'attente source et un gestionnaire de files d'attente cible sur les deux systèmes. Sur le gestionnaire de files d'attente source, définissez un canal émetteur, une définition de file d'attente éloignée et une file d'attente de transmission. Sur le gestionnaire de files d'attente cible, vous devez définir un canal récepteur et une file d'attente cible.

Remarque :
Voir la documentation de WebSphere MQ pour plus d'informations sur la définition de gestionnaires de files d'attente.

Cette section indique les valeurs à utiliser pour définir les gestionnaires de files d'attente et les objets associés nécessaires pour l'exemple de scénario. Dans ce scénario, WebSphere MQ V5.3 est installé sur les machines A et B. La première étape consiste ici à créer un gestionnaire de files d'attente sur chacune des machines A et B pour l'utiliser avec WebSphere Data Interchange et WebSphere Business Integration Connect Enterprise Edition respectivement.

Remarque :
Votre gestionnaire de files d'attente WebSphere Data Interchange doit être configuré pour actionner WebSphere Data Interchange Server à l'aide de l'application WDI Adapter.

Pour envoyer des messages depuis un gestionnaire de files d'attente vers un autre à l'aide de WebSphere MQ, vous devez définir les objets suivants :

Dans l'exemple de scénario, les machines A et B jouent le rôle d'émetteur et de récepteur. Par conséquent, vous allez devoir définir un certain nombre d'objets sur chaque machine.

Le Tableau 92 répertorie les objets que vous devez créer pour configurer les machines A et B en tant que réceptrice et émettrice.

Tableau 92. Objets WebSphere MQ à créer
Objet MQ WebSphere Machine A Machine B

Gestionnaire de files d'attente

WDI32_QM

WBIC42_QM

Canal émetteur

TO.WBIC42

TO.WDI32

Canal récepteur

TO.WDI32

TO.WBIC42

File d'attente éloignée

EDI_OUT_A

EDI_OUT_B

File d'attente de transmission

XMITQ_A

XMITQ_B

File d'attente locale

EDI_IN_A

EDI_IN_B

File d'attente locale

XML_IN_A

XML_IN_B

File d'attente locale

XML_OUT_A

XML_OUT_B

La Figure 28 illustre le flux de messages entre la machine A et la machine B en indiquant le rôle des objets WebSphere MQ répertoriés dans le Tableau 92.

Figure 28. Flux de messages entre la machine A et la machine B


Vous pouvez utiliser plusieurs méthodes différentes pour définir ces objets, en fonction de votre plateforme WebSphere MQ. Par exemple, vous pouvez utiliser WebSphere MQ Explorer sur Windows pour définir les objets.

Configuration de WebSphere Data Interchange

Pour permettre à WebSphere Data Interchange de recevoir des messages depuis la file d'attente WebSphere MQ et écrire des messages EDI sur une file d'attente, vous devez configurer des profils dans WebSphere Data Interchange Client. Grâce à WebSphere Data Interchange Client, vous pouvez créer les profils suivants, décrits dans les prochaines sections :

Dans cet exemple de scénario, WebSphere Data Interchange reçoit des messages XML provenant de la file d'attente WebSphere MQ XML_IN_A et écrit le résultat de la conversion dans la file d'attente WebSphere MQ EDI_OUT_A. Cette procédure est connue sous le nom de "conversion XML en EDI". WebSphere Data Interchange reçoit également un message EDI provenant de WebSphere Business Integration Connect, Edition Enterprise, dans la file d'attente WebSphere MQ EDI_IN_A et écrit le résultat de la conversion dans la file d'attente XML_OUT_A.

Profile de file d'attente MQSeries

Un profil de file d'attente MQSeries contient des informations sur une file d'attente de messages WebSphere MQ. Le Tableau 93 indique les propriétés à configurer pour chaque profil.

Tableau 93. Propriétés dans un profil de file d'attente MQSeries
Propriété MQ Description
Queue Profile ID

Identificateur unique pour nommer le profil (nom logique)

Full Queue Name

Nom réel de la file d'attente WebSphere MQ

Queue Manager Name

Nom réel du gestionnaire de files d'attente WebSphere MQ

Description

Toute chaîne identifiant l'objectif du profil

Maximum Length

Longueur maximale autorisée du message pour la file d'attente en fonction de la configuration dans WebSphere MQ

Destructive Reads

Si cette propriété est sélectionnée, elle peut obliger WebSphere Data Interchange à supprimer le message de la file d'attente WebSphere MQ à la lecture.

Syncpoint Control

Lorsque cette propriété est sélectionnée, la lecture et l'écriture des messages en file d'attente est sous contrôle du point de synchronisation. Si le contrôle du point de synchronisation est activé, les modifications apportées à une file d'attente de messages ne s'appliquent pas tant que WebSphere Data Interchange n'émet aucun point de synchronisation.

Dans la mesure où vous utilisez ' les files d'attente WebSphere MQ, vous avez besoin d'un profil de file d'attente MQSeries dans WebSphere Data Interchange pour chaque file d'attente. Dans tous les cas, vous devez créer quatre profils de file d'attente MQSeries, un pour chaque file d'attente WebSphere MQ utilisée dans le flux de messages. A partir de la zone d'installation de WebSphere Data Interchange Client, procédez comme suit :

  1. Créez un profil de file d'attente MQSeries pour XML_IN_A et EDI_OU_A.

    Le Tableau 94 répertorie les paramètres réels spécifiés dans chaque profil de file d'attente MQSeries créé. Les files d'attente représentées ici sont utilisées avec la conversion XML en EDI.

    Tableau 94. Profil de file d'attente MQSeries pour XML_IN_A et EDI_OU_A
    Propriété de file d'attente Valeur pour XML_IN_A Valeur pour EDI_OU_A
    Queue Profile ID XML_IN_A EDI_OU_A
    Full Queue Name XML_IN_A EDI_OUT_A
    Queue Manager Name WDI32_QM WDI32_QM
    Destructive Reads

    A vérifier

    A vérifier

    Syncpoint Control

    A vérifier

    A vérifier

    Remarque :
    La propriété Queue Profile ID est limitée à huit caractères uniquement. Il faut donc renommer le profile ID de la file d'attente EDI_OUT_A par EDI_OU_A. Toutes les références à la file d'attente WebSphere MQ EDI_OUT_A dans WebSphere Data Interchange utilisent le nom EDI_OU_A.
  2. Créez un profil de file d'attente MQSeries pour EDI_IN_A et XML_OU_A. Le Tableau 95 définit les propriétés de chaque file d'attente utilisée lors de la conversion EDI en XML.

    Tableau 95. Profil de file d'attente MQSeries pour EDI_IN_A et XML_OU_A
    Propriété de file d'attente Valeur pour EDI_IN_A Valeur pour XML_OU_A
    Queue Profile ID EDI_IN_A XML_OU_A
    Full Queue Name EDI_IN_A XML_OUT_A
    Queue Manager Name WDI32_QM WDI32_QM
    Destructive Reads

    A vérifier

    A vérifier

    Syncpoint Control

    A vérifier

    A vérifier

Profil de réseau

Les profils de réseau définissent pour WebSphere Data Interchange les caractéristiques des réseaux utilisés pour les communications avec les partenaires d'échanges. Pour ce scénario, vous devez créer et configurer un profil de réseau qui communique avec les files d'attente WebSphere MQ créées précédemment.

Le Tableau 96 indique les propriétés à configurer pour chaque profil de réseau.

Tableau 96. Propriétés dans un profil de réseau
Propriété de réseau Description
Network ID

Identificateur unique pour nommer le profil

Communication Routine

Nom du programme qui génère les commandes réseau et appelle le programme réseau afin qu'il traite les commandes

Network Program

Programme appelé par la routine de communication pour le traitement des requêtes

Network Parameters

Paramètres requis par le programme réseau

Pour cet exemple de scénario, vous devez créer et configurer un profil de réseau qui communique avec les files d'attente WebSphere MQ créées précédemment (voir Profile de file d'attente MQSeries), comme suit :

  1. Créez un nouveau profil de réseau appelé WBIC_IN.

    Ce profil de réseau est utilisé dans le scénario de conversion XML en EDI. Le Tableau 97 répertorie les paramètres réels spécifiés pour ce WBIC_IN.

    Tableau 97. Profil de réseau pour WBIC_IN
    Propriété de réseau Valeur pour le profil WBIC_IN
    Network ID WBIC_IN
    Communication Routine VANIMQ
    Network Program EDIMQSR
    Network Parameters SENDMQ=EDI_OU_A RECEIVEMQ=XML_IN_A

  2. Créez un second profil de réseau appelé WBIC_OUT.

    Ce profil de réseau est utilisé dans la conversion de messages EDI reçus de WebSphere Business Integration Connect, Edition enterprise. Un second profil de réseau est requis car WebSphere Business Integration Connect, Edition Enterprise place les messages dans les files d'attente WebSphere MQ qui contiennent des en-têtes RFH2.Le Tableau 98 répertorie les propriétés spécifiées pour ce WBIC_OUT.

    Tableau 98. Profil de réseau pour WBIC_OUT
    Propriété de réseau Valeur pour le profil WBIC_OUT
    Network ID WBIC_OUT
    Communication Routine VANIMQ
    Network Program EDIRFH2
    Network Parameters SENDMQ=XML_OU_A RECEIVEMQ=EDI_IN_A

Profil de boîte aux lettres

Les profils de boîte aux lettres contiennent les informations dont WebSphere Data Interchange a besoin pour identifier les personnes et les groupes de votre organisation qui reçoivent des documents à convertir. Le Tableau 99 indique les propriétés à configurer pour chaque profil de boîte aux lettres.

Tableau 99. Propriétés dans un profil de boîte aux lettres
Propriété de boîte aux lettres Description
Mailbox ID

Identificateur unique pour nommer le profil

Network ID

ID réseau du profil de réseau créé précédemment

Vous devez créer des profils de boîtes aux lettres pour chaque file d'attente WebSphere MQ afin d'identifier les personnes et les groupes de votre organisation, comme suit :

  1. Créez un profil de boîte aux lettres pour chaque file d'attente WebSphere MQ utilisée.

    Les paramètres réels utilisés dans chaque profil de boîte aux lettres sont indiqués dans le Tableau 100.

    Tableau 100. Profils de boîte aux lettres pour XML_IN_A et EDI_OU_A
    Propriété de boîte aux lettres Valeur pour XML_IN_A Valeur pour EDI_OU_A
    Mailbox ID XML_IN_A EDI_OU_A
    Network ID WBIC_IN WBIC_IN
    Receive File XML_IN_A EDI_OU_A

  2. Créez une seconde paire de boîtes aux lettres.

    Le Tableau 101 répertorie les propriétés spécifiées pour ces composants.

    Tableau 101. Profils de boîte aux lettres pour EDI_IN_A et XML_OU_A
    Propriété de boîte aux lettres Valeur pour EDI_IN_A Valeur pour XML_OU_A
    Mailbox ID EDI_IN_A XML_OU_A
    Network ID WBIC_OUT WBIC_OUT
    Receive File EDI_IN_A XML_OU_A

Profil de service

L'objectif des profils de service est de vous permettre d'entrer une commande d'utilitaire et de définir tous les fichiers qui seront utilisés au cours de l'exécution de cette commande.

Pour l'exemple de scénario, suivre les étapes suivantes :

  1. Créez un profil de service pour XML_IN_A. Les propriétés à définir sous l'onglet Général sont les suivantes :

    Le Tableau 102 répertorie les propriétés des fichiers communs.

    Tableau 102. Fichiers communs pour XML_IN_A
    Propriété des fichiers communs Valeur

    Fichier de suivi

    ..\trk\xml_in.trk

    Fichier d'exception

    ..\xex\xml_in.xex

    Fichier de travail

    ..\wrk\xml_in.wrk

    Fichier de rapport

    ..\rpt\xml_in.rpt

    Fichier de requête

    ..\qry\xml_in.qry

  2. Entrez ce qui suit dans l'onglet Output Files :
  3. Créez un second profil de service pour EDI_IN_A. Les propriétés à définir sous l'onglet Général sont les suivantes :

    Le Tableau 103 répertorie les propriétés des fichiers communs.

    Tableau 103. Fichiers communs pour EDI_IN_A
    Propriété des fichiers communs Valeur

    Fichier de suivi

    ..\trk\edi_in.trk

    Fichier d'exception

    ..\xex\edi_in.xex

    Fichier de travail

    ..\wrk\edi_in.wrk

    Fichier de rapport

    ..\rpt\edi_in.rpt

    Fichier de requête

    ..\qry\edi_in.qry

  4. Entrez les informations suivantes dans l'onglet Output Files :
    Remarque :
    Le nom XML_OU_A est utilisé au lieu du nom XML_OUT_A en raison des restrictions de longueur de caractère. Cette restriction a été exclue du CSD10 de WebSphere Interchange Server.

Importation et compilation de mappes de transformation de données

Après avoir créer les profils, comme indiqué dans les section précédentes, vous pouvez importer n'importe quelle mappe nécessaire à la transformation de vos données. Vous pouvez ensuite compiler les mappes de transformation et définir une règle pour chacune d'elle. Pour réaliser ces tâches, vous devez utiliser WebSphere Data Interchange Client. Pour plus d'informations, voir la documentation de WebSphere Data Interchange.

Configuration de l'environnement JMS

Comme indiqué précédemment dans ce chapitre, WebSphere Business Integration Connect, Edition Enterprise, utilise l'implémentation WebSphere MQ de JMS pour l'intégration à WebSphere Data Interchange.

Remarque :
Vous pouvez également utiliser LDAP ou WebSphere Application Server en tant que fournisseur JNDI.

Cette section indique les étapes de la création d'un environnement JMS sur la machine B :

Les classes WebSphere MQ pour Java et les classes WebSphere MQ pour JMS sont générées dans WebSphere MQ pour Windows version 5.3.

Configuration de JMSAdmin

Utilisez l'outil JMSAdmin disponible dans WebSphere MQ pour créer les objets JMS dans JNDI. Pour plus d'informations sur la création du fichier de configuration par défaut appelé JMSAdmin.config, voir Annexe A, Configuration d'un protocole JMS avec WebSphere MQ.

Pour créer les objets JMS pour ce référentiel :

  1. Pour utiliser un fournisseur JNDI basé sur les fichiers, vous devez veiller à ce que le fichier JMSAdmin.config contient les lignes indiquées ci-dessous :
    INITIAL_CONTEXT_FACTORY=com.sun.jndi.fscontext.RefFSContextFactory
     PROVIDER_URL=file:/opt/mqm/java/JNDI
     
  2. Si le répertoire JNDI n'existe pas déjà, créez-le sous le répertoire suivant :
    /opt/mqm/java/bin
     

Avant d'appeler l'outil JMSAdmin, vous devez veiller à ce que votre variable CLASSPATH contienne les entrées suivantes :

/opt/mqm/java/lib/jms.jar
 /opt/mqm/java/lib/com.ibm.mq.jar
 /opt/mqm/java/lib/com.ibm.mqjms.jar
 /opt/mqm/java/lib/jta.jar
 /opt/mqm/java/lib/connector.jar
 /opt/mqm/java/lib/jndi.jar
 /opt/mqm/java/lib/providerutil.jar
 /opt/mqm/java/lib/fscontext.jar
 

Remarque : Les entrées ci-dessus, associées à Linux, supposent que vous utilisez un fournisseur JNDI basé sur les fichiers.

Création d'objets JMS

Pour créer les objets JMS requis, vous devez utiliser l'outil JMSAdmin. Pour l'exemple de scénario, procédez comme suit :

  1. Définissez un nouveau contexte :
    DEF CTX(WdiJms)
     
  2. Accédez au nouveau contexte :
    CHG CTX(WdiJms)
     
  3. Définissez une fabrique de connexion de file d''attente :
    DEF QCF(WBIC42_QM_QCF)TRAN(CLIENT)HOST(IP_MACHINE_B)
     PORT(9999)CHAN(java.channel)QMANAGER(WBIC42_QM)
     
  4. Définissez la file d'attente EDI_IN_B :
    DEF Q(EDI_IN_B)QMANAGER(WBIC42_QM)QUEUE(EDI_IN_B)
     
  5. Définissez la file d'attente EDI_OUT_B :
    DEF Q(EDI_OUT_B)QMANAGER(WBIC42_QM)QUEUE(EDI_OUT_B)
     
  6. Quittez la session JMSAdmin :
    END
     

Configuration de Business Integration Connect, Edition Enterprise

WebSphere Business Integration Connect correspond à la couche de communication entre les divers participants de communauté et les processus internes. Lors de la configuration de Business Integration Connect pour l'utilisation de documents EDI, vous pouvez faire en sorte qu'il procède aux opérations suivantes :

Le Guide de configuration du concentrateur fournit des informations complètes sur la configuration de WebSphere Business Integration Connect, Editions Enterprise et Advanced. Cette section fournit un exemple de la configuration de WebSphere Business Integration Connect Enterprise Edition décrite dans l'exemple de scénario. Elle décrit les étapes suivantes :

  1. Création des participants
  2. Configuration des prestataires B2B
  3. Création d'une passerelle
  4. Définition des définitions du flot de documents et interactions
  5. Création d'une connexion du participant
  6. Création d'une cible

Remarque :
Pour des informations générales sur la manière de configurer WebSphere Business Integration Connect - Express, voir Configuration de Business Integration Connect - Express.

Création des participants

Un profil de participant identifie les sociétés du système. Vous pouvez créer des participants (Partenaires numéro Un et Deux) dans la Console de communauté de WebSphere Business Integration Connect, Edition Enterprise.

Créer un participant (Partenaire numéro Un)

créer un profil de participant pour représenter les machines A et B, qui correspondent aux deux systèmes appartenant au Partenaire numéro un.

Pour créer ce profil participant, procédez comme suit :

  1. Ouvrez la Console de communauté de WebSphere Business Integration Connect.
  2. Ouvrez une session en tant que Opérateur de concentrateur.
  3. Vérifiez que la case Profils est déjà sélectionnée dans le menu Administrateur du compte.
  4. Cliquez sur Créer et entrez les informations comme indiqué dans le Tableau 104 ci-dessous.

    Tableau 104. Propriétés du participant (Partenaire numéro Un)
    Nom de zone Valeur

    Nom de connexion du participant

    partnerOne

    Nom du participant

    Partenaire numéro Un

    Type de participant

    Gestionnaire de communauté

    Etat

    Activé

    Type de fournisseur

    Autre

    Site Web

    http://IP_MACHINE_A

    IP_MACHINE_A représente l'adresse IP de la machine A

    Type d'ID métier

    A format libre

    Identificateur d'ID métier

    123456789

    Type de passerelle de l'adresse IP

    Production

    Adresse IP

    IP_MACHINE_A

    IP_MACHINE_A représente l'adresse IP de la machine A

    Remarque : Pour créer le type d'ID métier et l'identificateur de l'ID métier, vous devez d'abord cliquer sur le bouton Nouveau sous l'ID métier. L'ID métier doit être unique. De la même manière, pour indiquer d'autres informations associées à l'adresse IP, vous devez cliquer sur le bouton Nouveau sous l'en-tête Adresse IP.

  5. Cliquez sur Sauvegarder.

WebSphere Business Integration Connect, Edition Enterprise, utilise la propriété Identificateur de l'ID métier (définie dans le Tableau 104) afin d'identifier l'expéditeur ou le destinataire d'un document. Lorsqu'une transaction ANSI X12 EDI est reçue, les données de l'expéditeur et du destinataire Interchange sont lues pour déterminer la source et la cible de la transaction.

Important:
Notez le mot de passe de l'administrateur pour le partenaire numéro Un, vous en aurez besoin plus tard. Lorsque vous ouvrirez une session sur la Console de communauté en tant que Partenaire numéro Un, il vous sera demandé de saisir ce mot de passe puis de le modifier.

Créer un participant (Partenaire numéro Deux)

créer un participant de communauté pour représenter le Partenaire numéro Deux. Pour créer ce participant, procédez comme suit :

  1. Cliquez sur Administrateur du compte dans le menu principal puis sur Profils dans la barre d'exploration horizontale.
  2. Cliquez sur Créer.
  3. Entrez les valeurs indiquées dans le Tableau 105 ci-dessous.

    Tableau 105. Propriétés du participant (Partenaire numéro Deux)
    Nom de zone Valeur

    Nom de connexion du participant

    partnerTwo

    Nom du participant

    Partenaire numéro Deux

    Type de participant

    Participant de communauté

    Etat

    Activé

    Type de fournisseur

    Autre

    Site Web

    http://IP_MACHINE_C

    IP_MACHINE_C représente l'adresse IP de la machine C

    Type d'ID métier

    A format libre

    Identificateur d'ID métier

    987654321

    Type de passerelle de l'adresse IP

    Production

    Adresse IP

    IP_MACHINE_C

    IP_MACHINE_C représente l'adresse IP de la machine C

  4. Cliquez sur Sauvegarder.
Important:
Notez le mot de passe de l'administrateur pour le partenaire numéro Deux, vous en aurez besoin plus tard. Lorsque vous ouvrirez une session sur la Console de communauté en tant que Partenaire numéro Deux, il vous sera demandé de saisir ce mot de passe puis de le modifier.

Configuration des prestataires B2B

Vous pouvez définir les prestataires B2B de chaque participant dans WebSphere Business Integration Connect, Edition Enterprise via la Console de communauté. Une fois les prestataires B2B définis pour les participants, vous pouvez établir une définition du flot de documents utilisé pour prendre en charge des types de collaboration métier spécifiques entre les participants.

Définition des prestataires B2B du Partenaire numéro Un

Pour définir les prestataires B2B du Partenaire numéro Un, procédez comme suit :

  1. Cliquez sur Administrateur du compte dans le menu principal puis sur Profils dans la barre d'exploration horizontale.
  2. Cliquez sur Rechercher pour afficher la liste de tous les participants définis dans le système.
  3. Cliquez sur l'icône en regard de Partenaire numéro Un, puis cliquez sur Prestataires B2B.

Pour activer les prestataires B2B, il suffit de cliquer sur l'icône . Pour les besoins de cet exemple, seuls les prestataires B2B requis pour l'implémentation du scénario seront configurés.

Pour définir le regroupement source et cible de Partenaire numéro Un sur Aucun, procédez comme suit :

  1. Cliquez sur l'icône sous Définition de la source pour le regroupement : Aucun pour l'activer. Répétez cette opération avec Définition de la cible.
  2. Cliquez sur l'icône pour passer au niveau inférieur.
  3. Cliquez sur l'icône pour Protocole: EDI-X12 (ALL) pour la source et la cible.
  4. Cliquez sur l'icône .
  5. Cliquez sur l'icône pour Flot de documents : Tous pour la source et la cible.

Définition des prestataires B2B pour Partenaire numéro Deux

Pour définir les prestataires B2B du Partenaire numéro Deux, procédez comme suit :

  1. Cliquez sur Administrateur du compte dans le menu principal puis sur Profils dans la barre d'exploration horizontale.
  2. Cliquez sur Rechercher pour afficher la liste de tous les participants définis dans le système.
  3. Cliquez sur l'icône en regard de Partenaire Numéro Deux, puis cliquez sur Prestataires B2B.

Pour définir le regroupement source et cible de Partenaire numéro Deux sur AS, procédez comme suit :

  1. Cliquez sur l'icône sous Définition de la source pour le regroupement : AS pour l'activer. Répétez cette opération avec Définition de la cible.
  2. Cliquez sur l'icône pour passer au niveau inférieur.
  3. Cliquez sur l'icône pour Protocole: EDI-X12 (ALL) pour la source et la cible.
  4. Cliquez sur l'icône .
  5. Cliquez sur l'icône pour Flot de documents : Tous pour la source et la cible.

Ensuite, vous pouvez mettre à jour la définition AS du Partenaire numéro Deux pour vous assurer que les notifications de disponibilité de messages (MDN) pour AS2 envoyés au Partenaire numéro Deux sont renvoyés à l'adresse appropriée, comme suit :

  1. Cliquez sur l'icône Edition ( ).
  2. Entrez une adresse de courrier électronique AS MDN.

    Il s'agit de l'adresse utilisée pour recevoir les MDN pour AS1.

  3. Entrez un URL HTTP AS MDN :
    http://IP_MACHINE_B:PORT/bcgreceiver/submit
     

    Remarque :
    Notez que l'URL défini pour AS2 utilise les mêmes paramètres que ceux qui seront définis pour la cible AS2 ultérieurement dans ce chapitre.

Création d'une passerelle

Dans Business Integration Connect, une passerelle définit un point du réseau qui permet l'entrée sur un autre réseau. La passerelle contient les informations indiquant à WebSphere Business Integration Connect comment faire parvenir les documents à la couche EAI (Enterprise Application Integration).

Création d'une passerelle pour Partenaire numéro Un

Le Partenaire numéro Deux envoie un document EDI au Partenaire numéro Un via le protocole AS2. La passerelle du Partenaire numéro Un est utilisée pour envoyer le document EDI reçu via AS2 à une file d'attente JMS et enfin à WebSphere Data Interchange pour la conversion.

Pour créer une nouvelle passerelle pour le Partenaire numéro Un, procédez comme suit :

  1. Cliquez sur Administrateur du compte dans le menu principal puis sur Profils dans la barre d'exploration horizontale.
  2. Cliquez sur Rechercher.
  3. Sélectionnez le Partenaire numéro Un en cliquant sur l'icône , puis sélectionnez Passerelles.
  4. Cliquez sur Créer pour créer une passerelle pour Partenaire numéro Un.
  5. Entrez les valeurs de cette nouvelle passerelle comme indiqué dans le Tableau 106.

    Tableau 106. Propriétés de la passerelle de Partenaire numéro Un
    Nom de zone Valeur

    Nom de la passerelle

    JMStoPartnerOne

    Transfert

    JMS

    Identificateur URI de la cible

    file:///opt/mqm/java/JNDI/WdiJms

    Nom de la fabrique JMS

    WBIC42_QM_QCF

    Classe de message JMS

    TextMessage

    Type de message JMS

    TextMessage

    Nom de file d'attente JMS

    EDI_OUT_B

    Nom de la fabrique du JNDI du JMS

    com.sun.jndi.fscontext.RefFSContextFactory

  6. Cliquez sur Sauvegarder.

Pour définir la passerelle JMStoPartnerOne en tant que passerelle par défaut pour le Partenaire numéro Un, procédez comme suit :

  1. Cliquez sur Afficher les passerelles par défaut.
  2. Dans la liste Production, sélectionnez JMS2toPartnerOne.
  3. Cliquez sur Sauvegarder.
Remarque :
Une passerelle JMS peut être définie uniquement pour le Gestionnaire de communauté (Partenaire numéro Un dans cet exemple de scénario).

Création d'une passerelle pour Partenaire numéro Deux

Le Partenaire numéro Un envoie un document EDI à WebSphere Business Integration Connect, Edition Enterprise, sur une file d'attente JMS. La passerelle du Partenaire numéro Deux est utilisée pour envoyer le document EDI reçu au Partenaire Deux via AS2.

Pour créer une nouvelle passerelle pour le Partenaire numéro Deux, procédez comme suit :

  1. Cliquez sur Administrateur du compte dans le menu principal puis sur Profils dans la barre d'exploration horizontale.
  2. Cliquez sur Rechercher.
  3. Sélectionnez le Partenaire numéro Deux en cliquant sur l'icône , puis sélectionnez Passerelles.
  4. Cliquez sur Créer pour créer une passerelle pour Partenaire numéro Deux.
  5. Entrez les valeurs de cette passerelle comme indiqué dans le Tableau 107.

    Tableau 107. Propriétés de la passerelle de Partenaire numéro Deux

    Nom de la passerelle

    AS2toPartnerTwo

    Transfert

    HTTP/1.1

    Identificateur URI de la cible

    http://IP_MACHINE_C/input/AS2

    Nom d'utilisateur

    partnerOne

    Mot de passe

    partnerOne

  6. Cliquez sur Sauvegarder.
    Remarque :
    Les propriétés Nom d'utilisateur et Mot de passe indiquées ci-dessus concerne la méthode de mappage du participant entrant pour HTTP telle qu'elle est définie dans WebSphere Business Integration Connect - Express.

    Vous trouverez un exemple de définition de ces propriétés dans WebSphere Business Integration Connect - Express, voir Configuration de Business Integration Connect, Edition Enterprise.

    Notez que la passerelle AS2toPartnerTwo est en ligne et que son état est Activé.

Pour définir la passerelle AS2toPartnerTwo en tant que passerelle par défaut pour le Partenaire numéro Deux, procédez comme suit :

  1. Cliquez sur Afficher les passerelles par défaut.
  2. Dans la liste Production, sélectionnez AS2toPartnerTwo.
  3. Cliquez sur Sauvegarder.

Définition des définitions du flot de documents et interactions

Une définition du flot de documents est un ensemble de "méta-informations" qui définit les prestataires de traitement des documents du participant. Pour permettre au système de traiter un document métier, deux définitions du flot de documents ou plus doivent être liées pour créer une interaction.

Pour créer une définition du flot de documents et une interaction valide entre le Partenaire numéro Un et le Partenaire numéro Deux, procédez comme suit :

  1. Cliquez sur Administrateur du concentrateur dans le menu principal puis sur Définition du flot de documents dans la barre d'exploration horizontale.
  2. Cliquez sur Gestion des interactions puis sur Créer une interaction valide.
  3. Dans la colonne Source, sélectionnez :
    1. Regroupement : Aucun
    2. Protocole : EDI-X12
    3. Flot de documents : Tout
  4. Dans la colonne Cible, sélectionnez :
    1. Regroupement : AS
    2. Protocole : EDI-X12
    3. Flot de documents : Tout
  5. Affectez à Action la valeur Passe-système.
  6. Cliquez sur Sauvegarder.
  7. Cliquez de nouveau sur Créer une interaction valide.
  8. Dans la colonne Source, sélectionnez :
    1. Regroupement : AS
    2. Protocole : EDI-X12
    3. Flot de documents : Tout
  9. Dans la colonne Cible, sélectionnez :
    1. Regroupement : Aucun
    2. Protocole : EDI-X12
    3. Flot de documents : Tout
  10. Affectez à Action la valeur Passe-système.
  11. Cliquez sur Sauvegarder.

Création d'une connexion du participant

Les connexions du participant correspondent au mécanisme qui active le système pour le traitement et l'acheminement des documents entre le Gestionnaire de communauté et ses divers participants. Les connexions contiennent les informations nécessaires à l'échange approprié de chaque flot de documents.

Pour créer une connexion du participant entre le Partenaire numéro Un et le Partenaire numéro Deux, procédez comme suit :

  1. Cliquez sur Administrateur du compte dans le menu principal puis sur Connexions du participant dans la barre d'exploration horizontale.
  2. Dans la liste Source, sélectionnez Partenaire numéro Un.
  3. Dans la liste Cible, sélectionnez Partenaire numéro Deux.
  4. Cliquez sur Rechercher.
  5. Activez la connexion du participant affichée ci-dessous en cliquant sur le bouton Activation. Les prestataires B2B indiqués dans le Tableau 108 doivent s'afficher.

    Tableau 108. Activation de la connexion du participant Partenaire Un-vers-Partenaire Deux
    Type de flot de documents Source Cible

    Regroupement

    Aucun (N/D)

    AS (N/D)

    Protocole

    EDI-X12 (ALL)

    EDI-X12 (ALL)

    Flot de documents

    ALL (ALL)

    ALL (ALL)

Pour créer une connexion du participant dans laquelle le Partenaire numéro Deux est la source et le Partenaire numéro Un est la cible, procédez comme suit :

  1. Cliquez sur Administrateur du compte dans le menu principal puis sur Connexions du participant dans la barre d'exploration horizontale.
  2. Dans la liste Source, sélectionnez Partenaire numéro Deux.
  3. Dans la liste Cible, sélectionnez Partenaire numéro Un.
  4. Cliquez sur Rechercher.
  5. Activez la connexion à l'aide des informations dans le Tableau 109.

    Tableau 109. Activation de la connexion du participant Partenaire Deux-vers-Partenaire Un
    Type de flot de documents Source Cible

    Regroupement

    AS (N/D)

    Aucun (N/D)

    Protocole

    EDI-X12 (ALL)

    EDI-X12 (ALL)

    Flot de documents

    ALL (ALL)

    ALL (ALL)

Création d'une cible

L'écran Liste cible fournit des informations d'emplacement qui permettent au Gestionnaire de documents Business Integration Connect d'extraire les documents depuis l'emplacement système approprié en fonction du type de transfert du document entrant. Vous pouvez créer des configurations de cibles distinctes en fonction du type de transfert. Le Gestionnaire de documents peut ensuite interroger les emplacements du référentiel de documents de plusieurs serveurs de messagerie Web, FTP et POP, notamment les répertoires internes et les files d'attente, pour les documents entrants.

Une fois le document extrait par le Gestionnaire de documents de l'emplacement correspondant à une cible prédéfinie, l'infrastructure d'acheminement peut traiter le document en fonction de la configuration de canal.

Pour recevoir une transaction EDI depuis WebSphere Data Interchange, vous devez créer une nouvelle cible JMS en procédant comme suit :

  1. Cliquez sur Administrateur du concentrateur dans le menu de niveau supérieur.
  2. Cliquez sur Cibles dans le menu de niveau inférieur, puis cliquez sur Créer.
  3. Affectez les propriétés indiquées dans le Tableau 110.

    Tableau 110. Propriétés de la cible pour la réception sur JMS
    Propriété de la cible Valeur

    Nom de la cible

    WdiJmsListener

    Transfert

    JMS

    Type de passerelle

    Production

    URL du fournisseur JMS

    file:///opt/mqm/java/JNDI/WdiJms

    Nom de file d'attente JMS

    EDI_IN_B

    Nom de la fabrique JMS

    WBIC42_QM_QCF

    Nom de la fabrique JNDI

    com.sun.jndi.fscontext.RefFSContextFactory

Une seconde cible est requise pour la réception du document EDI provenant de Partenaire numéro Deux via AS2. Pour la création de cette cible, procéder comme suit :

  1. Cliquez sur Administrateur du concentrateur dans le menu de niveau supérieur.
  2. Cliquez sur Cibles dans le menu de niveau inférieur, puis cliquez sur Créer.
  3. Affectez les propriétés indiquées dans le Tableau 111 ci-dessous :

    Tableau 111. Propriétés de la cible pour la réception via AS2

    Nom de la cible

    WbicAS2Listener

    Transfert

    HTTP/S

    Type de passerelle

    Production

    Identificateur URI

    /bcgreceiver/submit

    Remarque :
    L'URI de réception du protocole HTTP/S doit toujours commencer par /bcgreceiver

  4. Cliquez sur Sauvegarder.

Copyright IBM Corp. 1997, 2004