Quel transfert de message allez-vous utiliser ?

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.

Tableau 11. Protocoles de transfert compatibles avec l'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.

Tableau 12. Protocoles de transfert pris en charge depuis WebSphere Partner Gateway vers l'application dorsale
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.

Tableau 13. Protocoles de transfert pris en charge depuis une application dorsale vers WebSphere Partner Gateway
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).

Tableau 14. Protocoles de transfert pris en charge entre WebSphere Partner Gateway et le système dorsal pour EDI
Type de regroupement Document HTTP ou HTTPS JMS système de fichiers
Intégration dorsale Interchange simple contenant une seule transaction (telle qu'une transaction X12 850 dans une enveloppe) Oui Oui Non
Interchange simple contenant plusieurs transactions (telles qu'une transaction X12 850 et une transaction X12 890 dans la même enveloppe) Oui Oui Non
Plusieurs interchanges contenant une transaction (telles que deux enveloppes X12 dans le même fichier, contenant chacune une transaction) Oui Oui Non
Plusieurs interchanges contenant plusieurs transactions (telles que deux enveloppes X12 dans le même fichier, contenant chacune au moins deux transactions) Oui Oui Non
Transaction EDI (par exemple, une transaction X12 850), qui ne peut pas être envoyée seule car elle doit se trouver dans un interchange EDI Non Non Non
Document (par exemple, XML) ultérieurement transformé en transaction EDI. Oui Oui Non
Aucun Interchange unique contenant une seule transaction Oui Oui Oui
Interchange unique contenant plusieurs transactions Oui Oui Oui
Plusieurs interchanges contenant une seule transaction Oui Oui Oui
Plusieurs interchanges contenant plusieurs transactions Oui Oui Oui
La transaction EDI (non prise en charge ; doit avoir une enveloppe Interchange) Non Non Non
Document (par exemple, XML) ultérieurement converti en transaction EDI Oui Oui Oui

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.

Protocole de transfert HTTP

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:

Processus

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 :

  1. Le système source (WebSphere Partner Gateway ou l'application dorsale) soumet un message HTTP au système cible au moyen d'une URL spécifique.
  2. Le système cible reçoit le message et envoie un accusé de réception du niveau de protocole, HTTP 200 ou 202, pour indiquer le changement de droits de propriété. Le système source ignore le corps de ce message d'accusé de réception. Si une erreur se produit au cours du traitement, le système cible renvoie un message HTTP 500 au système source.
  3. Si WebSphere Partner Gateway est le système cible (i.e. lorsque WebSphere Partner Gateway reçoit le message), il conserve ensuite le message et libère la connexion vers le système source.
  4. Le système cible peut ensuite traiter le message de façon asynchrone

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.

Envoi de messages depuis le système dorsal via le protocole HTTP

Pour envoyer un message à WebSphere Partner Gateway à l'aide du protocole HTTP, l'application dorsale effectue les opérations suivantes :

  1. Elle crée le message.

    Le L'attribut Content-Type de l'en-tête du niveau de transfert fournit le codage utilisé pour le message.

  2. Elle groupe le message conformément au regroupement défini pour la connexion.

    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.

  3. Elle soumet le message à l'URL utilisée par WebSphere Partner Gateway pour recevoir ces messages.
  4. Si l'échange est synchrone, l'application dorsale attend de recevoir une réponse dans la même connexion que celle utilisée pour la requête.

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.

Réception de messages sur le système dorsal via le protocole HTTP

Pour recevoir un message de WebSphere Partner Gateway à l'aide du protocole HTTP, l'application dorsale effectue les opérations suivantes :

  1. Elle détecte l'arrivée d'un message sur une URL spécifique.
  2. Dès réception du message, elle le traite :
  3. Si l'échange est synchrone, l'application dorsale renvoie une réponse dans la même connexion que celle utilisée pour la requête.

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.

Protocole JMS

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.

Configuration de l'environnement JMS viaWebSphere MQ

Pour configurer votre environnement JMS, les fournisseurs ci-après sont requis.

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.

Présentation de l'utilisation de WebSphere MQ pour configurer l'environnement 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.

Envoi de messages depuis le système dorsal via le protocole JMS

Pour envoyer un message à WebSphere Partner Gateway à l'aide du protocole JMS, l'application dorsale effectue les opérations suivantes :

  1. Elle crée le message.
  2. Elle groupe le message conformément au regroupement défini pour la connexion.

    Pour le regroupement d'intégration dorsale, l'application ajoute les attributs d'en-tête JMS requis.

  3. Elle envoie le message à la file d'attente JMS utilisée par l'application dorsale pour envoyer des messages à WebSphere Partner Gateway.

Réception de messages sur le système dorsal via le protocole JMS

Pour recevoir un message de WebSphere Partner Gateway à l'aide du protocole JMS, l'application dorsale effectue les opérations suivantes :

  1. Elle détecte l'arrivée d'un message sur la file d'attente JMS.
  2. Dès réception du message, elle le traite :

Protocole de système de fichiers

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.

Envoi de messages depuis le système dorsal via le protocole de système de fichiers

Pour envoyer un message à WebSphere Partner Gateway à l'aide du protocole de système de fichiers, l'application effectue les opérations suivantes :

  1. Elle crée le fichier de messages dans un répertoire temporaire.
  2. Une fois le fichier de messages prêt, elle déplace le fichier dans le répertoire approprié interrogé par WebSphere Partner Gateway.

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.

Réception de messages sur le système dorsal via le protocole de système de fichiers

Pour recevoir des messages à l'aide du protocole de système de fichiers, l'application effectue les opérations suivantes :

  1. Elle interroge le répertoire approprié à la recherche de fichiers de messages.
  2. Chaque fois qu'un message se présente, elle le conserve.
  3. Elle supprime le message du répertoire.
  4. Elle traite le message.

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.

Copyright IBM Corp. 2003, 2005