L'Adaptateur pour JMS envoie votre document à InterChange Server et le reçoit sous la forme d'un objet métier de données utiles. L'Adaptateur pour JMS appelle le gestionnaire de données utiles pour qu'il gère cet objet métier lorsqu'il reçoit ou envoie un document de WebSphere Partner Gateway, comme suit :
Par conséquent, vous devez créer des définitions d'objet métier comme illustré dans le tableau 56 pour représenter la structure d'objet métier de données utiles attendue par l'Adaptateur pour JMS.
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 d'une structure objet métier de données utiles pour JMS. |
Si vous utilisez le regroupement d'intégration dorsale pour votre document |
Objets métier destinés à contenir les informations d'en-tête :
|
Création des informations d'en-tête JMS. |
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 |
La structure de l'objet métier de données utiles pour le protocole JMS est fonction du type de regroupement sélectionné, comme suit :
Comme l'explique la section Objet métier défini pour un document, vous devez créer un attribut pour chaque donnée utile à transférer.
Pour plus d'informations sur ces étapes, voir Création des informations d'en-tête JMS.
Si vous envoyez ou recevez des documents qui utilisent le regroupement d'intégration dorsale sur le protocole de transfert JMS, votre objet métier de requête doit contenir des informations d'en-tête de transfert personnalisé. L'Adaptateur pour JMS s'attend à ce que les informations d'en-tête personnalisé soient contenues dans son métaobjet dynamique.
La figure 24 illustre la structure de l'objet métier que l'Adaptateur pour JMS utilise pour un objet métier de requête qui représente un document WebSphere Partner Gateway utilisant le regroupement d'intégration dorsale.
Assurez-vous que la structure de l'objet métier contient un métaobjet dynamique en procédant comme suit :
Chaque étape est décrite dans les sections ci-dessous.
Un objet métier Propriétés JMS contient les propriétés JMS nécessaires pour les en-têtes de transfert requises par le regroupement d'intégration dorsale. Il peut également contenir l'attribut du type de contenu, qui indique l'en-tête du type de contenu à définir dans le message de requête, et l'attribut de longueur du contenu, qui indique la longueur du message, en octets. Le tableau 5 décrit chaque zone valide de l'en-tête de transfert.
Pour créer une définition d'objet métier Propriétés JMS, procédez comme suit :
Tous les attributs doivent comporter un type d'attribut Chaîne. Pour les messages utilisant le protocole JMS, les noms des zones d'en-tête de transfert utilisent des traits de soulignement au lieu des traits d'union, comme indiqué dans le tableau 57.
Ces informations spécifiques à l'application au niveau de l'attribut doivent avoir le format suivant :
name=JMSproperty;type=string
où JMSproperty est l'une des valeurs contenues dans la colonne Nom de propriété JMS du tableau 57.
Zone d'en-tête de transfert | Nom de propriété JMS |
---|---|
x-aux-sender-id | x_aux_sender_id |
x-aux-receiver-id | x_aux_receiver_id |
x-aux-protocol | x_aux_protocol |
x-aux-protocol-version | x_aux_protocol_version |
x-aux-process-type | x_aux_process_type |
x-aux-process-version | x_aux_process_version |
x-aux-create-datetime | x_aux_create_datetime |
x-aux-msg-id | x_aux_msg_id |
x-aux-production | x_aux_production |
x-aux-system-msg-id | x_aux_system_msg_id |
x-aux-payload-root-tag | x_aux_payload_root_tag |
x-aux-process-instance-id | x_aux_process_instance_id |
x-aux-event-status-code | x_aux_event_status_code |
x-aux-third-party-bus-id | x_aux_third_party_bus_id |
x-aux-transport-retry-count | x_aux_transport_retry_count |
content-type | content_type |
content-length | content_length |
Dans la figure 24, la définition de l'objet métier JMSProps_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 :
name=x_aux_sender_id;type=string
Ce métaobjet dynamique contient un objet métier enfant associé à des informations de configuration destinés à l'Adaptateur pour JMS. Pour créer une définition d'objet métier pour un métaobjet dynamique, procédez comme suit :
Pour que l'Adaptateur pour JMS utilise WebSphere Partner Gateway, la définition de l'objet métier pour le métaobjet dynamique doit inclure l'attribut nommé JMSProperties , dont le type correspond à la définition de l'objet métier Propriétés JMS (voir Création de l'objet métier Propriétés JMS). Par exemple, dans la figure 24, la définition de l'objet métier JMSDynMO_BusObj contient les attributs de plusieurs propriétés de configuration (non présentées) et inclut l'attribut JMSProperties.
Pour intégrer la structure de l'objet métier à votre objet métier de requête, vous devez effectuer les modifications suivantes dans la définition de l'objet métier de requête :
Le type de cet attribut est la définition d'objet métier du métaobjet dynamique (voir Création du métaobjet dynamique JMS).
Le code cw_mo_conn a le format suivant :
cw_mo_conn=dynamicMetaObjAttr
où dynamicMetaObjAttr est le nom de l'attribut dans l'objet métier de requête qui contient le métaobjet dynamique.
Par exemple, dans la figure 24, un attribut nommé JMSDynMO a été ajouté à la définition de l'objet métier de requête, HUB_JMSRequest_BusObj. Cet attribut contient le métaobjet dynamique, qui est un objet métier enfant de type JMSDynMO_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_conn suivant afin d'identifier ce métaobjet dynamique :
cw_mo_conn=JMSDynMO