Changes between Version 20 and Version 21 of Documentatie/Beheerder/Modules

Timestamp:

Sep 8, 2016 3:49:26 PM (8 years ago)

Author:

adriaan

Comment:

--

Documentatie/Beheerder/Modules

@@ -16 +16 @@
 == Module-Instellingen ==
 
-Welke modules gebruikt worden door OpenAC wordt door een configuratiebestand `modules.ini` geregeld (en nog een klein beetje door de adaptatie-init). De modules hebben hun eigen instellingen die ook in `modules.ini` worden ingesteld (of programmatisch worden doorgegeven), nog los van instellingen die ze via het instellingenscherm kunnen hebben.
+Welke (kern)modules gebruikt worden door OpenAC wordt door een configuratiebestand `modules.ini` geregeld (en nog een klein beetje door de adaptatie-init). De (kern)modules hebben hun eigen instellingen die ook in `modules.ini` worden ingesteld (of programmatisch worden doorgegeven), nog los van instellingen die ze via het instellingenscherm kunnen hebben.
 
 Het bestand `modules.ini` heeft een ini-achtige structuur. Dat betekent dat er kopjes zijn van de vorm `[section-name]` en onder een kopje, instellingen van de vorm `key = value`.
+
+Hoewel we schrijven over `modules.ini` in deze handleiding, worden er '''drie''' bestanden geraadpleegd door OpenAC bij het opstarten:
+ - `modules.ini` in de adaptatie-map,
+ - `modules-`''AGB''`.ini` in de adaptatie-map; hier wordt voor ''AGB'' de gekozen AGB bij het inloggen ingevuld,
+ - `modules-`''locatieletter''`.ini` in de adaptatie-map; hier wordt voor ''locatieletter'' de gekozen locatie (in de drop-down in het startscherm) ingevuld.
+
+Merk op dat deze gegevens vastliggen op het moment van inloggen. De drie bestanden worden in deze volgorde (algemeen, AGB, locatie) geraadpleegd, en instellingen uit de latere bestanden vervangen instellingen in eerdere bestanden. Zo is het mogelijk om bepaalde modules alleen bij bepaalde locaties aan te zetten, en dergelijke.
 
 == Modules Aanzetten ==
@@ -62 +69 @@
 Het `modules.ini` bestand wordt gebruikt '''naast''' de bestaande adaptatie-init. Het is dus mogelijk om ook configuratie te doen via de `start()` functie in de adaptatie, en daar modules op te starten. Het verdient de voorkeur om dat via `modules.ini` te regelen, maar dat is niet altijd mogelijk -- dan is de oude stijl nog bruikbaar.
 
+Om een module in oude stijl te starten, zijn twee stappen nodig:
+ - de module moet worden geïmporteerd in de adaptatie-init, door bovenaan een regel op te nemen (hier om module `d010_systeem` te importeren):
+   {{{
+from kern import d010_systeem
+}}}
+ - de module moet worden gestart. In de adaptatie-init is een functie `start()` gedefiniëerd. Binnen deze start-functie moet van de gewenste module de start-functie worden aangeroepen. Als de module parameters heeft, dan kunnen die (in de Python code) worden meegegeven:
+   {{{
+   d010_systeem.start(voorbeeldparameter=3)
+}}}
+
+Let op de indentatie van beide regels code! Die in de start-functie moet 4 spaties ingesprongen staan.
+
+De twee regels Python code hier komen overeen met de `modules.ini` instellingen als volgt:
+
+{{{
+[modules]
+kern.d010_systeem = True
+
+[kern.d010_systeem]
+voorbeeldparameter = 3
+}}}
+
 == Voorbeeldbestand ==