Détails de l'appel XML

Les éléments d'appel XML renferment le contenu de l'appel et les informations de transport pour cet appel. Le contenu inclut un XML transmis via un transport HTTP ou JMS. Les informations de transport font référence aux informations requises pour l'envoi, la réception et la réponse en fonction du protocole sélectionné.
Mettre à jour le nom du noeud automatiquement
Lorsque cette option est activée, elle met automatiquement à jour le nom de l'élément d'appel XML dans le contenu de test.
Unidirectionnel
Cette option indique qu'aucune réponse provenant du serveur n'est attendue après l'appel. Le bouton Mettre à jour le retour est désactivé.
Délai d'attente (ms)
Valeur du délai d'attente en millisecondes. Si aucune réponse n'est reçue après le délai indiqué, une erreur est générée.
Temps de réflexion (ms)
Indique le délai calculé par un programme qui doit s'écouler pour chaque utilisateur lorsque le test est exécuté avec plusieurs utilisateurs virtuels. Le délai de réflexion est une émulation statistique de la durée passée par les véritables utilisateurs à lire une entrée ou à réfléchir avant d'effectuer une action.
Mettre à jour le retour
Permet d'afficher la fenêtre Aperçu du retour. Dans cette fenêtre, vous pouvez invoquer l'appel à partir du plan de travail pour créer ou mettre à jour le retour de message associé à l'appel.

Message

Ces pages présentent le contenu XML de l'appel et permettent d'accéder à la corrélation des données de trois façons.

Form
This view provides a simplified view of the message that focuses on editing the values of the XML content. Use the Schema menu to enable assistance with editing XML content so that the XML is valid and complies with the XSD specification.

In the Form view, add the XML headers that are required for standard web service calls. On the Header bar, click Add (Add button) to create the default XML header structure for WS-Addressing, WS-ReliableMessaging or WS-Coordination requests, or click More for other standards. You can enable or disable XML header elements and specify the correct values for each XML element. Checks are performed to ensure that the XML content is valid.

Remarque : To add XML headers to calls in IBM® Security AppScan, add a Static XML Headers algorithm on the Request Stack tab of the request.
Tree

This view provides a hierarchical view of the XML structure of the message, including elements, namespaces, and the associated values. You can use Add, Insert, Remove, Up, and Down to edit the XML elements and namespaces in the tree.

Use Skip if Empty column to select the empty XML elements that you want to skip. This column is visible only if you selected the Display the 'Skip if Empty' column in XML tree viewer check box in Window > Preferences > Test > Test editor > Service test.

Click Filter to hide or show namespace, attribute, or text nodes, depending on your requirements.

Click Allow only valid modifications to enable smart editing, based on a specified XML schema document (XSD). To specify a set of XSD documents for the workbench, in the test navigator, right-click the project and select Properties and Schema Catalog. Disable Allow only valid modifications if you do not have an XSD or if you want to bypass the schema.

You can right-click an XML element to convert it to an XML fragment. This enables you to perform data correlation (use datapools and create references) on the entire XML fragment instead of only on the value.

Source
This view displays the source XML content of the message or plain text content. To format XML content, click Format XML text. To wrap XML content into a single line, click Pack XML text to single line. Similar controls are available for JSON content.
Important : In the Source view, do not edit the tags that start with SoaTag. If you delete or change these tags, any references and substitutions in the test will be broken. You cannot recreate these tags after you delete them.

Pièces jointes

Cette page répertorie les pièces jointes MIME liées à l'appel. Le contenu de cette vue correspond à la spécification MIME (Multipurpose Internet Mail Extensions). Vous pouvez utiliser cette page pour ajouter des ressources de plan de travail en tant que pièces jointes MIME et modifier les propriétés.

L'ID du contenu correspond à l'identificateur que l'appel utilise pour faire référence aux pièces jointes. La méthode d'utilisation de cet identificateur dépend de vos exigences serveur.

Protocole

Cette page concerne le protocole utilisé pour l'envoi de l'appel. Le protocole peut être HTTP ou JMS (Java™ Message Service) en fonction des messages.

HTTP
Cette page permet de remplacer les paramètres HTTP associés à l'appel pour une configuration HTTP locale.
Méthode
Cette option permet de choisir la méthode HTTP de l'appel XML parmi les méthodes suivantes :
  • POST
  • GET
  • PUT
  • DELETE
