Skip to main content
Belangrijk: Deze connector moet worden geïnstalleerd op de server waarop Winbooks draait. Installatie op uw eigen computer werkt niet. Als u niet zeker weet of u over de juiste toegang beschikt, neem dan contact op met uw IT-beheerder voordat u begint.

​
Voordat u begint - kritieke vereisten om de service te laten werken

Controleer deze vereisten VOORDAT u met de installatie begint. Als er iets ontbreekt, zal de installatie mislukken.

​
✅ Installatiechecklist

  • Winbooks versie 7 of hoger is geïnstalleerd
  • U hebt beheerderstoegang tot de server waarop Winbooks is geïnstalleerd
  • De server is altijd online met internettoegang (24/7)
  • .NET Framework 4.8 is geïnstalleerd op de server (Hier downloaden indien nodig)
  • U kent uw Winbooks-gebruikersnaam en -wachtwoord
  • Bij gebruik van een netwerkschijf: U kent het netwerkpad (meer uitleg hieronder)

​
Netwerkschijven versus lokale schijven begrijpen

Dit is de meest voorkomende oorzaak van installatieproblemen. Lees dit aandachtig. Wat is het verschil? Lokale schijf:
  • Ziet uit als: C:\\Winbooks of D:\\Data\\Winbooks
  • De bestanden worden rechtstreeks opgeslagen op de server waarop u installeert
Netwerkschijf:
  • Ziet uit als: P:\\ of Z:\\Shared\\Winbooks
  • De bestanden staan op een andere server en worden via het netwerk benaderd
Hoe u kunt controleren of u een netwerkschijf gebruikt Open Windows Verkenner
  1. Bekijk de locatie van uw Winbooks-map
  2. Als de schijfletter iets anders is dan C: of D:, gebruikt u waarschijnlijk een netwerkschijf
Wat u nodig hebt voor uw netwerkschijven Als u een netwerkschijf gebruikt, moet u het UNC-pad vinden. Dit is het “echte” netwerkadres. Voorbeeld:
  • Wat u ziet: P:\Winbooks
  • UNC-pad: \\ServerName\SharedFolder\Winbooks
Hoe u uw UNC-pad vindt:
  1. Klik met de rechtermuisknop op de netwerkschijf in Windows Verkenner
  2. Bekijk de eigenschappen of houd de muis boven de schijf
  3. U zou iets moeten zien zoals \\server-name\folder-name
  4. Schrijf dit op - u hebt het later nodig
💡 Weet u niet hoe u het vindt? Vraag uw IT-beheerder naar het “UNC-pad naar de Winbooks-map”

​
Deel 1: Vereiste informatie verzamelen

Verzamel voordat u met de installatie begint deze informatie uit uw Winbooks-account:

​
Stap 1: Zoek uw boekhoudmapcode

  1. Log in op uw Winbooks-account
  2. Zoek uw mapcode (meestal zichtbaar in de interface)
  3. Schrijf deze op - Voorbeeld: DEMO01 of COMP2024
winbooks_-_folder.png

​
Stap 2: Selecteer uw analytisch plan

  1. Ga in Winbooks naar: Tabblad Analytisch → Parameters → Boekhoudplan
  2. Noteer welk analytisch plan u standaard wilt gebruiken
  3. Schrijf het nummer op dat overeenkomt met het boekhoudplan dat u in de verbinding wilt gebruiken
winbooks_-_analytique_1.png Screenshot_2024-03-29_at_11_04_24.png

​
Stap 3: Zoek uw Winbooks-installatiepad

Dit is de locatie waar uw Winbooks-softwarebestanden zijn opgeslagen.
  1. Open Windows Verkenner op de server
  2. Zoek naar het bestand: Winbooks.ini
  3. Zodra u het hebt gevonden, kopieer het volledige pad naar de map die dit bestand bevat
Voorbeelden:
  • Lokale schijf: C:\Winbooks
  • UNC-pad netwerkschijf: \\ServerName\Winbooks
⚠ BELANGRIJK:
  • Als uw pad begint met een letter zoals P:\ of Z:\, MOET u het omzetten naar een UNC-pad
  • Als u het niet zeker weet, gebruik voor de zekerheid het UNC-padformaat
✅ Controlepunt: U zou nu moeten beschikken over:
  • Uw mapcode
  • Uw analytisch plan
  • Het volledige pad naar Winbooks (UNC-formaat indien op netwerk)

​
Deel 2: De verbinding aanmaken

