You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 15 Next »

Le Webservice SQL de Logistics/Flex se base sur les données répliquées par le Module Synchro SQL dans la base de données de SQL Server afin de de fournir une réponse la plus rapide possible.

Cette façon de faire oblige le Webservice SQL, dans un premier temps, a fournir uniquement des requêtes de lecture de la base de données, il est donc nécessaire dans le cas d'un besoin d'ajout de commande, de création de client ou autre modification de la base données de travailler conjointement avec la version DBF du Webservice ou via l’utilitaire SqlToDbf.

Dans le cas où un ancien site utilise une version du Webservice DBF, il est possible de spécifier au Webservice existant que certaines requêtes doivent être traitées par la version SQL.
Cette approche vous permet d'éviter d'interroger 2 Webservices différents.

Sur cette page:

Prérequis

L'installation du Webservice SQL nécessite les éléments suivants :

(tick) IIS diposant du rôle "Application Development"
(tick) Logistics/Flex avec Module Synchro SQL
(tick) Framework .NET 4.0
(tick) Information de connexion à une base de donnée générée par Logistics/flex sous SQL Server
(tick) Fichiers du Webservice SQL (à télécharger ici)

Haut de page

Installation

1. Configuration de l'application pool

  1. Ajoutez l'Application Pool dans IIS.

    Il est obligatoire de créer un application pool par Webservice SQL et dossier Logistics/Flex.

     

  2. Dans le champ .NET Framework version, sélectionnez le .NET Framework 4.0.

     

  3. Modifiez l'Identity de l'application pool que vous venez de créer via le menu Advanced settings.

    Nous vous recommandons d'utiliser au minimum l'identity NetworkService.

    Version non serveur de Windows

    %windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -i

"c:\Windows\Microsoft.NET\Framework\v3.0\Windows Communication Foundation\servicemodelreg" -i

2. Installation des fichiers du Webservice SQL

  1. Créez un répertoire et dé-zippez les fichiers du Webservice (Les fichier du Webservice sont à demander par mail au support Logistics).

    Dans cette documentation nous utiliserons le chemin : c:\inetpub\wwwroot\dossier_webserviceSQL



  2. Modifiez la sécurité du répertoire créé via l'onglet Securityde la fenêtre de propriété de ce dossier.

    1. Ajoutez l'utilisateur mentionner dans l'application pool.

    2. Ajoutez aux droits standard, les droits en écriture dans le dossier.

3. Configuration du fichier Web.config

Ouvrez le fichier Web.config via un éditeur de texte, et configurer les key de appSettings.

Description des key du fichier Web.config :

key

value

ConnexionStringSql

Information de connexion à la base de données de SQL Server.
De façon typique elle se constitue de la manière suivante :

"Data Source=SERVER2008DEV;Initial Catalog=DEMO;User ID=sa;Password=1234"

  • Data Source : nom DNS du ou IP du serveur contenant la database sql.
  • Initial Catalog : nom de la base de donnée celle-ci est généralement la même que le nom du dossier dans Logistics/Flex.
  • User ID : nom de l'utilisateur SQL.
  • Password : password de l'utilisateur SQL.

Serial

Numéro de série du dossier Logistics/Flex.

DataRootPath

Chemin envoyé par le site web et utiliser par le Webservice DBF.
Ce chemin doit être indiqué pour le calcul de la clé applicative renvoyée par la fonction WSLOGIN.

CompID

Nom du dossier client dans Logistics/Flex.

Debug

Création de log par le Webservice pour le debuging.

SqlToDbfPathChemin utilisé par l’utilitaire SqlToDbf.
SqlToDbfUserUtilisateur repris par le Webservice SQL pour lancer l'utilitaire SqlToDbf. Optionnel, utilisé dans les environnements très sécurisés.
SqlToDbfPasswordMot de passe de l'utilisateur repris par le Webservice SQL pour lancer l'utilitaire SqlToDbf. Optionnel, utilisé dans les environnements très sécurisés.
SqlToDbfDomainDomaine de l'utilisateur repris par le Webservice SQL pour lancer l'utilitaire SqlToDbf. Optionnel, utilisé dans les environnements très sécurisés.

4. Création de l'application dans IIS

  1. Ajoutez une application dans IIS.



  2. Sélectionner l'application pool.

    L'Alias sera utilisé dans l'URL d'accès au Webservice.



  3. A partir de cette étape, vous pouvez tester si le webservice SQL est correctement lancé par IIS, via un navigateur web en tapant cette URL (n'oubliez pas d'adapter l'URL suivant votre paramétrage !) :

    http://127.0.0.1/MonDossier_WSSQL/ServiceWcf.svc?wsdl

    Dans l'URL de test, il faut indiquer l'Alias de l'application et non le nom du répertoire.



  4. Si l'installation est correcte, vous devriez avoir une réponse semblable à l'écran suivant dans votre navigateur web :

    Pensez aussi à vérifier la disponibilité du Webservice à l'extérieur et à rediriger les ports si nécessaire.

Haut de page

Test du Webservice SQL

Des requêtes de test peuvent être réalisées sur le webservice installé via un exécutable de test à télécharger et en y effectuant les opérations suivantes.

Configuration des données de connexion

Remplissez chaque champ dans l’onglet de configuration.

Il est possible de sauvegarder une configuration pour la recharger plus tard. Pour cela, indiquez un nom de configuration et cliquez sur sauver.

Il est également possible de pré-remplir une partie de la configuration en chargeant le fichier WsConfig du Webservice SQL.

Une fois les champs complétés, passez à l’étape d’initialisation via l'onglet Init.

Si vous repassez dans l’onglet de configuration, vous devez procéder à nouveau à une initialisation.

Initialisation du Webservice

Dans l'onglet d'initialisation, le programme de test exécute les requêtes login sur les webservices SQL et/ou DBF actifs.

Dès que la requête est marquée comme Done, passez à l’onglet des requêtes.

Exécuter une requête

Cette étape permet de procéder à l'envoi d’une requête wsrequest sur l’un des webservices initialisées par le programme de test.

Il est possible d'exécuter des requêtes standard mais également des requêtes personnalisées.

Requête standard 

Sélectionnez le nom de la requête dans la liste déroulante, et ensuite remplissez les XML Header, Data et Footer avec les données souhaitées.

Lorsque les données sont complétées, exécutez la requête sur les webservices initialisés.

Le résultat de la requête ainsi que son temps d'exécution sont affichés dans la partie inférieure de l'onglet.

Requête personnalisée

Les requêtes personnalisées fonctionnent comme les requêtes standard sauf qu'il faut indiquer le nom de votre requête au lieu de le sélectionner dans la liste déroulante des propositions de nom de requête.

Haut de page

Liaison avec le Webservice DBF

Cette section est optionnelle et elle est proposée uniquement pour les sites existants afin permettre une phase d'adaptation sans mise hors service du site.

Installation du Webservice DBF

Suivez les instructions contenues dans l'Installation du Webservice DBF.

Configuration du fichier wsFlex.ini

Ajouter les lignes suivantes dans la configuration de votre dossier contenu dans le fichier wsFlex.ini

Description des lignes :

key

value

WCF_URL

correspond à l'adresse du Webservice SQL.

XXXX_USEWCF

XXXX représente le nom d'une fonction du webservice. Les fonctions qui sont mentionnées de la sorte dans le fichier de configuration avec la valeur YES seront redirigées vers le Webservice SQL pour traitement, le Webservice DBF sert alors simplement d'intermédiaire.

Haut de page

  • No labels