Version

Cette option permet de choisir HTTP 1.0 ou HTTP 1.1.

URL

Indiquez dans cette zone l'URL de l'appel XML.

En-têtes

Cette section permet d'ajouter des en-têtes à votre appel. Les en-têtes doivent être compatibles avec la méthode HTTP indiquée.

L'application gère les en-têtes suivants qui ne peuvent pas être ajoutés :
  • Agent utilisateur
  • Connexion hôte
  • Contrôle de cache
  • Pragma
  • Type de contenu
  • Longueur de contenu
Cookies

Cette section permet de gérer les cookies. Vous pouvez ajouter, éditer et supprimer des cookies et créer des références.

JMS

Cette page permet d'ajouter des propriétés de chaîne liées à l'appel pour une configuration JMS locale. Elles seront envoyées en tant que propriétés de message via JMS.

MQ

Cette page permet de remplacer les paramètres associés à l'appel pour une configuration WebSphere MQ locale.

Nom
Nom affiché dans l'appel de message en tant que lien vers cette configuration de protocole.
Nom du gestionnaire de files d'attente
Indique le nom du gestionnaire de files d'attente auquel envoyer l'appel.
Nom de la file d'attente
Indique le nom de la file d'attente gérée par le gestionnaire de files d'attente.
Utiliser le gestionnaire de files d'attente local
Indique si le serveur WebSphere MQ est en cours d'exécution sur l'ordinateur local. Si le serveur se trouve sur un ordinateur éloigné, désactivez cette option pour définir les détails du serveur MQ éloigné.
Adresse du gestionnaire de files d'attente
Indique l'adresse IP ou le nom d'hôte du serveur MQ éloigné.
Port du gestionnaire de files d'attente
Indique le port d'écoute du serveur MQ éloigné.
Canal client
Indique le canal du mode de connexion serveur du gestionnaire de files d'attente éloigné.
Utiliser la file d'attente temporaire
Indique si le serveur MQ crée une file d'attente temporaire. Si cette option est sélectionnée, la file d'attente temporaire est créée dans le seul but de recevoir des messages spécifiques puis est supprimée.
Nom de la file d'attente
Si l'option Utiliser la file d'attente temporaire n'est pas sélectionnée, cette option indique le nom de la file d'attente dans laquelle les retours de message du serveur MQ sont reçus. Le gestionnaire de files d'attente indiqué dans Nom du gestionnaire de files d'attente doit gérer cette file d'attente.

Les appels et les retours de message sont associés par l'ID corrélation se trouvant dans le message MQ, ce qui signifie que le paramètre report du message a la valeur MQC.MQRO_COPY_MSG_ID_TO_CORREL_ID. Le serveur doit respecter cette contrainte. Le transport de la fonction SOAP fourni par WebSphere MQ est pris en charge.

Service cible
Cette option concerne l'utilisation de Microsoft .NET avec le transport IBM WebSphere MQ pour la fonction SOAP. Indique le nom du fichier ASPX dans le répertoire du programme d'écoute .NET.
Utiliser l'en-tête RFH2
Indique si les messages SOAP utilisent un en-tête RFH2, qui utilise un format de message MQ prédéterminé. Lorsque cette option est sélectionnée, les autres options Descripteur de message sont désactivées. Utilisez cette option pour le transport WebSphere MQ pour la fonction SOAP. Si vous utilisez la liaison MQ WebSphere Integration Developer (WID), la liaison comprend les messages avec ou sans en-tête RFH2.
Descripteur de message
Cette section permet de configurer les zones de l'appel de message. Vous pouvez remplacer un sous-ensemble d'un descripteur de message MQ avec un format personnalisé pour une utilisation avec d'autres types de serveur, plus particulièrement lors de l'utilisation d'un appel de message XML. Pour plus de détails sur les descripteurs de messages, voir la documentation WebSphere MQ.
Utiliser la file d'attente temporaire
Cette section permet d'indiquer un nom d'utilisateur et un mot de passe pour l'authentification de base sur le serveur d'applications.
Connexion SSL
Cette option permet d'utiliser une connexion SSL si un paramètre Canal client fait référence à un canal sécurisé. Cliquez sur Ouvrir l'éditeur SSL pour créer une configuration SSL ou sur Changer pour changer la configuration SSL associée au test en cours.

