Lire et examiner la documentation Automation Anywhere

Automation Anywhere Automation 360

Fermer les contenus

Contenus

Ouvrir les contenus

Exemple d'utilisation de l'action Service Web SOAP

  • Mis à jour le : 2022/03/10
    • Automation 360 v.x
    • Créer
    • Espace de travail RPA
    • Exemples

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, entrez 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 bot l'utilisera lors de l'exécution. Sinon, le bot 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 6.
  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 10.
  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 service pour un appel de service Web SOAP (par exemple, Calculatrice).
  7. Facultatif : Dans le champ Port, entrez le point de terminaison auquel vous souhaitez vous connecter.
    Si vous ne spécifiez aucun port, le bot 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 bot échouera.
    Ce champ contient le @nom de la liaison pour 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.
  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 bot é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ération pour un appel de service Web SOAP (par exemple, Ajouter).
  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.
      Entrez 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 lockers 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 remplacera 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 entré le mot de passe pwd dans le champ Ajouter un remplacement et que vous avez entré le nom de référence password dans les données brutes, lors de l'exécution du bot, le bot rencontrera une erreur.
  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 Valeurs, choisissez une option de délimitation : Barre verticale ou Point-virgule.
      4. Si vous sélectionnez Valeurs, choisissez 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.
  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. Sélectionnez une variable pour stocker la sortie XML.
    Exemple : prompt-assignment
  22. 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 bot, la zone de message doit afficher 30.
Envoyer le commentaire