Configuration de WebSphere Partner Gateway

Processus de configuration du concentrateur fournissait une description très détaillée des étapes suivie par l'opérateur de communauté pour configurer le concentrateur. Cette section explique les étapes nécessaires à la configuration de WebSphere Partner Gateway destiné à être utilisé avec une application dorsale. Ces étapes de configuration impliquent que les participants de la communauté ont été paramétrés dans la communauté concentrée. En particulier, cette section nécessite que les configurations suivantes ont été effectuées :

Remarque : Vous devez ouvrir une session en tant qu'Opérateur de communauté (Administrateur du concentrateur).

Pour plus d'informations sur la configuration de WebSphere Partner Gateway pour qu'il soit compatible avec une communauté concentrée, voir le Guide de configuration du concentrateur.

Une fois les participants de la communauté paramétrés, configurer WebSphere Partner Gateway pour qu'il puisse communiquer avec l'application dorsale. Cette section fournit les informations suivantes pour décrire comment intégrer une application dorsale dans votre communauté :

Envoi de documents à l'application dorsale

Pour envoyer un document à l'application dorsale, WebSphere Partner Gateway effectue les opérations suivantes :

  1. Il reçoit un document provenant d'un participant de communauté.

    Le Réceptionnaire extrait ce document source d'une cible définie au niveau du concentrateur pour les messages entrants émis par un participant de la communauté ainsi que le protocole de transfert qui lui est associé. Lors de l'envoi d'un document au système dorsal, le document source correspond au document reçu d'un participant de communauté : il est par conséquent considéré comme le document du participant.

  2. Il convertit le document du participant en document cible au format requis par l'application dorsale.

    Le Gestionnaire de documents WebSphere Partner Gateway est est en charge de cette conversion en document cible. Lors de l'envoi d'un document au système dorsal, le document cible correspond au document envoyé au système dorsal ; il est par conséquent considéré comme le document dorsal. .

  3. Il envoie le document dorsal à l'application dorsale.

    Le Gestionnaire de documents envoie le document dorsal via une passerelle définie au niveau du concentrateur pour les messages sortants en direction de l'application dorsale.

Par conséquent, pour permettre au concentrateur d'envoyer un document à l'application dorsale, vous devez veiller à ce que la configuration résumée dans le tableau 17 ait été préalablement définie dans WebSphere Partner Gateway.

Tableau 17. Etapes de configuration pour l'envoi de documents à l'application dorsale
Etape de configuration Etapes WebSphere Partner Gateway Pour plus d'informations
1. Définir la destination du document.

1. Créer une passerelle vers l'application dorsale.

Définition de la destination du document du participant
2. Définir la méthode de traitement du document.

2. Créer des définitions du flot de documents pour les formats source et cible.

3. Activer les prestataires B2B pour la définition du flot du document envoyé à l'application dorsale.

4. Créer une interaction des définitions du flot de documents entre les définitions source et cible du flot de documents.

Définition du traitement du document du participant
3. Définir la méthode de connexion à l'application dorsale.

5. Créer une connexion de participant qui envoie les documents à l'application dorsale.

Définition de la connexion à l'application dorsale

Définition de la destination du document du participant

Pour envoyer des documents à l'application dorsale, une passerelle doit être définie pour le concentrateur. Cette passerelle indique la destination des documents convertis. En d'autres termes, elle précise l'emplacement (sous forme d'URI) où le concentrateur envoie le document dorsal. Cet emplacement est le même que celui utilisé par l'application dorsale pour écouter les messages entrants. La passerelle identifie le point d'entrée dans la couche application de l'entreprise (dans l'application dorsale). Dans WebSphere Partner Gateway, c'est le Gestionnaire de documents qui est chargé de détecter la passerelle. Après avoir traité le document, le Gestionnaire de documents envoie le document converti à l'application dorsale à l'endroit indiqué dans la passerelle.

