Configuration d'InterChange Server

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.

Remarque : Pour plus d'informations sur la manière de créer des ICL et de configurer InterChange Server, voir le document System Implementation Guide dans la documentation de WebSphere InterChange Server.

Création de définitions d'objets métier

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.

Remarque : L'outil Business Object Designer est inclus dans les produits WebSphere InterChange Server et WebSphere Business Integration Adapter. Pour plus d'informations sur l'utilisation de cet outil, voir le document Business Object Development Guide.

InterChange Server utilise les objets métier pour indiquer les informations suivantes :

Objet métier défini pour un document

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 :

Structure d'objet métier

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.

Tableau 30. Relation entre le regroupement et la structure de l'objet métier de données utiles
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 :

  • les informations de données utiles du document ;
  • les en-têtes du niveau de transfert.
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 :

  • les informations de données utiles du document ;
  • les en-têtes du niveau de transfert.
  • le conteneur de pièces jointes, qui stocke les données de pièces jointes et tous les objets métier Pièce jointe.

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é.

Tableau 31. Création d'objets métier de données utiles pour des protocoles de transfert différents
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
Conversion d'objet métier

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.

Remarque : Pour le traitement des messages XML, veillez à utiliser WebSphere Business Integration Data Handler for XML version 2.3.1 ou supérieure. Pour les messages cXML, vous devez utiliser le composant Data Handler for XML version 2.4.1 ou supérieure.

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 :

  1. Identifiez le type MIME que le gestionnaire de données doit prendre en charge pour convertir les données utiles et localiser un gestionnaire de données capable de traiter ce type MIME.

    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é.

  2. Dans Business Object Designer, créez un métaobjet enfant pour le gestionnaire de données que vous devez utiliser. Si vous utilisez un gestionnaire de données fourni par IBM, voir le document Data Handler Guide pour plus d'informations sur la structure du métaobjet enfant.
  3. Dans Business Object Designer, mettez à jour le métaobjet du gestionnaire de données de niveau supérieur des connecteurs pour inclure un attribut correspondant au type MIME pris en charge. Le type de cet attribut correspond au métaobjet enfant du gestionnaire de données.
  4. Dans Connector Configurator, définissez les propriétés de configuration du connecteur afin d'identifier le gestionnaire de données à utiliser :
    Remarque : Vous définissez soit les propriétés DataHandlerConfigMO et DataHandlerMimeType soit la propriété DataHandlerClassName.
  5. Dans Connector Configurator, ajoutez le métaobjet du gestionnaire de données de niveau supérieur dans la liste des objets métier pris en charge.
Terminologie d'InterChange Server

Pour InterChange Server, le nom de l'objet métier de données utiles dépend du sens de la communication :

Objets métier définis pour les informations de configuration

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é.

Tableau 32. Sections sur la création d'objets métier
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

Création des connecteurs

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.

Remarque : Pour plus d'informations sur la création d'objets connecteur, voir System Implementation Guide dans la documentation de WebSphere 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é.

Tableau 33. Création d'objets connecteur pour des protocoles de transfert différents
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

Création des collaborations

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 :

  1. Vérifiez qu'un modèle de collaboration contenant le processus métier dont vous avez besoin existe :
  2. Créez un objet de collaboration et associez ses ports, comme suit :

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é.

Tableau 34. Définition des accès à la collaboration pour des protocoles de transfert différents
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

Déploiement du projet

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.

Copyright IBM Corp. 2003, 2005