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 WebSphere Partner Gateway :

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 WebSphere Partner Gateway. 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 ordinateurs A et B. La première étape consiste ici à créer un gestionnaire de files d'attente sur chacun des ordinateurs A et B pour l'utiliser avec WebSphere Data Interchange et WebSphere Partner Gateway 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 ordinateurs 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 ordinateur.

Le tableau 73 répertorie les objets que vous devez créer pour configurer les ordinateurs A et B en tant que récepteur et émetteur.

Tableau 73. Objets WebSphere MQ à créer
Objet MQ WebSphere Ordinateur A Ordinateur B

Gestionnaire de files d'attente

WDI32_QM

HUB_QM

Canal émetteur

TO.HUB60

TO.WDI32

Canal récepteur

TO.WDI32

TO.HUB60

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 30 illustre le flux de messages entre l'ordinateur A et l'ordinateur B en indiquant le rôle des objets WebSphere MQ répertoriés dans le tableau 73.

Figure 30. Flux de messages entre l'ordinateur A et l'ordinateur B
Cette figure montre les files d'attente configurée pour les documents reçus et envoyés de WebSphere Data Interchange ainsi que les files d'attente configurées pour le document reçu et envoyé de WebSphere Partner Gateway.

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 Partner Gateway Enterprise Edition 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.

Profil 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 74 indique les propriétés à configurer pour chaque profil.

Tableau 74. 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 75 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 75. 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 76 définit les propriétés de chaque file d'attente utilisée lors de la conversion EDI en XML.
    Tableau 76. 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 77 indique les propriétés à configurer pour chaque profil de réseau.

Tableau 77. 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 Profil de file d'attente MQSeries), comme suit :

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

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

    Tableau 78. Profil de réseau pour HUB_IN
    Propriété de réseau Valeur du profil HUB_IN
    Network ID HUB_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é HUB_OUT.

    Ce profil de réseau est utilisé dans la conversion de messages EDI reçus de WebSphere Partner Gateway Enterprise Edition. Un second profil de réseau est requis car WebSphere Partner Gateway Enterprise Edition place les messages dans les files d'attente WebSphere MQ qui contiennent des en-têtes RFH2. Le tableau 79 répertorie les propriétés spécifiées pour ce HUB_OUT.

    Tableau 79. Profil de réseau pour HUB_OUT
    Propriété de réseau Valeur du profil HUB_OUT
    Network ID HUB_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 80 indique les propriétés à configurer pour chaque profil de boîte aux lettres.

Tableau 80. 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 81.

    Tableau 81. 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 HUB_IN HUB_IN
    Receive File XML_IN_A EDI_OU_A
  2. Créez une seconde paire de boîtes aux lettres.

    Le tableau 82 répertorie les propriétés spécifiées pour ces composants.

    Tableau 82. 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 HUB_OUT HUB_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 83 répertorie les propriétés des fichiers communs.

    Tableau 83. 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 84 répertorie les propriétés des fichiers communs.

    Tableau 84. 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 Partner Gateway Enterprise Edition 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 l'ordinateur 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 le mode de création du fichier de configuration par défaut JMSAdmin.config, voir le Guide de configuration du concentrateur.

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(HUB60_QM_QCF) TRAN(CLIENT) HOST(IP_COMPUTER_B)
     PORT(9999) CHAN(java.channel) QMANAGER(HUB60_QM)
  4. Définissez la file d'attente EDI_IN_B :
    DEF Q(EDI_IN_B) QMANAGER(HUB60_QM) QUEUE(EDI_IN_B)
  5. Définissez la file d'attente EDI_OUT_B :
    DEF Q(EDI_OUT_B) QMANAGER(HUB60_QM) QUEUE(EDI_OUT_B)
  6. Quittez la session JMSAdmin :
    END

Configuration de WebSphere Partner Gateway Enterprise Edition

WebSphere Partner Gateway correspond à la couche de communication entre les divers participants de communauté et les processus internes. Lors de la configuration de WebSphere Partner Gateway 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 Partner Gateway Enterprise et Advanced Editions. Cette section fournit un exemple de la configuration de WebSphere Partner Gateway 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 d'interactions
  5. Création d'une connexion du participant
  6. Création d'une cible

Remarque : Pour plus d'informations sur la manière de configurer WebSphere Partner Gateway - Express, voir Configuration de WebSphere Partner Gateway - 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 Partner Gateway Enterprise Edition.

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