Pour définir une passerelle dans WebSphere Partner Gateway

  1. Cliquez sur Administrateur du compte > Profils.
  2. Cliquez l'option de recherche pour afficher une liste de participants.
  3. Cliquez sur l'icône Afficher les détails en regard du Gestionnaire de communauté.
  4. Cliquez sur Passerelles.
  5. Cliquez sur Créer.

Lorsque vous définissez la passerelle, vous devez indiquer le protocole de transfert utilisé par le concentrateur et l'application dorsale pour transférer le document dorsal. Comme le montre le tableau 12, le choix du protocole de transfert dépend du format du document. Son format est fourni par son type de regroupement et son protocole métier, tous deux définis dans la définition du flot de documents.

Remarque : Pour plus d'informations sur la création d'une passerelle dans WebSphere Partner Gateway, voir le Guide de configuration du concentrateur.

Le choix du protocole de transfert dépend également des protocoles de transfert pris en charge par votre propre application dorsale. Pour plus d'informations, voir le chapitre concernant l'intégration à votre propre système dorsal dans ce manuel.

Une fois qu'un protocole de transfert a été sélectionné et validé pour votre document, entrer les données requises pour la passerelle dans l'écran Passerelles.

Définition du traitement du document du participant

Pour permettre au Gestionnaire de documents de traiter le document du participant, il doit connaître le format à utiliser pour convertir ce document. En d'autres termes, il doit connaître le format du document dorsal. Dans le cadre de l'intégration dorsale, vous devez veiller à ce que les entités suivantes soient définies avec WebSphere Partner Gateway :

Création de la définition du flot de documents

Chaque définition du flot de documents définit la manière dont WebSphere Partner Gateway traite un document spécifique. Elle inclut le type de regroupement et le protocole métier du document. WebSphere Partner Gateway fournit quelques types de regroupement et définitions de protocoles prédéfinis. Si ces formats prédéfinis caractérisent de manière appropriée votre document du participant et votre document dorsal, il n'est pas nécessaire de créer de définition du flot de documents. Toutefois, si les formats prédéfinis ne caractérisent pas convenablement votre document du participant ou votre document dorsal, vous devez créer une définition du flot de documents appropriée pour ce document. Pour créer une définition du flot de documents dans WebSphere Partner Gateway, vous devez utiliser la page Gestion des définitions du flot de documents (Administrateur du concentrateur > Configuration du concentrateur > Définition du flot de documents > Création d'une définition du flot de documents).

Remarque : Pour plus d'informations sur les définitions du flot de documents prédéfinies ainsi que sur la création de définitions du flot de documents dans WebSphere Partner Gateway, voir le Guide de configuration du concentrateur.

Pour l'intégration dorsale, le type de regroupement du document dorsal doit être l'un des suivants :

Vous devez déterminer lequel de ces types de regroupement s'applique, en fonction du protocole métier de votre document et de l'application dorsale spécifique utilisée. Pour plus d'informations sur les types de regroupement associés aux applications dorsales, voir Quel regroupement allez-vous utiliser ?. Pour plus d'informations sur les applications dorsales prises en charge, voir Comment accéder à l'application dorsale?.

Configuration des prestataires B2B pour l'envoi

Avant de pouvoir convertir le document source, le Gestionnaire de documents doit déterminer s'il peut gérer le format du document cible souhaité. Pour ce faire, le gestionnaire de documents vérifie les prestataires B2B du profil du Gestionnaire de communauté, qui définit quelles définitions de flux de documents ont été activées pour le Gestionnaire de communauté. Chaque type de document des composants des définitions du flot de documents prises en charge (tel que le type de regroupement, le protocole métier et le document) est activé. Pour activer une définition du flot de documents spécifique, vous devez utiliser la page Capacités B2B de WebSphere Partner Gateway. Pour accéder à cet écran, suivez les étapes suivantes :

  1. Cliquez sur Administrateur du compte > Profils > Participant de communauté.
  2. Cliquez sur l'option de recherche pour afficher une liste de participants.
  3. Cliquez sur l'icône Afficher les détails en regard du Gestionnaire de communauté.
  4. Cliquez sur Prestataires B2B.
  5. Pour l'intégration dorsale, vous devez vous assurer que chaque type de document des composants pour le document dorsal a été activé pour servir de destination (cible). Sous Définition de la cible, activez chaque composant du type de document dans la définition du flot du document dorsal.
  6. Dans la page Capacités B2B, si le concentrateur est également supposé recevoir des documents issus de l'application dorsale, vous pouvez activer les prestataires B2B correspondants. Dans ce cas, vous activez, sous Définition de la source, le composant de type du document dorsal.

