EekBoek

Electronisch Boekhouden voor het MKB

Documentatie

Configuratie

Configuratiebestanden

De configuratie van EekBoek wordt vastgelegd in configuratiebestanden. Deze bestanden zijn gemodelleerd naar een va de vele de-facto standaards, die van de INI files.

Bij het opstarten zal EekBoek de volgende configuratiebestanden verwerken indien ze aanwezig zijn:

Het systeem-globale configuratiebestand. Op een Unix of Linux systeem is dit het bestand /etc/eekboek/eekboek.conf.
In dit bestand kan bijvoorbeeld de systeembeheerder de instellingen voor de databases opnemen.
Het gebruikers-specifieke configuratiebestand. Op een Unix of Linux systeem is dit het bestand .eekboek/eekboek.conf in de home-directory van de gebruiker.
In dit bestand kan een gebruiker bijvoorbeeld taalinstellingen en andere voorkeuren opnemen. Wanneer er met slechts één administratie wordt gewerkt kan hier ook de naam van de te gebruiken database worden opgenomen.
Het administratie-specifieke configuratiebestand. Op een Unix of Linux systeem is dit het bestand .eekboek.conf in de huidige directory.
Wanneer met meerdere administraties wordt gewerkt is dit een goede plek om de naam van de te gebruiken database op te nemen.

De gegevens uit de specifieke bestanden hebben voorrang boven die uit meer generieke bestanden.

De EekBoek shell ebshell kan bovendien op de command line een configuratie-optie --config worden meegegeven. Met deze optie wordt een niet-standaard configuratiebestand aangewezen dat in de plaats van het administratie-specifieke bestand komt. Tevens is het mogelijk om met de command line optie -X de EekBoek shell te instrueren alle standaard-configuratiebestanden te negeren. Dit is uiteraard alleen zinvol in combinatie met --config.

Configuratie-variabelen kunnen ook worden gezet op de command line bij het opstarten van EekBoek. Zie hiervoor Command line opties.

De configuratiebestanden zijn verdeeld in secties, die elk een of meer variabelen kunnen bevatten. Bijvoorbeeld

[Database] name = demoadmin

In dit kleine voorbeeldje is er sprake van een sectie, ‘Database’, met een variabele ‘name’ met de waarde ‘demoadmin’. Voor meer details, zie b.v. WikiPedia.

De waarde van configuratie-variabelen kan worden opgevraagd met de EekBoek shell. Als de eerste optie op de command line --printcfg is, of de verkorte vorm -P, dan worden alle volgende argumenten gezien als configuratie-variabelen en wordt de waarde ervan afgedrukt. Dit is met name zinvol in shell scripts, bijvoorbeeld om de actuele naam van de database op te vragen. Na het afdrukken van de variabelen stopt de EekBoek shell, er wordt dus geen normale verwerking opgestart.
Configuratie-variabelen kunnen worden opgegeven in de vorm sectie:variabele. Ook is het mogelijk een sectie te selecteren voor een reeks van variabelen met de optie --section=sectie.

Omdat in de configuratiebestanden onder meer de internationalisatie-gegevens kunnen worden bepaald, kunnen deze bestanden zelf geen gebruik maken van internationalisatie. De gebruikte namen van secties en variabelen in de configuratiebestanden zijn daarom voor alle talen hetzelfde, en enigszins taal-neutraal (lees: engels-achtig).

Sectie "Locale"

`lang`	Deze variable kan worden gebruikt om de door EekBoek te gebruiken taal (locale) te selecteren. Standaard wordt de instelling van het systeem overgenomen. De waarde is doorgaans een string als `nl_NL.iso8859-1` of `nl_NL.utf8`. Als de tekensetaanduiding `utf8` is, zal EekBoek alle invoer en uitvoer in Unicode verzorgen. In alle andere gevallen vindt in- en uitvoer in ISO-8859-1 (Latin1) plaats. Default: `nl_NL.utf8` voor MS Windows systemen, anders `nl_NL`. Taalinstelling is alleen effectief in de internationale versie van EekBoek, en niet in de standaardversie.
`unicode`	Deze variable kan worden gebruikt om expliciet aan te geven dat EekBoek UNICODE moet gebruiken. Deze variabele heeft voorrang boven de waarde van `lang`.
`decimalpt`	Deze variable kan worden gebruikt om de door EekBoek te gebruiken decimaalpunt te wijzigen.
`thousandsep`	Deze variable kan worden gebruikt om EekBoek duizendpuntjes te laten zetten in bedragen. De waarde van de variabele is het ‘puntje’. De breedte van de kolommen in de rapportages wordt automatisch aangepast om ruimte te bieden aan de duizendpuntjes.

Sectie "Company"

`name`	De naam van de onderneming.
`id`	Administratienummer van de onderneming.
`address`	Adres.
`postalcode`	Postcode.
`city`	Woonplaats.
`taxreg`	Het fiscale nummer van de onderneming.

Sectie "Preferences"

journal Door deze variable een waarde ongelijk nul te geven wordt na elke boeking automatisch de betreffende journaalpost getoond.

Sectie "Database"