​
Stap 1: Geef uw verbinding een naam

  1. Ga naar de instelpagina van de connector
  2. Voer een duidelijke naam in voor deze verbinding
    • Voorbeeld: “Winbooks hoofdkantoor” of “Bedrijfsboekhouding”

​
Stap 2: Configuratiegegevens invoeren

  1. Analytisch plan: Selecteer het plan dat u eerder hebt genoteerd
  2. Winbooks-pad: Voer het volledige pad in dat u in Deel 1, Stap 3 hebt gevonden
    • ✅ Correct: C:\Winbooks of \\ServerName\Winbooks
    • ❌ Fout: P:\Winbooks (als P: een netwerkschijf is)

​
Stap 3: De connector downloaden

  1. Klik op de knop Download
  2. Er wordt een ZIP-bestand gedownload
  3. Belangrijk: Verplaats dit ZIP-bestand naar de server waarop Winbooks is geïnstalleerd
    • Als u zich al op die server bevindt, ga verder naar Stap 4
    • Zo niet, kopieer het bestand via Extern bureaublad, een netwerkshare of een USB-stick voordat u naar Stap 4 gaat

​
Stap 4: Voer uw mapcode in

  1. Voer de boekhoudmapcode in die u in Deel 1, Stap 1 hebt genoteerd
  2. Controleer dubbel of deze exact overeenkomt (let op hoofdletters en kleine letters)

​
Stap 5: Verzenden

Klik op Submit om de instelling van de verbinding af te ronden. ✅ Controlepunt: Verbinding aangemaakt. ZIP-bestand gedownload en op de Winbooks-server geplaatst.

​
Deel 3: De Windows-service installeren

⚠ Dit moet worden uitgevoerd OP DE SERVER waarop Winbooks is geïnstalleerd, niet op uw eigen computer ⚠ Begin niet aan Deel 3 als u niet alle stappen uit Deel 2 hebt uitgevoerd Hier is een korte video die elke actie van stap 1 tot stap 3 laat zien:

​
Stap 1: Pak het ZIP-bestand uit

  1. Zoek het ZIP-bestand dat u hebt gedownload
  2. Rechtermuisklik → Alles uitpakken
  3. Kies een locatie op de server (het bureaublad is voorlopig prima)

​
Stap 2: Voer het installatieprogramma uit

  1. Open de uitgepakte map
  2. Zoek het bestand: WinbooksServiceSetup.exe
  3. Klik met de rechtermuisknop erop → Als administrator uitvoeren
  4. Volg de installatiewizard
Tijdens de installatie krijgt u de vraag om VFPOLEDB te installeren. Dit is vereist om de service correct te laten werken.

​
Stap 3: VFPOLEDB installeren (cruciaal!)

Het installatieprogramma start automatisch de VFPOLEDB-installatie. Dit is vereist om de service te laten werken. ⚠ BELANGRIJK - Volg deze instellingen exact:
  1. Vink niet aan “Sample data files and programs” (installeer GEEN voorbeeldgegevens)
  2. Selecteer “Everyone” (NIET “Just me”, dat standaard geselecteerd is)
    • Dit is cruciaal - de service draait als systeemgebruiker en heeft toegang voor iedereen nodig
Screenshot_2025-02-20_at_16_57_44.png Screenshot_2025-02-20_at_16_57_51.png
  1. Klik op Install
  2. Wacht tot het voltooid is
✅ Controlepunt:
  • VFPOLEDB geïnstalleerd
  • “Sample data” was NIET aangevinkt
  • De optie “Everyone” WAS geselecteerd

​
Stap 4: Controleer de installatie van de service

  1. Druk op Windows-toets + R
  2. Typ: services.msc en druk op Enter
  3. Zoek WinbooksService in de lijst
  4. Er zou “Status: Actief” moeten staan
Als de service niet draait:
  • Rechtermuisklik → Starten
  • Als hij niet start, ga verder naar Deel 4 (Probleemoplossing)

​
Deel 4: Configureren voor netwerkschijven (indien van toepassing)

Sla dit gedeelte over als Winbooks op een lokale schijf is geïnstalleerd (C:\ of D:) Als uw Winbooks-bestanden op een netwerkschijf staan, moet u deze aanvullende stappen uitvoeren:

​
Stap 1: Werk het instellingenbestand bij

  1. Ga naar: C:\Program Files (x86)\WinbooksService\
  2. Zoek en open: settings.json (gebruik Notepad)
  3. Zoek deze regels:
