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

• Description du service : l'emplacement du schéma WSDL.
• Menu Ellipsis : permet de parcourir le disque dur à la recherche d’un fichier .wsdl.
• 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 - Mot de passe du certificat client. Ce champ prend en charge String variables.
• SecureClientCertificatePassword - Mot de passe du certificat client, sous la forme d'une variable Secure String .

Commun

• Poursuite sur erreur (ContinueOnError) - Spécifie si l'automatisation doit continuer même si l'activité génère un message d'erreur. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et si une erreur est renvoyée, l'exécution du projet s'interrompt. Si la valeur est configurée sur True, l'exécution du projet continue indépendamment de toute erreur.

  Remarque : si cette activité est incluse dans l'activité Try Catch et que la valeur de la propriété ContinuerSurErreur est « True », aucune erreur ne sera 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

• En-têtes : Réponse reçue de requête SOAP.
• Résultat (Result) - Réponse du serveur Web sous la forme d'une variable String.

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.
• Mot de passe (Password) - indique que le service Web utilise une authentification simple et vous permet de saisir votre mot de passe. L'ajout d'un nom d'utilisateur est également requis. Cette propriété prend en charge les variables de Strings et String.
• MotdePasseSécurisé - indique que le service Web utilise une authentification sécurisée et vous permet de saisir votre mot de passe de chaîne sécurisée. L'ajout d'un nom d'utilisateur est également requis. Cette propriété prend en charge les variables Secure String.

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é.