Création de définitions d'objet métier pour JMS

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 contacte alors le gestionnaire de données utiles pour qu'il gère 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, voir Tableau 75, pour illustrer la structure objet métier de données utiles attendue par l'Adaptateur pour JMS.

Tableau 75. Définitions d'objets métier pour l'Adaptateur pour JMS
Condition Définition d'objet métier Pour plus d'informations
Si vous n'utilisez Aucun regroupement ou si vous utilisez le regroupement d'intégration dorsale pour votre message et que vos documents ne contiennent pas de pièce jointe

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 :

  • Métaobjet dynamique
  • Objet métier Propriétés JMS

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

Création d'une structure objet métier de données utiles pour JMS

La structure de l'objet métier de données utiles pour le protocole JMS est fontion du type de regroupement sélectionné, comme suit :

Remarque :
Pour le traitement des requêtes, le protocole JMS peut uniquement prendre en charge les interactions asynchrones. Vous pouvez envoyer un objet métier de requête, mais vous ne pouvez pas obtenir de réponse. Par conséquent, vous devez créer une définition d'objet métier de requête mais pas une définition d'objet métier de réponse.

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 22 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 Business Integration Connect utilisant le regroupement d'intégration dorsale via le protocole HTTP.

Remarque :
Pour plus d'informations sur cette structure d'objet métier, voir le document Guide utilisateur de l'Adaptateur pour JMS. Consultez ce document lorsque vous définissez vos objets métier.

Figure 22. Relation entre l'objet métier de requête et le métaobjet dynamique JMS


Assurez-vous que la structure de l'objet métier contient un métaobjet dynamique en procédant comme suit :

  1. Créez une définition d'objet métier destinée à contenir les propriétés JMS requises par le regroupement d'intégration dorsale.
  2. Créez une définition d'objet métier pour l'objet métier dynamique.
  3. Modifiez la définition de l'objet métier de requête afin d'inclure un attribut pour le métaobjet dynamique.

Chaque étape est décrite dans les sections ci-dessous.

Création de l'objet métier Propriétés JMS

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 4 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 :

  1. Créez un attribut au sein de la définition de l'objet métier pour chaque zone d'en-tête de transfert.

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

  2. Pour chacun des attributs contenus dans la définition d'objet métier Propriétés JMS, ajoutez les informations spécifiques à l'application qui permettent d'identifier l'objectif de l'attribut associé.

    Ces informations spécifiques à l'application au niveau de l'attribut doivent avoir le format suivant :

    name=JMSproperty;type=string
     

    JMSproperty est l'une des valeurs contenues dans la colonne Nom de propriété JMS du Tableau 76.

  3. Pour tous les attributs contenus dans la définition d'objet métier Propriétés JMS, vous pouvez ajouter une valeur par défaut afin d'indiquer la valeur commune (ou uniquement valide) pour la zone d'en-tête de transfert.

Tableau 76. Attributs de la définition de l'objet métier Propriétés JMS
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

Remarque :
Le Tableau 76 ne fournit pas de liste exhaustive des en-têtes requis pour l'intégration dorsale. Pour obtenir la liste complète et la description des en-têtes, voir Contenu de l'en-tête du niveau de transfert. Veillez à remplacer les traits d'union par les caractères de soulignement dans les noms de zone d'en-tête de transfert.

Dans la Figure 22, 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
 

Création du métaobjet dynamique JMS

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 :

  1. Créez un 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).
  2. Ajoutez d'autres propriétés de configuration, le cas échéant. Pour obtenir la liste des attributs valides contenus dans le métaobjet dynamique, voir le document Guide utilisateur de l'Adaptateur pour JMS. Consultez ce document pour plus d'informations sur la création d'attributs afin de configurer le métaobjet dynamique.

Pour que l'Adaptateur pour JMS utilise Business Integration Connect, 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 HTTP (voir Création de l'objet métier Propriétés JMS). Par exemple, dans la Figure 22, 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.

Modification de la définition de l'objet métier de requête

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 :

  1. Ajoutez un attribut à votre définition d'objet métier de requête afin qu'il contienne le métaobjet enfant dynamique.

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

  2. Ajoutez le code cw_mo_conn aux informations spécifiques à l'application au niveau de l'objet métier de votre définition d'objet métier afin d'identifier l'attribut qui contient le métaobjet dynamique.

    Le code cw_mo_conn a le format suivant :

    cw_mo_conn=dynamicMetaObjAttr
     

    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 22, un attribut nommé JMSDynMO a été ajouté à la définition de l'objet métier de requête, WBIC_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
 

Copyright IBM Corp. 1997, 2004