Skip to main content
Important: Ce connecteur doit être installé sur le serveur où Winbooks fonctionne. L’installer sur votre ordinateur local ne fonctionnera pas. Si vous n’êtes pas sûr d’avoir les droits nécessaires, contactez votre administrateur informatique avant de commencer.

​
Avant de commencer - Prérequis essentiels au bon fonctionnement du service

Vérifiez ces exigences AVANT de commencer l’installation. L’absence de l’une d’elles entraînera l’échec de l’installation.

​
✅ Liste de contrôle d’installation

  • Winbooks version 7 ou supérieure est installé
  • Vous avez accès administrateur au serveur où Winbooks est installé
  • Le serveur est toujours en ligne avec un accès internet (24/7)
  • .NET Framework 4.8 est installé sur le serveur (Télécharger ici si besoin)
  • Vous connaissez votre nom d’utilisateur et mot de passe Winbooks
  • Si vous utilisez un disque réseau: Vous connaissez le chemin réseau (plus d’explications ci-dessous)

​
Comprendre les disques réseaux vs. les disques locaux

C’est la cause la plus fréquente des problèmes d’installation. Veuillez lire attentivement. Quelle est la différence ? Disque local :
  • Ressemble à : C:\Winbooks ou D:\Data\Winbooks
  • Les fichiers sont stockés directement sur le serveur sur lequel vous installez
Disque réseau :
  • Ressemble à : P:\ ou Z:\Shared\Winbooks
  • Les fichiers sont stockés sur un serveur différent et accessibles via le réseau
Comment vérifier si vous utilisez un disque réseau Ouvrez l’Explorateur Windows
  1. Regardez l’emplacement de votre dossier Winbooks
  2. Si la lettre du lecteur est autre que C: ou D:, vous utilisez probablement un disque réseau
Ce dont vous avez besoin pour vos disques réseaux Si vous utilisez un disque réseau, vous devez trouver le chemin UNC. C’est l’adresse réseau “réelle”. Exemple :
  • Ce que vous voyez : P:\Winbooks
  • Chemin UNC : \\ServerName\SharedFolder\Winbooks
Comment trouver votre chemin UNC :
  1. Cliquez avec le bouton droit sur le lecteur réseau dans l’Explorateur Windows
  2. Regardez les propriétés ou survolez le lecteur
  3. Vous devriez voir quelque chose comme \\server-name\folder-name
  4. Notez-le - vous en aurez besoin plus tard
💡 Pas sûr de comment le trouver ? Demandez à votre administrateur informatique le “chemin UNC du dossier Winbooks contenant le fichier Winbooks.ini”

​
Partie 1 : Rassembler les informations nécessaires

Avant de commencer l’installation, collectez ces informations depuis votre compte Winbooks :

​
Étape 1 : Trouvez le code de votre dossier comptable

  1. Connectez-vous à votre compte Winbooks
  2. Recherchez votre code de dossier (généralement visible dans l’interface)
  3. Notez-le - Exemple : DEMO01 ou COMP2024
winbooks_-_folder.png

​
Étape 2 : Sélectionnez votre plan d’analyse

  1. Dans Winbooks, allez à : Onglet Analytique → Paramètres → Plan comptable
  2. Notez le plan analytique que vous souhaitez utiliser par défaut
  3. Notez le numéro correspondant au plan analytique que vous souhaitez utiliser dans cette connexion
winbooks_-_analytique_1.png Screenshot_2024-03-29_at_11_04_24.png

​
Étape 3 : Trouvez le chemin d’installation de Winbooks

C’est ici que les fichiers du logiciel Winbooks sont stockés.
  1. Ouvrez l’Explorateur Windows sur le serveur
  2. Recherchez le fichier: Winbooks.ini
  3. Une fois trouvé, copiez le chemin complet du dossier contenant ce fichier
Exemples:
  • Lecteur local: C:\Winbooks
  • Chemin UNC du lecteur réseau: \\ServerName\Winbooks
⚠ IMPORTANT:
  • Si votre chemin commence par une lettre comme P:\ ou Z:\, vous DEVEZ le convertir en un chemin UNC
  • Si vous n’êtes pas sûr, utilisez le format de chemin UNC pour plus de sécurité
✅ Point de contrôle: Vous devriez maintenant avoir :
  • Votre code de dossier
  • Votre plan analytique
  • Le chemin complet vers Winbooks (format UNC si sur le réseau)

​
Partie 2 : Créer la connexion

