Does the user use a network drive?

1. Update the settings.json to inform it about your network player

If the user uses a network drive, some modifications must be made in the settings.json to allow the connection to work properly.

You will first have to find the UNC path of your network drive.

For example, if you use the P:// drive, it is most likely a network drive, so you will need to get the UNC path for that drive. He'll look like something like this: \\chi-win02\sage_compta

You will then need to update the value of the settings.json to allow the agent to know how to manage this path P://. For this, you will find two values in the Json: toReplace and replaceWith. The default values will be set to null

The idea is therefore to change the values provided for these fields and fill in the values you obtained just before.

You will then end up with the following elements in the settings.json

"toReplace": "P://" , "replaceWith": "\\\\chi-win02\\sage_compta"

Note that in this json file, all must be doubled (here in my example, chi-win02sage compta becomes chi-win02sage compta)

1. Make sure that the user running the service has access to Winbooks and network drive

Open the service tab of your Windows server by searching with the service keyword on your server.

Open it and search for the service called WinbooksService.

You must right-click on this service, click on the properties option.

You will need to use this account section and select a user with access to both the network drive and the folder in which all Winbooks files are stored.

1. Once all previous checks are completed, restart the service and test the connection

Restart local agent

• Access the Windows service.msc application

  

• Make sure the service is configured with a Windows user having access privileges to the SQL database and shared network drives

  

• Then restart Winbooks service

  

The given company does not exist in the accounting system.

This means that we cannot establish the connection required to create the connection.

1. Check the path configured in Winbooks form on Shift

   • Make sure the specified path (for example, C:\\Winbooks) exists.

   • Check that this folder contains the file Winbooks.ini.

   • ⚠ If the path does not exist or is not accessible by the user running Windows service → use a UNC path if the folder is on a network share or drive.

2. Ouvrez le fichier Winbooks.ini

   • Vérifiez la présence de la variable UsersPath.

   • Si la variable est manquante ou vide → C'est probablement le problème (cela arrive souvent lorsque le connecteur est installé sur un serveur proxy au lieu du serveur principal).

3. Vérifiez le dossier spécifié dans UsersPath

   • Assurez-vous que le dossier existe.

   • Vérifiez qu'il contient le fichier Users.dbf.

   • ⚠ Même règle : si le dossier est partagé ou sur un lecteur réseau, remplacez par un chemin UNC dans le fichier winbooks.ini

4. Vérifiez le fichier Users.dbf

   • Ce fichier contient la liste de toutes les entreprises (1 ligne = 1 entreprise).

   • Chaque entrée d'entreprise indique le chemin vers son dossier DB/DATA.

   • ⚠ Le fichier est crypté → le connecteur le déchiffre automatiquement et crée un fichier déchiffré temporaire dans :

     C:\\Program Files (x86)\\WinbooksService\\tmp . Ce fichier ne sera visible que lorsqu'une requête sera effectuée au service

Voici un exemple de fichier users.dbf ouvert. Vous y retrouvez une colonne CODESOC qui référence les codes winbooks des différentes sociétés, ainsi que les chemins permettant à winbooks de savoir où sont stockés les dossiers.

• Pour vérifier :

  • The code entreprise saisi dans Chift correspond à une entreprise dans le fichier.

    • Si aucune correspondance n'est trouvée dans le fichier, alors le connecteur ne fonctionnera pas. Il est alors nécessaire de re soumettre le formulaire sur chift afin de renseigner le bon code dossier et y renseigner le code que vous voyez ici.

  • Le chemin spécifié pour le dossier DB/DATA est valide et accessible.

    • Si le chemin n'existe pas ou n'est pas accessible, il faut alors corriger le chemin si celui ci n'est pas valide, ou modifier l'utilisateur faisant tourner le service si celui ci n'a pas accès au dossier en question. Une section détaillée de cette documentation vous explique le détail des étapes à réaliser pour effectuer cette modification.

  • Si le chemin existe, n'est pas sous le format UNC et est associé à un disque réseau, il est alors nécessaire de modifier le chemin renseigné afin d'y mettre un chemin UNC, cela ne changera absolument rien car ces deux chemins sont équivalents du point de vue de votre serveur mais cela permettra au service de savoir où chercher les différents fichiers relatif à Winbooks.

Erreurs à propos de VFPOLEDB dans le fichier log.html

Si vous constatez des lignes avec des erreurs mentionnant VFPOLEDB dans les logs du fichier html, cela veut dire que le plugin n'a pas été installé / que l'utilisateur faisant tourner le service n'a pas accès à ce plugin.

Rendez vous donc dans le dossier du WinbooksService avec le chemin suivant: “C:/Program Files (x86)/WinbooksService/”

Et lancez l'exécutable “VFPOLEDBSetup”

1. Dans un premier temps, si il a déjà été installé, désinstallez le

   

2. Ensuite relancez ce même fichier pour le ré installer correctement.

   

3. Ne sélectionnez pas l'option suivante lors de l'installation

   

4. Assurez vous de bien cliquer sur l'option permettant d'installer le plugin pour tout les utilisateurs et non seulement pour l'utilisateur courant.

   

5. Vous pouvez maintenant finaliser l'installation.

   

• Rendez vous maintenant dans le menu des services windows.

  

• Vérifiez bien que l'utilisateur configuré a bien accès au plugin que l'on vient d'installer ainsi qu'aux disques réseaux si vous utilisez des disques réseaux en lien avec les dossiers connectés.

  

• Redémarrez le service pour que toutes les modifications ci dessus soient prises en compte.