Pour vos interactions entre WebSphere Partner Gateway et InterChange Server, vous devez créer un composant Integration Component Library (ICL) dans l'outil System Manager. Cet ICL contiendra les artefacts suivants :
Vous devez également créer un produit utilisateur et sélectionner les artefacts ICL requis pour l'interaction spécifique entre InterChange Server et WebSphere Partner Gateway.
WebSphere Partner Gateway envoie votre message à un adaptateur, qui le transfère à InterChange Server sous la forme d'un ou plusieurs objets métier. Pour qu'InterChange Server identifie un objet métier, il doit au préalable localiser un modèle, appelé définition d'objet métier, qui est utilisé pour décrire la structure des informations présentes dans l'objet métier. Chaque information présente dans une définition d'objet métier est contenue dans un attribut. Par conséquent, vous devez créer des définitions d'objet métier pour représenter les informations contenues dans votre message. Pour créer des définitions d'objet métier, utilisez l'outil Business Object Designer.
InterChange Server utilise les objets métier pour indiquer les informations suivantes :
Pour conserver les données utiles du document ou du message envoyé par WebSphere Partner Gateway, vous devez réaliser une définition d'objet métier afin de représenter l'objet métier de données utiles. L'adaptateur transmet le document à InterChange Server ou le récupère sous la forme d'un objet métier de données utiles. Cette section contient des informations relatives à l'objet métier de données utiles :
L'objet métier de données utiles doit être conçu de sorte que chaque information contenue dans le document que vous voulez transférer possède un attribut dans la définition d'objet métier de données utiles associée. Comme le montre le tableau 30, le contenu de l'objet métier de données utiles est fonction de la structure du document et du type de regroupement utilisé par le document.
Structure du document | Type de regroupement | Définition d'objet métier de données utiles |
---|---|---|
Données utiles uniquement | Aucun | Conserve les informations de données utiles du document |
Données utiles uniquement | Intégration dorsale |
Conserve :
|
Données utiles et pièces jointes | Aucun | Non applicable. Vous devez utiliser le regroupement d'intégration dorsale si votre document contient des pièces jointes. |
Données utiles et pièces jointes
Le document contient un encapsuleur XML, appelé enveloppe de transfert, dans lequel les données utiles et les pièces jointes sont encapsulées. |
Intégration dorsale |
Conserve :
Un gestionnaire de données fourni par WebSphere Partner Gateway, appelé gestionnaire de données de pièces jointes, est requis pour le traitement de l'enveloppe de transfert. Pour plus d'informations, voir Gestion des documents contenant des pièces jointes. |
L'objet métier de données utiles doit également être conçu selon les besoins de l'adaptateur particulier qui est utilisé pour l'intégration à WebSphere Partner Gateway. Le tableau 31 indique comment obtenir des informations sur la manière de créer un objet métier de données utiles pour le transférer sur un protocole de transfert donné.
Protocole de transfert | Remarques et limitations | Pour plus d'informations |
---|---|---|
HTTP | Création de définitions d'objet métier pour ICS sur HTTP | |
JMS | Si le document utilise le regroupement d'intégration dorsale | Création de définitions d'objet métier pour JMS |
Tous | Si le document contient des pièces jointes | Création de définitions d'objets métier liées aux pièces jointes |
En général, l'adaptateur utilise un gestionnaire de données pour la conversion du format du document en représentation d'objet métier associée. Ce gestionnaire de données est appelé gestionnaire de données utiles. L'adaptateur doit être configuré pour appeler le gestionnaire de données approprié pour le type de contenu des données utiles. En général, WebSphere Business Integration Data Handler for XML est configuré sous forme de gestionnaire de données utiles car il permet la conversion des messages XML en objets métier. Cependant, vous pouvez créer des gestionnaires de données personnalisés pour les formats de message qui n'ont pas de gestionnaire de données correspondant fourni par WebSphere Business Integration Server.
Vous devez vous assurer que les gestionnaires de données utiles que vous utilisez peuvent ignorer les métaobjets enfant requis par le protocole de transfert utilisé. Avant d'utiliser un gestionnaire de données (qu'il soit fourni par WebSphere Business Integration ou qu'il s'agisse d'un gestionnaire de données personnalisé), assurez-vous qu'il prend en charge les métaobjets enfant. Reportez-vous à la section relative à la balise cw_mo_libellé dans les informations spécifiques à l'application de l'objet métier dans la section appropriée de votre protocole de transfert (voir tableau 31).
Pour indiquer quel gestionnaire de données utiliser pour convertir les données utiles, vous devez procéder comme suit :
Le document Data Handler Guide dans la documentation de WebSphere Business Integration Adapter décrit les gestionnaires de données fournis par IBM. Si vous ne pouvez utiliser aucun de ces gestionnaires de données, vous pouvez créer un gestionnaire de données personnalisé.
Pour InterChange Server, le nom de l'objet métier de données utiles dépend du sens de la communication :
Dans ce cas, l'objet métier de données est appelé objet métier d'événement (parfois appelé simplement événement), qui informe InterChange Server du déclenchement d'un événement chez un participant de la communauté.
Dans ce cas, l'objet métier de données est un objet métier de requête qu'InterChange Server a envoyé pour demander des informations à un participant de la communauté. En réponse, InterChange Server peut envoyer un objet métier de réponse à la communauté de concentrateur.
Pour de nombreux adaptateurs, vous créez des définitions d'objets métier afin d'y intégrer les informations de configuration. Ces objets métier sont souvent appelés des métaobjets.
Le tableau 32 indique comment obtenir des informations sur la manière de créer un objet métier de données pour le transférer sur un protocole de transfert donné.
Protocole de transfert | Composant associé | Pour plus d'informations |
---|---|---|
HTTP | Adapter for HTTP | Création d'informations d'en-tête de niveau de transfert HTTP pour ICS |
JMS | Adapter for JMS | Création des informations d'en-tête JMS |
Tous | Gestionnaire de données de pièces jointes | Création du métaobjet enfant de pièces jointes |
Vous devez créer un objet de connecteur pour l'adaptateur que vous utiliserez. Cet objet connecteur représente une instance de l'adaptateur lors de l'exécution. Vous pouvez créer des objets de connecteur dans l'outil System Manager d'InterChange Server.
Le tableau 33 indique où trouver des informations sur la procédure de création d'objets connecteur, en fonction du protocole de transfert utilisé.
Protocole de transfert | Adaptateur | Pour plus d'informations |
---|---|---|
HTTP | Adapter for HTTP | Création de l'objet de connecteur HTTP |
JMS | Adapter for JMS | Création de l'objet de connecteur JMS |
C'est la collaboration, dans InterChange Server, qui exécute le processus métier en cours dont vous avez besoin. Par conséquent, vous devez créer la collaboration appropriée pour InterChange Server afin de traiter correctement les documents de WebSphere Partner Gateway. Effectuez les opérations suivantes afin de rendre la collaboration appropriée disponible lors de l'exécution :
Le tableau 34 indique où trouver des informations sur la procédure de création d'objets connecteur, en fonction du protocole de transfert utilisé.
Protocole de transfert | Adaptateur | Pour plus d'informations |
---|---|---|
HTTP | Adapter for HTTP | Liaison de collaborations pour communiquer avec Adapter for HTTP |
JMS | Adapter for JMS | Mise en place de liens de collaboration en vue d'une communication avec l'Adaptateur pour JMS |
Une fois que le projet de l'utilisateur contient les artefacts qui définissent les composants d'exécution requis, vous devez le déployer dans le référentiel InterChange Server. Vous pouvez déployer un projet d'utilisateur dans System Manager.