Services web SOAP (SW SOAP)

Le mode d’accès SOAP n’est plus maintenu sur la plateforme SaaS en septembre 2024

Elément requis

Version

Harmony

> Harmony 401

IIS

> 7.5 (WServer 2008, W7)





Comment mettre en oeuvre des services web en mode SOAP pour permettre a des applications extérieures de communiquer avec l'ERP



L'appel en mode SOAP utilise un format d’enveloppe et un contenu en XML.

Installation On Premise

Lancer Harmony, choisir le menu Administration / Installation serveur client léger web

Cocher les cases suivantes et valider


Cette action installe le service dans le gestionnaire Microsoft IIS.

 

Contrôler par le bouton 'Ouvrir la console IIS' la console IIS qui doit permettre de déployer le dossier virtuel WebServiceDiva



Les objets windows(fichiers DLL) sont installés par exemple dans C:\divalto\Internet\WebServiceDiva

Gestion de droits windows

Les appels entrants par service web SOAP sont exécutés par défaut sur le compte utilisateur windows du service "Divalto DhsDivaAgent"

Cet utilisateur doit donc avoir des droits suffisants pour accéder aux données.



Installation Cloud

L'installation en mode cloud est déjà effective.



Chaque environnement dispose de cette fonctionnalité par défaut avec une adresse de connexion dédiée au service :

https://websvc.divaltocloud.com/[NUMEROSITE]/[ENVIRONNEMENT]/WebServiceDiva.asmx

Vous devez substituer [NUMEROSITE] par le numéro de votre site client ainsi que [ENVIRONNEMENT] par le nom de l’environnement que vous souhaitez exploiter.

Ce protocole se base sur des échanges HTTPS au format XML.

Contrôle

Il est possible de tester le web service dans un navigateur.

L'URL, avec le paramétrage par défaut, est sous la forme : http://nomDuServeur:Protocole/WebServiceDiva/webservicediva.asmx
http://localhost:8080/WebServiceDiva/webservicediva.asmx



Paramétrage d'environnements

Si le même serveur doit gérer des services web pour différents environnements, vous pouvez dupliquer l’installation existante afin de créer plusieurs dossiers virtuels sur le même principe que WebServiceDiva.

Il s'agit donc de copier le dossier physique en lui donnant le nom du nouveau service web

Il faut alors créer un fichier ‘DivaltoEnv.txt’ à la racine de chaque installation pour définir l’environnement concerné.

L'environnement est indiqué sous la forme : <env>NOMDELENVIRONNEMENT

Et ajouter une nouvelle application IIS qui correspond a chaque web service

 

Ces nouveaux services web sont accessible avec une URL qui comporte le nom de l'application



Paramétrage possible IIS

Il est possible de paramétrer l'application IIS en "Préchargement" (preloadEnabled) et aussi en toujours actif (AlwaysRunning)

  • Cela consomme des ressources complémentaires (mémoire) mais éviter le temps de "réveil" du WebService

  • C'est un sujet MS Windows (indépendant d'Harmony), mais qui permet de petits gains pour les "premiers" appels aux WebServices