​
Étape 1 : Nommez votre connexion

  1. Accédez à la page de configuration du connecteur
  2. Saisissez un nom descriptif pour cette connexion
    • Exemple : “Main Office Winbooks” ou “Company Accounting”

​
Étape 2 : Saisir les détails de configuration

  1. Plan d’analyse: Sélectionnez le plan que vous avez noté précédemment
  2. Chemin Winbooks: Entrez le chemin complet que vous avez trouvé dans la Partie 1, Étape 3
    • ✅ Correct : C:\Winbooks ou \\ServerName\Winbooks
    • ❌ Incorrect : P:\Winbooks (si P: est un disque réseau)

​
Étape 3: Télécharger le connecteur

  1. Cliquez sur le bouton Télécharger
  2. Un fichier ZIP sera téléchargé
  3. Important: Transférez ce fichier ZIP vers le serveur où Winbooks est installé
    • Si vous êtes déjà sur ce serveur, passez à l’étape 4
    • Sinon, copiez le fichier en utilisant le Bureau à distance, le partage réseau ou une clé USB avant de passer à l’étape 4

​
Étape 4 : saisissez votre code de dossier

  1. Entrez le code du dossier comptable que vous avez noté dans la partie 1, étape 1
  2. Vérifiez qu’il correspond exactement (sensible à la casse)

​
Étape 5 : Soumettre

Cliquez sur Soumettre pour finaliser la configuration de la connexion. ✅ Point de contrôle: Connexion créée. Fichier ZIP téléchargé et sur le serveur Winbooks.

​
Partie 3 : Installer le service Windows

⚠ Cela doit être fait SUR LE SERVEUR où Winbooks est installé, pas sur votre ordinateur local ⚠ Ne commencez pas la Partie 3 si vous n’avez pas effectué toutes les étapes décrites dans la Partie 2 Voici une courte vidéo montrant toutes les actions de l’étape 1 à l’étape 3 décrites ci dessous:

​
Étape 1 : Extraire le fichier ZIP

  1. Localisez le fichier ZIP que vous avez téléchargé
  2. Clic droit → Extraire tout
  3. Choisissez un emplacement sur le serveur (le bureau convient pour le moment)

​
Étape 2 : Exécuter l’installateur

  1. Ouvrez le dossier extrait
  2. Trouvez le fichier : WinbooksServiceSetup.exe
  3. Cliquez avec le bouton droit dessus → Exécuter en tant qu’administrateur
  4. Suivez l’assistant d’installation
⚠ Pendant l’installation, vous verrez une fenêtre pour installer VFPOLEDB. Cela est nécessaire pour que le service fonctionne correctement.

​
Étape 3 : Installer VFPOLEDB (Critique !)

Le programme d’installation lancera automatiquement l’installation de VFPOLEDB. Cela est nécessaire pour le bon fonctionnement du service. ⚠ IMPORTANT - Suivez exactement ces paramètres :
  1. Ne pas cocher “Fichiers de données d’exemple et programmes” (NE PAS installer les données d’exemple)
  2. Sélectionner “Tout le monde” (PAS “Juste moi” sélectionné par défaut)
    • Ceci est critique - le service s’exécute en tant qu’utilisateur système et nécessite un accès pour tout le monde
Screenshot_2025-02-20_at_16_57_44.png Screenshot_2025-02-20_at_16_57_51.png
  1. Cliquez Installer
  2. Attendez la fin de l’installation
✅ Point de contrôle:
  • VFPOLEDB installé
  • “Sample data” n’a PAS été coché
  • “Everyone” option A ÉTÉ sélectionnée

​
Étape 4 : Vérifier l’installation du service

  1. Appuyez sur Windows + R
  2. Tapez : services.msc et appuyez sur Entrée
  3. Recherchez WinbooksService dans la liste
  4. Il devrait afficher “Statut : En cours”
Si le service n’est pas en cours d’exécution :
  • Clic droit → Démarrer
  • Si le démarrage échoue, passez à la Partie 4 (Dépannage)

​
Partie 4 : Configurer pour les lecteurs réseau (le cas échéant)

Ignorez cette section si Winbooks est installé sur un lecteur local (C:\ or D:) Si vos fichiers Winbooks sont sur un lecteur réseau, vous devez suivre ces étapes supplémentaires :

​
Étape 1 : Mettre à jour le fichier de paramètres

  1. Accédez à : C:\Program Files (x86)\WinbooksService\
  2. Trouvez et ouvrez : settings.json (utilisez le Bloc-notes)
  3. Recherchez ces lignes :
