> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chift.eu/llms.txt
> Use this file to discover all available pages before exploring further.
# Winbooks Classic - Installatiehandleiding
**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](https://dotnet.microsoft.com/download/dotnet-framework/net48) 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`
***
### 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**
***
### 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
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:**
| | |
| - | - |
| | Wat u zietUNC-pad |
| `P:\Winbooks` | `\\FileServer\Accounting\Winbooks` |
| `Z:\Shared\Data` | `\\MainServer\SharedDrive\Data` |
| `C:\Winbooks` | `C:\Winbooks` (al een lokaal pad, geen conversie nodig) |
**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