WebSphere Business Integration Connect peut échanger des documents avec la version 4.2.2. de WebSphere InterChange Server (ICS) via le protocole de transfert HTTP.
Remarques:
Cette section fournit les informations suivantes sur la manière de configurer InterChange Server version 4.2.2 et les composants compatibles ICS appropriés en vue de leur utilisation avec Business Integration Connect sur HTTP :
Pour que Business Integration Connect puisse communiquer avec une version
4.2.2 d'InterChange Server via le protocole HTTP, vous
devez configurer ces deux composants. Tableau 60 résume ces étapes de configuration.
Tableau 60. Configuration de Business Integration Connect et d'InterChange Server
Composant | Version | Pour plus d'informations |
---|---|---|
WebSphere Business Integration Connect | 4.2.2 |
Configuration de documents sortants sur le protocole de transfert HTTP Configuration de documents entrants sur le protocole de transfert HTTP
|
WebSphere InterChange Server | 4.2.2 | Création d'artefacts ICS version 4.2.2 pour HTTP |
Pour échanger un document entre Business Integration Connect et InterChange
Server version 4.2.2 via le protocole HTTP, vous devez utiliser
les composants compatibles ICS répertoriés dans le Tableau 61.
Les sections suivantes décrivent la façon dont les composants répertoriés dans le Tableau 61 fonctionnent conjointement pour permettre l'échange de documents entre Business Integration Connect et InterChange Server version 4.2.2 via le protocole HTTP.
Pour que Business Integration Connect envoie un document à InterChange Server version 4.2.2 par le biais du protocole HTTP, vous devez utiliser le composant Adapter for HTTP afin de récupérer le document que Business Integration Connect a envoyé sous la forme d'un flux HTTP. L'adaptateur achemine ensuite le document vers InterChange Server. La Figure 16 illustre comment Business Integration Connect envoie des documents à InterChange Server version 4.2.2 sur le protocole HTTP.
Figure 16. Flux de messages entre Business Integration Connect et une collaboration via HTTP
Pour que Business Integration Connect puisse recevoir un document issu d'InterChange Server version 4.2.2 par le biais du protocole HTTP, vous devez utiliser le composant Adapter for HTTP qui envoie le message reçu depuis InterChange Server sous la forme d'un flux HTTP que Business Integration Connect peut extraire. La Figure 17 illustre comment Business Integration Connect reçoit des documents à partir d'InterChange Server version 4.2.2 sur le protocole HTTP.
Figure 17. Flux de messages entre une collaboration et Business Integration Connect via HTTP
Etant donné que l'échange de documents sur InterChange Server nécessite l'utilisation de composants compatibles avec ICS, vous devez effectuer les tâches d'installation et de configuration sur le composant Adapter for HTTP. Pour plus d'informations sur la manière de configurer Business Integration Connect pour être utilisé avec InterChange Server sur HTTP, voir Configuration de Business Integration Connect pour InterChange Server.
Adapter for HTTP est un composant compatible avec ICS qui permet à Business Integration Connect d'échanger des documents avec InterChange Server version 4.2.2 sous la forme de messages HTTP. Il prend en charge les interactions suivantes avec InterChange Server :
Lorsque vous avez configuré Adapter for HTTP pour communiquer avec InterChange Server, suivez les étapes décrites dans ces sections afin de configurer cet adaptateur pour qu'il soit à l'écoute des messages HTTP envoyés par Business Integration Connect:
Comme l'illustre la Figure 17, Adapter for HTTP utilise un gestionnaire de données pour convertir les objets métier reçus depuis InterChange Server dans un flux HTTP approprié.
Pour indiquer quel gestionnaire de données utiliser pour convertir les données utiles, vous devez procéder comme indiqué dans le Conversion d'objet métier. Par ailleurs, vous devez configurer le composant Adapter for HTTP pour utiliser ce gestionnaire de données utiles. Vous pouvez définir le gestionnaire de données utiles de l'une des façons suivantes :
Le composant Adapter for HTTP utilise la propriété de configuration du connecteur JavaProtocolHandlerPackages pour identifier le nom des modules du gestionnaire de protocole Java. Pour permettre l'intégration avec Business Integration Connect, assurez-vous que la propriété JavaProtocolHandlerPackage est définie sur sa valeur par défaut :
com.ibm.net.ssl.internal.www.protocol
Le composant Adapter for HTTP prend en charge les propriétés de configuration hiérarchiques pour obtenir les informations dont il a besoin pour configurer ses programmes d'écoute de protocole. La propriété de configuration de niveau supérieur s'appelle ProtocolListenerFramework. Cette propriété de niveau supérieur comporte plusieurs niveaux de sous-propriétés. Pour configurer les gestionnaires de protocole en vue de leur utilisation avec le module Adapter for HTTP, assurez-vous que les propriétés sont configurées dans la propriété ProtocolListener, comme décrit dans la procédure suivante :
ProtocolListenerFramework ProtocolListeners HttpListener1
Pour configurer votre programme d'écoute de protocole, définissez les
sous-propriétés répertoriées dans le Tableau 62.
Tableau 62. Configuration du programme d'écoute de protocole
Propriété | Description | Valeur |
---|---|---|
Protocol |
Type de programme d'écoute de protocole :
|
http ou https
|
Host | Adresse IP sur laquelle le programme d'écoute de protocole est à l'écoute | Adresse IP de la machine locale sur laquelle WebSphere Business Integration Connect s'exécute |
Port | Port sur lequel le programme d'écoute est à l'écoute des requêtes | 8080 |
ProtocolListenerFramework ProtocolListeners HttpListener1 URLsConfiguration URL1
Définissez la propriété ContextPath en lui affectant comme valeur l'identificateur URI des requêtes HTTP que le programme d'écoute de protocole reçoit.
ProtocolListenerFramework ProtocolListeners HttpListener1 URLsConfiguration URL1 TransformationRules TransformationRule1
Pour configurer la transformation des pièces jointes pour votre programme
d'écoute de protocole, définissez les sous-propriétés répertoriées dans
le Tableau 63. Vous avez besoin d'une règle de transformation
pour chaque instance du composant Attachment Data Handler que vous
utilisez. Pour plus d'informations sur le composant Attachment
Data Handler, voir Gestion des documents contenant des pièces jointes.
Propriété | Description | Valeur |
---|---|---|
ContentType | Type de contenu des données à transformer à l'aide d'un gestionnaire de données | Type de contenu associé aux données relatives aux pièces jointe |
MimeType | Type MIME à utiliser pour identifier le gestionnaire de données à appeler | Type MIME associé à l'instance du composant Attachment Data Handler |
Charset | Jeu de caractères à utiliser lors de la transformation des données du type de contenu spécifié | Jeu de caractères pour les données relatives aux pièces jointes |
Pour plus d'informations sur ces propriétés, voir le document Adapter for HTTP User Guide.
Le composant Adapter for HTTP envoie votre document à InterChange Server et le reçoit sous la forme d'un objet métier de données utiles. Adapter for HTTP appelle le gestionnaire de données utiles pour gérer cet objet métier lorsqu'il reçoit ou envoie un document de Business Integration Connect, comme suit :
Par conséquent, vous devez créer des définitions d'objet métier comme
illustré dans le Tableau 64 pour représenter la structure d'objet métier de données
utiles que le composant Adapter for HTTP attend.
Tableau 64. Définitions d'objets métier pour Adapter for HTTP
Condition | Définition d'objet métier | Pour plus d'informations |
---|---|---|
Si vous utilisez Aucun regroupement ou un Regroupement d'intégration dorsale pour votre message et si vos documents ne possèdent pas de pièces jointes |
Objet métier de données utiles :
| Création de la structure d'objet métier de données utiles pour ICS version 4.2.2. sur HTTP |
Si vous utilisez le regroupement d'intégration dorsale pour votre message. |
Ajoutez à l'objet métier de données utiles les objets métier destinés à contenir les informations d'en-tête du message :
| Création d'informations d'en-tête de niveau de transfert HTTP pour ICS version 4.2.2. |
Si le document contient des pièces jointes | Vous devez également créer des objets métier supplémentaires pour représenter les pièces jointes. | Création de définitions d'objets métier liées aux pièces jointes |
L' Adapter for HTTP attend une structure d'objet métier de données utiles qui comprend les objets métier suivants :
La Figure 18 illustre un exemple de structure d'objet métier correspondant à la définition d'un objet métier de données utiles à utiliser avec InterChange Server version 4.2.2 via le protocole HTTP.
L'objet métier de niveau supérieur est un encapsuleur des objets métier de requête et de réponse. Vous devez créer une définition d'objet métier pour cet objet métier. Le Tableau 57 contient les attributs de la définition de l'objet métier de niveau supérieur.
Tableau 65. Attributs de l'objet métier de niveau supérieur
Attribut | Type d'attribut | Description |
---|---|---|
MimeType | Chaîne |
Définit le type de contenu et le format des données qui sont transmises à
l'URL.
|
Charset | Chaîne |
Utilisé pour déterminer quel gestionnaire de données appeler.
|
Request | Objet métier | Objet métier enfant qui représente le message de requête. L'objectif de cet objet métier dépend de sa participation ou non au traitement des requêtes ou à la notification des événements. Pour plus d'informations sur la structure de l'objet métier, voir Objet métier de requête. |
Response | Objet métier | Objet métier enfant qui représente le message de réponse (si vous attendez une réponse). L'objectif de cet objet métier dépend de sa participation ou non au traitement des requêtes ou à la notification des événements. Pour plus d'informations sur la structure de l'objet métier, voir Objet métier de réponse. |
Le Tableau 66 récapitule les informations spécifiques à l'application
que la définition d'objet métier de niveau supérieur peut
contenir.
Informations spécifiques à l'application | Code | Description |
---|---|---|
Niveau d'objet métier | ws_mode | Définit si l'interaction est synchrone ou asynchrone |
Niveau de l'attribut | ws_botype | Définit l'attribut qui contient l'objet métier de requête ou de réponse |
Pour obtenir une description complète de la structure de l'objet métier de niveau supérieur et les informations spécifiques à l'application qui lui sont associées, voir le document Adapter for HTTP User Guide.
L'objet métier de requête contient les données à transmettre à l'URL. Il représente le message de requête HTTP.L'objectif de cet objet métier de requête dépend de la tâche à laquelle InterChange Server participe, par exemple :
Pour obtenir une description de la structure de l'objet métier de requête, voir le document Adapter for HTTP User Guide. Pour l'utiliser avec Business Integration Connect, vous devez effectuer deux personnalisations de la structure de la définition de l'objet métier de requête :
Cet attribut contient des informations de configuration pour les en-têtes de transfert du message. Pour plus d'informations, voir Création d'informations d'en-tête de niveau de transfert HTTP pour ICS version 4.2.2.
Tableau 67. Codes contenus dans les informations d'application sur l'objet métier de requête
Code des informations spécifiques à l'application | Description | Obligatoire ? |
---|---|---|
ws_tloname | Donne le nom de l'objet métier de niveau supérieur | Obligatoire uniquement si la définition d'objet métier participe à la notification d'événements |
cw_mo_http | Indique le métaobjet de configuration de protocole HTTP, qui contient les zones d'en-tête de transfert HTTP. Pour plus d'informations, voir Création d'informations d'en-tête de niveau de transfert HTTP pour ICS version 4.2.2. | Obligatoire uniquement si vous utilisez le regroupement d'intégration dorsale |
L'objet métier de réponse contient les données à recevoir depuis l'URL. Il contient les attributs des différents codes XML utilisés dans le message de réponse. L'objectif de cet objet métier de réponse dépend de la tâche à laquelle InterChange Server participe, par exemple :
Que la réponse ait lieu dans le cadre du traitement des requêtes ou de la notification d'événements, un objet métier de réponse est envoyé uniquement si l'échange entre Business Integration Connect et InterChange Serverest synchrone et qu'un objet métier est attendu en réponse à la requête.
Pour obtenir une description de la structure de l'objet métier d'échec, voir le document Adapter for HTTP User Guide.Pour l'utiliser avec Business Integration Connect, vous devez effectuer deux personnalisations de la structure de la définition de l'objet métier de requête :
Cet attribut contient des informations de configuration pour les en-têtes de transfert du message. Pour plus d'informations, voir Création d'informations d'en-tête de niveau de transfert HTTP pour ICS version 4.2.2.
La syntaxe de ce code est la suivante :
ws_botype=response
Si ce code n'est pas indiqué, le composant Wrapper Data Handler utilise le métaobjet enfant indiqué par l'attribut wbic_response_mime (dans l'objet métier de niveau supérieur) afin de déterminer le gestionnaire de données à utiliser pour la réponse.
Si l'échange entre Business Integration Connect et InterChange Server est asynchrone, Business Integration Connect n'attend pas de réponse, vous n'avez donc pas besoin de créer un objet métier de réponse.
Si vous envoyez des documents avec le regroupement d'intégration dorsale sur le protocole de transfert HTTP, votre objet métier de requête doit contenir des informations d'en-tête de transfert personnalisé. Le composant Adapter for HTTP s'attend à ce que les informations d'en-tête personnalisé soient contenues dans un métaobjet dynamique.
La Figure 19 illustre la structure de l'objet métier définie pour un objet métier de requête qui représente un document Business Integration Connect utilisant le regroupement d'intégration dorsale via le protocole HTTP.
Assurez-vous que la structure de l'objet métier inclut un métaobjet de configuration de protocole HTTP en procédant comme suit :
Chaque étape est décrite dans les sections ci-dessous.
Le composant Adapter for HTTP prend en charge un objet métier des propriétés définies par l'utilisateur qui contient les propriétés personnalisées dans le métaobjet de configuration de protocole HTTP. Business Integration Connect utilise cet objet métier pour inclure les propriétés HTTP requises par le regroupement d'intégration dorsale. Il peut également contenir l'attribut Content-Type, qui spécifie l'en-tête du type de contenu à définir dans le message de requête ainsi que l'attribut de longueur du contenu qui détermine la longueur du message, en octets. Le Tableau 4 décrit chaque zone valide de l'en-tête de transfert.
Pour créer une définition d'objet métier des propriétés définies par l'utilisateur pour les zones d'en-tête HTTP, procédez comme suit :
Tous les attributs doivent comporter un type d'attribut Chaîne. Vous pouvez affecter à l'attribut le même nom que la propriété HTTP (comme indiqué dans la colonne de la zone En-tête du Tableau 4).
Ces informations spécifiques à l'application au niveau de l'attribut ont le format suivant :
ws_prop_name=HTTPproperty
où HTTPproperty est l'une des valeurs contenues dans la colonne zone En-tête du Tableau 4.
Dans la Figure 19, la définition de l'objet métier HttpProps_BusObj contient des attributs pour les différentes zones d'en-tête de transfert. Ces attributs possèdent tous des informations spécifiques à l'application au niveau des attributs afin de spécifier le nom de l'en-tête du protocole associé. Par exemple, les informations spécifiques à l'application de l'attribut x-aux-sender-id sont définies comme suit :
ws_prop_name=x-aux-sender-id
Pour la notification d'événements, l'objet métier de requête, de réponse ou d'échec peut contenir un métaobjet dynamique appelé métaobjet de configuration de protocole HTTP destiné à contenir les informations de configuration (telles que les informations d'en-tête).
Pour obtenir une description de la structure de l'objet métier de configuration de protocole HTTP, voir le document Adapter for HTTP User Guide. Pour l'utiliser avec Business Integration Connect, vous devez effectuer deux personnalisations de la structure de la définition de l'objet métier de configuration de protocole HTTP :
Tous les attributs doivent comporter un type d'attribut Chaîne.
Le type de cet attribut est la définition d'objet métier de l'objet métier des propriétés définies par l'utilisateur (voir Création de l'objet métier des propriétés définies par l'utilisateur).
Par exemple, dans la Figure 19, la définition de l'objet métier HttpConfigMO_BusObj contient l'attribut UserDefinedProperties, de type HttpProps_BusObj.
La définition de l'objet métier de requête représente les informations demandées auprès de Business Integration Connect. Pour plus d'informations sur la création d'un objet métier de requête, voir Objet métier de requête. Pour intégrer le métaobjet dynamique à votre structure d'objet métier de données utiles, vous devez effectuer les modifications suivantes dans la définition d'objet métier de requête :
Le type de cet attribut est la définition d'objet métier du métaobjet de configuration de protocole HTTP (voir Création du métaobjet de configuration de protocole HTTP).
Le code cw_mo_http a le format suivant :
cw_mo_http=HttpConfigMetaObjAttr
où HttpConfigMetaObjAttr est le nom de l'attribut dans l'objet métier de requête qui contient le métaobjet de configuration de protocole HTTP.
Par exemple, dans la Figure 19, un attribut nommé HttpConfigMO a été ajouté à la définition d'objet métier de requête, WBIC_HttpRequest_BusObj. Cet attribut contient le métaobjet dynamique, qui est un objet métier enfant du type HttpConfigMO_BusObj. Par ailleurs, les informations spécifiques à l'application de l'objet métier de requête ont été modifiées pour inclure le code cw_mo_http suivant afin d'identifier ce métaobjet dynamique :
cw_mo_http=HttpConfigMO
Pour configurer un InterChange Server version 4.2.2 pour
qu'il communique avec Business Integration Connect via le protocole HTTP,
vous devez créer les artefacts InterChange Server indiqués dans le Tableau 68.
Tableau 68. Artefacts pour la communication avec ICS version 4.2.2 via le protocole HTTP
Artefact ICS | Fonction | Pour plus d'informations |
---|---|---|
Définitions d'objet métier | Représentent le document | Création de définitions d'objet métier pour ICS version 4.2.2. sur HTTP |
Objet de connecteur | Représente le composant Adapter for HTTP au moment de l'exécution | Création de l'objet de connecteur HTTP |
Modèle de collaboration et objet de collaboration | Représente le processus métier qu'InterChange Server utilise pour traiter le document | Liaison de collaborations pour communiquer avec Adapter for HTTP |
Pour obtenir une instance du composant Adapter for HTTP au moment de l'exécution, exécutez la procédure suivante dans l'outil System Manager :
Pour plus d'informations sur la manière de configurer l'objet de connecteur du composant Adapter for HTTP afin de l'utiliser avec Business Integration Connect, voir Configuration de l'environnement requis pour HTTP avec ICS 4.2.2.
Comme décrit dans Création des collaborations, un objet de collaboration doit exister au moment de l'exécution pour qu'InterChange Server puisse savoir où recevoir et envoyer des objets métier. Lorsque vous créez l'objet de collaboration pour la collaboration qui utilise le composant Adapter for HTTP pour échanger des informations avec Business Integration Connect, vous devez lier les ports de collaboration, comme suit :