Les Services Internet

XINX propose d'interagir faiblement avec les services Internet. Il permet de faire quelques opérations plus facilement. Il a été écrit et testé pour être utilisé avec les fichiers de description et les services internet de Generix mais peut fonctionner avec d'autres services.

Le protocole SOAP n'est pas entièrement implémenté, ainsi que la lecture des fichiers WSDL.

Configuration des services

La configuration des services Internet se fait dans la boite de dialogue de propriété du projet. Il faut que la case soit cochée dans l'onglet Service Internet. Il faut également ajouter les liens vers les fichiers de description WSDL que XINX doit charger.

Au chargement du projet, l'application va télécharger chaque fichier de description pour pouvoir être utilisé par la suite.

Éditer un flux

Afin d'appeler un service Internet, il vous faut écrire un flux. Ce flux sera envoyé à l'aide du protocole SOAP au service Internet et ce dernier vous retournera le résultat.

Pour l'écriture du flux, il faut créer un fichier Nouveau Service Internet dans le menu Fichier. Un éditeur dédié au flux s'ouvre alors. La coloration syntaxique et celle d'un fichier XML.

Dans la barre du haut vous pouvez renseigner le service Internet que vous voulez appeler, l'action du service à solliciter et les différents paramètres disponibles pour le couple Service/Action?. Il peut y avoir plusieurs paramètres pour un service donné, chaque paramètre est enregistré dans le flux.

Chaque paramètre est enregistré dans le flux XML, ainsi que le service et l'action sélectionnés.

Les WebServices Generix, n'ont qu'un seul paramètre qui contient un fichier XML. C'est pour cela que XINX utilise la coloration syntaxique du XML.

La saisie des flux peut-être simplifiée grâce à l'utilisation de Snipet que vous pouvez trouver dans le menu Outils ou dans la boîte à outils des Snipets. XINX possède plusieurs Snipets par défaut permettant la saisie de quelques Services Internet propre à Generix.

Execution du Service

L'exécution du service se fait à l'aide de l'icône Appeler le service Internet ou du menu Service internet. Cette action est faite sur l'éditeur courant. Le service Internet sélectionné est alors appelé avec l'action selectionnée.

Quand l'appel au service internet est fait, une boite de dialogue affichant alors la progression de la communication s'affiche. Si une erreur se produit, la boite reste alors affichée affichant le message d'erreur.

Si l'exécution se passe sans erreur, une boite de dialogue affichant le résultat s'affiche alors. Vous pouvez alors voir dans la partie haute, le flux que vous avez envoyé et dans la partie basse la réponse du service Internet.