Ajoute un entête à la prochaine fonction SOAP d'un Webservice à exécuter.
L'entête ajouté peut contenir des paramètres supplémentaires affectant la requête SOAP. Généralement, les informations ajoutées dans les entêtes ne sont pas directement des paramètres de la fonction du Webservice mais des meta informations telles que des informations d'authentification par exemple.
// Ajout d'un entête à la prochaine procédure SOAP exécutée
// Cet entête permet de vérifier le niveau de sécurité utilisée par le serveur SOAP
// Si le niveau de sécurité maximum n'est pas utilisé,
// la prochaine procédure SOAP ne sera pas exécutée
SOAPAjouteEntête("Sécurité", "SécuritéMax", "Sécurité-Niveau", Vrai)
Syntaxe
Personnaliser l'entête du Webservice Masquer les détails
SOAPAjouteEntête(<Nom du webservice> , <Elément à ajouter dans l'entête>)
<Nom du webservice> : Webservice
Nom du webservice à manipuler. Le nom du Webservice est affiché dans le volet "Explorateur de projet", dans le dossier "Webservices".
<Elément à ajouter dans l'entête> : Type simple ou complexe
Variable du type de l'entête à insérer dans l'appel de la méthode du Webservice. Les différents types disponibles ont été récupérés lors de l'importation du fichier WSDL. Cet élément est ajouté dans l'entête à chaque appel d'une fonction SOAP du Webservice.
Ajouter un entête pour un Webservice spécifique Masquer les détails
SOAPAjouteEntête(<Nom du webservice> , <Nom du paramètre> , <Valeur du paramètre> , <Espace de nommage du paramètre>)
<Nom du webservice> : Webservice
Nom du webservice à manipuler. Le nom du Webservice est affiché dans le volet "Explorateur de projet", dans le dossier "Webservices".
<Nom du paramètre> : Chaîne de caractères
Nom du paramètre supplémentaire. Ce paramètre supplémentaire est utilisé pour vérifier une information spécifique au serveur SOAP.
Ce paramètre est fourni dans la documentation du serveur SOAP et de ses fonctions.
<Valeur du paramètre> : Tout type
Valeur du paramètre supplémentaire. Les différentes valeurs possibles sont fournies dans la documentation du serveur SOAP et de ses fonctions.
<Espace de nommage du paramètre> : Chaîne de caractères
Espace de nommage (aussi appelé "NameSpace") du paramètre. Ce paramètre est fourni dans la documentation du serveur SOAP et de ses fonctions.
Remarques
Exécution de la procédure (syntaxe 4, conservée par compatibilité)
Il est possible d'exécuter ou non la prochaine procédure SOAP grâce à l'ajout d'un entête. Pour cela, le paramètre <Exécution de la procédure> doit être initialisé à
Vrai.
Si le paramètre <Exécution de la procédure> est initialisé à Vrai :
- La fonction SOAPExécute (ou SOAPExécuteXML) retourne Vrai si la liaison avec le serveur SOAP a été établie, Faux dans le cas contraire.
- Si la liaison avec le serveur SOAP a été établie et si le serveur SOAP répond aux conditions demandées par l'entête, la procédure s'exécute.
- Si la procédure a été exécutée, la fonction SOAPDonneRésultat retourne :
- le résultat de la procédure si la procédure a été exécutée avec succès,
- une chaîne vide ("") si la procédure a échoué.
- Si la procédure a échoué ou n'a pas été exécutée, la fonction SOAPErreur retourne :
- le code d'erreur "MustUnderstand" si le serveur SOAP ne répond pas aux conditions demandées par l'entête,
- une erreur dans les autres cas.
Classification Métier / UI : Code métier
Composante : wd270com.dll