Créer une requête SOAP

1. Sélectionner le mode Conception de NeoLoad.

   Sélectionner le bouton .

2. Créer un Utilisateur virtuel

   Cliquez au bouton droit le noeud Profils d'utilisateurs virtuels et sélectionner Nouvel Utilisateur Virtuel. Tapez "Utilisateur". Cliquez sur le bouton "OK".

3. Ajouter une nouvelle requête SOAP

   Cliquez au bouton droit sur l'utilisateur virtuel créé et sélectionnez "Insérer dans", puis "Requête SOAP".

4. Créer la requête depuis une définition WSDL

   Sélectionnez l'option "Générer la requête depuis un fichier WSDL" et entrer l'URL du fichier. Dans notre exemple, nous utilisons l'URL suivante: http://ws.strikeiron.com/textdisguise/CaptchaService?WSDL. NeoLoad analyse le WSDL et extrait les méthodes pouvant être appelées.

   

   Sélectionner le bouton Suivant.

5. Choisir la méthode à appeler

   En se basant sur la définition du WSDL, NeoLoad liste les méthodes que vous pouvez utiliser. Dans notre exemple, nous sélectionnons la méthode CaptchaServiceSoap.GetNewWord.

   

   Sélectionner le bouton Suivant.

6. Définir un nom de requête

   NeoLoad fournit un nom par défaut issu du nom de méthode du WSDL. La plupart du temps vous n'aurez pas besoin de changer ce nom.

   

   Sélectionner le bouton Suivant.

7. Définir le point d'accès

   Cette étape vous permet de définir l'adresse à utiliser pour invoquer le service spécifié. L'URL est spécifiée dans le WSDL et vous n'avez pas besoin de le changer la plupart du temps. Vous pouvez modifier l'URL pour basculer entre un environnement de production et un environnement de test.

   

   Sélectionner le bouton Terminer.

8. Vérifier les éléments principaux de configuration

   A ce niveau, la requête SOAP est ajoutée à l'utilisateur virtuel.

   

   Le panneau NeoLoad de droite affiche les éléments de configuration principaux de la requête SOAP. Cela inclut l'URL d'accès au service qui définit avec les éléments Serveur et Chemin. Ces éléments ont été extraits du WSDL mais peuvent être modifiés. Comme pour les requêtes HTTP, l'élément Chemin peut utiliser des variables NeoLoad.

   Le WSDL peut être modifié ou rechargé. Le rechargement est utilisé lorsque la requête SOAP et le WSDL sont désynchronisés.

   	Avertissement
   	Recharger le WSDL réinitialise les paramètres précédents qui seront perdus.

9. Vérifier les entêtes HTTP

   La plupart des requêtes SOAP nécessitent au moins deux entêtes HTTP lorsque la requête est effectuée au travers d'HTTP. Il est préférable de vérifier que ces éléments sont correctement positionnés. Ils sont accessibles par la fenêtre Paramètres avancés en cliquant le bouton :

   

   Dans notre exemple ces éléments sont ContentType et SOAPAction. Si votre framework de web services requiert d'autres entêtes HTTP vous pouvez les ajouter dans cette même fenêtre.

Configurer la requête SOAP

Avant de tester la requête SOAP, d'autres éléments comme les valeurs de paramètres d'appels ainsi que les types d'encoding doivent être configurés. Utiliser le bouton pour accéder à la fenêtre de configuration SOAP.

1. Définir les paramètres du corps du message

   L'onglet Paramètres vous permet de définir la structure du corps du message. L'arbre de gauche affiche les paramètres d'appel.

   Comme mentionné précédemment, la méthode GetNewWord n'attend aucun argument ou un argument vide donc la liste des paramètres n'affiche des cet élément vide, donc l'arbre n'a qu'un élément vide nommé GetNewWord. S'il y avait eu d'autres arguments, ils auraient été affichés dans cet arbre. Pour notre exemple, aucune configuration n'est nécessaire.

   