Remarque : Pour plus d'informations sur le mode de configuration des prestataires B2B dans WebSphere Partner Gateway, voir le Guide de configuration du concentrateur.
Définition de l'interaction du flot de documents pour l'envoi

Pour permettre au Gestionnaire de documents de savoir comment convertir le document du participant, il doit pouvoir localiser une interaction qui associe les définitions du flot de documents pour le document du participant au document dorsal et identifie le participant source et cible.

Lorsque le Gestionnaire de documents est prêt à envoyer le document converti à l'application dorsale, il doit être en mesure de rechercher une connexion du participant entre le participant source et le participant cible (application dorsale). Toutefois, pour qu'une connexion du participant existe, il faut qu'une interaction valide entre les documents source et cible existe. Pour définir une définition du flot de documents dans WebSphere Partner Gateway, cliquez sur : Administrateur du concentrateur > Configuration du concentrateur > Définition du flot de documents> Gestion des interactions > Créer une interaction.

Remarque : Pour plus d'informations sur le mode de création d'interactions de la définition du flot de documents dans WebSphere Partner Gateway, voir le Guide de configuration du concentrateur.

Pour envoyer des documents à l'application dorsale, vous pouvez définir une interaction entre les documents source et de destination (cible), comme indiqué dans le tableau 18.

Tableau 18. Création d'une interaction pour l'envoi d'un document
Section Gestion des interactions Action
Source Sélectionnez les types de document des composants dans la définition du flot du document du participant.
Cible Sélectionnez les types de document des composants dans la définition du flot du document dorsal.

Remarque : Pour plus d'informations sur le mode de création d'interactions de la définition du flot de documents dans WebSphere Partner Gateway, voir le Guide de configuration du concentrateur.

Définition de la connexion à l'application dorsale

Pour permettre au Gestionnaire de documents d'envoyer le document converti au système dorsal, il doit trouver une connexion du participant valide qui identifie les participants source et cible et fournit l'emplacement utilisé par ces deux participants pour communiquer. Pour créer une connexion du participant, vous devez utiliser la page Gestion des connexions dans WebSphere Partner Gateway. Pour accéder à cet écran, cliquez sur : Administrateur du compte > Connexions du participant.

Pour qu'une connexion du participant soit définie, une interaction de la définition du flot de documents entre les documents source et cible doit déjà exister. Dans l'écran Gestion des connexions, vous devez d'abord rechercher l'existence d'une interaction en spécifiant les participants source et de destination (cible). Le tableau 19 répertorie les participants à sélectionner dans la page Gestion des connexions afin de définir une connexion du participant pour l'envoi d'un document vers l'application dorsale.

Tableau 19. Création d'une connexion du participant pour l'envoi d'un document
Liste déroulante Gestion des connexions Nom du participant de communauté
Source Nom du participant de communauté qui envoie le document au Gestionnaire de communauté
Cible Nom du Gestionnaire de communauté qui reçoit le document du participant de communauté

Une fois la source et la cible définies, vous pouvez cliquer sur Rechercher pour rechercher une interaction existante de la définition du flot de documents. Si aucune interaction n'existe, vous devez en créer une avant de pouvoir poursuivre la création d'une connexion du participant. Si une interaction existe (une dont la source est la définition du flot du document du participant et dont la cible est la définition du flot du document dorsal), vous pouvez configurer la connexion du participant pour activer la communication avec l'application dorsale.

