| View file | ||||
|---|---|---|---|---|
|
| Table of Contents |
|---|
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 | name medication | 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: "-" |
| unit | 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 | quantity | item[cd[@S='CD-ITEM'][text()='medication']]/regimen/quantity/decimal |
| 5 | frequency | 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 | end date | /endmoment/date If /endmoment/date is not present and /duration is present: /beginmoment/date + /duration/decimal * /duration/unit If both are not present:
|
| 7 | end condition | item[cd[text()='endcondition']]/content[text]/text If end condition is not present: no visualisation. |
| 7' | begin condition | item[cd[text()='begincondition']]/content[text]/text If begin condition is not present: no visualisation. |
| 8 | start date | /beginmoment/date |
| 15 | instructions | /instructionforpatient/text |
TS
| Nr | Description | Value from Kmehrmessage /folder/transaction[content/cd[text()='medicationschemeelement']... | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| 9 | start date of suspension | /beginmoment/date | ||||||||
| 10 | end date of suspension | /endmoment/date If /endmoment/date is not present and /duration is present: /beginmoment/date + /duration/decimal * /duration/unit | ||||||||
| 11 | reason of suspension | item[cd[text()='transactionreason']]/content[text]/text | ||||||||
| 12 | author of suspension | All name data from /hcparty[?]
| ||||||||
| 13 | role of author of suspension | 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 | decision date of suspension | /date + " - " + /time |
Deviations for "Indien nodig" and "Nog in te plannen medicatie"
| Nr | Description | Value from Kmehrmessage /folder/transaction[content/cd[text()='medicationschemeelement']... |
|---|---|---|
| 1 | free text posology | /posology/text If /posology is not present and /regimen is also not present: no visualisation. |
| 2 | unit | 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:
|
| 3 | quantity | item[cd[@S='CD-ITEM'][text()='medication']]/regimen/quantity/decimal |
| 4 | intake moment | If item[cd[@S='CD-ITEM'][text()='medication']]/regimen/daytime/dayperiod is present:
If item[cd[@S='CD-ITEM'][text()='medication']]/regimen/daytime/time is present:
|
| 5 | frequency | 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 periodicity is not present: no visualisation. |
Validation error