2. Définir les entêtes SOAP

   Sélectionner l'onglet Entêtes pour définir et configurer les éléments liés à l'entête SOAP. Les entêtes sont présentées de la même manière que les paramètres de requête. L'arbre de gauche affiche la structure et le contenu des entêtes SOAP. Utiliser les boutons et pour ajouter ou supprimer des éléments. Utiliser les boutons et pour déplacer les éléments.

   La structure des paramètres contient soit des conteneurs, comme UnregisteredUser dans notre cas, ou des éléments feuille comme EmailAddress. Le but des éléments Conteneur est de contenir d'autres éléments. Cliquer au bouton droit sur un conteneur permet d'ajouter ou de supprimer des éléments fils. NeoLoad ne permet que d'ajouter des éléments compatibles avec la définition du WSDL.

   D'un autre côté les éléments feuille ne peuvent contenir d'autres éléments mais ont une valeur associée. Dans notre exemple vous devez entrer une adresse email valide pour l'élément EmailAddress.

   

   Pour les conteneurs et les feuilles, vous pouvez définir des attributs. Encore une fois, les attributs doivent être cohérents avec le WSDL. Encoder permet d'utiliser des caractères spéciaux comme '<', '>' ou '&'.

3. Configurer les paramètres avancés

   Le panneau Paramètres avancés vous permet de configurer le style de binding de la requête ainsi que les formats des attachements. Cette information a été extraite du WSDL, vous devez bien connaître ces notions si vous décidez de modifier ces paramètres.

   

4. Voir le XML

   Le dernier onglet affiche le contenu XML tel qu'il sera envoyé. NeoLoad génère ce contenu à la volée d'après les paramètres que vous avez défini. Cliquer au bouton droit sur le contenu XML et sélectionner Indenter le XML pour indenter le XML.

   

   	Astuce
   	Vous pouvez rechercher une expression particulière en cliquant au bouton droit Rechercher... ou en utilisant le raccourci clavier: CONTROL + F.

Tester la requête SOAP

En créant un utilisateur virtuel temporaire, NeoLoad fournit une méthode facile et rapide de tester vos requêtes SOAP. Sélectionner le bouton pour tester votre requête.

