Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

(tick) SqlToDbf (à télécharger ici) - Nécessaire dans le cas ou des écritures sont doivent être réalisées dans la base de données

...

  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. Installation & configuration du SQLTODBF

L'utilitaire SQLTODBF est utilisé pour reporter les modifications apportée sur la base de donnée SQL dans la base de données DBF utilisé par le programme, si le webservice est utilisé uniquement en lecture cette étape peut être ignorée

Le webservice exécute de manière automatique à intervalle réguliere cet utilitaire afin de reporter les ajout et modification de la base de données SQL vers le DBF

Prérequis
  • Exécuté par un utilisateur disposant des droits de lecture et écriture et suppression dans le répertoire du dossier client de logistics
  • les composant Visual Foxpro 9 doivent être installé sur la machine exécutant le logiciel
Installation

Dézipper l’exécutable dans un répertoire dont le compte qui est définit dans l'application pools dispose de droit de lecture, vous devrez indiquer le chemin de ce répertoire dans la clé SqlToDbfPath qui est à définir à l'étape Configuration du fichier Web.Config

Configuration

vous pouvez configurer divers paramètre pour l’exécution et le traitement exécuté par le SqlToDbf, les paramètres sont a ajouter dans les paramètre généraux du dossier client Logistics

ParamètreDescriptionValeur par défaut
WSSQL_TABLETOSYNCTable ou les modifications SQL sont à reprendre en DBF, les tables sont séparées par *DOCHEAD*DOCDET*CUST*PERS
WSSQL_SQLTODBF_TIMER

Délai en seconde que le webservice attend avant d'éxecuté une nouvelle instance du SQLTODBF.

Si une instance est toujours en cours d’exécution l'appel est ignoré

10


Exécution manuelle 

Suivant votre environnement vous pouvez décider d'exécuter le SqlToDbf manuellement dans un scheduler par exemple 

Pour ce faire vous devez exécuter le SqlToDbf avec les paramètres suivant 

ParamètreDescriptionExemple de valeur
1Table à synchroniser"DOCHEAD*DOCDET*CUST*PERS"
2Chemin de l'installation data de logistics"c:/winbooks/data/logistics/"
3Nom du répertoire du dossier client"DEMOLOGISTICS_FR"

Gestion des erreurs

En cas d'erreur le programme génère un log par jour dans le dossier logistics sous la forme <date> error - sqltodbf.txt

Vous pouvez vérifier si les données sont bien renvoyée dans les table dbf en regardant si le champ SQLMODIF dans la base de données SQL est bien à 0.

4. Configuration du fichier Web.config

  1. Dans IIS, ouvrez le menu Application Settings


  2. Définissez les différents paramètres suivant le paramétrage de votre dossier


    Description des entrées de configuration 

    Advanced Tables - Table Plus
    enableSortingfalse


    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
    bgColorwhite
    borderStyledashed

    "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.



...

Vous pouvez également modifier le fichier Web.config via un éditeur de texte, et configurer les key de l'appSettings.

...

5. 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

    Warning

    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 :

    Info

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

...


6. Configuration en HTTPS


Info

Cette section est optionnelle et nécessite la modification du site hébergeant le webservice
elle nécessite également au minimum la version 1.1.0.2 du webservice

...