Pour vos interactions entre Business Integration Connect 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 Business Integration Connect.
Business Integration Connect envoie votre message à un composant compatible avec ICS, qui transfère les messages à 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 Business Integration Connect, vous devez réaliser une définition d'objet métier afin de représenter l'objet métier de données utiles. Le composant compatible ICS 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 33, 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 33. 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 :
|
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 fournies par Business Integration Connect,
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 du composant compatible ICS particulier qui est utilisé pour
l'intégration à Business Integration Connect (voir Tableau 27). Le Tableau 34 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 34. 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 |
A utiliser pour un InterChange Server antérieur à la version
4.2.2
| Création de définitions d'objet métier pour une version antérieure à ICS 4.2.2. sur HTTP |
HTTP |
A utiliser pour un InterChange Server version 4.2.2
| Création de définitions d'objet métier pour ICS version 4.2.2. 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, le composant compatible avec ICS 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. Le composant compatible avec ICS 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 le métaobjet enfant qui est 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 34).
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 renvoyer un objet métier de réponse à la communauté de concentrateur.
Pour de nombreux composants compatibles avec ICS, 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 34 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 (vers une version antérieure à InterChange Server 4.2.2) | Wrapper Data Handler |
Création d'objets métier de configuration pour Wrapper Data Handler
|
HTTP (vers InterChange Server 4.2.2) | Adapter for HTTP | Création d'informations d'en-tête de niveau de transfert HTTP pour une version d'InterChange Server antérieure à 4.2.2. |
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 |
Si le composant compatible avec ICS de votre protocole de transfert est un WebSphere Business Integration Adapter, vous devez créer un objet connecteur pour cet adaptateur. Cet objet connecteur représente une instance de l'adaptateur lors de l'exécution. Vous pouvez créer des objets connecteur dans l'outil System Manager d'InterChange Server.
Le Tableau 36 indique où trouver des informations sur la procédure de
création d'objets connecteur, en fonction du protocole de transfert
utilisé.
Tableau 36. Création d'objets connecteur pour des protocoles de transfert différents
Protocole de transfert | Composant compatible ICS | Pour plus d'informations |
---|---|---|
HTTP
(avec une version antérieure à InterChange Server 4.2.2) | Adapter for XML
(Traitement de requêtes uniquement) | Création de l'objet de connecteur XML |
HTTP
(avec une version 4.2.2 d'InterChange Server) | 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 Business Integration Connect. Effectuez les opérations suivantes afin de rendre la collaboration appropriée disponible lors de l'exécution :
Le Tableau 37 indique où trouver des informations sur la procédure de
création d'objets connecteur, en fonction du protocole de transfert
utilisé.
Tableau 37. Définition des accès à la collaboration pour des protocoles de transfert différents
Protocole de transfert | Composant compatible ICS | Pour plus d'informations |
---|---|---|
HTTP
(avec une version antérieure à InterChange Server 4.2.2) | Adapter for XML
(Traitement de requêtes uniquement) | Liaison de collaborations pour communiquer avec Adapter for XML |
HTTP
(avec une version 4.2.2 d'InterChange Server) | 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.