1. Démarrer la vérification

   Si vous déjà testé des utilisateurs virtuels avec NeoLoad, vous êtes familier avec cette fenêtre. En sélectionnant le bouton Lancer la validation, NeoLoad génère une requête SOAP et l'envoie au point d'accès spécifié. NeoLoad affiche le code de réponse associé et le nombre d'assertions ayant échouée pour la requête. Lorsque la ligne est sélectionnée, la fenêtre affiche plus de détails dans la partie basse du panneau. Vous pouvez choisir d'afficher la requête SOAP envoyée ou la réponse XML.

   

   	Astuce
   	Vous pouvez rechercher une expression particulière en cliquant au bouton droit Rechercher... ou en utilisant le raccourci clavier: CONTROL + F.

   	Astuce
   	Cliquer au bouton droit sur le contenu XML et sélectionner Indenter le XML pour indenter le XML.

   Si vous suivez notre exemple, la première fois que vous soumettrez la requête, la réponse ressemblera au texte suivant: (les entêtes HTTP ont été omises):

   <?xml version="1.0" encoding="utf-8"?>
   <soap:Envelope 
        xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
        xmlns:xsd="http://www.w3.org/2001/XMLSchema">
     <soap:Header/>
     <soap:Body>
       <soap:Fault>
         <faultcode>soap:Client</faultcode>
         <faultstring>
           Thank you for your attempt to try this Web service. Before the 
           free trial can occur, 
           you must first validate your email address. 
           Simply click on the link in the email that was just sent to you, 
           and you will then be able to invoke every Web service 
           within the StrikeIron Web Services Marketplace, including this one.
         </faultstring>
         <faultactor/>
       </soap:Fault>
     </soap:Body>
   </soap:Envelope>

   Comme indiqué par l'élément faultstring, tout ce que vous avez à faire pour utiliser ce service un nombre limité de fois est de valider l'adresse email que vous avez envoyé en suivant le lien que Strikelron vous a communiqué. Une fois l'adresse validée, la réponse devrait ressembler à:

   <?xml version="1.0" encoding="utf-8"?>
   <soap:Envelope 
       xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
       xmlns:xsd="http://www.w3.org/2001/XMLSchema">
     <Header xmlns="http://schemas.xmlsoap.org/soap/envelope/">
       <SubscriptionInfo xmlns="http://ws.strikeiron.com">
         <LicenseStatusCode>1</LicenseStatusCode>
         <LicenseStatus>Valid key</LicenseStatus>
         <LicenseActionCode>0</LicenseActionCode>
         <LicenseAction>Decremented hit count</LicenseAction>
         <RemainingHits>4</RemainingHits>
         <Amount>0</Amount>
       </SubscriptionInfo>
     </Header>
     <soap:Body>
       <GetNewWordResponse 
           xmlns="http://www.textdisguise.com/TextDisguise/CaptchaService/">
         <GetNewWordResult>
           <CaptchaImageGuid>
             82e16912-14c1-4253-bbcb-699585e3ba63
           </CaptchaImageGuid>
           <Url>
             http://www.textdisguise.com/TextDisguise/CaptchaService/
             CaptchaImage.aspx?
             guid=82e16912-14c1-4253-bbcb-699585e3ba63
           </Url>
         </GetNewWordResult>
       </GetNewWordResponse>
     </soap:Body>
   </soap:Envelope>
   

   A partir d'ici vous pouvez utiliser le lien défini par l'élément Url dans une page HTML. Comme précisé dans la section suivante, vous pouvez alors utiliser la méthode ValidateImageWord et CaptchaImageGuid pour valider le texte entré par l'utilisateur.

Créer une requête SOAP manuellement

1. Sélectionner le mode Conception de NeoLoad

   Utiliser le bouton .

2. Créer une nouvelle requête

   Cliquez au bouton droit sur l'utilisateur virtuel et sélectionner "Insérer dans", puis "Requête SOAP".

3. Spécifier la création manuelle

   Sélectionner l'option Générer la requête manuellement.

   

   Sélectionner le bouton Suivant.

4. Choisir un nom pour la requête

   Entrer un nom pour cette requête.

   Dans notre exemple nous nommerons la requête ValidateImageWord.

   

   Sélectionner le bouton Suivant.

5. Définir le point d'accès

   Il s'agit de l'URL où le service web est situé. Dans notre exemple, le point d'accès (end point) est: http://ws.strikeiron.com:80/textdisguise/CaptchaService.

   

   Sélectionner le bouton Terminer.

6. Vérifier les éléments principaux de configuration

   A ce niveau, la requête SOAP est ajoutée à l'utilisateur virtuel sélectionné précédemment.

   

   Le panneau NeoLoad de droite affiche les éléments de configuration principaux de la requête SOAP. Cela inclut l'URL d'accès au service qui définit avec les éléments Serveur et Chemin. Comme pour les requêtes HTTP, l'élément Chemin peut utiliser des variables NeoLoad.

7. Vérifier les entêtes HTTP

   La plupart des requêtes SOAP nécessitent au moins deux entêtes HTTP lorsque la requête est effectuée au travers d'HTTP. Il est préférable de vérifier que ces éléments sont correctement positionnés. Ils sont accessibles par la fenêtre Paramètres avancés en cliquant le bouton :

   

   Dans notre exemple ces éléments sont ContentType et SOAPAction.

Configurer le contenu XML

Pour configurer le XML, sélectionner le bouton Editer le contenu XML.

