Détails de l'appel XML

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.

Formulaire

Cette vue offre une présentation simplifiée du message, axée sur l'édition des valeurs du contenu XML. Utilisez le menu Schéma pour activer l'assistance en éditant le contenu XML afin que le fichier XML soit valide et conforme à la spécification XSD.

Dans la vue Formulaire, ajoutez les en-têtes XML requis pour les appels de service Web standard. Dans la barre En-tête, cliquez sur Ajouter () pour créer la structure d'en-tête XML par défaut pour les demandes WS-Addressing, WS-ReliableMessaging ou WS-Coordination, ou cliquez sur Plus pour d'autres normes. Vous pouvez activer ou désactiver les éléments d'en-tête XML et spécifier les valeurs correctes pour chaque élément XML. Des contrôles sont effectués pour vérifier la validité du contenu XML.

Remarque : Pour ajouter des en-têtes XML pour les appels dans IBM® Security AppScan, ajoutez un algorithme En-têtes XML statiques sur l'onglet Pile de requêtes de la demande.

Arborescence

Cette vue offre une présentation hiérarchique de la structure XML du message, y-compris des éléments, des espaces nom et des valeurs associées. Vous pouvez cliquer sur les boutons Ajouter, Insérer, Supprimer, Vers le haut et Vers le bas pour modifier les éléments et les espaces de nom XML dans l'arbre.

Utilisez la colonne Ignorer si vide pour sélectionner les éléments XML vides que vous souhaitez ignorer. Cette colonne est visible uniquement si vous avez coché la case Afficher la colonne 'Ignorer si vide' dans l'afficheur d'arbre XML dans Fenêtre > Préférences > Test > Editeur de test > Test de service.

Cliquez sur Filtrer pour masquer ou afficher les noeuds d'espace de nom, d'attribut ou de texte, en fonction de vos besoins.

Cliquez sur Autoriser uniquement les modifications valides pour permettre l'édition intelligente, selon un document XSD (XML schema document) indiqué. Pour indiquer un ensemble de documents XSD pour le plan de travail, dans le navigateur de test, cliquez à l'aide du bouton droit de la souris sur le projet et sélectionnez Propriétés ainsi que Catalogue des schémas. Désactivez l'option Autoriser uniquement les modifications valides si vous n'avez pas de document XSD ou si vous voulez ignorer le schéma.

Vous pouvez cliquer avec le bouton droit de la souris sur un élément XML pour le convertir en fragment XML. Ceci vous permet d'effectuer une corrélation des données (en utilisant des pools de données et en créant des références) sur l'ensemble du fragment XML et non pas seulement sur la valeur.

Source

Cette vue présente le contenu XML source du message ou le contenu en texte clair. Pour mettre en forme le contenu XML, cliquez sur Mettre en forme le texte XML. Pour encapsuler le contenu XML dans une ligne unique, cliquez sur Comprimer le texte XML sur une ligne. Des contrôles similaires sont disponibles pour le contenu JSON.

Important : Dans la vue Source, ne modifiez pas les balises qui commencent par SoaTag. Si vous supprimez ou modifiez ces balises, toutes les références et les substitutions dans le test seront interrompues. Vous ne pouvez pas recréer ces balises après les avoir supprimées.

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.