Requête SOAP

UiPath.Web.Activities.Design.SoapClientWithBodyFactory

Description

Permet d'effectuer des requêtes HTTP vers une API Web spécifiée qui utilise le protocole SOAP. Lorsque vous faites d'abord glisser cette activité vers le volet Concepteur (Designer), la fenêtre Assistant de requête SOAP (SOAP Request Wizard) apparaît. L'assistant fournit un moyen simple de créer des requêtes et de prévisualiser les réponses du serveur. Une fois que vous avez fermé l'assistant, vous ne pouvez pas le rouvrir.

Tous les champs présents dans cette fenêtre sont également disponibles dans le volet Propriétés. Par conséquent, vous pourrez toujours modifier vos préférences après la fermeture de l'assistant.

Compatibilité du projet

Windows - Héritage

Remarque :

Les requêtes SOAP ne sont prises en charge que par les projets Windows - Héritage. Si vous devez exécuter des requêtes SOAP dans des projets Windows ou multiplateformes, essayez plutôt ces solutions :

• Utilisez une version héritée de Windows pour l’ensemble de votre processus.
• Utilisez un processus Windows Héritage juste pour la partie Demande SOAP et invoquez-le à partir d’un processus Windows via des arguments d’entrée/de sortie
• Utilisez l’activité Appeler le code (Invoke Code).
• Utilisez des workflows codés (disponibles à partir de Studio 2023.10).
• Utilisez l’activité Requête HTTP (HTTP Request) pour créer votre propre requête qui correspond à la définition SOAP. Assurez-vous d’utiliser les en-têtes appropriés et d’inclure le bon XML dans le corps de votre demande.

Fenêtre de l'Assistant de requête SOAP

• Service Description - The WSDL schema location.
• Menu Ellipsis : permet de parcourir le disque dur à la recherche d’un fichier .
• Obtenir (Get) : extrait les informations du fichier .wsdl et affiche les paramètres disponibles dans la table.
• Contrat (Contract) - Nom du contrat qui décrit les méthodes exposées par le service SOAP.
• Méthode (Method) : liste de toutes les méthodes prises en charge. La modification de la méthode modifie également les paramètres affichés dans la table.

Table des paramètres

• Nom (Name) - Nom de tous les paramètres pris en charge.
• Type (Type) - Type de chaque paramètre pris en charge. Dans certains cas, pointez sur le Type (Type) pour afficher d'autres informations (par exemple, si le paramètre est facultatif ou non).
• Valeur (Value) - Permet d'ajouter une valeur pour chaque paramètre, afin d'effectuer la requête souhaitée.
• Authentification : liste déroulante qui permet de sélectionner le type d’authentification utilisé par le service Web. Les options suivantes sont disponibles :
  • None (Aucun) - Option par défaut. Indique que le service Web n'utilise aucune sorte d'autorisation.
  • Simple (Simple) - Indique que le service utilise une authentification simple. Si cette méthode est sélectionnée, les champs Nom d'utilisateur (Username) et Mot de passe (Password) apparaissent, ce qui vous permet de saisir vos informations d'identification.
  • Windows (Windows) - Indique que le service utilise l'authentification Windows.
  • Certificat client (Client Certificate) - Indique que le service utilise les certificats clients pour l'autorisation. Si cette option est sélectionnée, le champ Certificat client (Client Certificate) s'affiche, ce qui vous permet de rechercher votre certificat sur votre lecteur local.
• Appeler (Invoke) - Permet d'effectuer la requête avec les options spécifiées.
• Réponse (Response) - Affiche un aperçu de la réponse du serveur Web.

Propriétés

Authentification du certificat client

• Certificat client (Client Certificate) - Indique que le service utilise les certificats clients pour l'autorisation et permet de rechercher votre certificat sur le lecteur local.
• ClientCertificatePassword - The password for the client certificate. This field supports String variables.
• SecureClientCertificatePassword - The password for the client certificate, in the form of a Secure String variable.

Commun

• ContinuerSurErreur (ContinueOnError) : spécifie si l’automatisation doit se poursuivre même lorsque l’activité génère une erreur. Ce champ prend uniquement en charge les valeurs booléennes (Vrai (True), Faux (False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu’une erreur est générée, l’exécution du projet s’arrête. Si le champ indique au contraire True, l’exécution du projet se poursuit même en cas d’erreur.
  Remarque :

  Si cette activité est incluse dans Tenter de capturer (Try Catch) et que la valeur de la propriété Poursuite sur erreur (ContinueOnError) est True, aucune erreur n'est détectée lors de l'exécution du projet.

• NomAffichage (DisplayName) - Nom affiché de l'activité.

Entrée

• Nom du contrat (Contract Name) - Nom du contrat décrivant les méthodes exposées par le service SOAP. Cette propriété prend en charge les chaînes et les variables de chaîne.
• Point de terminaison (End point) - Emplacement du schéma WSDL. Par défaut, l'URL http://www.webservicex.com/globalweather.asmx?wsdl est fournie à des fins de test. Cette propriété prend en charge les chaînes et les variables de chaîne et correspond au champ Description du service (Service Description), dans la fenêtre Assistant de requête SOAP (SOAP Request Wizard).
• Méthode (Method) - Nom de la méthode appelée par le client.
• Paramètres (Parameters) : paramètres de la méthode spécifiée. Sélectionnez le bouton Ellipse pour afficher la fenêtre Paramètres (Parameters) dans laquelle vous pouvez ajouter les paramètres souhaités.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Sortie

• Headers - The response received from the SOAP request.
• Result - The web server's response, as a String variable.

Authentification simple

• Nom d'utilisateur (Username) - indique que le service Web utilise une authentification simple et vous permet de saisir votre nom d'utilisateur. L'ajout d'un mot de passe est également requis. Cette propriété prend en charge les chaînes et les variables de chaîne.
• Password - Indicates that the web service uses simple authentication and enables you to input your password. Adding a username is also required. This property supports Strings and String variables.
• SecurePassword - Indicates that the web service uses secure authentication and enables you to input your secure string password. Adding a username is also required. This property supports Secure String variables.

Authentification Windows

• Utiliser les identifiants Windows (UseWindowsCredentials) - Si cette case est cochée, les informations d'identification Windows doivent être utilisées avec le service Web spécifié.