Page History
...
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
...
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
Modifiez la sécurité du répertoire créé via l'onglet Securityde la fenêtre de propriété de ce dossier.
- Ajoutez l'utilisateur mentionner dans l'application pool.
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ètre | Description | Valeur par défaut |
---|---|---|
WSSQL_TABLETOSYNC | Table 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ètre | Description | Exemple de valeur |
---|---|---|
1 | Table à synchroniser | "DOCHEAD*DOCDET*CUST*PERS" |
2 | Chemin de l'installation data de logistics | "c:/winbooks/data/logistics/" |
3 | Nom 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
- Dans IIS, ouvrez le menu Application Settings
Définissez les différents paramètres suivant le paramétrage de votre dossier
Description des entrées de configurationAdvanced Tables - 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 bgColor white borderStyle dashed "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 fonctionWSLOGIN
.CompID
Nom du dossier client dans Logistics/Flex.
Debug
Création de log par le Webservice pour le debuging.
SqlToDbfPath
Chemin utilisé par l’utilitaire SqlToDbf. SqlToDbfUser
Utilisateur repris par le Webservice SQL pour lancer l'utilitaire SqlToDbf. Optionnel, utilisé dans les environnements très sécurisés. SqlToDbfPassword
Mot 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. SqlToDbfDomain
Domaine 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
Ajoutez une application dans IIS.
Sélectionner l'application pool.
L'Alias sera utilisé dans l'URL d'accès au Webservice.
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.
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 |
...