json "toReplace": null, "replaceWith": null
  1. Mettez-les à jour avec les informations de votre lecteur réseau :
Exemple : Si votre lecteur réseau est P:\ et le chemin UNC est \\ServerName\WinbooksData, changez-le en : json "toReplace": "P:\\", "replaceWith": "\\\\ServerName\\WinbooksData" ⚠ Notez les doubles barres obliques inverses : Dans les fichiers JSON, chaque \\ doit être tapé comme \\\\ Il est TRÈS important de s’assurer que ces barres obliques inverses sont doublées Ensuite, enregistrez le fichier pour vous assurer que ces modifications sont appliquées par le service.

​
Étape 2 : Configurer le compte d’utilisateur du service

Pourquoi cela importe : Le service s’exécute sous un compte d’utilisateur Windows. Ce compte doit avoir la permission d’accéder à la fois à Winbooks et au lecteur réseau.
  1. Appuyez sur Windows Key + R
  2. Tapez : services.msc et appuyez sur Entrée
  3. Recherchez WinbooksService
  4. Clic droit → Propriétés
  5. Allez à l‘“Connexion” onglet
  6. Sélectionnez “Ce compte”
  7. Cliquez sur Parcourir et sélectionnez un compte d’utilisateur qui possède :
    • Accès au dossier Winbooks
    • Accès au lecteur réseau
    • Idéalement, il devrait s’agir d’un compte de service ou d’un compte administrateur
  8. Saisissez le mot de passe pour ce compte
  9. Cliquez sur OK

​
Étape 3 : redémarrer le service

  1. Toujours dans services.msc, trouvez WinbooksService
  2. Clic droit → Redémarrer
  3. Vérifiez qu’il démarre correctement (Statut : En cours d’exécution)
✅ Point de contrôle:
  • settings.json mis à jour avec les chemins corrects (le cas échéant)
  • Compte de service configuré avec accès réseau
  • Service redémarré avec succès

​
Partie 5: Tester la connexion

  1. Revenez à l’interface web du connecteur
  2. Cherchez le statut de votre connexion
  3. Vous devriez voir un indicateur vert montrant que la connexion est active
Si vous voyez une erreur, passez à la section Dépannage ci-dessous.

​
Dépannage des problèmes courants

Le service crée des journaux détaillés qui peuvent aider à identifier les problèmes:
  1. Accédez à : C:\Program Files (x86)\WinbooksService\Log\
    1. Le nom de ce dossier sur votre lecteur C peut légèrement différer en fonction de votre serveur, de la version de Windows que vous utilisez, de la langue configurée sur votre ordinateur, …
  2. Ouvrez log.html dans votre navigateur web
  3. Faites défiler jusqu’en bas (les entrées les plus récentes)
  4. Recherchez les messages d’erreur en rouge
Si le fichier journal n’existe pas :
  • Le service n’a pas encore traité de requêtes
  • Essayez de déclencher une synchronisation depuis l’interface web
  • Assurez-vous que l’utilisateur qui exécute le service dispose des autorisations d’écriture dans le dossier que vous avez ouvert
  • Attendez quelques minutes et vérifiez à nouveau
Problème : “L’entreprise donnée n’existe pas” Ce que cela signifie : Le service ne trouve pas votre dossier comptable. Solutions à essayer (dans l’ordre) :

​
Solution 1 : Vérifier le chemin

  1. Vérifiez le chemin que vous avez saisi dans le formulaire de connexion
  2. Naviguez jusqu’à ce chemin dans l’Explorateur Windows
  3. Confirmez que le fichier Winbooks.ini existe à cet emplacement
Si le chemin n’existe pas ou que vous ne pouvez pas y accéder ou qu’il ne contient pas le fichier Winbooks.ini :
  • Vous avez peut-être saisi un chemin local (comme P:\) au lieu d’un chemin UNC
  • Revenez au formulaire de connexion et mettez à jour vers le chemin UNC
  • Exemple : Changez P:\Winbooks en \\ServerName\SharedFolder\Winbooks

​
Solution 2 : Vérifier le fichier Winbooks.ini

  1. Ouvrez Winbooks.ini dans le Bloc-notes
  2. Recherchez une ligne commençant par UsersPath=
  3. Vérifiez que ce chemin existe et est accessible
Si UsersPath est manquant ou vide :
  • Cela se produit souvent lorsque le connecteur est installé sur un serveur proxy plutôt que sur le serveur principal Winbooks
  • Le connecteur DOIT être installé sur le même serveur où Winbooks s’exécute