json "toReplace": null, "replaceWith": null
  1. Werk ze bij met de informatie van uw netwerkschijf:
Voorbeeld: Als uw netwerkschijf P:\ is en het UNC-pad \\ServerName\WinbooksData, wijzig dan naar: json "toReplace": "P:\\", "replaceWith": "\\\\ServerName\\WinbooksData" ⚠ Let op de dubbele backslashes: In JSON-bestanden moet elke \\ worden getypt als \\\\ Het is ZEER belangrijk dat die backslashes verdubbeld zijn Bewaar daarna het bestand zodat die wijzigingen door de service worden toegepast.

​
Stap 2: Configureer het gebruikersaccount van de service

Waarom dit belangrijk is: De service draait onder een Windows-gebruikersaccount. Dat account moet toegang hebben tot zowel Winbooks als de netwerkschijf.
  1. Druk op Windows-toets + R
  2. Typ: services.msc en druk op Enter
  3. Zoek WinbooksService
  4. Rechtermuisklik → Eigenschappen
  5. Ga naar het tabblad “Aanmelden”
  6. Selecteer “Dit account”
  7. Klik op Zoeken en selecteer een gebruikersaccount dat beschikt over:
    • Toegang tot de Winbooks-map
    • Toegang tot de netwerkschijf
    • Idealiter is dit een serviceaccount of een beheerdersaccount
  8. Voer het wachtwoord voor dit account in
  9. Klik op OK

​
Stap 3: Start de service opnieuw

  1. Zoek nog steeds in services.msc naar WinbooksService
  2. Rechtermuisklik → Opnieuw starten
  3. Controleer of hij succesvol start (Status: Actief)
✅ Controlepunt:
  • settings.json bijgewerkt met de juiste paden (indien van toepassing)
  • Serviceaccount geconfigureerd met netwerktoegang
  • Service succesvol opnieuw gestart

​
Deel 5: De verbinding testen

  1. Ga terug naar de webinterface van de connector
  2. Bekijk de status van uw verbinding
  3. U zou een groene indicator moeten zien die aangeeft dat de verbinding actief is
Als u een foutmelding ziet, ga verder naar het gedeelte Probleemoplossing hieronder.

​
Veelvoorkomende problemen oplossen

De service maakt gedetailleerde logboeken aan die kunnen helpen bij het identificeren van problemen:
  1. Ga naar: C:\Program Files (x86)\WinbooksService\Log\
    1. De naam van deze map op uw C-schijf kan licht afwijken afhankelijk van uw server, de Windows-versie die u gebruikt, de taal die op uw computer is ingesteld, …
  2. Open log.html in uw webbrowser
  3. Scroll naar de onderkant (meest recente vermeldingen)
  4. Zoek naar foutmeldingen in het rood
Als het logbestand niet bestaat:
  • De service heeft nog geen verzoeken verwerkt
  • Probeer een synchronisatie te starten vanuit de webinterface
  • Zorg ervoor dat de gebruiker die de service uitvoert schrijfrechten heeft in de map waar u net naartoe bent gegaan
  • Wacht een paar minuten en controleer opnieuw
Probleem: “The given company does not exist” Wat dit betekent: De service kan uw boekhoudmap niet vinden. Mogelijke oplossingen (in deze volgorde):

​
Oplossing 1: Controleer het pad

  1. Controleer het pad dat u in het verbindingsformulier hebt ingevoerd
  2. Ga naar dat pad in Windows Verkenner
  3. Bevestig dat het bestand Winbooks.ini daar aanwezig is
Als het pad niet bestaat, u er geen toegang toe hebt of het bestand Winbooks.ini er niet in staat:
  • U hebt mogelijk een lokaal pad (zoals P:\) ingevoerd in plaats van een UNC-pad
  • Ga terug naar het verbindingsformulier en werk het bij naar het UNC-pad
  • Voorbeeld: wijzig P:\Winbooks naar \\ServerName\SharedFolder\Winbooks

​
Oplossing 2: Controleer het bestand Winbooks.ini

  1. Open Winbooks.ini in Notepad
  2. Zoek naar een regel die begint met UsersPath=
  3. Controleer of dit pad bestaat en toegankelijk is
Als UsersPath ontbreekt of leeg is:
  • Dit gebeurt vaak wanneer de connector op een proxyserver is geïnstalleerd in plaats van op de hoofdserver van Winbooks
  • De connector MOET worden geïnstalleerd op dezelfde server waarop Winbooks draait

