Définition et chargement d'un schéma XML pour un en-tête MQRFH2

Pour inclure des métadonnées ou des paramètres supplémentaires dans un message MQ, vous devez définir un en-tête MQRFH2 qui définit vos paramètres. Généralement, ces paramètres sont spécifiques d'une application mais n'apparaissent pas dans les données du message-même.

Pourquoi et quand exécuter cette tâche

Chaque paramètre, appelé dossier dans MQ, est transmis en tant que fragment XML avec d'autres données d'en-tête MQRFH2. Chaque paramètre peut avoir sa propre structure XML unique.

Etant donné que le dispositif d'intégration utilise des messages XML, chacun de ces fragments de paramètre doit être extrait de l'en-tête MQRFH2. Les fragments sont consolidés en un seul fragment et transmis en tant que paramètre MQRFH2 au dispositif d'intégration.

Pour que ces paramètres soient accessibles, Studio et le dispositif d'intégration doivent avoir accès à un schéma XML qui définit les structures de tous les paramètres. Pour créer ce schéma XML et le charger dans le projet, procédez comme suit :

Procédure

  1. Créez un schéma XML qui définit les paramètres de l'en-tête MQRFH2 à l'aide d'un éditeur de schéma XML ou d'un éditeur de texte. Pour consulter un exemple de schéma XML, voir Données XML MQRFH2 et exemples de schéma. Vous devez personnaliser le schéma XML pour les paramètres de l'application.
    Créez le schéma XML en appliquant les instructions suivantes :
    • Définissez la structure consolidée en tant qu'élément NameValueData unique.
    • Répertoriez tous les paramètres dans l'ordre où ils apparaissent dans l'en-tête MQRFH2, en tant qu'éléments dans l'élément NameValueData.
    • Les noms de paramètre doivent être uniques.
    • Les noms de paramètre, de groupe et de propriété doivent être des noms XML valides. Voir la spécification XML ou la documentation MQ pour plus d'informations.
    • Chaque paramètre doit être encapsulé dans un élément unique. La documentation MQ fait référence à cet élément de paramètre en tant que dossier.
    • Les paramètres peuvent contenir des propriétés, des groupes ou les deux.
    • Les groupes et les propriétés doivent être répétés.
    • Les groupes peuvent être imbriqués dans d'autres groupes.
    • Les propriétés doivent être définies en tant que type MQRFHQPropertyType.
  2. Ajoutez ce schéma XML au projet. Voir Téléchargement de fichiers dans un projet pour plus d'informations.
  3. Le schéma XML est à présent disponible dans la boîte de dialogue Recherche d'élément de type de schéma. Dans le panneau Configurer des activités MQ, cette boîte de dialogue apparaît lorsque vous cochez la case Fragment de schéma pour en-tête MQRFH2, puis cliquez sur [..]. Dans la boîte de dialogue Recherche d'élément de type de schéma, recherchez le schéma XML qui définit l'en-tête, sélectionnez l'élément NameValueData dans ce schéma XML et cliquez sur OK.



Commentaires | Notices


Icône d'horodatage Dernière révision: Friday, November 1, 2013


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/MQ_Define_and_Load_a_Schema_Fragment_for_the_MQRFH2_Header.html