​
Solution 3 : Vérifier le fichier Users.dbf

  1. Naviguez jusqu’au dossier indiqué dans UsersPath
  2. Vérifiez la présence d’un fichier appelé Users.dbf
  3. Ce fichier contient votre liste de dossiers comptables
Pour vérifier si le code de votre dossier existe :
  • Le service crée une version temporaire décryptée à l’emplacement : C:\Program Files (x86)\WinbooksService\tmp\
  • Ce fichier n’apparaît que lorsque le service est en cours d’exécution et traite une requête
  • Contactez le support si vous avez besoin d’aide pour vérifier que le code de votre dossier se trouve dans ce fichier

​
Solution 4 : Vérifier les permissions utilisateur

Le compte utilisateur Windows exécutant le service doit posséder :
  • Accès en lecture à tous les dossiers Winbooks
  • Accès en lecture à tous les lecteurs réseau
  • Accès en écriture au dossier de journal du service
Pour vérifier :
  1. Vérifiez quel utilisateur exécute le service (services.msc → Propriétés → onglet Se connecter)
  2. Connectez-vous en tant que cet utilisateur (ou faites-le vérifier par le service informatique)
  3. Essayez d’accéder manuellement aux dossiers Winbooks
  4. Si l’accès est refusé, mettez à jour le compte de service (voir Partie 4, Étape 2)
Problème : Erreurs VFPOLEDB Si vous voyez des erreurs liées à VFPOLEDB, le pilote de base de données peut ne pas être installé correctement. Solution : Réinstaller VFPOLEDB
  1. Naviguez jusqu’à : C:\\Program Files (x86)\\WinbooksService\\
  2. Trouvez : VFPOLEDBSetup.exe
  3. Premièrement, désinstallez la version existante :
    • Clic droit → Exécuter en tant qu’administrateur
    • Sélectionnez Désinstaller
    • Terminez la désinstallation
  4. Ensuite réinstallez :
    • Exécutez à nouveau VFPOLEDBSetup.exe en tant qu’administrateur
    • Décocher “Fichiers et programmes d’exemple”
    • Sélectionnez “Everyone” (critique !)
    • Terminez l’installation
  5. Redémarrez le WinbooksService :
    • services.msc → Clic droit sur WinbooksService → Redémarrer
Problème : Le service ne démarre pas
  1. Ouvrez le Visionneur d’événements (recherchez “Event Viewer” dans Windows)
  2. Allez à : Journaux Windows → Application
  3. Recherchez les erreurs provenant de “WinbooksService”
  4. Le message d’erreur indiquera ce qui ne va pas
Causes courantes :
  • Framework .NET 4.8 manquant
  • VFPOLEDB installé incorrectement
  • Le compte utilisateur n’a pas les permissions nécessaires
  • Chemin réseau inaccessible

​
Référence rapide : Résumé de l’installation

  1. ✅ Vérifier toutes les conditions préalables (Partie 1)
  2. ✅ Rassembler le code du dossier, le plan d’analyse et le chemin Winbooks
  3. ✅ Créer une connexion dans l’interface web
  4. ✅ Télécharger le fichier ZIP sur le serveur Winbooks
  5. ✅ Installer le service (Exécuter en tant qu’administrateur)
  6. ✅ Installer VFPOLEDB (Décocher les Données exemples, installer le service pour TOUT les utilisateurs)
  7. ✅ Si vous utilisez des lecteurs réseau : mettre à jour settings.json et le compte de service
  8. ✅ Redémarrer le service
  9. ✅ Tester la connexion

​
Annexe : Comprendre les chemins UNC

Qu’est-ce qu’un chemin UNC ? UNC signifie “Universal Naming Convention” - c’est la façon standard de spécifier les emplacements réseau sous Windows. Format: \\ServerName\ShareName\FolderPath Exemples de conversions : Pourquoi les chemins UNC sont importants :
  • Les services Windows (comme WinbooksService) s’exécutent dans un contexte différent de celui de votre compte utilisateur
  • Ils ne voient pas automatiquement les lecteurs mappés (P:, Z:, etc.)
  • Ils ont besoin de l’adresse réseau complète (chemin UNC) pour trouver les fichiers réseau
Comment trouver un chemin UNC :
  1. Ouvrir l’Explorateur Windows
  2. Cliquez avec le bouton droit sur le lecteur réseau
  3. Sélectionnez “Propriétés”
  4. Recherchez “Emplacement” ou “Cible” - cela indique le chemin UNC