DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / SOAP
  • Paramètres de la procédure à exécuter
  • Type du paramètre
  • Appel de la fonction SOAPExécute
  • Gestion des erreurs
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Avertissement
A partir de la version 2024, cette fonctionnalité n'est plus disponible
Exécute une procédure sur un serveur SOAP.
Remarques :
  • Les paramètres de la procédure doivent être spécifiés avant l'utilisation de la fonction SOAPExécute grâce à la structure SOAP (voir Notes).
  • Cette fonction ne gère pas les langues non latines.
  • Cette fonction est d'un usage avancé permettant de gérer certains cas particuliers. Dans la majorité des cas, il est recommandé d'importer le wsdl du webservice SOAP. Pour plus de détails, consultez Importation/consommation de Webservices.
// Définition des paramètres de la procédure "Température" qui
// retourne la température d'une ville identifiée par son code postal
SOAP.Valeur[1] = 94010
SOAP.Nom[1] = "CodePostal"
SOAP.Type[1] = SOAPTypeChaîne
// Exécution de la procédure "Température" sur un serveur non WINDEV
ResExécution = SOAPExécute("http://www.Temp.com/Degré", "Température", "urn:Temp-Degré")
Syntaxe

Exécuter une procédure sur un serveur SOAP quelconque Masquer les détails

<Résultat> = SOAPExécute(<URL du serveur SOAP> , <Nom de la procédure> [, <Espace de nommage de la procédure> [, <Action de la procédure> [, <Style d'encodage>]]])
<Résultat> : Booléen
  • Vrai si la communication avec le serveur SOAP a été établie,
  • Faux dans le cas contraire. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<URL du serveur SOAP> : Chaîne de caractère
URL du serveur SOAP à contacter. Ce paramètre est fourni dans la documentation du serveur SOAP et de ses procédures.
Pour soumettre une requête avec authentification, ce paramètre doit correspondre à :
http://utilisateur:motdepasse@URLServeur

Il est également possible de préciser le port en utilisant la syntaxe : http://utilisateur:motdepasse@URLServeur:port
<Nom de la procédure> : Chaîne de caractères
Nom de la procédure à exécuter sur le serveur SOAP spécifié. Ce paramètre est fourni dans la documentation du serveur SOAP et de ses procédures.
<Espace de nommage de la procédure> : Chaîne de caractères optionnelle (obligatoire dans le cas d'un serveur SOAP WINDEV)
Espace de nommage (appelé aussi "NameSpace") de la procédure à exécuter. Ce paramètre est fourni dans la documentation du serveur SOAP et de ses procédures.
<Action de la procédure> : Chaîne de caractères optionnelle
Action de la procédure (appelé aussi "SOAPAction"). Ce paramètre est fourni dans la documentation du serveur SOAP et de ses procédures.
<Style d'encodage> : Chaîne de caractères optionnelle
Style d'encodage de la procédure (appelé aussi "EncodingStyle"). Ce paramètre est fourni dans la documentation du serveur SOAP et de ses procédures.
Remarques

Paramètres de la procédure à exécuter

Pour passer des paramètres à une procédure exécutée sur un serveur SOAP, WINDEV utilise la structure suivante :
VariableTypeDétail
SOAP.NameSpaceChaîne de caractères optionnelleEspace de nommage (appelé "NameSpace") du paramètre.
SOAP.NomChaîne de caractèresNom du paramètre
SOAP.ParamXMLChaîne de caractères optionnelleDescription complète du paramètre sous forme XML. Si ce paramètre est spécifié, les autres paramètres (Valeur, Nom, Type, NameSpace et StyleEncodage) sont ignorés.
SOAP.StyleEncodageChaîne de caractères optionnelleStyle d'encodage (appelé "EncodingStyle") du paramètre.
SOAP.TypeConstanteType du paramètre
SOAP.ValeurTout typeValeur du paramètre
Cette structure doit être utilisée pour chaque paramètre. Par exemple :
SOAP.Valeur[1] = 94010
SOAP.Nom[1] = "CodePostal"
SOAP.Type[1] = SOAPTypeChaîne
Cette structure est équivalente à :
SOAP.ParamXML[1] = <CodePostal xsi:type="xsd:string">94010</CodePostal>

Type du paramètre

Le type du paramètre peut être :
ConstanteType
SOAPTypeBinaireBase64Binaire
SOAPTypeBinaireHexaBinaire hexadecimal
SOAPTypeBooléenBooléen
SOAPTypeChaîneChaîne de caractères
SOAPTypeChaîneNormaliséeChaîne de caractères sans retour chariot (RC) et sans tabulation (TAB)
SOAPTypeDécimalTout nombre sans limite
SOAPTypeEntierEntier compris entre - 2 147 483 648 et + 2 147 483 647)
SOAPTypeEntierCourtEntier court
SOAPTypeEntierCourtNonSignéEntier court non signé
SOAPTypeEntierIllimitéEntier (sans limite)
SOAPTypeEntierLongEntier long
SOAPTypeEntierLongNonSignéEntier long non signé
SOAPTypeEntierNégatifEntier négatif (sauf 0)
SOAPTypeEntierNonNégatifEntier non négatif
SOAPTypeEntierNonPositifEntier non positif
SOAPTypeEntierNonSignéEntier non signé
SOAPTypeEntierPositifEntier positif (sans 0)
SOAPTypeOctetOctet
SOAPTypeOctetNonSignéOctet non signé
SOAPTypeRéelRéel
SOAPTypeRéelDoubleRéel double
SOAPTypeURLAdresse URL

Appel de la fonction SOAPExécute

Après l'appel de la fonction SOAPExécute :
  • Les paramètres de la procédure sont effacés.
  • La structure de l'entête spécifié avec la fonction SOAPAjouteEntête est effacée.
  • La fonction SOAPDonneRésultat permet de récupérer le résultat de la procédure exécutée.
  • La fonction SOAPErreur permet de récupérer le message d'erreur de la procédure exécutée.

Gestion des erreurs

La fonction SOAPExécute retourne Faux si aucune communication avec le serveur SOAP n'a été établie. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
Attention : La fonction SOAPExécute peut retourner Faux avec un résultat correct si celui-ci contient le texte ":fault".
Cas particulier : Erreur "405 Method not allowed"
Cette erreur signifie qu'il manque la chaîne "/.soap" à la suite de l'URL du serveur SOAP réalisé avec WINDEV. Cette erreur peut également apparaître si le serveur Web n'est pas configuré pour utiliser le serveur SOAP WINDEV.
Classification Métier / UI : Code métier
Composante : wd290com.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/08/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale