General
This document describes the mapping of the Kmehr data to the summary view of the healthcare professionals of the Vitalink medication scheme.
The screenshots below are all from the reference PDF.
Data source
The Vitalink PDF is a visualisation of a <kmehrmessage> with CD-STANDARD "20161201".
All data of the Vitalink PDF are taken from the <folder>.
The <folder> contains:
- exactly 1 patient
- exactly 1 transaction of the type medicationscheme (further referred to as MS)
- 1 or more transactions of the type medicationscheemeelement (further referred to as MSE)
- 0 or more transactions of the type treatmentsuspension (further referred to as TS), where each TS is linked to exactly 1 MSE.
Mapping
Header (MS)
| Nr | Description | Value from Kmehrmessage |
|---|---|---|
| 1 | "Afgedrukt op:" | Does not occur in the Kmehrmessage, but it is generated. today() + " - " + now() |
| 2 | "Medicatieschema:" | folder/patient/firstname + " " + folder/patient/lastname |
| 3 | "Laatst gewijzigd op:" | folder/transaction[content/cd[text()='medicationscheme']/date + " - " + folder.transaction[content/cd[text()='medicationscheme']/time |
| 4 | "Naam:" | All name data from folder/transaction[content/cd[text()='medicationscheme']/hcparty[?]
|
| 5 | "Functie:" | Dutch translation for the code of the role data in folder/transaction[content/cd[text()='medicationscheme']/hcparty[?], translated according to https://www.ehealth.fgov.be/standards/kmehr/sites/default/files/assets/reference_table/xml/cd-hcparty.xml
|
| 6 | "Versienummer:" | folder/transaction[content/cd[text()='medicationscheme']/version |
Intake blocks
The overview shows the schedule in 4 intake blocks, with each intake block up to 3 columns: "voor", "tijdens" and "na".
The table below indicates what a medicationschemeelement-transaction must meet in order to occur in a specific intake block.
| Intake block | How to use this intake block | Condition from Kmehrmessage /folder/transaction[content/cd[text()='medicationschemeelement']/item[cd[@S='CD-ITEM'][text()='medication']]... | |
|---|---|---|---|
| AND | |||
| Nog in te plannen medicatie | Unlabeled
| If / posology is present, it is used, otherwise it is empty | ( /temporality == chronic OR /temporality == acute ) AND /regimen is not present |
| Ontbijt | 's morgens
|
| ( /temporality == chronic OR /temporality == acute ) AND /regimen is present |
voor
| /regimen/daytime/dayperiod == beforebreakfast | ||
tijdens
| /regimen/daytime/dayperiod == duringbreakfast | ||
na
| /regimen/daytime/dayperiod == afterbreakfast | ||
Tussen ontbijt en middagmaal
|
| ||
| Middagmaal | voor
| /regimen/daytime/dayperiod == beforelunch | |
tijdens
| /regimen/daytime/dayperiod == duringlunch | ||
na
| /regimen/daytime/dayperiod == afterlunch | ||
Tussen middagmaal en avondmaal
|
| ||
| Avondmaal | voor
| /regimen/daytime/dayperiod == beforedinner | |
tijdens
| /regimen/daytime/dayperiod == duringdinner | ||
na
| /regimen/daytime/dayperiod == afterdinner | ||
Tussen avondmaal en nacht
|
| ||
| Bij het slapen | voor
|
| |
| Indien nodig | Unlabeled
| /regimen/daytime/dayperiod is used | /temporality == adhoc |
| If /posology is present, it is used, otherwise it is empty | |||
Medicationline (MSE+TS)
General
MSE
| Nr | Description | Value from Kmehrmessage /folder/transaction[content/cd[text()='medicationschemeelement']... |
|---|---|---|
1 | naam medicatie | If one of the following is present, show this:
|
2 | drugroute | Dutch translation of code from item[cd[@S='CD-ITEM'][text()='medication']]/route, according to http://www.vitalink.be/sites/default/files/atoms/files/Vitalink_Medicatieschema_Vertaaltabellen_v1%204.pdf If route is not present: "-" |
| eenheid | Dutch translation of code from first entered item[cd[@S='CD-ITEM'][text()='medication']]/regimen/quantity/unit, according to http://www.vitalink.be/sites/default/files/atoms/files/Vitalink_Medicatieschema_Vertaaltabellen_v1%204.pdf if no unit is present: "-" | |
| 4 | hoeveelheid | item[cd[@S='CD-ITEM'][text()='medication']]/regimen/quantity/decimal |
| 5 | frequentie | Dutch translation of code from /frequency/periodicity according to http://www.vitalink.be/sites/default/files/atoms/files/Vitalink_Medicatieschema_Vertaaltabellen_v1%204.pdf if no periodicity is present: no visualisation. |
| 6 | einddatum | /endmoment/date If /endmoment/date is not present and /duration is present: /beginmoment/date + /duration/decimal * /duration/unit If both are not present:
|
| 7 | eindconditie | item[cd[text()='endcondition']]/content[text]/text If end condition is not present: no visualisation. |
| 7' | beginconditie | item[cd[text()='begincondition']]/content[text]/text If begin condition is not present: no visualisation. |
| 8 | startdatum | /beginmoment/date |
| 15 | gebruiksaanwijzing | /instructionforpatient/text |
TS
| Nr | Description | Value from Kmehrmessage /folder/transaction[content/cd[text()='medicationschemeelement']... |
|---|---|---|
| 9 | startdatum van opschorting | /beginmoment/date |
| 10 | einddatum van opschorting | /endmoment/date If /endmoment/date is not present and /duration is present: /beginmoment/date + /duration/decimal * /duration/unit |
| 11 | reden van opschorting | item[cd[text()='transactionreason']]/content[text]/text |
| 12 | auteur van opschorting | All name data from /hcparty[?]
|
| 13 | rol van auteur van opschorting | Dutch translation for the code of the role data in /hcparty[?], translated according to https://www.ehealth.fgov.be/standards/kmehr/sites/default/files/assets/reference_table/xml/cd-hcparty.xml
|
| 14 | beslissingsdatum van opschorting | /date + " - " + /time |
Deviations for "Indien nodig" and "Nog in te plannen medicatie"
| Nr | Description | Value from Kmehrmessage /folder/transaction[content/cd[text()='medicationschemeelement']... |
|---|---|---|
| 1 | vrije tekst posologie | /posology/text Indien niet aanwezig, en ook /regimen niet aanwezig: geen visualisatie. |
| 2 | eenheid | Nederlandse vertaling van code uit eerst ingevulde item[cd[@S='CD-ITEM'][text()='medication']]/regimen/quantity/unit, Nederlandse vertaling volgens http://www.vitalink.be/sites/default/files/atoms/files/Vitalink_Medicatieschema_Vertaaltabellen_v1%204.pdf Indien geen enkele unit aanwezig:
|
| 3 | hoeveelheid | item[cd[@S='CD-ITEM'][text()='medication']]/regimen/quantity/decimal |
| 4 | innamemoment | Indien item[cd[@S='CD-ITEM'][text()='medication']]/regimen/daytime/dayperiod aanwezig:
Indien item[cd[@S='CD-ITEM'][text()='medication']]/regimen/daytime/time aanwezig:
|
| 5 | frequentie | Nederlandse vertaling van code uit /frequency/periodicity volgens http://www.vitalink.be/sites/default/files/atoms/files/Vitalink_Medicatieschema_Vertaaltabellen_v1%204.pdf Indien periodicity niet aanwezig: geen visualisatie. |
Validation error