`name`	De naam van de te gebruiken database. Let op! De werkelijke naam wordt voorzien van een voorvoegsel, om de EekBoek databases te kunnen onderscheiden van de overige databases. Deze configuratievariabele, indien opgevraagd, zal altijd de naam weergeven zonder dit voorvoegsel. Zie ook `fullname` hieronder.
`fullname`	De volledige naam van de database, dus inclusief het voorvoegsel. Deze variabele kan niet worden opgegeven in de configuratiebestanden maar wordt automatisch afgeleid van de database naam.
`driver`	De te gebruiken database-driverer. Mogelijke waarden zijn `postgres` voor het PostgreSQL database systeem, en `sqlite` voor SQLite. Default: `postgres`.
`user`	De naam van de database-gebruiker. Indien deze configuratievariabele niet is gezet, wordt de loginnaam gebruikt.
`password`	De toegangscode van de database-gebruiker, indien nodig.
`host`	De naam van het systeem waarop de database draait. Indien deze configuratievariabele niet is gezet wordt de database verondersteld op het lokale systeem te draaien.
`port`	De poort waarlangs de database is te benaderen. Indien deze configuratievariabele niet is gezet wordt een database-specifieke standaardwaarde genomen.

Sectie "Strategy"

round

Hiermee kan worden ingesteld op welke wijze EekBoek bij berekeningen bedragen moet afronden.
De volgende methoden worden ondersteund:

`ieee`	Afronding volgens de IEEE standaard. Dit is de standaardinstelling.
`bankers`	Afronding naar even getallen (het zg. Bankers algoritme)
`posix`	Afronding volgens de POSIX standaard.

bkm_multi Indien ingesteld op een waarde anders dan 0 (default) zal EekBoek proberen boekingen in een Bank, Kas of Memoriaaldagboek waarvoor geen overeenstemmende open post kan worden gevonden te verdelen over meerdere open posten.
De boeking wordt alleen uitgevoerd indien er meerdere open posten zijn die tezamen exact het gewenste bedrag uitmaken.

iv_vc

Bij het boeken in een Inkoop- of Verkoopdagboek wordt BTW berekend per boekstukregel. Sommige leveranciers berekenen echter de BTW over het totaal van de boekstukregels. Daardoor kunnen afrondingsverschillen ontstaan met als gevolg een boekstuktotaal dat niet klopt met de opgegeven waarde. De boeking zal dan worden geweigerd.

EekBoek zal echter eerst proberen zo'n boeking te corrigeren door de BTW te herberekenen over het totaal. Er wordt dan een melding gegeven, en een correctieboekstukregel aangemaakt.

Dit gedrag kan worden afgezet door de strategy optie iv_vc de waarde 0 te geven.

Sectie "Shell"

userdefs De EekBoek shell zoekt bij het opstarten standaard een module met de naam EB::Shell::Userdefs. Indien deze module bestaat, wordt deze geladen. Deze module kan eigen opdrachten definiëren, of bestaande opdrachten aanpassen.
Met deze configuratie-variable kan een andere module in plaats van de standaardmodule worden gespecificeerd. In dit geval moet de module echter succesvol geladen kunnen worden.

Sectie "Format"

date

De vorm waarin datums moeten worden getoond.
De volgende vormen zijn mogelijk:

`YYYY-MM-DD`		ISO standaardvorm.
`DD-MM-YYYY`		NEN standaardvorm.
`DD-MM`		Verkorte NEN standaardvorm. In dit geval zullen, waar nodig, de datums toch compleet met jaartal worden weergegeven.

Sectie "Text"

numwidth De standaardbreedte voor de kolommen met bedragen in tekstuele rapportages. Deze is standaard 9 posities, voldoende voor bedragen onder het miljoen (zes cijfers voor de komma, komma plus twee achter de komma). Heeft u een miljoenenadministratie dan kan de breedte hiermee worden aangepast.
numwidth kan een waarde worden toegekend, maar ook ‘+n’, ‘-n’ of ‘nnn%’ om de breedte te vergroten of te verkleinen.
Merk op dat bij gebruik van duizendpuntjes de kolombreedte automatisch wordt aangepast om de plaats te bieden aan de puntjes.

Sectie "Html"

cssdir

De directory waar de HTML stylesheets zijn te vinden.
De uiteindelijk toegepaste stylesheet hangt af van deze setting, en de aan de rapport-opdracht meegegeven style optie.

Style	Cssdir	Resultaat
		De EekBoek standaard style voor dit type rapport wordt opgenomen in het rapport
	`dir`	Stylesheet link naar ‘`dir/std.css`’, waarin `std` de naam is van de EekBoek standaard style voor dit type rapport
`naam`	`dir`	Stylesheet link naar ‘`dir/naam.css`’
`bestandsnaam`	n.v.t.	Stylesheet link naar ‘`bestandsnaam`’

Sectie "CSV"

separator Deze variable kan worden gebruikt om de kolom-scheider in te stellen voor de in de vorm van CSV bestanden aangemaakte rapporten. Standaard staat de kolom-scheider ingesteld op ‘,’.

Sectie "Internal"

Het gebruik van deze variabelen is strict intern en kan tot ongewenste problemen leiden.

now Deze variable kan worden gebruikt om de 'huidige' datum te zetten. Dit is enkel relevant voor regressietests, waarin de gegenereerde rapporten worden vergeleken met standaardversies en het onwenselijk is als steeds de rapportage-datum zou wijzigen.