[[TOC(heading=Mailmerge variabelen)]]
[[TOC(heading=Procedures, sectionindex, compact, depth=3, allactive, Documentatie/Ontwikkelaar/Procedures/)]]
[[TOC(heading=Ontwikkelaar, sectionindex, compact, depth=2, allactive, Documentatie/Ontwikkelaar/)]]
[[TOC(heading=Documentatie, sectionindex, compact, depth=1, allactive, Documentatie/)]]


= Mailmerge variabelen =
Quote uit Wikipedia: "Mailmerge is een techniek om vanuit een sjabloonbrief een veelvoud aan documenten te genereren waarin enkele gegevens verschillen.". OpenAC gebruikt mailmerge om documenten te maken waarin automatisch gegevens uit het dossier worden opgenomen zoals naam, adres, woonplaats van de patiënt. Het gaat hierbij meestal om Word-documenten maar mailmerge wordt ook gebruikt voor Excel, labels, e-mails etc.

== !MailMerge module ==
Als het secretariaat een uitnodigingsbrief wil versturen dan moet het gekozen sjabloon worden gevuld met mailmerge-variabelen die nodig zijn om de brief te completeren. Denk hierbij aan de datum van de afspraak, het type onderzoek, locatie etc. De !MailMerge module is een framework voor het samenstellen en beschikbaar maken van mailmerge-variabelen.

Voordat we mailmerge-variabelen voor een afspraak kunnen samenstellen moeten we eerst alle gerelateerde gegevens ophalen. Het gaat hierbij niet alleen om gegevens over de afspraak zelf, maar ook om gegevens over het zorgtraject waar de afspraak bij hoort en gegevens over de patiënt.

In OpenAC kunnen alle gegevenselementen worden geadresseerd met een //pad//. Het pad voor een afspraak heeft de vorm patient(x)/behandelingen(y)/plandagen(z). In dit voorbeeld zijn x, y en z  database keys. De !MailMerge module haalt automatisch de gegevens op van patient x, behandeling y en plandag z. Deze gegevens vormen de basis van de mailmerge-variabelen voor dit pad.

== Terminologie ==
=== Enkelvoudige en samengestelde mailmerge-variabelen ===
* Enkelvoudige mailmerge-variabelen zijn gelijk aan de gegevens uit de database. De !MailMerge module haalt deze automatisch op voor de entiteiten uit het pad. In een enkel geval zal de module variabelen nabewerken. Datumvelden bijvoorbeeld komen uit de database in formaat jjjj-mm-dd. De !Mailmerge module zet dit om tot dd-mm-jjjj.
* Samengestelde mailmerge-variabelen worden samengesteld uit enkelvoudige variabelen. Denk bijvoorbeeld aan de volledige naam van een patiënt die is samengesteld uit de voorletters of voornaam, achternaam, voorvoegsel, naam partner etc. Soms zijn samengestelde variabelen conditioneel bijvoorbeeld in het geval van de aanhef "Dhr" (man, > 16) of "ouders van" (< 16). In andere gevallen moeten query's worden uitgevoerd voor een samengestelde variabele, bijvoorbeeld voor het bepalen van het eerste of laatste bezoek in een zorgtraject. Het opstellen van samengestelde mailmerge-variabelen voor een pad is de taak van een "!MergeValue getter", zie hieronder.

=== !MergeGlobals en !MergeRecords ===
Deze termen zijn overgenomen uit OpenAC 2. 
* !MergeGlobals zijn 

== !MergeValues en !MergeValue getters ==
Voor het samenstellen van mailmerge-variabelen voor een entiteit hebben we een "!MergeValue getter" nodig. Een !MergeValue getter is een klasse die interface {{{ IMergeValueGetter }}} implementeert.

=== Getter registreren ===
!MergeValue getters worden geregistreerd voor één of meer ACL-paden. Een ACL-pad is de generieke vorm van het pad naar een entiteit. Als patient(x)/behandeling(y)/plandagen(z) het pad is naar afspraak z, dan is patient/behandeling/plandagen het ACL-pad.