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