A ce niveau, vous devez définir la requête XML soit en effectuant un copier-coller d'une requête que vous testez ou définir manuellement chaque noeud et attribut de la requête. Nous utiliserons le copier-coller dans notre exemple.

Copier puis coller une requête XML existante dans le panneau Texte XML est le moyen le plus facile de définir le contenu XML. Dans notre exemple, nous copions le contenu de la méthode ValidateImageWord:

Vous pouvez aussi utiliser le panneau Arbre XML pour définir manuellement ou par éditer les éléments XML. NeoLoad construit automatiquement une vue à partir de l'autre (Arbre XML à partir de Texte XML et vice versa). Le panneau Arbre XML ressemble à:

A ce niveau la requête est complètement définie et vous pouvez la tester.

Tester la requête SOAP

En créant un utilisateur virtuel temporaire, NeoLoad fournit une méthode facile et rapide de tester vos requêtes SOAP. Sélectionner le bouton pour tester votre requête.

1. Démarrer la vérification

   Si vous avez déjà testé des utilisateurs virtuels avec NeoLoad, vous êtes familier avec cette fenêtre. En sélectionnant le bouton Lancer la validation, NeoLoad génère une requête SOAP et l'envoie au point d'accès spécifié. NeoLoad affiche le code de réponse associé et le nombre d'assertions ayant échouée pour la requête. Lorsque la ligne est sélectionnée, la fenêtre affiche plus de détails dans la partie basse du panneau. Vous pouvez choisir d'afficher la requête SOAP envoyée ou la réponse XML.

   

   	Astuce
   	Vous pouvez rechercher une expression particulière en cliquant au bouton droit Rechercher... ou en utilisant le raccourci clavier: CONTROL + F.

   	Astuce
   	Cliquer au bouton droit sur le contenu XML et sélectionner Indenter le XML pour indenter le XML.

Extraire l'identifiant d'image (le CaptchaImageGuid) de la réponse à la requête GetNewWord.

1. Sélectionner le mode Conception en sélectionnant le bouton .

2. Sélectionner l'onglet Utilisateurs Virtuels.

3. Ouvrir l'utilisateur virtuel.

4. Sélectionner la requête GetNewWord d'où l'identifiant sera extrait.

   

5. Ouvrir l'onglet Extracteur de Variable

   1. Ouvrir la fenêtre des paramètres avancés en utilisant le bouton .

   2. Sélectionner l'onglet Extracteurs de Variable:

      

6. Définir une nouvelle variable

   Sélectionner le bouton pour créer une nouvelle variable d'extraction. Dans notre exemple, nous définissons la variable captchaImageGuid. La manière d'identifier et d'extraire la valeur est plutôt simple car la réponse XML est simple. Nous voulons extraire tout ce qui apparait entre les tags XML <captchaImageGuid> et </captchaImageGuid> tags:

   

   A ce niveau, la définition de l'extraction est terminée. A chaque invocation de GetNewWord, NeoLoad extraira l'identifiant d'image et l'attribuera à la variable captchaImageGuid.

   Pour plus d'informations sur l'extraction de variables, se reporter à la section intitulée « Créer un extracteur de variable » et au guide de référence.

Réinjecter la valeur dans la requête ValidateImageWord

1. Sélectionner la requête ValidateImageWord où l'identifiant doit être injecté.

2. Sélectionner le bouton Editer le contenu XML.

3. Sélectionner l'onglet Arbre XML.

4. Sélectionner l'élément captchaImageGuid dans l'arbre XML.

5. Utiliser le picker de variables en utilisant le bouton .... Vous pouvez aussi commencer à taper ${c et NeoLoad suggérera des noms de variables.

6. Choisir la variable captchaImageGuid

   La fenêtre du contenu XML devrait ressembler à:

   

   Avec une telle configuration NeoLoad extrait l'identifiant d'image de la réponse à GetNewWord et l'injecte dans la requête ValidateImageWord.