[[TOC(heading=Inhoudsopgave)]]
[[TOC(heading=Hoofdstukken, sectionindex, compact, Documentatie/Beheershandleiding/)]]

= Koppeling CQI =

De CQI koppeling zorgt voor de uitnodigingen in het kader van het CQI protocol dat door de FENAC is afgesproken. Er zijn vijf partijen gemoeid met het CQI onderzoek:

 - de patient zelf, die wel of niet meewerkt aan het onderzoek. Zie hierover de gebruikershandleiding. De patient heeft een voorkeur om mee te doen (of niet) en vult uiteindelijk via een website de CQI enquete in.
 - het AC waar de patient komt. Deze ziet er op toe dat de patient uitgenodigd wordt om mee te doen aan het onderzoek en registreert of de patient dat wel wil.
 - de FENAC, die de CQI enquete verplicht stelt voor de leden.
 - Kiwa Carity b.v., die de enquete afneemt en de gegevens verwerkt.
 - de NVVS, die de geaggregeerde gegevens rapporteert.

== Inrichten ==

Het inrichten van de module gaat om het (eenmalig) in-gebruik-nemen van de module. Hiervoor moeten er sjablonen worden aangemaakt, zoals dat ook voor de module `s080_herinneringen` gaat. Daarnaast zijn er enkele instellingen die in de adaptatie-init gedaan moeten worden.

=== Module ===

Om de nieuwe CQI te gebruiken, moeten de volgende stappen worden ondernomen:

 - 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()
}}}
 - 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
}}}

=== 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)]]

== Gebruik ==

Als de module is ingericht, dan moeten er met enige regelmaat beheers-acties worden ondernomen om de module werkend te houden. Voornaamste is hierbij het inlezen van nieuwe code-bestanden.

=== Nieuwe Codes ===

De patient gebruikt (afhankelijk van de preciese instellingen bij doelgroepen) login-namen en -codes die door KIWA Carity b.v. worden uitgedeeld. Een AC kan ook afspreken om vaste login-namen en -codes te gebruiken, per doelgroep.

 - '''Vaste code per doelgroep''' Vul in de codetabel voor doelgroepen de login-naam en login-code voor deze doelgroep. Het is niet nodig om codes in te lezen van KIWA Carity b.v.
   [[Image(sjablonen3.png)]]
 - '''Unieke code per patient''' Vul in de codetabel voor doelgroepen '''geen''' naam of code in. Lees sheets met aangeleverde codes in in OpenAC zoals hieronder beschreven.

Deze unieke codes (login-namen en login-codes) worden als Excel worksheet aangeleverd in een formaat dat OpenAC in kan lezen.

[[Image(importeren.png)]]

Gebruik het menu ''Beheer'' -> ''Importeren uit'' -> ''KIWA CQI Codebestand''. Kies dan het aangeleverde codebestand om het in te leveren. Er is een voorbeeld codebestand opgenomen in OpenAC voor test-doeleinden. Dat bestand staat in de OpenAC installatiemap onder `kern/d080_cqi/test-codeaanlevering.xls`.

Indien het AC een vaste gebruiker en code heeft ingesteld bij een doelgroep, wordt voor die doelgroep geen code verbruikt.


=== Rapportages ===

Rapportage over het verbruik van de CQI codes en de hoeveelheid uitnodigingen zijn voor OpenAC v2.010 gepland. In v2.008 is er nog niks van beschikbaar. De resultaten van de CQI enquete zelf -- geaggregeerde scores over de tevredenheid van patienten met de dienstverlening door het AC -- komen niet in OpenAC maar worden door KIWA Carity b.v., de FENAC of de NVVS aan de ACs beschikbaar gesteld.

=== Database Opschonen ===

Er zijn drie soorten records die in de database terecht komen tijdens het gebruik van de CQI module:
 - Voorkeur records (tabel `voorkeur_data`)
 - Voorkeur items (tabel `voorkeur_item_data`)
 - CQI codes (tabel `cqi_kiwacode_data`)
Voorkeuren kunnen worden opgeruimd zoals elk ander soort "wees" record; daarna kunnen voorkeur-items opgeruimd worden. We verwachten hier geen grote aantallen, omdat zulke records alleen ontstaan als dossiers worden verwijderd of als een voorkeur-code buiten gebruik gesteld wordt.

De CQI codes die gebruikt zijn blijven opgeslagen in de database. Deze zijn nodig voor de rapportages (zie boven). Na een aantal jaar is wel te overwegen om de oud(st)e gebruikte codes te verwijderen.