Documentation Web service SOAP
Mise en oeuvre
La mise en oeuvre des webservices dans FormPublisher s'opère par l'usage de la balise WebService.
La balise WebService est rendue de la manière suivante en mode Edit :
La balise WebService est rendue de la manière suivante en mode Flow :
Enfin, les propriétés associées sont les suivantes :
L'on retrouve ici les propriétés décrites précédemment, ainsi que InputMapping et OutputMapping qui permettent de renseigner template et properties pour le premier choix et mapping pour le second.
Ceci s'opère par le biais d'assistants.
L'assistant InputMapping :
Son environnement de simulation, démarré par la flèche verte (en haut à gauche) :
On remarquera que l'outil de simulation indique les données à renseigner avant d'effectuer l'appel. Le mode Advanced affichera directement les enveloppes soap envoyées et reçues lors de l'échange aller/retour avec le WebService de type 
Document Literal Wrapped.
L'assistant OutputMapping :
Celle-ci introduit un comportement spécifique
L'usage de WebService introduit un comportement spécifique à adopter lors de cas extrêmes comme la non réponse par le WebService (NoAnswer) et l'absence de données extraites de la réponse (NoData).
Par défaut, le comportement est le suivant :
-
NoAnswer : cela va générer une erreur de code ERR042 qui sera propagée jusqu'à la page error.xml. La session sera close et les données de l'utilisateur seront perdues.
-
NoData : est ignoré par FormPublisher.
Il y a donc quatre niveaux de réponse aux cas extrêmes :
-
Fatal : session close
-
Error : session conservée mais il est conseillé à l'utilisateur d'arrêter de travailler et de sauvegarder ses données
-
Warning : session conservée mais l'utilisateur est averti du dysfonctionnement.
-
Ignore : aucune information n'est indiquée.
L'auteur peut influer sur le comportement par défaut en utilisant OnErrorAction sur la balise WebService associée :
Ici on a associé deux OnErrorAction à ce WebService.
La balise OnErrorMessage permet d'indiquer le message qui sera affiché à l'utilisateur. Si elle est manquante, le message technique associé au cas extrême rencontré sera affichée.
Le cas extrême et le niveau de réponse sont renseignés sur la balise OnErrorAction par le biais de la fenêtre Propeties associée.