Rubrique précédente: Protocole de données EDI X12Rubrique suivante: JSON


Protocole de données d'analyseur de charge utile XML générique

L'analyseur de charge utile XML générique détermine si les demandes et les réponses sont des chaînes XML. Ce protocole permet d'identifier les variables dans les messages XML utilisés par l'enregistreur.

Remarque : Pour le protocole de données Delimited Text (Texte délimité), le protocole de données Copybook et le protocole de données DRDA, vous pouvez activer cette fonctionnalité en sélectionnant la case à cocher XML Elements as request arguments (Eléments XML comme arguments de la demande) dans les fenêtres de configuration de protocole de données.

Identification des conversations et des transactions

La qualité de l'image de service enregistrée dépend directement de la quantité d'informations dont dispose VSE pour identifier les conversations et chaque transaction qu'elles contiennent. Notamment, le VSE requiert de l'aide pour différencier les transactions les unes des autres :

En interne, le VSE connaît de nombreux modèles à rechercher. Par exemple, pour la virtualisation HTTP, si le serveur utilisé est un serveur Java, le VSE définit un cookie qui contient la valeur d'une variable spéciale appelée sessionid. La variable sessionid identifie la session de manière unique. Le VSE peut utiliser la variable pour distinguer différentes sessions.

Toutefois, le VSE requiert parfois une assistance supplémentaire, que vous pouvez fournir comme suit :

L'utilisation de l'analyseur de charge utile XML générique est une technique permettant d'aider le VSE à examiner le corps des messages enregistrés (charge utile) et d'en extraire des informations explicites pour identifier les transactions. Cette technique peut être la seule façon d'obtenir des informations explicite sur des conversations, notamment dans le cas de protocoles opaques tels que le protocole natif de WebSphere MQ.

Remarque : Lors de l'utilisation de l'analyseur de charge utile XML générique et du protocole de données Delimited Text (Texte délimité), ajoutez ce dernier avant l'analyseur de charge utile XML générique. Sinon, la demande ne s'affichera jamais comme analysée dans l'enregistreur.

Procédez comme suit:

  1. Pour utiliser un protocole de données dynamiques, dans l'onglet Data Protocols (Protocoles des données) de l'enregistreur d'image de service virtuel, sélectionnez Generic XML Payload Parse (Analyseur de charge utile XML générique), si la charge utile est au format XML correct.
  2. Effectuez les étapes restantes, y compris l'étape de nettoyage.

    Après l'étape de nettoyage, la fenêtre suivante s'affiche :

    Capture d'écran de la fenêtre Create XPaths (Créer des expressions XPath) du protocole de données XML génériques

    Par défaut, aucune transaction de démarreur n'est identifiée ; DevTest ne sait donc pas quelles sont les données à examiner pour identifier les conversations. Toutefois, la liste Other Transactions (Autres transactions) indique les transactions enregistrées.

  3. Pour afficher la charge utile XML dans la zone Content (Contenu), cliquez sur la première transaction.

    Capture d'écran de la fenêtre Create XPaths (Créer des expressions XPath) du protocole de données XML génériques, annotée

    L'onglet XML dans la zone de Content (Contenu) contient la vue XML classique. L'onglet DOM Tree (Arborescence DOM) affiche la charge utile sous forme d'arborescence.

    Remarque : Cette partie de la fenêtre est similaire au panneau qui s'affiche lors de la création d'un filtre XPath de résultat XML. Comme décrit dans la section Filtre XPath de résultat XML de la rubrique Utilisation, vous pouvez utiliser la propriété lisa.xml.xpath.computeXPath.alwaysUseLocalName pour ignorer l'espace de noms.

  4. Pour identifier un noeud spécifique comme paramètre pour le VSE, cliquez sur le noeud dans l'onglet DOM Tree (Arborescence DOM). La zone XPATH Query (requête XPath) affiche la requête qui correspond au noeud sélectionné. Pour évaluer la requête XPath sur la charge utile actuelle, cliquez sur Icône de flèche.

    Le résultat de l'évaluation s'affiche sous l'en-tête Filter Run Results (Résultats de l'exécution du filtre).

  5. Pour ajouter cette requête XPath particulière à la liste de paramètres, cliquez sur Add (Ajouter)LISA-- icon_image_whiteplussign.

    Un menu s'affiche et permet de définir une opération, un argument, un métaparamètre, ou le corps de la demande. Par exemple, utilisez le menu pour sélectionner un document SOAP intégré au corps de la demande de sorte à utiliser le protocole WS SOAP pour analyser le document.

    Capture d'écran de la fenêtre Create XPaths (Créer des expressions XPath) du protocole de données XML génériques, annotée et contenant les résultats de l'exécution de filtre

  6. Cliquez sur Protocol Control Info (Informations sur le contrôle de protocole). DevTest a mémorisé la chaîne XPath identifiée et lui a attribué un nom d'argument. Vous pouvez renommer l'argument. Egalement dans ce panneau, utilisez les boutons Save (Enregistrer)Icône d'enregistrement et Restore (Restaurez)Icône d'actualisation pour enregistrer votre liste d'expressions XPath dans un fichier, ou charger une liste d'expressions XPaths à partir d'un fichier. L'enregistrement et le chargement permettent de copier et coller facilement d'un analyseur de charge utile XML à un autre.

    Capture d'écran de la fenêtre Create XPaths (Créer des expressions XPath) du protocole de données XML génériques avec l'option Set Argument (Définir un argument) sélectionnée

    De même, vous pouvez extraire des variables supplémentaires à partir de cette transaction ou d'autres. Il n'est pas nécessaire que toutes les transactions contiennent l'argument spécifique. Lors du traitement, si un argument particulier n'est pas présent dans la charge utile, il sera ignoré.

    Si vous faites défiler le panneau Protocol Control Info (Informations sur le contrôle de protocole) vers la droite, une colonne NS apparaît et permet d'ajouter ou de supprimer des définitions d'espace de noms. Pour rechercher et importer un fichier XML à partir du système de fichiers pour utiliser les définitions d'espace de noms inclus dans ce fichier, utilisez le bouton Browse (Parcourir).

  7. Double-cliquez sur une transaction dans l'onglet XML pour afficher une boîte de dialogue indiquant le contenu de la transaction.
  8. Lorsque vous êtes satisfait de vos choix de variables, cliquez sur Next (Suivant). Vous serez ensuite dirigé vers la fenêtre post-traitement.