Créez un profil de participant pour représenter les ordinateurs 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 Partner Gateway.
  2. Ouvrez une session en tant que hubadmin (administrateur du 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 85 ci-dessous.
    Tableau 85. Propriétés du participant (Partenaire numéro Un)
    Nom de zone Valeur

    Nom de connexion de l'entreprise

    partnerOne

    Nom affiché du participant

    Partenaire numéro Un

    Type de participant

    Gestionnaire de communauté

    Etat

    Activé

    Type de fournisseur

    Autre

    Site Web

    http://IP_COMPUTER_A

    IP_COMPUTER_A représente l'adresse IP de l'ordinateur 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_COMPUTER_A

    IP_COMPUTER_A représente l'adresse IP de l'ordinateur 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 Partner Gateway Enterprise Edition utilise la propriété Identificateur de l'ID métier (définie dans le tableau 85) 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 86 ci-dessous.
    Tableau 86. Propriétés du participant (Partenaire numéro Deux)
    Nom de zone Valeur

    Nom de connexion de l'entreprise

    partnerTwo

    Nom affiché du participant

    Partenaire numéro Deux

    Type de participant

    Participant de communauté

    Etat

    Activé

    Type de fournisseur

    Autre

    Site Web

    http://IP_COMPUTER_C

    IP_COMPUTER_C représente l'adresse IP de l'ordinateur 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_COMPUTER_C

    IP_COMPUTER_C représente l'adresse IP de l'ordinateur 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 Partner Gateway Enterprise Edition 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 Afficher les détails 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 Le rôle est inactif. 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 Le rôle est inactif 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 Développer pour passer au niveau inférieur.
  3. Cliquez sur l'icône Le rôle est inactif pour Protocole : EDI-X12 (ALL) pour la source et la cible.
  4. Cliquez sur l'icône Développer.
  5. Cliquez sur l'icône Le rôle est inactif pour Flot de documents : ISA (ALL) 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 Afficher les détails 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 Le rôle est inactif sous Définition de la source pour Regroupement : AS pour l'activer. Répétez cette opération avec Définition de la cible.
  2. Cliquez sur l'icône Développer pour passer au niveau inférieur.
  3. Cliquez sur l'icône Le rôle est inactif pour Protocole : EDI-X12 (ALL) pour la source et la cible.
  4. Cliquez sur l'icône Développer.
  5. Cliquez sur l'icône Le rôle est inactif pour Flot de documents : ISA (ALL) 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_COMPUTER_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 WebSphere Partner Gateway, 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 Partner Gateway 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 Afficher les détails, 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 87.
    Tableau 87. 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

    HUB60_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.
Création d'une passerelle pour Partenaire numéro Deux

Le Partenaire numéro Un envoie un document EDI à WebSphere Partner Gateway Enterprise Edition, 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 Afficher les détails, 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 88.
    Tableau 88. 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_COMPUTER_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 concernent la méthode de mappage du participant entrant pour HTTP, telle qu'elle est définie dans WebSphere Partner Gateway - Express.

    Vous trouverez un exemple de définition de ces propriétés dans WebSphere Partner Gateway - Express, voir Configuration de WebSphere Partner Gateway - Express.

    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 d'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 interaction 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éation d'une interaction.
  3. Dans la colonne Source, sélectionnez :
    1. Regroupement : Aucun
    2. Protocole : EDI-X12 (ALL)
    3. Flot de documents : ISA (ALL)
  4. Dans la colonne Cible, sélectionnez :
    1. Regroupement : AS
    2. Protocole : EDI-X12 (ALL)
    3. Flot de documents : ISA (ALL)
  5. Affectez à Action la valeur Passe-système.
  6. Cliquez sur Sauvegarder.
  7. Cliquez de nouveau sur Création d'une interaction.
  8. Dans la colonne Source, sélectionnez :
    1. Regroupement : AS
    2. Protocole : EDI-X12 (ALL)
    3. Flot de documents : ISA (ALL)
  9. Dans la colonne Cible, sélectionnez :
    1. Regroupement : Aucun
    2. Protocole : EDI-X12 (ALL)
    3. Flot de documents : ISA (ALL)
  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 89 doivent s'afficher.
    Tableau 89. 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

    ISA (ALL)

    ISA (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 90.
    Tableau 90. 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

    ISA (ALL)

    ISA (ALL)

Création d'une cible

L'écran Liste cible fournit des informations d'emplacement qui permettent au Gestionnaire de documents WebSphere Partner Gateway 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 91.
    Tableau 91. 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

    HUB60_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 92 ci-dessous :
    Tableau 92. Propriétés de la cible pour la réception via AS2

    Nom de la cible

    HubAS2Listener

    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. 2003, 2005