PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • 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 WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
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.
Versions 22 et supérieures
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Nouveauté 22
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
// 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 WINDEV 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 connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
<URL du serveur SOAP> : Chaîne de caractère (avec guillemets)
URL du serveur SOAP à contacter. Ce paramètre est fourni dans la documentation du serveur SOAP et de ses procédures.
Dans le cas d'un serveur SOAP réalisé avec WINDEV, il est nécessaire de faire suivre l'URL de la chaîne "/.soap". Par exemple :
"http://192.168.1.138/.soap".
<Nom de la procédure> : Chaîne de caractères (avec guillemets)
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 (avec guillemets)
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.
Si vous utilisez un serveur SOAP WINDEV, ce paramètre est obligatoire. Le nom de la bibliothèque (WDL) est précisé grâce au namespace ("<Nom de l'application Serveur>" devient sur le serveur "c:\modulessoap\<Nom de l'application Serveur>.wdl ").
Remarque : Le mot-clé urn: n'est pas obligatoire dans ce paramètre.
<Action de la procédure> : Chaîne de caractères optionnelle (avec guillemets)
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 (avec guillemets)
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.

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 connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
<URL du serveur SOAP> : Chaîne de caractère (avec guillemets)
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 (avec guillemets)
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 (avec guillemets)
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 (avec guillemets)
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.
Composante : wd250com.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire