Header
The header is the first part of a KMEHR message. It is mandatory. It mainly identifies the sender and the receiver of the message as well as the message itself.
It is composed the following elements.
confidentiality |
This element restricts the access to the content of the header to enumerated healthcare parties. (not recommended) |
Optional |
standard |
Specifies the version of the KMEHR specification your message complies with. You must use a value from CD-STANDARD. |
Mandatory |
id |
Identifies the message within the system according to ID-KMEHR identification system. The value must be the concatenation of the id of the first hcparty of the sender element, a dot, and a unique message number within your own system. This latest can be easily implemented through a timestamp like YYYYMMDDHHMMSSmmm. In addition to this, you can always add your own local message identifiers. |
Mandatory |
date |
Date of the creation of the message. |
Mandatory |
time |
Time of the creation of the message. |
Mandatory |
sender |
Contains a combination of hcparty that specifies the sender of the message. |
Mandatory |
recipient |
Contains a combination of hcparty that specifies the receiver of the message. By convention, the first recipient is the main addressee of the message. The following recipients are considered as cc (carbon copy). KMEHR compliant IT systems should use this information to route the message. |
Mandatory |
urgency |
Specifies the urgency of the message using a value from CD-URGENCY. |
Optional |
acknowledgment |
Specifies the type of acknowledgment that is desired by the sender unsing a value from urgency of the message using a value from CD-ACKNOWLEDGMENT. |
Optional |
text |
Comments the message. |
Optional |
lnk |
Establishes links with the message. For instance, to replace another message by using the value ‘isanewversionof’ from CD-LNK; to manage order/result relationship by using the value ‘isareplyto’ from CD-LNK. |
Optional |
XML example
<header>
<standard>
<cd SV="1.0" S="CD-STANDARD">20090101</cd>
</standard>
<id SV="1.0" S="ID-KMEHR">71071801.20090415123000123</id>
<date>2009-04-15</date>
<time>12:30:00</time>
<sender>
<hcparty>
<id SV="1.0" S="ID-HCPARTY">71071801</id>
<cd SV="1.0" S="CD-HCPARTY">orghospital</cd>
<name>Hôpital civil de Charleroi</name>
</hcparty>
<hcparty>
<cd SV="1.0" S="CD-HCPARTY">application</cd>
<name>application name</name>
</hcparty>
</sender>
<recipient>
<hcparty>
<cd SV="1.0" S="CD-HCPARTY">application</cd>
<name>target application name</name>
</hcparty>
</recipient>
</header>