|
|
|
|
|
|
|
|
|
|
- Paramètres de la procédure à exécuter
- Type du paramètre
- Appel de la fonction SOAPExécute
- Gestion des erreurs
SOAPExécute (Fonction) En anglais : SOAPRun
 Avertissement
A partir de la version 2024, cette fonction est conservée par compatibilité.
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.
SOAP.Valeur[1] = 94010
SOAP.Nom[1] = "CodePostal"
SOAP.Type[1] = SOAPTypeChaîne
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 : | | | | Variable | Type | Détail |
|---|
| SOAP.NameSpace | Chaîne de caractères optionnelle | Espace de nommage (appelé "NameSpace") du paramètre. | | SOAP.Nom | Chaîne de caractères | Nom du paramètre | | SOAP.ParamXML | Chaîne de caractères optionnelle | Description 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.StyleEncodage | Chaîne de caractères optionnelle | Style d'encodage (appelé "EncodingStyle") du paramètre. | | SOAP.Type | Constante | Type du paramètre | | SOAP.Valeur | Tout type | Valeur 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>
Le type du paramètre peut être : | | | Constante | Type |
|---|
| SOAPTypeBinaireBase64 | Binaire | | SOAPTypeBinaireHexa | Binaire hexadecimal | | SOAPTypeBooléen | Booléen | | SOAPTypeChaîne | Chaîne de caractères | | SOAPTypeChaîneNormalisée | Chaîne de caractères sans retour chariot (RC) et sans tabulation (TAB) | | SOAPTypeDécimal | Tout nombre sans limite | | SOAPTypeEntier | Entier compris entre - 2 147 483 648 et + 2 147 483 647) | | SOAPTypeEntierCourt | Entier court | | SOAPTypeEntierCourtNonSigné | Entier court non signé | | SOAPTypeEntierIllimité | Entier (sans limite) | | SOAPTypeEntierLong | Entier long | | SOAPTypeEntierLongNonSigné | Entier long non signé | | SOAPTypeEntierNégatif | Entier négatif (sauf 0) | | SOAPTypeEntierNonNégatif | Entier non négatif | | SOAPTypeEntierNonPositif | Entier non positif | | SOAPTypeEntierNonSigné | Entier non signé | | SOAPTypeEntierPositif | Entier positif (sans 0) | | SOAPTypeOctet | Octet | | SOAPTypeOctetNonSigné | Octet non signé | | SOAPTypeRéel | Réel | | SOAPTypeRéelDouble | Réel double | | SOAPTypeURL | Adresse 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.
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 : wd300com.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|