Changes between Version 2 and Version 3 of Documentatie/Beheerder/Modules/CQI

Timestamp:

Oct 20, 2014 8:15:06 AM (12 years ago)

Author:

adriaan

Comment:

--

Documentatie/Beheerder/Modules/CQI

@@ -14 +14 @@
 == Inrichten ==
 
-[[NoteBox(warn, Het is '''zeker''' dat de sjablonen voor CQI herinneringen nog aangepast moeten worden. De merge-velden die hier onder beschreven staan zijn niet compleet.)]]
+
+
+=== Module ===
 
 Om de nieuwe CQI te gebruiken, moeten de volgende stappen worden ondernomen:
- - In de adaptatie-init, voeg `from kern import s080_cqi` toe aan de lijst imports en start deze module in de `start()` functie van de adaptatie. De twee regels zien er ongeveer zo uit, maar ze staan uiteraard niet bij elkaar in de adaptatie-init:
+
+ - In de adaptatie-init, voeg minstens de module `s080_cqi` toe. Wellicht is
+   `d080_cqi` ook nodig, om configuratie-parameters vast te leggen. Voeg
+   voor elke module een `import` regel toe (bovenaan) en een `start()` aanroep
+   in de eigen `start()` functie. Dat ziet er ongeveer zo uit:
    {{{
+from kern import d080_cqi
 from kern import s080_cqi
+    d080_cqi.start()
     s080_cqi.start()
 }}}
- - Nadat je de module in gebruik hebt genomen, moet je enkele tabellen expliciet initialiseren:
-   - Draai het migratie-script voor v2.008 met de stappen ''init-voorkeur'' en ''init-voorkeur-item'' als volgt:
+ - Indien nodig, voeg module-parameters toe voor `d080_cqi`. Deze bepalen hoe
+   de module werkt. De parameters zijn uitgebreid beschreven in de technische
+   documentatie, maar in het kort:
+   - ''geen_email_versturen'' wordt gebruikt om '''alleen''' papieren
+     brieven te versturen (geen e-mail, zelfs als de patient een e-mail
+     adres heeft opgegeven). Een zinvolle waarde is `True`, om e-mail uit
+     te schakelen.
+   - ''exclusie_aantekeningen'' kan aantekeningen (op patient niveau) toevoegen
+     om bepaalde groepen patienten uit te sluiten van deelname aan de CQI.
+     Deze aantekeningen moeten worden afgestemd met KIWA. Een zinvolle waarde
+     is een lijst met strings.
+   - ''doelgroepselectie'' selecteert welke methode wordt gebruikt voor het
+     bepalen van de doelgroep waartoe een patient behoort. Beschikbare waarden
+     zijn ''default'' (alleen van toepassing indien het AC geen doelgroepen
+     gebruikt), ''leeftijd'' (geeft doelgroepen kind en volwassene) en enkele
+     anderen. Zie de technische documentatie voor de volledige lijst.
+ - Nadat je de module in gebruik hebt genomen, moet je enkele tabellen expliciet
+   initialiseren. Draai het migratie-script voor v2.008 met de stappen
+   ''init-voorkeur'' en ''init-voorkeur-item''. Doe dit ook als het migratie
+   script al een keer eerder is gedraaid voordat CQI aanstond.
    {{{
 Python25\python.exe script.py migratie v2_008 --init-voorkeur --init-voorkeur-item
 }}}
- - Neem het uitnodiging-sjabloon over uit `kern\d080_cqi\uitnodiging.cqi` (dit is een ''.doc'' bestand dat met Word kan worden bewerkt, maar de extensie moet ''.cqi'' zijn). Pas de codetabel voor sjablonen aan naar het nieuwe pad van het sjabloon. Bewerk het sjabloon, maar laat de twee sjabloon-velden ''cqi_url'' en ''cqi_code'' staan. Het sjabloon wordt naar HTML geconverteerd, dus het heeft geen zin om heel veel opmaak te doen in het sjabloon. '''NB.''' Het is te verwachten dat er nog twee merge-velden bij komen.
- - Neem '''ook''' het uitnodiging-sjabloon over uit `kern\d080_cqi\uitnodigingbrief.cqi`. Dit sjabloon wordt gebruikt om brieven te printen. Hier mag wel opmaak in worden gebruikt.
+
+=== Sjablonen ===
+
+Er zijn twee voorbeeld-sjablonen meegeleverd met OpenAC, in de map `kern/d080_cqi`.
+Om deze sjablonen te bewerken, maak een kopie in de eigen adaptatie sjablonen-map.
+De extensie van beide bestanden is `.cqi`, maar het zijn gewone Word-bestanden.
+
+Het sjabloon ''uitnodiging.cqi'' is het sjabloon voor e-mail uitnodigingen.
+Dit sjabloon wordt door Word omgezet in HTML. Hierdoor verdwijnen afbeeldingen,
+logo's enz.; die worden niet meegestuurd door OpenAC. Hierdoor is het aan te bevelen
+om weinig opmaak aan het sjabloon toe te voegen. Het sjabloon ''uitnodigingbrief.cqi''
+daarentegen wordt gebruikt voor brieven (die afgedrukt worden) en kan wel layout,
+logo's enz. bevatten.
+
+Als het sjabloon gekopieerd is naar de adaptatie sjablonen-map, dan moet de code-tabel
+voor sjablonen worden aangepast om de veranderde filenaam aan te geven. Ga naar
+het codetabel scherm, kies tabel ''sjablonen'' (in het blok van ''d010_systeem'').
+Zoek sjabloon ''CQI-Uitnodiging'' bij de sjablonen voor de patienten-tabel.
+
+Pas de filenaam aan, bijvoorbeeld door op ''bladeren'' te klikken en het aangepaste
+sjabloon te zoeken in de adaptatie sjablonen-map.
+
+Het is ook mogelijk om meerdere sjabloon-bestanden op te nemen, een  voor elke
+doelgroep (zie hieronder). Om dat te doen, maak meerdere kopieen van het sjabloon
+en pas ze aan. Maak meerdere sjabloon-entries in de sjablonen codetabel aan,
+een voor elk bestand -- bijvoorbeeld een sjabloon ''CQI-UitnodigingVolw'' voor
+de uitnodigingen per e-mail aan volwassenen.
+
+[[Image(sjablonen1.png)]]
+
+=== Doelgroepen ===
+
+Afhankelijk van de afspraken van het AC met KIWA worden de CQI enquetes afgenomen
+per ''doelgroep''. Een doelgroep is een patienten-populatie -- zoals kinderen, of
+volwassenen, of patienten van de locatie Simpelveld, of CI patienten. Er is in
+ieder geval afgesproken welke doelgroepen er zijn, en KIWA levert codes aan
+per doelgroep.
+
+Elke doelgroep heeft een (korte) naam. Dat is de doelgroep ''code''. Als je
+er een langere omschrijving bij kunt verzinnen, is die ook zichtbaar voor
+OpenAC gebruikers.
+
+Elke doelgroep heeft een e-mail en een brief-sjabloon. Kies voor elke doelgroep
+een e-mail en een briefsjabloon. Een sjabloon kan je ook bij meerdere doelgroepen
+gebruiken -- bijvoorbeeld eenzelfde email voor elke doelgroep, maar verschillende
+brieven.
+
+[[Image(sjablonen2.png)]]
+