> ## 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
# **VEREISTEN**
* Een versie 7 of hoger van Winbooks is vereist
* Je moet de connector installeren op de server waarop Winbooks is geïnstalleerd. Om te zorgen dat de connector op de server werkt, controleer vóór de installatie dat:
* Je beheerderstoegang hebt tot de server waarop Winbooks is geïnstalleerd om de installatie te kunnen uitvoeren
* **Let op:** de server/computer moet permanent bereikbaar zijn met internettoegang (24 uur per dag). Anders zouden de gegevens op een bepaald moment niet gesynchroniseerd kunnen worden.
* Je je Winbooks-gebruikersnaam en -wachtwoord kent
Het **.NET Framework 4.8 MOET geïnstalleerd zijn** op de server/computer waarop de connector geïnstalleerd zal worden!
Als je een netwerkschijf gebruikt, moeten alle paden die in de volgende stappen worden opgegeven UNC-paden zijn en geen lokale paden, opdat de service werkt. In dat geval moet je ook de gebruiker die de service uitvoert aanpassen naar een gebruiker die toegang heeft tot zowel Winbooks als de netwerkschijf.
# **VOORBEREIDING**
**Bekijk deze video:**
[](https://chift-connector-videos.s3.eu-west-3.amazonaws.com/1005/1005-config.mp4)
1. Zoek de code van je boekhoudmap in je Winbooks-account
2. Selecteer het analytische plan dat standaard gebruikt moet worden
1. Ga naar je Winbooks-account
2. Selecteer het tabblad Analytisch → Parameters → Boekhoudplan
3. Zoek op je computer de schijf waarop het Winbooks.ini-bestand zich bevindt en kopieer het pad naar de map
# VERBINDING
**Stap 1:** Kies een naam voor je verbinding
**Stap 2:** Selecteer het analytische plan dat je standaard wilt configureren & voer het pad in waar je Winbooks-software zich bevindt
**Stap 3:** Download het zip-archief en plak het op de server waarop je Winbooks-instantie draait.
**Stap 4:** Voer de code van je boekhoudmap in, overeenkomend met je Winbooks-account
**Stap 5:** Klik op "Submit" om de verbinding af te ronden
**Stap 6:** Ga terug naar je server en start de installatie van de lokale agent door het WinbooksServiceSetup-bestand uit te voeren uit het archief dat je zojuist in stap 3 hebt gedownload.
# **DOWNLOAD VAN DE LOKALE AGENT**
Winbooks is geïnstalleerd op een server. Om het delen van gegevens mogelijk te maken, is het nodig om een connector (lokale agent) te downloaden die de gegevensoverdracht met Winbooks mogelijk maakt.
Na de verbindingsstap heb je twee opties om de lokale agent te downloaden en te installeren op dezelfde server als je Winbooks-instantie:
* Als Winbooks op je computer gehost wordt, kun je het programma direct downloaden door op **Download** te klikken
* Als Winbooks op een andere server gehost wordt, heb je de mogelijkheid om het installatieprogramma van de connector per e-mail te sturen naar de persoon of het bedrijf dat Winbooks host, zodat zij het kunnen downloaden en installeren
Hier is een video van de volledige installatie van de service.
Het is vereist om VFPoleDB te installeren opdat de service werkt; een specifieke installatiepagina zal automatisch openen tijdens de installatie van de service.
**Het is vereist om de "sample data" niet te installeren en ervoor te zorgen dat je het installeert voor Everyone en niet alleen voor je eigen gebruiker, anders kan de service het niet gebruiken en zal de verbinding niet werken.**
## 🚨 Als er een fout is met de lokale Winbooks-agent in Chift
Ga naar de logs-map in de Service **(C:/Program Files (x86)/WinbooksService/Log/log.html)** en open het bestand met je standaardbrowser. De meest recente regels staan aan het einde van het bestand en zouden moeten helpen te begrijpen wat er aan de hand is. Als het bestand niet bestaat, betekent dit dat we de connector nog niet hebben proberen te bereiken, dus er zijn geen logs te zien. In dat geval moet er een verzoek worden uitgevoerd voor deze consumer zodat het aangemaakt wordt.
Is Winbooks geïnstalleerd op een netwerkschijf of worden de gegevens op een netwerkschijf gehost
1. **Werk de settings.json bij om je netwerkschijf te koppelen aan een UNC-pad**
Als de gebruiker een netwerkschijf gebruikt, moeten er enkele wijzigingen worden aangebracht in de settings.json om de verbinding correct te laten werken.
Je moet eerst het UNC-pad van je netwerkschijf vinden.
Bijvoorbeeld, als je de P://-schijf gebruikt, is dit hoogstwaarschijnlijk een netwerkschijf, dus je moet het UNC-pad voor die schijf achterhalen. Het zal er ongeveer zo uitzien: \chi-win02\sage\_compta
Vervolgens moet je de waarde in de settings.json bijwerken zodat de agent weet hoe hij met dit P://-pad moet omgaan. Hiervoor vind je twee waarden in de Json: toReplace en replaceWith. De waarden zijn standaard ingesteld op null
Het idee is dus om de waarden voor deze velden te wijzigen en de waarden in te vullen die je zojuist hebt verkregen.
Je eindigt dan met de volgende elementen in de settings.json
"toReplace": "P://" , "replaceWith": "\\\chi-win02\sage\_compta"
**Let op: in dit json-bestand moeten alle \ verdubbeld worden (hier in mijn voorbeeld werd \chi-win02\sage\_compta \\\chi-win02\sage\_compta)**
2. **Zorg ervoor dat de gebruiker die de service uitvoert toegang heeft tot zowel Winbooks als de netwerkschijf**
Open het service-tabblad van je Windows-server door te zoeken op het trefwoord service op je server.
Open het en zoek naar de service met de naam WinbooksService.
Je moet rechtsklikken op deze service en op de optie eigenschappen klikken.
Je moet de sectie "dit account" gebruiken en een gebruiker selecteren die toegang heeft tot zowel de netwerkschijf als de map waarin alle Winbooks-bestanden zijn opgeslagen.
3. Zodra alle voorgaande controles zijn uitgevoerd, herstart de service en test de verbinding
Herstart de lokale agent
* **Navigeer naar de service.msc Windows-app**
* **Zorg ervoor dat de service is geconfigureerd met een Windows-gebruiker met toegangsrechten tot de SQL DB en gedeelde netwerkschijven**
* **Herstart daarna de Winbooks-service**
Fouten gerelateerd aan VFPOLEDB in het log.html-bestand
* **Navigeer naar de Winbooks-servicemap “*C:/Program Files (x86)/WinbooksService/*” en start het “*VFPOLEDBSetup*”-uitvoerbare bestand**
* **Verwijder het (Windows-beheerdersrechten vereist)**
* **Start daarna het installatieprogramma opnieuw (Windows-beheerdersrechten vereist)**
* **Vink het selectievakje “*Sample data files and programs*” niet aan**
* **Zorg ervoor dat de optie “*Everyone*” is aangevinkt, anders werkt de driver niet met de lokale systeemgebruiker die de Winbooks-service uitvoert.**
* **Ga verder met de installatie**
* **Navigeer naar de service.msc Windows-app**
* **Zorg ervoor dat de service is geconfigureerd met een Windows-gebruiker met toegangsrechten tot de SQL DB en gedeelde netwerkschijven**
* **Herstart daarna de Winbooks-service**
Het opgegeven bedrijf bestaat niet in het boekhoudsysteem
Dit betekent dat we de boekhoudmap niet kunnen vinden. Dit komt vaak doordat de connector het pad waar de gegevens zijn opgeslagen niet kan vinden. Dit kan komen door problemen met toegangsrechten of met de toegang tot netwerkschijven.
1. **Controleer het pad dat geconfigureerd is in het Winbooks-verbindingsformulier op Chift**
* Zorg ervoor dat het opgegeven pad (bijv. `C:\\Winbooks`) bestaat.
* Controleer of deze map het **Winbooks.ini**-bestand bevat.
* ⚠ Als het pad niet bestaat of niet toegankelijk is voor de gebruiker die de Windows-service uitvoert → **gebruik een UNC-pad als de map zich op een gedeelde of netwerkschijf bevindt.**
2. **Open het Winbooks.ini-bestand**
* Controleer of de variabele **UsersPath** aanwezig is.
* Als de variabele ontbreekt of leeg is → Dit is hoogstwaarschijnlijk het probleem (gebeurt vaak wanneer de connector is geïnstalleerd op een **proxyserver** in plaats van op de **hoofdserver**).
3. **Verifieer de map die is opgegeven in UsersPath**
* Zorg ervoor dat de map bestaat.
* Controleer of deze het **Users.dbf**-bestand bevat.
* ⚠ Zelfde regel: als de map gedeeld is of op een netwerkschijf staat, vervang deze dan door een UNC-pad in het winbooks.ini-bestand
4. **Controleer het Users.dbf-bestand**
* Dit bestand bevat de lijst van alle bedrijven (1 rij = 1 bedrijf).
* Elke bedrijfsvermelding geeft het pad naar zijn **DB/DATA**-map aan. Als je pad naar een netwerkschijf leidt, moet dit pad een UNC-pad zijn.
* ⚠ Het bestand is versleuteld → de connector ontsleutelt het automatisch en maakt een tijdelijk ontsleuteld bestand aan in:
`C:\\Program Files (x86)\\WinbooksService\\tmp` . Dit bestand is alleen zichtbaar wanneer er een verzoek naar de service wordt uitgevoerd.
Hier is een voorbeeld van een users.dbf-bestand zodra het geopend is: je hebt de kolom CODESOC die verwijst naar de mapcodes en het pad dat de bijbehorende paden aangeeft.
* **Te verifiëren:**
* De **bedrijfscode** die in Chift is ingevoerd komt overeen met een bedrijf in het bestand.
* Als er geen overeenkomst in het bestand wordt gevonden, zal de connector niet werken. Je kunt het formulier op Chift opnieuw indienen om het te wijzigen zonder de service opnieuw te moeten installeren
* Het pad dat is opgegeven voor de **DB/DATA**-map is geldig en toegankelijk.
* Als het pad niet bestaat of niet toegankelijk is voor de gebruiker die de service uitvoert, kan het niet werken. Je moet dan de gebruiker die de service uitvoert aanpassen zoals uitgelegd in de gedetailleerde probleemoplossingssectie.
* Als het pad bestaat en correct is maar geen UNC-pad is en gekoppeld is aan een netwerkschijf, dan moet je dit bestand bijwerken zodat het het UNC-pad bevat en niet het lokale pad. Dit verandert niets aan je Winbooks-configuratie, aangezien deze 2 paden voor jouw machine hetzelfde zijn, maar het stelt de service in staat te weten waar hij naar Winbooks-gerelateerde bestanden moet zoeken