Si le document WSDL (Web Services Description Language) permettant de créer l'appel de message utilise un URI JMS pris en charge pour désigner le serveur WebSphere MQ, la configuration SSL est créée automatiquement. Si le générateur de test n'a pas pu créer la configuration SSL, vous devez en créer une manuellement.

Si le document WSDL a été généré à l'aide du service WebSphere MQ (amqwdeployWMService), éditez le document WSDL pour changer la liaison de transport entre HTTP et JMS afin d'empêcher le générateur de test de générer une configuration HTTP.

Algorithme de cryptographie
Permet d'indiquer l'algorithme de cryptographie utilisé dans la configuration de canal.

Sécurité XML locale

Cette page permet d'ajouter un algorithme de sécurité personnalisé implémenté dans une classe Java. Des algorithmes personnalisés peuvent être appliqués au contenu XML envoyé et reçu du serveur.

Ajouter, Insérer, Supprimer, Haut et Bas
Ces boutons permettent de créer une pile d'algorithmes de sécurité. Chaque algorithme est appliqué à la pile de manière séquentielle. Cliquez sur Ajouter pour ajouter un algorithme de sécurité personnalisé.
Outils
Ce bouton permet de changer le mode d'affichage de la pile d'algorithmes.
Algorithme de sécurité personnalisé

Après l'ajout d'un algorithme de sécurité personnalisé à la pile. A l'aide de cette fenêtre, vous pouvez définir la classe Java qui implémente l'algorithme. La classe Java utilise l'interface suivante :

/**
* ***************************************************************
* IBM Confidential
* 
* (c) Copyright IBM Corporation. 2008. All Rights Reserved.
* 
* The source code for this program is not published or otherwise
* divested of its trade secrets, irrespective of what has been
* deposited with the U.S. Copyright Office.
* *************************************************************** 
* 
*/

package com.ibm.rational.test.lt.models.wscore.datamodel.security.xmlsec;

import java.util.Properties;
import org.w3c.dom.Document;


public interface ICustomSecurityAlgorithm {
	
	/**
	 * The following methods can be used in both case:
	 * Execution in the workbench and execution of the test.
	 */
	
	
	/**
	 * Called to process de Document that is sent over a transport.
	 * @param subject
	 */
	void process(Document subject);
	/**
	 * Called to un process a document that is received from a server.
	 * @param subject
	 */
	void unProcess(Document subject);
	
	/**
	 * Properties defined in the UI of the CustomSecurityAlgorithm.
	 * @param map
	 */
	void setProperties(Properties map);
	
	/**
	 * The following methods can only be used in terms of cast to test service interface,
	 * or in terms of access to the previous XML information, when the jar containing
	 * the custom security algorithm is deployed in the performance test project. In
	 * this case you cannot use the algorimth directly from the workbench.
	 */
	
	/**
	 * This object corresponds to the ITestExecutionService object.
	 * This applies only to an algorithm that must link to the execution of the test.
	 * If you plan to use this object you will need to deploy the jar containing the
	 * implementation into your performance test project and not directly into the JRE.
	 * 
	 * In case of a need of the previous xml document received from the execution you can 
	 * obtain the value using:
	 * IDataArea area = ((ITestExecutionService)executionObject).findDataArea(IDataArea.VIRTUALUSER);
	 *String previousXML = (String) area.get("PREVIOUS_XML"); //$NON-NLS-1$
	 * 
	 */
	void setExecutionContext(Object executionObject);
  • La méthode process modifie l'élément XML avant de l'envoyer au serveur.
  • La méthode unprocess modifie l'élément XML une fois qu'il a été reçu du serveur.
  • La méthode setProperties extrait les propriétés définies dans l'éditeur de sécurité pour cette interface de sécurité personnalisée.
  • La méthode setExecutionContext est appelée lors du test avec l'objet ITestExecutionServices qui correspond au message utilisant cette interface de sécurité personnalisée.
Option de nom de classe de l'algorithme de sécurité personnalisé
Définit la classe qui implémente l'algorithme de sécurité. Cliquez sur Parcourir la classe pour sélectionner une classe dans l'espace de travail.
Nom de l'algorithme
Indique un nom pour l'algorithme en cours.
Propriétés
Cette liste indique les propriétés que la méthode setProperties utilise dans l'algorithme. Utilisez les boutons Ajouter, Supprimer ou Editer pour créer la liste des propriétés.

Retour d'informations