​
Oplossing 3: Controleer het bestand Users.dbf

  1. Ga naar de map die is opgegeven in UsersPath
  2. Controleer of er een bestand met de naam Users.dbf aanwezig is
  3. Dit bestand bevat uw lijst met boekhoudmappen
Om te controleren of uw mapcode bestaat:
  • De service maakt een tijdelijke ontsleutelde versie aan in: C:\Program Files (x86)\WinbooksService\tmp\
  • Dit bestand verschijnt alleen wanneer de service draait en een verzoek verwerkt
  • Neem contact op met support als u hulp nodig hebt om te controleren of uw mapcode in dit bestand staat

​
Oplossing 4: Controleer gebruikersrechten

Het Windows-gebruikersaccount waaronder de service draait moet beschikken over:
  • Leesrechten op alle Winbooks-mappen
  • Leesrechten op alle netwerkschijven
  • Schrijfrechten op de logmap van de service
Om dit te controleren:
  1. Controleer welke gebruiker de service uitvoert (services.msc → Eigenschappen → tabblad Aanmelden)
  2. Meld u aan als die gebruiker (of laat IT dit verifiëren)
  3. Probeer de Winbooks-mappen handmatig te openen
  4. Als de toegang wordt geweigerd, werk het serviceaccount bij (zie Deel 4, Stap 2)
Probleem: VFPOLEDB-fouten Als u fouten ziet die verband houden met VFPOLEDB, is het databasestuurprogramma mogelijk niet correct geïnstalleerd. Oplossing: VFPOLEDB opnieuw installeren
  1. Ga naar: C:\\Program Files (x86)\\WinbooksService\\
  2. Zoek: VFPOLEDBSetup.exe
  3. Verwijder eerst de bestaande versie:
    • Rechtermuisklik → Als administrator uitvoeren
    • Selecteer Uninstall
    • Voltooi de verwijdering
  4. Installeer daarna opnieuw:
    • Voer VFPOLEDBSetup.exe opnieuw uit als administrator
    • Vink “Sample data files and programs” uit
    • Selecteer “Everyone” (cruciaal!)
    • Voltooi de installatie
  5. Start de WinbooksService opnieuw:
    • services.msc → Rechtermuisklik op WinbooksService → Opnieuw starten
Probleem: service start niet
  1. Open Logboeken (zoek naar “Logboeken” of “Event Viewer” in Windows)
  2. Ga naar: Windows-logboeken → Toepassing
  3. Zoek naar fouten van “WinbooksService”
  4. De foutmelding geeft aan wat er fout is
Veelvoorkomende oorzaken:
  • .NET Framework 4.8 ontbreekt
  • VFPOLEDB is niet correct geïnstalleerd
  • Het gebruikersaccount heeft niet de benodigde rechten
  • Het netwerkpad is niet toegankelijk

​
Snelle referentie: installatiesamenvatting

  1. ✅ Controleer alle vereisten (Deel 1)
  2. ✅ Verzamel mapcode, analytisch plan en Winbooks-pad
  3. ✅ Maak de verbinding aan in de webinterface
  4. ✅ Download het ZIP-bestand naar de Winbooks-server
  5. ✅ Installeer de service (Als administrator uitvoeren)
  6. ✅ Installeer VFPOLEDB (voorbeeldgegevens uitvinken, Everyone selecteren)
  7. ✅ Bij gebruik van netwerkschijven: werk settings.json en het serviceaccount bij
  8. ✅ Start de service opnieuw
  9. ✅ Test de verbinding

​
Bijlage: UNC-paden begrijpen

Wat is een UNC-pad? UNC staat voor “Universal Naming Convention” - het is de standaardmanier om netwerklocaties in Windows op te geven. Formaat: \\ServerName\ShareName\FolderPath Voorbeelden van conversies: Waarom UNC-paden belangrijk zijn:
  • Windows-services (zoals WinbooksService) draaien in een andere context dan uw gebruikersaccount
  • Ze zien toegewezen schijven (P:, Z:, enz.) niet automatisch
  • Ze hebben het volledige netwerkadres (UNC-pad) nodig om netwerkbestanden te vinden
Hoe u een UNC-pad vindt:
  1. Open Windows Verkenner
  2. Klik met de rechtermuisknop op de netwerkschijf
  3. Selecteer “Eigenschappen”
  4. Zoek naar “Locatie” of “Doel” - dit toont het UNC-pad