Effectuer les configurations et paramètrages suivants pour établir une communication entre WebSphere Data Interchange et WebSphere Partner Gateway :
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.
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.
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.
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.
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.
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.
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.
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 :
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.
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 |
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 |
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.
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 :
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.
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 |
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.
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 |
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.
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 :
Les paramètres réels utilisés dans chaque profil de boîte aux lettres sont indiqués dans le tableau 81.
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 |
Le tableau 82 répertorie les propriétés spécifiées pour ces composants.
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 |
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 :
PERFORM TRANSFORM WHERE INFILE(XML_IN_A) SYNTAX(X) OUTTYPE(MQ)OUTFILE(EDI_OU_A)
Le tableau 83 répertorie les propriétés des fichiers communs.
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 |
PERFORM TRANSFORM WHERE INFILE(EDI_IN_A) SYNTAX(E) OUTTYPE(MQ) OUTFILE(XML_OU_A)
Le tableau 84 répertorie les propriétés des fichiers communs.
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 |
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.
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.
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.
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 :
INITIAL_CONTEXT_FACTORY=com.sun.jndi.fscontext.RefFSContextFactory PROVIDER_URL=file:/opt/mqm/java/JNDI
/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.
Pour créer les objets JMS requis, vous devez utiliser l'outil JMSAdmin. Pour l'exemple de scénario, procédez comme suit :
DEF CTX(WdiJms)
CHG CTX(WdiJms)
DEF QCF(HUB60_QM_QCF) TRAN(CLIENT) HOST(IP_COMPUTER_B) PORT(9999) CHAN(java.channel) QMANAGER(HUB60_QM)
DEF Q(EDI_IN_B) QMANAGER(HUB60_QM) QUEUE(EDI_IN_B)
DEF Q(EDI_OUT_B) QMANAGER(HUB60_QM) QUEUE(EDI_OUT_B)
END
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 :
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é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 :
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 où 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 où 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.
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.
créer un participant de communauté pour représenter le Partenaire numéro Deux. Pour créer ce participant, procédez comme suit :
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 où 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 où IP_COMPUTER_C représente l'adresse IP de l'ordinateur C |
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.
Pour définir les prestataires B2B du Partenaire numéro Un, procédez comme suit :
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 :
Pour définir les prestataires B2B du Partenaire numéro Deux, procédez comme suit :
Pour définir le regroupement source et cible de Partenaire numéro Deux sur AS, procédez comme suit :
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 :
Il s'agit de l'adresse utilisée pour recevoir les MDN pour AS1.
http://IP_COMPUTER_B:PORT/bcgreceiver/submit
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).
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 :
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 |
Pour définir la passerelle JMStoPartnerOne en tant que passerelle par défaut pour le Partenaire numéro Un, procédez comme suit :
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 :
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 |
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 :
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 :
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 :
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 :
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) |
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 :
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 :