Remarque : Pour plus d'informations sur le mode de création d'une connexion de participant dans WebSphere Partner Gateway, voir le Guide de configuration du concentrateur.

Pour l'intégration dorsale, cette connexion du participant doit spécifier en tant que passerelle cible la passerelle définie dans Définition de la destination du document du participant.

Réception de documents de l'application dorsale

Pour recevoir un document de l'application dorsale, le concentrateur effectue les opérations suivantes :

  1. Il reçoit un document provenant de l'application dorsale.

    Le Réceptionnaire WebSphere Partner Gateway extrait ce document source d'une cible définie par le concentrateur pour les messages entrants émis par une application dorsale de la communauté ainsi que le protocole de transfert qui lui est associé. Lors de la réception d'un document de l'application dorsale, le document cible correspond au document reçu du système dorsal ; par conséquent, ce document est appelé document dorsal.

  2. Il convertit le document dorsal en document cible au format requis par le participant de communauté désigné.

    Le Gestionnaire de documents est en charge de cette conversion en document cible. Lors de la réception d'un document du système dorsal, le document cible correspond au document envoyé à un participant de communauté : il est par conséquent considéré comme le document du participant.

  3. Il envoie le document du participant au participant de communauté approprié.

    Le Gestionnaire de documents envoie le document du participant via une passerelle définie par le concentrateur pour les messages sortants en direction du participant de communauté approprié.

Par conséquent, pour permettre au concentrateur de recevoir un document de l'application dorsale, vous devez veiller à ce que la configuration résumée dans le tableau 20 "> ait été préalablement définie dans WebSphere Partner Gateway.

Tableau 20. Etapes de configuration pour la réception de documents de l'application dorsale
Etape de configuration Etapes WebSphere Partner Gateway Pour plus d'informations
1. Définir le lieu d'extraction du document.

1. Créer une cible pour recevoir les messages entrants en provenance de l'application dorsale.

Définition du lieu d'extraction du document dorsal
2. Définir la méthode de traitement du document.

2. Créer des définitions du flot de documents pour les formats source et cible.

3. Activer les prestataires B2B pour la définition du flot du document reçus de l'application dorsale.

4. Créer une interaction des définitions du flot de documents entre les définitions source et cible du flot de documents.

Définition du traitement du document dorsal
3. Définir la méthode de connexion à WebSphere Partner Gateway.

5. Créer une connexion du participant qui envoie les documents à WebSphere Partner Gateway.

Définition de la connexion à WebSphere Partner Gateway

Définition du lieu d'extraction du document dorsal

Pour recevoir des documents de l'application dorsale, une cible doit être définie pour le concentrateur. Cette cible indique la source des documents. En d'autres termes, elle précise l'emplacement (sous forme d'URI) où le concentrateur est en mode de réception des documents entrants. Cet endroit est le même que celui utilisé par l'application dorsale pour envoyer les documents. La cible identifie le point d'entrée chez le Réceptionnaire (dans WebSphere Partner Gateway). Dans WebSphere Partner Gateway, c'est le Réceptionnaire qui est chargé de détecter la cible. Après avoir traité le document, le Réceptionnaire enregistre le document converti dans la mémoire partagée permanente pour permettre au Gestionnaire de documents de l'extraire ultérieurement.

Pour définir une cible dans WebSphere Partner Gateway, cliquez sur Administrateur du concentrateur > Configuration du concentrateur> Cibles.

Remarque : Pour plus d'informations sur la création d'une cible dans WebSphere Partner Gateway, voir le Guide de configuration du concentrateur.

Lorsque vous définissez la cible, vous devez indiquer le protocole de transfert utilisé par le concentrateur et l'application dorsale pour transférer le document dorsal. Comme le montre le tableau 13, le choix du protocole de transfert dépend du format du document. Son format est fourni par son type de regroupement et son protocole métier, tous deux définis dans la définition du flot de documents.

