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 ou de création de client ou autre modification de la base données de travailler conjointement avec la version DBF du Webservice.

Dans ce cas, il est possible de spécifier au Webservice DBF certaines requêtes qui 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

#Haut de page


Installation

1. Configuration de l'application pool
  1. Ajoutez l'Application Pooldans 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.

2. Installation des fichiers du Webservice SQL
  1. Créez un répertoire et dé-zippez les fichiers du Webservice.
    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 :

{table-plus:enableSorting=false}
||{{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 :
{panel:borderStyle=dashed|bgColor=white}
{{"{color:blue}Data Source{color}=SERVER2008DEV;{color:green}Initial Catalog{color}=DEMO;{color:orange}User ID{color}=sa;{color:purple}Password{color}=1234"}}
{panel}
* {{{color:blue}Data Source{color}}} : nom DNS du ou IP du serveur contenant la database sql.
* {{{color:green}Initial Catalog{color}}} : nom de la base de donnée celle-ci est généralement la même que le nom du dossier dans Logistics/Flex.
* {{{color:orange}User ID{color}}} : nom de l'utilisateur SQL.
* {{{color:purple}Password{color}}} : password de l'utilisateur SQL.
|*{{Serial}}*|Numéro de série du dossier Logistics/Flex.
|*{{PrgRoot}}*|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.
{table-plus}
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


Liaison avec le Webservice DBF

Installation du Webservice DBF

Suivez les instructions contenues dans Installation du Webservice côté Logistics.

Configuration du fichier wsFlex.ini

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

Description des lignes :

{table-plus:enableSorting=false}
||{{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.
{table-plus}

#Haut de page


Fonctions disponibles

Pour une explication sur l'utilisation de ces fonctions, consultez l'Utilisation du web service.

#Haut de page