Lorsque l'application dorsale et WebSphere Partner Gateway s'envoient des messages entre eux, chacun doit utiliser le même protocole de transfert des messages. Le protocole de transfert des messages définit le protocole de communication utilisé pour l'envoi des messages.
WebSphere Partner Gateway communique avec une application dorsale via son interface d'intégration dorsale. Le tableau 11 fournit la liste des protocoles de transfert compatibles avec l'interface d'Intégration dorsale.
Protocole de transfert | Pour plus d'informations |
---|---|
HTTP ou HTTPS | Protocole de transfert HTTP |
Fichiers de système de fichiers | Protocole de système de fichiers |
JMS | Protocole JMS |
Le tableau 12 indique les protocoles de transfert pris en charge pour les types de regroupement et les protocoles métiers lorsque le concentrateur envoie des documents au système dorsal.
Type de regroupement | Protocole métier | HTTP ou HTTPS ? | JMS ? | Système de fichiers ? |
---|---|---|---|---|
Intégration dorsale | RosettaNet (RNSC) | Oui | Oui | Non |
Binaire | Oui | Oui | Non | |
EDI (voir le tableau 14 pour plus d'informations sur EDI) | ||||
XML | Oui | Oui | Non | |
ROD | Oui | Oui | Non | |
Aucun | EDI (voir le tableau 14 pour plus d'informations sur EDI) | |||
cXML uniquement | Oui | Non | Non | |
SOAP uniquement | Oui | Non | Non | |
Binaire | Oui | Oui | Oui | |
XML | Oui | Oui | Oui | |
ROD | Oui | Oui | Oui |
Le tableau 13 indique les protocoles de transfert pris en charge pour les types de regroupement et les protocoles métiers lorsque le système dorsal envoie des documents au concentrateur.
Type de regroupement | Protocole métier | HTTP ou HTTPS ? | JMS ? | Système de fichiers ? |
---|---|---|---|---|
Intégration dorsale | RosettaNet (RNSC) | Oui | Oui | Non |
XML | Oui | Oui | Non | |
Binaire | Oui | Oui | Non | |
ROD | Oui | Oui | Non | |
Aucun | XML uniquement | Oui | Oui | Oui |
EDI (voir le tableau 14 pour plus d'informations sur EDI) | ||||
cXML uniquement | Oui | Non | Non | |
SOAP uniquement | Oui | Non | Non | |
Binaire uniquement | Non | Non | Non | |
ROD uniquement | Oui | Oui | Oui |
Le tableau 14 indique les protocoles de transfert et les types de regroupement pris en charge pour divers documents EDI, XML et ROD (Données orientées enregistrement).
Les tableaux précédents répertorient les protocoles de transfert valides entre le concentrateur et le système dorsal. Le concentrateur peut utiliser d'autres protocoles de transfert pour envoyer des documents aux participants et en recevoir de ces derniers. Par exemple, le concentrateur peut envoyer un document à un serveur FTP distant via le transfert de scriptFTP. Il peut également recevoir des documents via le transfert de script FTP. Le transfert de scripts FTP, décrit dans le guide de configuration du concentrateur, peut être utilisé pour envoyer et recevoir des documents via Internet mais il doit être utilisé pour envoyer et recevoir des documents depuis des réseaux à valeur ajoutée.
Pour envoyer des messages à l'aide d'un protocole HTTP, WebSphere Partner Gateway utilise HTTP/S 1.1. Pour recevoir des messages en provenance d'applications dorsales, WebSphere Partner Gateway prend en charge HTTP/S version 1.0 et 1.1.
Le message HTTP peut inclure des attributs de regroupement d'intégration. Ces attributs sont inclus dans ce message en fonction du type de regroupement associé à la connexion du participant, comme suit:
Les messages RosettaNet doivent utiliser le regroupement d'intégration dorsale.
Les messages SOAP et cXML ne doivent utiliser Aucun regroupement.
Lorsque de messages HTTP ou HTTPS sont envoyés entre WebSphere Partner Gateway et une application pour des échanges asynchrones, la procédure suivante se produit :
Lorsque l'échange est synchrone (par exemple, pour un document SOAP ou cXML), une réponse est renvoyée avec le message HTTP 200 dans la même connexion HTTP.
Pour envoyer un message à WebSphere Partner Gateway à l'aide du protocole HTTP, l'application dorsale effectue les opérations suivantes :
Le L'attribut Content-Type de l'en-tête du niveau de transfert fournit le codage utilisé pour le message.
Pour le regroupement d'intégration dorsale, l'application dorsale ajoute les attributs de l'en-tête du protocole requis par WebSphere Partner Gateway.
Pour activer ce type d'échange de message via HTTP, sur la page Détails Cible de la Console de Communauté, définir une Cible destinée aux documents entrants au niveau du concentrateur. Cette cible spécifie une URL. L'application dorsale doit connaître cette adresse pour envoyer des documents au concentrateur.
Pour recevoir un message de WebSphere Partner Gateway à l'aide du protocole HTTP, l'application dorsale effectue les opérations suivantes :
Pour activer ce type d'échange de message HTTP, utilisez la page de la passerelle de la Console de Communauté pour configurer une passerelle spécifiant l'emplacement auquel les documents doivent être transmis au système dorsal.
Le protocole JMS est basé sur le service JMS (Java Message Service) et transfère les messages par l'intermédiaire de files d'attente JMS transactionnelles et permanentes fournies, par exemple, par IBM WebSphere MQ. Le protocole JMS prend en charge les types de message JMS suivants :
Dans le protocole JMS, un système envoie un message JMS à un autre.Une fois que le second système reçoit le message, il le supprime de la file d'attente. A partir de ce moment, le système de réception peut traiter le messagede manière asynchrone.
Le message JMS peut inclure des attributs de regroupement d'intégration. Ces attributs sont inclus dans ce message en fonction du type de regroupement associé à la connexion du participant, comme suit:
A l'exception des messages binaires, WebSphere Partner Gateway prend en charge l'envoi et la réception des messages JMS utilisant n'importe quel type de regroupement. Les messages binaires reçus d'une application doivent utiliser le regroupement d'intégration dorsale. L'inverse n'est pas vrai car WebSphere Partner Gateway prend en charge l'envoi des messages binaires vers l'application au moyen de n'importe quel type de regroupement.
Pour configurer votre environnement JMS, les fournisseurs ci-après sont requis.
Un fournisseur JMS fournit l'implémentation du support d'API JMS pour la messagerie. WebSphere MQ est un exemple de fournisseur JMS ; il est utilisé dans les procédures décrites dans la présente documentation et dans celle de WebSphere Partner Gateway. Bien qu'il soit possible d'utiliser d'autres fournisseurs JMS, notez que WebSphere Partner Gateway a été testée uniquement avec WebSphere MQ. Notez aussi que WebSphere Partner Gateway ne prend pas en charge le fournisseur de messagerie par défaut WebSphere 6.0.
WebSphere MQ fournit le programme JMSAdmin, qui permet de construire des objets requis par JMS (la fabrique de connexion JMS et les objets de file d'attente JMS). Lorsque ces objets sont construits, les références à ceux-ci sont stockées dans JNDI.
Le fournisseur JNDI fournit l'implémentation de JNDI, qui est utilisé pour stocker les références aux objets JMS.
Pour qu'une application dorsale envoie des documents de gestion à WebSphere Partner Gateway via le protocole JMS, une cible JMS doit être configurée. La cible JMS reçoit des messages d'une file d'attente JMS et les documents sont introduits dans le flux de travaux WebSphere Partner Gateway. La configuration cible JMS inclut les paramètres requis pour l'accès àJNDI ainsi que les noms des objets JMS. A des fins d'intégration avec le système dorsal, la file d'attente configurée dans la cible JMS est celle depuis laquelle ce système envoie le message JMS.
De façon similaire, un passerelle JMS est utilisée par WebSphere Partner Gateway pour envoyer des documents de gestion à une file d'attente dans laquelle les participants s'attendent à les recevoir. Par conséquent, pour envoyer des messages au système dorsal, vérifiez qu'une passerelle JMS est configurée dans le profil du Gestionnaire de communauté. Cette passerelle doit être configurée pour effectuer des envois à la file d'attente sur laquelle le système dorsal reçoit les messages. La configuration de la passerelle JMS inclut les paramètres requis pour l'accès à JNDI ainsi que les noms des objets JMS.
Pour communiquer sur le protocole de transfert JMS, WebSphere Partner Gateway et l'application dorsale requièrent une file d'attente JMS pour chaque direction de la communication. Par conséquent, vous devez procéder aux opérations suivantes pour fournir les files d'attente JMS :
Le Le gestionnaire de file d'attente JMS peut se trouver sur n'importe quel ordinateur, y compris ceux cités ci-dessous :
De plus, un gestionnaire de files d'attente peut être installé à la fois sur l'ordinateur qui héberge l'application dorsale et l'ordinateur qui héberge WebSphere Partner Gateway. Dans ce cas, utiliser des canaux de configuration destinés à relier les deux gestionnaires de files d'attente entre eux. A l'aide de cette méthode, aucune connexion client n'est nécessaire sur le réseau.
Pour plus d'informations sur les instructions de configuration du mécanisme de protocole de transfert JMS via WebSphere MQ version 5.3, voir leGuide de configuration du concentrateur.
Pour envoyer un message à WebSphere Partner Gateway à l'aide du protocole JMS, l'application dorsale effectue les opérations suivantes :
Pour le regroupement d'intégration dorsale, l'application ajoute les attributs d'en-tête JMS requis.
Pour recevoir un message de WebSphere Partner Gateway à l'aide du protocole JMS, l'application dorsale effectue les opérations suivantes :
Le protocole de système de fichiers permet à WebSphere Partner Gateway d'envoyer des messages en les plaçant dans une arborescence de répertoires définie. WebSphere Partner Gateway reçoit des messages en les lisant à partir de l'arborescence de répertoires. Le protocole de système de fichiers prend en charge uniquement le type Aucun regroupement.
Pour envoyer un message à WebSphere Partner Gateway à l'aide du protocole de système de fichiers, l'application effectue les opérations suivantes :
Pour activer ce type d'échange de message via le système de fichiers, sur la page Détails Cible de la Console de Communauté, définir une Cible destinée aux documents entrants. La cible du message détermine le répertoire interrogé par WebSphere Partner Gateway. Lorsque vous créez une cible, WebSphere Partner Gateway crée un répertoire de stockage des documents et ses sous-répertoires pour la cible, comme suit :
<doc_root> Documents Production Test <other destination types>
WebSphere Partner Gateway interroge régulièrement les répertoires de stockage des documents et leurs sous-répertoires pour détecter les fichiers de messages. S'il trouve un message, WebSphere Partner Gateway le conserve puis le supprime du répertoire. WebSphere Partner Gateway traite ensuite le message normalement. Voir le Guide de configuration du concentrateur pour obtenir des informations sur la création d'une cible.
Pour recevoir des messages à l'aide du protocole de système de fichiers, l'application effectue les opérations suivantes :
Pour activer ce type d'échange de message via le système de fichiers, utiliser la page de la passerelle de la Console de Communauté pour configurer une passerelle spécifiant l'emplacement où les documents doivent être transmis. WebSphere Partner Gateway place le message dans le répertoire Documents défini par la passerelle. En définissant le répertoire de destination en fonction de la passerelle, chaque connexion de participant peut avoir un répertoire différent. Pour plus d'informations sur les passerelles, voir le Guide de configuration du concentrateur.