Exemple d'utilisation de l'action Service Web SOAP

Utilisez l'action Service Web SOAP pour transmettre deux valeurs numériques et renvoyer la somme à partir d'une application de calcul en ligne.

Procédure

Pour effectuer un appel de services Web SOAP, procédez comme suit :

  1. Double-cliquez sur l'action Services Web SOAP ou faites-la glisser.
  2. Sélectionnez une méthode de connexion :
    • Pour vous connecter à l'aide d'un URI, saisissez l'URI, par exemple, http://www.dneonline.com/calculator.asmx?WSDL.
    • Pour vous connecter à l'aide d'un fichier, sélectionnez un fichier dans la Control Room ou sur le bureau, ou insérez une variable.
  3. Facultatif : Entrez le point de terminaison SOAP dans le champ Emplacement de l'adresse.
    Si vous spécifiez l'emplacement de l'adresse, le robot l'utilisera lors de l'exécution. Sinon, le robot utilisera l'emplacement de l'adresse indiqué dans le fichier WSDL.
    Remarque : Si vous créez l'URI SOAP manuellement sans utiliser l'option Construire une requête SOAP passez à l'étape Exemple d'utilisation de l'action Service Web SOAP.
  4. Cliquez sur Construire une requête SOAP.
    La fenêtre Requête SOAP apparaît et affiche les services et les ports, avec des détails sur leurs opérations et leurs paramètres.
  5. Dans la fenêtre Requête SOAP, développez le service pour lequel vous souhaitez afficher la liste des ports. Cliquez sur le port requis pour afficher la liste des opérations disponibles. Sélectionnez l'opération souhaitée et cliquez sur Appliquer pour récupérer les détails de l'opération à partir de la requête SOAP.
    Si vous utilisez l'option Construire une requête SOAP, les champs Services, Port, Opération et Paramètres d'opération sont automatiquement remplis avec les détails de l'opération que vous avez sélectionnée. Passez à l'étape Exemple d'utilisation de l'action Service Web SOAP.
  6. Dans le champ Service, entrez le nom du service.
    Ce champ identifie l'ensemble de ports pris en charge par le service Web. Il contient le@nom du servicepour un appel de service Web SOAP, par exemple, Calculator.
  7. Facultatif : Dans le champ Port, entrez le point de terminaison auquel vous souhaitez vous connecter.
    Si vous ne spécifiez aucun port, le robot utilisera le premier port mentionné dans le fichier WSDL en fonction du service sélectionné. Cependant, si ce port n'est pas pris en charge par le service Web SOAP, l'exécution du robot échouera.
    Ce champ contient le@nom de la liaisonpour un appel de service Web SOAP, par exemple, CalculatorSoap.
  8. Sélectionnez la version SOAP du point de terminaison que vous avez spécifié dans le champ Port.
    Choisissez 1.1 ou 1.2.
    Remarque : La version SOAP peut être déterminée en utilisant l'un des espaces de noms suivants spécifiés dans le fichier WSDL :
    • Espace de noms SOAP 1.1 : http://schemas.xmlsoap.org/soap/envelope
    • Espace de noms SOAP 1.2 : http://www.w3.org/2003/05/soap-envelope
  9. Dans le champ Opération, entrez le nom de la fonction de service pour le point de terminaison que vous avez spécifié dans le champ Port.
    L'exécution du robot échoue si l'une des conditions suivantes est remplie :
    • Le port mentionné dans le champ Port n'a pas d'opérations.
    • L'opération mentionnée dans la requête SOAP pour le port est indisponible.
    Ce champ contient le@nom de l'opérationpour un appel de service Web SOAP, par exemple, Add.
  10. Sélectionnez Paramètres d'opération ou Paramètres des données brutes pour indiquer les détails des paramètres.
    Remarque : Si vous avez sélectionné Construire une requête SOAP, le tableau contenant les détails des paramètres dans l'onglet Opération est automatiquement rempli avec les paramètres de l'opération sélectionnée. Fournissez des valeurs pour ces paramètres. Vous pouvez également ajouter, modifier ou supprimer des paramètres pour une opération donnée.
    • Si vous sélectionnez Paramètres d'opération, entrez le nom et la valeur de chaque paramètre. Par exemple, saisissez les valeurs suivantes :
      1. intA dans le premier champ Nom
      2. 10 dans le premier champ Valeur
      3. intB dans le deuxième champ Nom
      4. 20 dans le deuxième champ Valeur
    • Si vous choisissez Paramètres de données brutes, sélectionnez Paramètres ou Paramètres des informations d'identification.
  11. Paramètres : Vous pouvez utiliser les valeurs d'informations identification de la consigne dédiée sans exposer les informations d'identification (nom d'utilisateur ou mot de passe) en texte brut dans les données brutes. Pour ce faire, vous devez d'abord mapper les informations d'identification dans le mappeur d'informations d'identification et utiliser le nom de référence dans les données brutes entre accolades.

    Par exemple, dans les données brutes, vous avez fourni le mot de passe en texte brut pour vous authentifier auprès du serveur.

    <aut:AuthHeader>
    <aut:Password> abc@123</aut:Password>
    </aut:AuthHeader>
    
    Pour utiliser le mot de passe de la consigne d'informations d'identification, procédez comme suit :
    1. Cliquez sur Ajouter un remplacement.
      Saisissez le nom de référence, par exemple pwd, dans le champ Nom en XML. Sélectionnez Information d'identification pour utiliser une valeur disponible dans le coffre des informations d'identification, Variable pour utiliser une variable d'information d'identification ou Chaîne non sécurisée pour spécifier manuellement la valeur que vous souhaitez utiliser.
      Pour plus d'informations sur les coffres d'informations d'identification et leur utilisation, reportez-vous à la section Informations d'identification et consignes dans le Credential Vault.
    2. Cliquez sur Ajouter.
    3. Spécifiez la référence dans les données brutes entre accolades, comme suit :
      <aut:AuthHeader>
      <aut:Password>{{pwd}}</aut:Password>
      </aut:AuthHeader>
      
      Le nom de la référence pwd spécifié dans les données brutes remplace la valeur correspondante, stockée dans le coffre des informations d'identification.
      Veillez à entrer le nom de la référence au même format que celui spécifié dans le champ Ajouter un remplacement. Par exemple, si vous avez saisi le mot de passe pwd dans le champ Ajouter un remplacement et que vous avez saisi le nom de référence password dans les données brutes, lorsque vous exécutez le robot, une erreur se produit sur le robot lors de son exécution.
  12. Paramètres d'information d'identification : ce champ permet de saisir des paramètres de données brutes comme informations d'identification. Vous pouvez choisir Information d'identification pour utiliser une valeur disponible dans le coffre des informations d'identification, ou sélectionner Variable pour utiliser une variable d'information d'identification ou Chaîne non sécurisée pour spécifier manuellement la valeur que vous souhaitez utiliser.
  13. Sélectionnez Aucune authentification ou Basique dans la liste Mode d'authentification.
    • Si vous sélectionnez Aucune authentification, passez à l'étape suivante.
    • Si vous sélectionnez Basique, entrez vos informations d'identification.
  14. Facultatif : Indiquez un certificat client en sélectionnant un fichier dans la Control Room ou sur votre bureau, ou insérez une variable.
  15. Facultatif : Indiquez des en-têtes personnalisés.
  16. Facultatif : Indiquez un fichier pour enregistrer la sortie XML.
  17. Sélectionnez Réponse complète ou Réponse sélectionnée pour limiter la portée de la réponse.
    • Si vous sélectionnez Réponse complète, passez à l'étape suivante.
    • Si vous sélectionnez Réponse sélectionnée, effectue les étapes suivantes si vous créez l'expression Xpath manuellement et que vous n'utilisez pas l'option Construire Xpath.
      1. Indiquez l'expression XPath. Par exemple :
        /*[local-name()='Envelope' and namespace-uri()='http://schemas.xmlsoap.org/soap/envelope/']/*[local-name()='Body' and namespace-uri()='http://schemas.xmlsoap.org/soap/envelope/']/*[local-name()='AddResponse' and namespace-uri()='http://tempuri.org/']/*[local-name()='AddResult' and namespace-uri()='http://tempuri.org/']
      2. Sélectionnez une section de la sortie XML : Valeurs, XML interne ou XML externe.
      3. Si vous sélectionnez l'option Valeurs, choisissez de renvoyer le contenu en tant que : Chaîne délimitée par ou Liste de chaînes de caractères.
        • Si vous sélectionnez Chaîne délimitée par, choisissez l'une option de délimitation : Barre verticale, Point-virgule ou Personnalisé.
          Si vous sélectionnez Personnalisé, saisissez des variables ou des caractères dans le champ Délimiteur personnalisé (facultatif).
          Remarque : Le caractère spécial du symbole dollar ($) n'est pas pris en charge comme délimiteur.
        • Sélectionnez Liste de chaînes pour renvoyer la sortie de la réponse Soap sous forme de liste de chaînes.
          Remarque : Vous pouvez uniquement une variable de type liste dont le type de données est une chaîne.
  18. Cliquez sur Construire XPath.
    La fenêtre Aperçu de la sortie s'ouvre.
  19. Sélectionnez le nœud approprié dans le corps de la réponse. Le chemin XML est automatiquement créé. Cliquez sur Appliquer.
    Si vous utilisez l'option Construire XPath, les champs Expression XPath et Valeur seront automatiquement remplis avec les détails de l'opération que vous avez sélectionnée.
  20. Facultatif : Pour définir une valeur de délai d'expiration lorsque vous envoyez une demande SOAP et recevez une réponse, dans le champ Attendre la fin de l'action, indiquez le temps d'attente (en millisecondes).
    Par défaut, le temps d'attente est de 60 000 millisecondes.
  21. Configurez le certificat P12 :
    • Pour obtenir le fichier de certification SSL, sélectionnez l'une des options suivantes : Fichier de la Control Room, Fichier de bureau ou Variable
    • Configurez les propriétés du magasin de clés :
      • Fichier de magasin de clés (facultatif) : pour fournir le fichier de magasin de clés au format .p12, sélectionnez l'une des options suivantes : Fichier de la Control Room, Fichier de bureau ou Variable. Le fichier de magasin de clés comprend la clé privée et le certificat du client.
      • Mot de passe du magasin de clés (facultatif) : pour fournir le mot de passe du fichier de magasin de clés, sélectionnez l'une des options suivantes : Information d'identification, Variable ou Chaîne non sécurisée. Le mot de passe est utilisé pour accéder au fichier de magasin de clés.
  22. Sélectionnez une variable pour stocker la sortie XML.
    Par exemple : prompt-assignment
  23. Vérifiez la sortie de l'action Service Web SOAP en insérant une action Zone de message avec la variable prompt-assignment dans le corps du message.
    Lorsque vous exécutez le robot, la zone de message doit afficher 30.