Remarque : Le choix du protocole de transfert dépend également des protocoles de transfert pris en charge par votre propre application dorsale. Pour plus d'informations, voir le chapitre concernant l'intégration à votre propre application dorsale dans ce manuel.

Une fois qu'un protocole de transfert a été sélectionné et validé pour votre document, entrer les données requises pour la cible dans l'écran Détails Cible.

Définition du traitement du document dorsal

Pour permettre au Gestionnaire de documents de traiter le document dorsal, il doit connaître le format à utiliser pour convertir ce document. En d'autres termes, il doit connaître le format du document du participant. Dans le cadre de l'intégration dorsale, vous devez veiller à ce que les entités répertoriées dans le tableau 21 soient définies avec WebSphere Partner Gateway.

Tableau 21. Définition de la méthode de conversion du document dorsal
Etape Pour plus d'informations

1. Des définitions du flot de documents doivent exister pour définir à la fois le format du document du participant et du document dorsal.

Création de la définition du flot de documents

2. Les prestataires B2B du Gestionnaire de communauté doivent inclure l'activation de la définition du flot du document dorsal en tant que source.

Configuration des prestataires B2B pour la réception

3. Une interaction de la définition du flot de documents regroupant le document dorsal en tant que source et le document du participant en tant que cible doit exister.

Définition d'une interaction pour la réception
Configuration des prestataires B2B pour la réception

Pour obtenir un récapitulatif des prestataires B2B et de leur application à l'intégration dorsale, voir Configuration des prestataires B2B pour l'envoi.

Si ce n'est pas déjà fait, activez, sous Définition de la source, le composant de type du document dorsal.

Définition d'une interaction pour la réception

Pour obtenir un récapitulatif des interactions des définitions du flot de documents et de leur application à l'intégration dorsale, voir Définition de l'interaction du flot de documents pour l'envoi. Cette section montre comment définir l'interaction pour la réception d'un document de l'application dorsale.

Pour recevoir des documents issus de l'application dorsale, définir une interaction entre les définitions du flot de documents pour les documents source et de destination (cible), comme indiqué dans le tableau 22.

Tableau 22. Création d'une interaction pour la réception d'un document
Section Gestion des interactions Action
Source Sélectionnez les types de document des composants dans la définition du flot du document dorsal.
Cible Sélectionnez les types de document des composants dans la définition du flot du document du participant.

Définition de la connexion à WebSphere Partner Gateway

Pour permettre au Réceptionnaire d'extraire le document de l'application dorsale, il doit trouver une connexion du participant valide qui identifie les participants source et cible et fournit l'endroit utilisé par ces deux participants pour communiquer. Pour obtenir un récapitulatif des connexions de participants et de leur application à l'intégration dorsale, voir Définition de la connexion à l'application dorsale.

Le tableau 23 répertorie les participants à sélectionner sur la page Gestion des connexions de WebSphere Partner Gateway afin de définir une connexion du participant pour la réception d'un document de l'application dorsale.

Tableau 23. Création d'une connexion du participant pour la réception d'un document
Liste déroulante Gestion des connexions Nom du participant de communauté
Source Nom du Gestionnaire de communauté
Cible Nom du participant de communauté qui reçoit le document du Gestionnaire de communauté

Une fois la source et la cible définies, vous pouvez cliquer sur Rechercher pour rechercher une interaction existante de la définition du flot de documents. Si aucune interaction existe, vous devez en créer une avant de pouvoir poursuivre la création d'une connexion du participant. Si une interaction existe (une dont la source est la définition du flot du document dorsal et dont la cible est la définition du flot du document du participant), vous pouvez configurer la connexion du participant pour activer la communication avec l'application dorsale.

Remarque : Pour plus d'informations sur le mode de création d'une connexion de participant dans WebSphere Partner Gateway, voir le Guide de configuration du concentrateur.

Copyright IBM Corp. 2003, 2005