cdamedp:Ultrakurzformat plus: Unterschied zwischen den Versionen

Aus Hl7wiki
Wechseln zu: Navigation, Suche
(Übersicht über den Aufbau des Ultrakurzformat Patientenorientierter Medikationsplan PLUS Referenz (UKF-REF))
 
(58 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
 
=Ultrakurzformat=
 
=Ultrakurzformat=
Das hier vorgestellte Ultrakurzformat beruht auf den zuvor vorgestellten FHIR-Profile bzw. Vorarbeiten davon und wurde in einer angepassten Form auch als Technische Spezifikation für das Barcode-Format des Bundeseinheitlichen Medikationsplan verwendet.  
+
Das Ultrakurzformat ist eine Familie von Struktur und Semantikvorgaben für die Wiedergabe von Gesundheitsinformationen auf "kleinstem Raum".
  
In Bezug auf den Medikationplan ist die hier beschriebene Zusammenstellung er Komponenten das Äquivalent zum CDA-Format und wird seine Anwendung vornehmlich im Bereich der Mobilen Apps finden.
+
Die hier vorgestellten Ultrakurzformate
 +
* Ultrakurzformat Patientenorientierter Medikationsplan Plus (UKF-PMPP) für die inhaltliche Wiedergabe von Medikationsplänen
 +
* Ultrakurzformat Patientenorientierter Medikationsplan Plus Referenz (UKF-REF) für die Wiedergabe von Referenzen auf Medikationspläne
 +
beruhen auf den zuvor vorgestellten FHIR-Profilen bzw. Vorarbeiten davon und wurde in einer angepassten Form auch als Technische Spezifikation für das Barcode-Format des Bundeseinheitlichen Medikationsplan verwendet. Der UKF-PMPP ist eine Fortschreibung des 2016 veröffentlichten UKF-PMP<ref>Addendum zum Implementierungsleitfaden Patientenbezogener Medikationsplan: Ultrakurzformat für kapazitätslimitierte Datenträger (UKFPMP) http://wiki.hl7.de/index.php?title=IG:Ultrakurzformat_Patientenbezogener_Medikationsplan</ref>.
  
Die fachinhaltlichen Festlegungen aus dem Bundeseinheitlichen Medikationsplan<ref name="bmp"/> sind hier zunächst übernommen und die zu Erweiterungen in Bezug auf AMTS-Anwendungsfälle ergänzt.
+
Die Ultrakurzformate sind nicht nur für den Barcode, sondern auch für die eGK und andere von der Kapazität her eingeschränkte Medien nutzbar. Mit der eGK soll es – so der Plan – zum Beispiel möglich sein, bis zu 40 Arzneimittel zu speichern und auch bisherige nicht mehr aktuell eingenommene bzw. abgesetzte Medikamente oder jedenfalls nicht einzunehmende Substanzen (zum Beispiel wegen Unverträglichkeiten oder Allergien) wiederzugeben.
  
Das Ultrakurzformat ist nicht nur für den Barcode, sondern auch für die eGK nutzbar. Damit soll es möglich sein, bis zu 40 Arzneimittel auf der eGK zu speichern und zum Beispiel bisherige nicht mehr aktuell eingenommene bzw. abgesetzte Medikamente oder jedenfalls nicht einzunehmende Substanzen (zum Beispiel wegen Unverträglichkeiten oder Allergien) wiederzugeben.
+
Nichtsdestoweniger kann zumindest das Ultrakurzformat zur inhaltliche Wiedergabe von Medikationsplänen als zeitliche Zwischenlösung angesehen werden, denn mit dem Vorhandensein von Infrastrukturen zum Datenaustausch wie zum Beispiel einer Telematik-Infrastruktur und/oder der Verfügbarkeit mobiler Lösungen, gelten inhaltliche vollständige Wiedergaben von Inhalten obsolet.
  
 
==Bezug des Ultrakurzformats zum Basisstandard FHIR==
 
==Bezug des Ultrakurzformats zum Basisstandard FHIR==
  
Das Ultrakurzformat (UKF) basiert auf den zuvor vorgestellten FHIR-Profilen wie zum Beispiel ''Patient'', ''AllergyIntolerance'' und MedicationStatement. Dabei wurden die üblichen Aspekte und Freiheiten in den Resources zunächst eingeschränkt und vorab in den Kurzformat-FHIR-Profilen festgelegt, dass die eigentlichen Instanzen („die Daten“) außerordentlich kurz gehalten werden können.
+
Allen Ultrakurzformaten ist gemein, dass sie auf FHIR bzw. FHIR-Profilen wie die in diesem Leitfaden vorgestellten beruhen, zum Beispiel ''Patient'', ''AllergyIntolerance'' und ''MedicationStatement''. Dabei wurden die üblichen Aspekte und Freiheiten in den Resources zunächst eingeschränkt und vorab in den Kurzformat-FHIR-Profilen festgelegt, dass die eigentlichen Instanzen („die Daten“) außerordentlich kurz gehalten werden können.
  
 
Das Ultrakurzformat reduziert dann von den FHIR-Profil-Definitionen ausgehend schließlich auf sehr kurze XML-Elemente und -Attribute, die in einer eins-zu-eins Beziehung zum zugrundeliegenden FHIR-Profil stehen. Dadurch können FHIR-Instanzen, die nach den Kurzformat-FHIR-Profilen erstellt sind und die Ultrakurzformat-Instanzen leicht ineinander überführt werden (Bijektivität).
 
Das Ultrakurzformat reduziert dann von den FHIR-Profil-Definitionen ausgehend schließlich auf sehr kurze XML-Elemente und -Attribute, die in einer eins-zu-eins Beziehung zum zugrundeliegenden FHIR-Profil stehen. Dadurch können FHIR-Instanzen, die nach den Kurzformat-FHIR-Profilen erstellt sind und die Ultrakurzformat-Instanzen leicht ineinander überführt werden (Bijektivität).
Zeile 20: Zeile 23:
 
Das bedeutet auch, dass Instanzen im Ultrakurzformat aufgrund der Einheit von Instanz und Kurzformat-FHIR-Profil nur durch die langen Strukturen und die im Profil definierten Festlegungen ergänzt werden müssen, um auch außerhalb der Spezifikation des Ultrakurzformats vollwertig gemäß dem allgemeinen FHIR-Profil für den Medikationsplan zu sein (vgl. auch folgende Tabelle).
 
Das bedeutet auch, dass Instanzen im Ultrakurzformat aufgrund der Einheit von Instanz und Kurzformat-FHIR-Profil nur durch die langen Strukturen und die im Profil definierten Festlegungen ergänzt werden müssen, um auch außerhalb der Spezifikation des Ultrakurzformats vollwertig gemäß dem allgemeinen FHIR-Profil für den Medikationsplan zu sein (vgl. auch folgende Tabelle).
  
{{NoteBox|Hinweis: das Ultrakurzformat ist nur dafür bestimmt, in diesem Kontext auf kapazitätslimitierte Datenträger geschrieben zu werden. Sollen die Daten im Kontext von zum Beispiel FHIR-Server-Client Applikationen verwendet werden, müssen die Instanzen in eine vollwertige FHIR-Instanz nach dem Kurzformat-FHIR-Profil überführt werden.
+
{{NoteBox|Hinweis: das Ultrakurzformat ist nur dafür bestimmt, in diesem Kontext auf kapazitätslimitierte Datenträger geschrieben zu werden. Sollen die Daten im Kontext von zum Beispiel FHIR-Server-Client Applikationen verwendet werden, müssen die Instanzen in eine vollwertige FHIR-Instanz nach dem Kurzformat-FHIR-Profil oder in ein CDA-Dokument überführt werden.
Zur Überführung der Instanzen im Ultrakurzformat in ein reguläres FHIR-Bundle stehen Konversionsskripts öffentlich zur Verfügung.}}
+
}}
  
 
{| class="hl7table"
 
{| class="hl7table"
Zeile 28: Zeile 31:
 
|Beispiel Ultrakurzformat mit sehr<br/>kurzen XML-Elementen und -Attributen
 
|Beispiel Ultrakurzformat mit sehr<br/>kurzen XML-Elementen und -Attributen
 
|-
 
|-
|<syntaxhighlight lang="xml" highlight="1,10,12,18,23">
+
|<syntaxhighlight lang="xml" highlight="1,9,20,23">
 
<Bundle xmlns="http://hl7.org/fhir">
 
<Bundle xmlns="http://hl7.org/fhir">
 
   <meta>
 
   <meta>
       <profile value="http://fhir.de/.../bundle...planplus"/>
+
       <profile value="http://fhir.de/.../bundle"/>
 
   </meta>
 
   </meta>
 
   <type value="document"/>
 
   <type value="document"/>
 
   <entry>
 
   <entry>
       <fullUrl value="http://.../2aca0674-...-6e5e5aea15ca"/>
+
       <fullUrl value="http://.../2aca0674..."/>
 
       <resource>
 
       <resource>
 
         <Composition>
 
         <Composition>
 
             <meta>
 
             <meta>
               <profile  
+
               <profile value="http://fhir.de/.../composition"/>
                value="http://fhir.de/.../composi...planplus"/>
 
 
             </meta>
 
             </meta>
 
             <identifier>
 
             <identifier>
               <system value="http://mp.de/Composition"/>
+
               <system value="http://mp.de/composition-identifier"/>
               <value value="2aca0674-...-6e5e5aea15ca"/>
+
               <value value="2aca0674..."/>
 
             </identifier>
 
             </identifier>
 
             <type>
 
             <type>
Zeile 53: Zeile 55:
 
             </type>
 
             </type>
 
             <title value="Patientenbezogener Medikationsplan Plus"/>
 
             <title value="Patientenbezogener Medikationsplan Plus"/>
 +
            ...
 
             <status value="final"/>
 
             <status value="final"/>
 
             <confidentiality value="N"/>
 
             <confidentiality value="N"/>
Zeile 60: Zeile 63:
 
| valign=top | <syntaxhighlight lang="xml">
 
| valign=top | <syntaxhighlight lang="xml">
 
<MP v="1" u="MPP"  
 
<MP v="1" u="MPP"  
     U="CA620D79D334428CBA6203181EAA1378" l="de-DE">
+
     U="CA620D79D334428CBA6203181EAA1378"
 +
    l="de-DE">
 
...
 
...
 
</MP>
 
</MP>
Zeile 68: Zeile 72:
 
<Observation>
 
<Observation>
 
     <meta>
 
     <meta>
         <profile value="http://fhir.hl7.de/.../bodywei...planplus"/>
+
         <profile value="http://fhir.hl7.de/.../bodyweight"/>
 
     </meta>
 
     </meta>
 
     <status value="final"/>
 
     <status value="final"/>
Zeile 90: Zeile 94:
 
</syntaxhighlight>
 
</syntaxhighlight>
 
|-
 
|-
|<syntaxhighlight lang="xml" highlight="13,17,36,37">
+
|<syntaxhighlight lang="xml" highlight="7,11,30,31,37">
 
<Patient>
 
<Patient>
 
     <meta>
 
     <meta>
         <profile value="http://fhir.de/.../patient...planplus"/>
+
         <profile value="http://fhir.de/.../patient"/>
 
     </meta>
 
     </meta>
 
     <identifier>
 
     <identifier>
        <type>
+
         <system value="http://fhir.de/NamingSystem/gkv/kvid-10"/>
            <coding>
+
         <value value="G995030567"/>
                <system value="http://hl7.org/fhir/v2/0203" />
 
                <code value="HC" />
 
            </coding>
 
        </type>
 
         <system value="http://fhir.de/NamingSystem/gkv/kvnr" />
 
         <value value="G995030567" />
 
 
     </identifier>
 
     </identifier>
 
     <active value="true"/>
 
     <active value="true"/>
Zeile 109: Zeile 107:
 
         <text value="Dr. med. Maximilian Prinz von und zu Mustermännchen" />
 
         <text value="Dr. med. Maximilian Prinz von und zu Mustermännchen" />
 
         <family value="Prinz von und zu Mustermännchen">
 
         <family value="Prinz von und zu Mustermännchen">
             <extension url="http://fhir.de/S...n/humanname-namenszusatz">
+
             <extension url="http://fhir.de/.../humanname-namenszusatz">
 
                 <valueString value="Prinz" />
 
                 <valueString value="Prinz" />
 
             </extension>
 
             </extension>
             <extension url="http://hl7.org/fhir/S...n/humanname-own-prefix">
+
             <extension url="http://hl7.org/fhir/.../humanname-own-prefix">
 
                 <valueString value="von und zu" />
 
                 <valueString value="von und zu" />
 
             </extension>
 
             </extension>
             <extension url="http://hl7.org/fhir/S...n/humanname-own-name">
+
             <extension url="http://hl7.org/fhir/.../humanname-own-name">
 
                 <valueString value="Mustermännchen" />
 
                 <valueString value="Mustermännchen" />
 
             </extension>
 
             </extension>
Zeile 122: Zeile 120:
 
         <prefix value="Dr. med.">
 
         <prefix value="Dr. med.">
 
             <extension url="http://hl7.org/fhir/S...n/iso21090-EN-qualifier">
 
             <extension url="http://hl7.org/fhir/S...n/iso21090-EN-qualifier">
                 <valueString value="AC" />
+
                 <valueString value="AC"/>
 
             </extension>
 
             </extension>
 
         </prefix>
 
         </prefix>
Zeile 128: Zeile 126:
 
     <gender value="male"/>
 
     <gender value="male"/>
 
     <birthDate value="1970-03-04"/>
 
     <birthDate value="1970-03-04"/>
 +
    <communication>
 +
        <language>
 +
          <coding>
 +
            <system value="urn:ietf:bcp:47"/>
 +
              <!-- IETF language tag -->
 +
              <code value="de-DE"/>
 +
              <display value="Deutsch"/>
 +
          </coding>
 +
          <text value="Deutsch"/>
 +
        </language>
 +
        <preferred value="true"/>
 +
    </communication>
 
</Patient>
 
</Patient>
 
</syntaxhighlight>
 
</syntaxhighlight>
Zeile 137: Zeile 147:
 
</syntaxhighlight>
 
</syntaxhighlight>
 
|-
 
|-
|<syntaxhighlight lang="xml" highlight="6,9,22">
+
|<syntaxhighlight lang="xml" highlight="6,9,21">
 
<MedicationStatement>
 
<MedicationStatement>
 
   ...
 
   ...
Zeile 145: Zeile 155:
 
       <when value="CM"/>
 
       <when value="CM"/>
 
   </repeat>
 
   </repeat>
   <quantityQuantity>
+
   <doseQuantity>
 
       <value value="1"/>
 
       <value value="1"/>
      <unit value="HKP"/>
 
 
       <system value="http://standardterms.edqm.eu"/>
 
       <system value="http://standardterms.edqm.eu"/>
 
       <code value="10210000"/>
 
       <code value="10210000"/>
   </quantityQuantity>
+
   </doseQuantity>
 
     ...
 
     ...
 
</MedicationStatement>
 
</MedicationStatement>
Zeile 177: Zeile 186:
 
Textwiedergaben können aber sowieso jederzeit aus den maschinenlesbaren Informationen generiert werden. Auch hierfür finden sich Beispiele für solche Transformationen in den Materialien.
 
Textwiedergaben können aber sowieso jederzeit aus den maschinenlesbaren Informationen generiert werden. Auch hierfür finden sich Beispiele für solche Transformationen in den Materialien.
  
==Übersicht über die Komponenten (Ressourcen)==
+
==Übersicht über die Komponenten des Ultrakurzformat Patientenorientierter Medikationsplan (UKF-PMPP)==
  
Das vollwertige FHIR-Basisformat ist eine Sammlung von FHIR-Profilen, die für den Zweck der Abbildung eines Patientenbezogenen Medikationsplans zusammengestellt sind und sich nach den fachinhaltlichen Vorgaben des AkdÄ-Medikationsplans und weiterer bekannter Pläne richtet.
+
Zur vereinfachten Übersicht sind im Folgenden die Elemente des Ultrakurzformats für den Medikationsplan Plus schematisch dargestellt.
 +
{{HL7img|Pmp-ukfpmppuebersicht.png|600px|70%}}
 +
<ref group="Abbildung">Übersicht über die Elemente des Ultrakurzformats für den Medikationsplan Plus</ref> Übersicht über die Elemente des Ultrakurzformats für den Medikationsplan Plus
  
Der „Container“ ist ein so genanntes Bundle. Das FHIR Bundle enthält eine Composition (Entry) in der Basisinformationen zum Medikationsplan und Referenzen zum Patienten, dem eigentlichen Medikamentenliste und anderes enthalten ist. Die Daten sind in weiteren Entries als Resources im Bundle enthalten.
+
===Root-Element Medikationsplan (MP)===
 
+
Das "Root"-Element des Medikationsplan Plus im Ultrakurzformat heißt MP (ebenso wie bei anderen Medikationsplänen). Es kommt der FHIR-Kombination von Bundle und Composition gleich und vereint in sich
{{HL7img|Ukfpmp2.jpg|300px|40%}}
+
*Informationen zum Medikationsplan selbst, z. B. Medikationsplan-Identifikation
<ref group="Abbildung">Übersicht über die anzuwendenden Komponenten des Medikationsplan-Bundles</ref>
+
*den Patienten um den es geht
''Übersicht über die anzuwendenden Komponenten des Medikationsplan-Bundles''
+
*zum Ersteller/Ausdruckenden
 
+
**Abschnitte (section) mit den Daten über
Im Folgenden werden die FHIR-Darstellungen jeweils ergänzt um die Spezifikation im Ultrakurzformat.
 
 
 
{{BeginGreenBox|Ultrakurzformat}}
 
Die Darstellung / Spezifikation des Ultrakurzformats ist in grünen Kästen aufgeführt.
 
 
 
Zur vereinfachten Übersicht sind im Folgenden die Elemente des Ultrakurzformats für den Medikationsplan schematisch dargestellt.
 
{{HL7img|Ukfpmp4.jpg|600px|70%}}
 
<ref group="Abbildung">Übersicht über die Elemente des Ultrakurzformats für den Medikationsplan (Element C wird zurzeit noch nicht verwendet).</ref>
 
 
 
{{EndGreenBox}}
 
 
 
==Bundle==
 
 
 
Die FHIR-Ressource Bundle bündelt die entsprechende Komponenten als Dokument. Es enthält
 
*Den Typ des Bundles (hier fixiert auf „document“)
 
*Einen Entry zur Composition, dem eigentlichen Dokument, das verschiedene Resources referenziert (weitere Entry-Elemente im Bundle)
 
*Weitere Entry-Elemente zu Patient, Medikationsplan-Einträgen usw.
 
In einer Übersicht in XML sieht dies wie folgt aus<ref>Auf die Darstellung in JSON wird hier aus Lesbarkeitsgründen verzichtet und auf die Materialien verwiesen</ref>.
 
 
 
{{BeginBlueBox|Beispiel}}
 
<syntaxhighlight lang="xml">
 
<Bundle xmlns="http://hl7.org/fhir">
 
    <meta>
 
        <versionId value="201"/>
 
        <profile value="http://fhir.hl7.de/medikationsplan/bundle"/>
 
    </meta>
 
    <type value="document"/>
 
    <entry>
 
        <fullUrl value="http://mein.medikationsplan.de/composition/1433e0a7-...-5280508da565"/>
 
        <resource>
 
            <Composition>
 
                ...(mit Referenzen zu Patient, Medikationsplan-Einträgen usw.)
 
            </Composition>
 
        </resource>
 
    </entry>
 
    <entry>
 
        <fullUrl value="urn:uuid:e3e65616-8fd4-427urnd-b560-d847c2ca0a3a"/>
 
        <resource>
 
            ... (Entry: in der Composition referenzierte Resourcen wie Patient,
 
                Medikationsplan-Einträgen usw.)
 
        </resource>
 
    </entry>
 
    (weitere Entry-Einträge)
 
</Bundle>
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
 
 
Die eigentlichen Daten sind in einem nachfolgenden Entry (Resource Patient) faktisch aufgeführt.
 
 
 
Ein Entry-Eintrag beinhaltet immer ein fullUrl-Element. Dieses enthält eine absolute URL zur Resource (im Beispiel: die Composition) ...
 
 
 
{{BeginBlueBox|Beispiel}}
 
<syntaxhighlight lang="xml">
 
<Bundle xmlns="http://hl7.org/fhir">
 
    <type value="document"/>
 
    <entry>
 
        <fullUrl value="http://mein.medikationsplan.de/Composition/ed73c0b0-....-514f36ab7c13"/>
 
        <resource>
 
            <Composition>...
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
 
 
...oder eine relative URL in der Form zum Beispiel <code>urn:uuid:e3e65616-8fd4-427urnd-b560-d847c2ca0a3a</code> um auf Resources innerhalb des Bundles zu zeigen. Auf diese Weise sind die Verbindungen zwischen Referenzen (z. B. Patientenreferenz) und den tatsächlichen Daten in den Resources (z. B. Patientendaten) gelegt.
 
 
 
{{NoteBox|Im Ultrakurzformat wird das Bundle und die im Folgenden beschriebene Composition (das Dokument) "ineinandergeschoben" und in einem einzigen Element repräsentiert (siehe unten).}}
 
 
 
==Composition==
 
 
 
Die FHIR-Ressource Composition kommt dem Clinical Document gleich und weist entsprechende Komponenten auf:
 
*Profil-Andeutung (im meta-Element)
 
*Medikationsplan-Identifikation (diese Ausgabe des Medikationsplans, dieser Patient)
 
*Datum (der Erstellung)
 
*Type der Composition
 
*Titel, zum Beispiel „Medikationsplan“
 
*Status, fixiert auf „final“
 
*Vertraulichkeitsgrad (confidentiality, hier zunächst fixiert auf „N“, normal)
 
*Referenz zum Patienten (subject, reference), die eigentlichen Daten sind ein einem nachfolgenden Entry (Resource Patient) faktisch aufgeführt (siehe Bundle)
 
*Ersteller (author), ebenso als Referenz gehandhabt
 
*Verwaltende Organisation der Composition/des Dokuments (custodian)
 
*Abschnitte (section) mit den Daten über
 
 
**Klinische Parameter
 
**Klinische Parameter
 
**Allergien und Unverträglichkeiten
 
**Allergien und Unverträglichkeiten
 
**Gesundheitsbelangen
 
**Gesundheitsbelangen
**Aktuelle Medikation
+
**Aktuelle Medikation (Medikamentenliste)
**Wichtige Angaben / Instruktionen
+
**Wichtige Angaben / Instruktionen.
entsprechend den CDA-Sections (siehe <ref>CDA-basierter Patientenbezogener Medikationsplan: http://wiki.hl7.de/index.php?title=IG:Patientenbezogener_Medikationsplan</ref>).
 
 
 
{{HL7img|Ukfpmp3.jpg|300px|40%}}
 
<ref group="Abbildung">Übersicht über die Komponenten der Composition</ref>
 
''Übersicht über die Komponenten der Composition''
 
 
 
In einem Übersichtsbeispiel in XML stellt sich dies wie folgt dar.
 
{{BeginBlueBox|Beispiel}}
 
<syntaxhighlight lang="xml">
 
<Composition>
 
    <meta>
 
    <versionId value="201"/>
 
        <profile value="http://http://fhir.hl7.de/medikationsplan/composition"/>
 
    </meta>
 
    <identifier>
 
        <system value="http://mein.medikationsplan.de/composition"/>
 
        <value value="1433e0a7-ba2a-4f46-8cad-5280508da565"/>
 
    </identifier>
 
    <date value="2016-01-21T14:00:03+01:00"/>
 
    <type>
 
        <coding>
 
            <system value="http://loinc.org"/>
 
            <code value="56445-0"/>
 
        </coding>
 
    </type>
 
    <title value="Patientenbezogener Medikationsplan (2016)"/>
 
    <status value="final"/>
 
    <confidentiality value="N"/>
 
    <subject>
 
        <reference value="urn:uuid:e3e65616-8fd4-427urnd-b560-d847c2ca0a3a"/>
 
        <display value="Michaela Mustermann"/>
 
    </subject>
 
    <author>
 
        <reference value="urn:uuid:f262b3d9-d969-4759-a957-c1df5addfc86"/>
 
    </author>
 
    <custodian>
 
        <reference value="urn:uuid:1a910d80-ee7b-485d-a97e-644bd275d459"/>
 
    </custodian>
 
    <section>
 
        ...
 
    </section>
 
</Composition>
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
 
 
Als erstes Element wird im meta-Element der Hinweis auf das entsprechende UKF-FHIR-Profil inklusive Profil-Versions-Id in der Instanz angegeben.
 
{{BeginBlueBox|Beispiel}}
 
<syntaxhighlight lang="xml">
 
<meta>
 
    <versionId value="201"/>
 
    <profile value="http://fhir.hl7.de/medikationsplan/composition"/>
 
</meta>
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
Es folgt die eindeutige Identifikation der Instanz dieser Composition (Medikationsplan-Identifikation), d.h. die Identifikation dieses Medikationsplans für diesen Patienten in der vorliegenden Fassung. Neue Pläne für diesen oder andere Patienten haben entsprechende eine andere Id.
 
{{BeginBlueBox|Beispiel}}
 
<syntaxhighlight lang="xml">
 
<identifier>
 
    <system value="http://mein.medikationsplan.de/composition"/>
 
    <value value="1433e0a7-ba2a-4f46-8cad-5280508da565"/>
 
</identifier>
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
Es folgen das Datum der Erstellung, der Typ des Dokuments (Composition) ist fixiert und so anzugeben wie im obigen Gesamtbeispiel. Das gleiche gilt für den Status (final) des Dokuments und den Vertraulichkeitsgrad (N).
 
  
Der Patient, der Ersteller (Autor) und die das Dokument verwaltende Organisation (custodian) werden in der Composition als Referenzen angegeben. Die eigentlichen Daten hierzu stehen jeweils in den zugehörigen Entry-Elementen des Bundles mit dem entsprechenden fullUrl-Element. Die Verknüpfung erfolgt über Referenz-Elemente, die auf das jeweilige Entry zeigen.
+
Im Ultrakurzformat wird das FHIR Bundle+Composition mitsamt LOINC Code für den Dokumententyp und die hier beschriebene Composition (das Dokument) "ineinandergeschoben" und in einem einzigen Element repräsentiert. Auch auf die Angabe eines XML-Namespaces wird verzichtet, dieser ist für das Ultrakurzformat xmlns="http://fhir.hl7.de/ukfc".
{{BeginBlueBox|Beispiel: Patient-Referenz in der Composition, die Angabe des Patientennamens ist hier optional}}
 
<syntaxhighlight lang="xml">
 
<subject>
 
    <reference value="urn:uuid:e3e65616-8fd4-427d-b560-d847c2ca0a3a"/>
 
    <display value="Michaela Mustermann"/>
 
</subject>
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
 
 
{{BeginBlueBox|Beispiel: Author- und Custodian-Referenz in der Composition}}
 
<syntaxhighlight lang="xml">
 
<author>
 
    <reference value="urn:uuid:f262b3d9-d969-4759-a957-c1df5addfc86"/>
 
</author>
 
<custodian>
 
    <reference value="urn:uuid:1a910d80-ee7b-485d-a97e-644bd275d459"/>
 
</custodian>
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
 
 
Schließlich folgen die vier Abschnitte (Sections, analog zu der CDA-Definition).
 
 
 
{| class="hl7table"
 
|-
 
!Section!!LOINC-Code
 
|-
 
|Klinische Parameter (Körpergewicht, Kreatinin, …)
 
|55752-0
 
|-
 
|Allergien und Unverträglichkeiten
 
|48765-2
 
|-
 
|Gesundheitsbelange (schwanger, stillend)
 
|75310-3
 
|-
 
|Aktuelle Medikation
 
|19009-0
 
|-
 
|Wichtige Angaben / Instruktionen
 
|69730-0
 
|}
 
<ref group="Tabelle">LOINC-Codes der eingesetzten Sections</ref> ''LOINC-Codes der eingesetzten Sections''
 
 
 
Im Folgenden ist ein Beispiel zu den klinischen Parametern (LOINC 55752-0) gezeigt, es wird auf zwei Entries verwiesen (Körpergewicht, Kreatinin).
 
{{BeginBlueBox|Beispiel}}
 
<syntaxhighlight lang="xml">
 
<section>
 
    <title value="Klinische Parameter"/>
 
    <code>
 
        <coding>
 
            <system value="http://loinc.org"/>
 
            <code value="55752-0"/>
 
            <display value="Clinical information"/>
 
        </coding>
 
    </code>
 
    <entry>
 
        <reference value="urn:uuid:23f6114c-994f-4b77-b7a9-5fa402aa93b1"/>
 
    </entry>
 
    <entry>
 
        <reference value="urn:uuid:f8611c65-fd9c-4fda-ac05-3ae005eedd91"/>
 
    </entry>
 
</section>
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
 
 
Weitere Informationen finden sich in der Beschreibung der entsprechenden FHIR Resource https://www.hl7.org/fhir/composition.html und den Datentypen https://www.hl7.org/fhir/datatypes.html.
 
 
 
 
 
{{BeginGreenBox|Ultrakurzformat}}
 
Im Ultrakurzformat wird das oben beschriebene Bundle mitsamt LOINC Code für den Dokumententyp und die hier beschriebene Composition (das Dokument) "ineinandergeschoben" und in einem einzigen Element repräsentiert. Auch auf die Angabe eines XML-Namespaces wird verzichtet, dieser ist für das Ultrakurzformat xmlns="http://fhir.hl7.de/ukfc".
 
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
 
<MP  
 
<MP  
   U="4CD0CC3963044C17835766390C1883A7"
+
   <MP v="1" u="MPP" U="56DEC1A02F9340A1BA73704ABEF8B704" l="de-DE">
  v="021"
 
  a="1"
 
  z="2">
 
 
   ...
 
   ...
 
</MP>
 
</MP>
Zeile 420: Zeile 214:
 
{| class="hl7table"
 
{| class="hl7table"
 
|-
 
|-
!Element/<br/>Attribut!!Beschreibung!! Referenz in <ref name="mpakdae20"/>
+
! style="text-align:left;" | Element/Attribut
 +
! style="text-align:left;" | Kardinalität
 +
! style="text-align:left;" | Beschreibung
 
|-
 
|-
|MP || Root-Element (Bundle+Composition): Medikationsplan Ultrakurzformat ||
+
|<code>MP</code> || 1..1 || Root-Element (Bundle+Composition): Medikationsplan Ultrakurzformat ||
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@v || Version der Spezifikation des Medikationsplans, Format xxy, beim Druck wird aus 020 ein 2.0; Aktuell für diesen Plan "021" || 1.1
+
|[[Datei:Treetree.png|16px]]<code>@v</code> || 1..1 || Version der Spezifikation des Medikationsplans Plus, zurzeit fixiert auf "1"
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@U || konkrete Instanz-ID des Plans (gleich für alle Seiten des Plans); hier wird eine UUID ohne "-" Trennzeichen und A-F als Buchstaben verwendet||
+
|[[Datei:Treetree.png|16px]]<code>@u</code> || 1..1 || Type der Spezifikation des Medikationsplans, zurzeit fixiert auf "MPP" (Medikationsplan Plus)
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@a || Aktuelle Seite, mit 1 startend; nur bei mehrseitigen Plänen zu verwenden ||1.2
+
|[[Datei:Treetree.png|16px]]<code>@U</code> || 1..1 || konkrete Instanz-ID des Plans (gleich für alle Seiten des Plans); hier wird eine UUID ohne "-" Trennzeichen und A-F als Buchstaben verwendet
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@z || Gesamtseitenanzahl; nur bei mehrseitigen Plänen zu verwenden ||1.3
+
|[[Datei:Treetree.png|16px]]<code>@a</code> || 0..1 || Aktuelle Seite, mit 1 startend; nur bei mehrseitigen Plänen zu verwenden
 +
|-
 +
|[[Datei:Treetree.png|16px]]<code>@z</code> || 0..1 || Gesamtseitenanzahl; nur bei mehrseitigen Plänen zu verwenden
 +
|-
 +
|[[Datei:Treetree.png|16px]]<code>@l</code> || 0..1 || Sprache des Plans im Format ss-CC (nach BCP-47, http://tools.ietf.org/html/bcp47), z. B. "de-DE", "de-CH", "en-US" etc.
 
|}
 
|}
Anstatt die erforderlichen Daten über Referenzen in die Composition einzubinden, werden die Angaben zum Patienten, Autoren, den Beobachtungen, Sections usw. direkt an Ort und Stelle im Ultrakurzformat verwendet. Im folgenden Auszug ist gezeigt, wie der Patient (P) und der Ersteller/Autor (A) und weiteren Informationen (O) als Kind-Elemente innerhalb des eben beschriebenen Bundle+Composition-Elements für den Medikationsplan (MP) eingebettet sind.
+
 
 +
Im folgenden Auszug ist gezeigt, wie der Patient (P) und der Ersteller/Autor (A) und weiteren Informationen (O) und (AI) als Kind-Elemente innerhalb des eben beschriebenen Bundle+Composition-Elements für den Medikationsplan (MP) eingebettet sind.
  
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
 
<MP ...>
 
<MP ...>
     <P g="Michael" f="Mustermann" egk="D998367871" s="M" b="1966-07-21"/>
+
     <P .../>
     <A lanr="1656304456" n="Dr. Xra Überall"
+
     <A .../>
      s="Hauptstraße 55" z="01234" c="Am Ort"
+
    <O .../>
      t="2016-02-16" p="04562-12345" e="m.ueberall@mein-netz.de"/>
+
    <AI .../>
     <O w="69" i="Penizillin"/>
+
     <S>
    ...
+
        <M>
 +
            <D .../>
 +
            <W .../>
 +
        </M>
 +
    </S>
 
</MP>
 
</MP>
 
</syntaxhighlight>
 
</syntaxhighlight>
 
Diese Kind-Elemente werden im Detail in den folgenden Abschnitten beschrieben.
 
Diese Kind-Elemente werden im Detail in den folgenden Abschnitten beschrieben.
{{EndGreenBox}}
 
  
==Patient==
+
===Patient (P)===
  
Die Patienten-Resource für die hier beschriebenen Zwecke beginnt mit einer Identifikationsnummer, zum Beispiel der eGK-Nummer (wie im Beispiel).
+
Im Ultrakurzformat wird der Patient in einem einzigen Element repräsentiert:
 
 
Der Status ist fixiert auf den Wert „active“.
 
 
 
Der Name wird typischerweise in family- und given-Element verteilt.
 
 
 
Das Geschlecht ist nach der FHIR-Spezifikation anzugeben (https://www.hl7.org/fhir/valueset-administrative-gender.html), hier also entweder „female“, „male“ oder „other“. „unknown“ ist ebenso erlaubt.
 
 
 
Schließlich erfolgt das Geburtsdatum im ISO-Format YYYY-MM-DD.
 
{{BeginBlueBox|Beispiel}}
 
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
<Patient>
+
<P g="Michael" f="Mustermann" egk="G996253153" s="M" b="1950-01-22"/>
    <meta>
 
        <versionId value="201"/>
 
        <profile value="http://fhir.hl7.de/medikationsplan/patient"/>
 
    </meta>
 
    <identifier>
 
        <system value="http://kvnummer.gkvnet.de"/>
 
        <value value="1234567890"/>
 
    </identifier>
 
    <active value="true"/>
 
    <name>
 
        <text value="Michaela Mustermann"/>
 
        <family value="Mustermann"/>
 
        <given value="Michaela"/>
 
    </name>
 
    <gender value="female"/>
 
    <birthDate value="1936-12-13"/>
 
</Patient>
 
 
</syntaxhighlight>
 
</syntaxhighlight>
{{EndBlueBox}}
 
Weitere Informationen finden sich in der Beschreibung der entsprechenden FHIR Resource https://www.hl7.org/fhir/patient.html und den Datentypen https://www.hl7.org/fhir/datatypes.html.
 
 
{{BeginGreenBox|Ultrakurzformat}}
 
Im Ultrakurzformat wird der Patient in einem einzigen Element repräsentiert:
 
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
<P g="Michael" f="Mustermann" egk="G996253153" s="M" b="1950-01-22"/>
+
<P t="Dr." g="Jürgen" z="Graf" v="von und zu" f="Wernersen" b="1940-03-24" egk="A123456789" s="M"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
Dabei bedeuten:
 
Dabei bedeuten:
 
{| class="hl7table"
 
{| class="hl7table"
 
|-
 
|-
!Element/<br/>Attribut!!Beschreibung!! Referenz in <ref name="mpakdae20"/>
+
! style="text-align:left;" | Element/Attribut
 +
! style="text-align:left;" | Kardinalität
 +
! style="text-align:left;" | Beschreibung
 +
|-
 +
|<code>P</code> || required || Element (Patient) ||
 +
|-
 +
|[[Datei:Treetree.png|16px]]<code>@t</code> || 0..1 || Titel des Patienten, z. B. "Dr."
 
|-
 
|-
|P || Element (Patient) ||
+
|[[Datei:Treetree.png|16px]]<code>@g</code> || 1..1 || Vorname(n) des Patienten
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@g || Vorname(n) des Patienten (optional) || 2.1
+
|[[Datei:Treetree.png|16px]]<code>@z</code> || 0..1 || Namenszusatz des Patienten, z. B. "Gräfin"
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@f || Familienname(n) des Patienten (required) || 2.2
+
|[[Datei:Treetree.png|16px]]<code>@v</code> || 0..1 || Vorsatzwort des Patienten, z. B. "von"
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@egk || eGK-Nummer (optional), Format: A000000000) || 2.3
+
|[[Datei:Treetree.png|16px]]<code>@f</code> || 1..1 || Familienname(n) des Patienten
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@s || Geschlecht des Patienten (M, F, UN), im Druck: "Geschl.:" m / w / unbestimmt; Dieses Feld ist kodiert und kommen aus dem Value Set [http://art-decor.org/art-decor/decor-valuesets--pmp-?valueSetRef=2.16.840.1.113883.1.11.1 AdministrativeGender] welches auch für die CDA-Fassung verwendet wird. ||
+
|[[Datei:Treetree.png|16px]]<code>@egk</code> || 0..1 || eGK-Nummer (optional), Format: A000000000)
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@b || Geburtsdatum des Patienten, Formate: YYYY-MM-DD, YYYY-MM (wenn Tag nicht bekannt), YYYY (wenn Monat und Tag nicht bekannt) || 2.4
+
|[[Datei:Treetree.png|16px]]<code>@s</code> || optional || Geschlecht des Patienten (M, F, UN). Dieses Feld ist kodiert und kommen aus dem Value Set [http://art-decor.org/art-decor/decor-valuesets--pmp-?valueSetRef=2.16.840.1.113883.1.11.1 AdministrativeGender] welches auch für die CDA-Fassung verwendet wird.
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@kvnr || KVK-Nr (wird nicht mehr benötigt) || 2.3
+
|[[Datei:Treetree.png|16px]]<code>@b</code> || optional || Geburtsdatum des Patienten, Formate: YYYY-MM-DD, YYYY-MM (wenn Tag nicht bekannt), YYYY (wenn Monat und Tag nicht bekannt)  
 
|}
 
|}
{{EndGreenBox}}
 
  
==Author==
+
===Autor/Ersteller/Ausdruckender (A)===
  
Die Resource für den Ersteller (author) für die hier beschriebenen Zwecke beginnt mit einer Identifikationsnummer, zum Beispiel der lebenslangen Arztnummer (wie im Beispiel). Es folgen Namen und Kontaktinformationen.
+
Im Ultrakurzformat wird der Autor in einem Element und Kind-Elementen repräsentiert:
 
+
<syntaxhighlight lang="xml">
{{BeginBlueBox|Beispiel}}
+
<A n="Dr. Fritz Überall"
 +
    s="Hauptstraße 55" z="01234" c="Am Ort"
 +
    lanr="1656304456"
 +
    p="04562-12345" e="f.ueberall@mein-netz.de" t="2016-02-16"/>
 +
</syntaxhighlight>
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
<Practitioner>
+
<A n="Praxis Dr. Michael Müller"
    <meta>
+
  s="Schloßstr. 22" z="10555" c="Berlin"
        <versionId value="201"/>
+
  p="030-1234567" e="dr.mueller@kbv-net.de" t="2017-07-15T12:59:12"/>
        <profile value="http://fhir.hl7.de/medikationsplan/practitioner"/>
 
    </meta>
 
    <identifier>
 
        <system value="http://kbv.de/LANR"/>
 
        <value value="165746304"/>
 
    </identifier>
 
    <name>
 
        <family value="Überall"/>
 
        <given value="Fritz"/>
 
        <prefix value="Dr."/>
 
    </name>
 
    <telecom>
 
        <system value="phone"/>
 
        <value value="tel:04562-12345"/>
 
        <use value="work"/>
 
    </telecom>
 
    <telecom>
 
        <system value="email"/>
 
        <value value="mailto:m.ueberall@mein-netz.de"/>
 
        <use value="work"/>
 
    </telecom>
 
    <address>
 
        <use value="work"/>
 
        <line value="Hauptstraße 55"/>
 
        <line value="01234 Am Ort"/>
 
    </address>
 
</Practitioner>
 
 
</syntaxhighlight>
 
</syntaxhighlight>
{{EndBlueBox}}
 
 
Weitere Informationen finden sich in der Beschreibung der entsprechenden FHIR Resource https://www.hl7.org/fhir/practitioner.html und den Datentypen https://www.hl7.org/fhir/datatypes.html.
 
 
{{BeginGreenBox|Ultrakurzformat}}
 
Im Ultrakurzformat wird der Autor in einem Element und Kind-Elementen repräsentiert:
 
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
<A lanr="1656304456" n="Dr. Fritz Überall"
+
<A n="Sonnen-Apotheke"  
    s="Hauptstraße 55" z="01234" c="Am Ort"
+
  s="Musterweg 1" z="01662" c="Meißen"
    p="04562-12345" e="f.ueberall@mein-netz.de" t="2016-02-16" />
+
  idf="3379589"  
 +
  p="03521-1234567" e="sonnen-apotheke@meissen.de" t="2017-07-15T10:11:12"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 
Dabei bedeuten:
 
Dabei bedeuten:
 
{| class="hl7table"
 
{| class="hl7table"
 
|-
 
|-
!Element/<br/>Attribut!!Beschreibung!! Referenz in <ref name="mpakdae20"/>
+
! style="text-align:left;" | Element/Attribut
 +
! style="text-align:left;" | Kardinalität
 +
! style="text-align:left;" | Beschreibung
 
|-
 
|-
|A ||Element (Autor) ||
+
|<code>A</code> ||Element (Autor) ||
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@lanr ||Lebenslange Arztnummer LANR (optional) ||
+
|[[Datei:Treetree.png|16px]]<code>@n</code> || 1..1 || Name der aktuell ausdruckende Instanz (Einrichtung, Leistungsträger)
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@idf ||7-stellige Apothekenidentifikationsnummer ||
+
|[[Datei:Treetree.png|16px]]<code>@s</code> || 0..1 || Straße
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@n ||Name der aktuell ausdruckende Instanz (Einrichtung, Leistungsträger) || 2.5
+
|[[Datei:Treetree.png|16px]]<code>@z</code> || 0..1 || Postleitzahl
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@s ||Straße|| 2.6
+
|[[Datei:Treetree.png|16px]]<code>@o</code> || 0..1 || Ort
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@z ||Postleitzahl || 2.7
+
|[[Datei:Treetree.png|16px]]<code>@p</code> || 0..1 || Telefonnummer
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@o ||Ort|| 2.8
+
|[[Datei:Treetree.png|16px]]<code>@e</code> || 0..1 || Emailadresse
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@p ||Telefonnummer|| 2.9
+
|[[Datei:Treetree.png|16px]]<code>@lanr</code> || 0..1 || Lebenslange Arztnummer LANR
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@e ||Emailadresse|| 2.10
+
|[[Datei:Treetree.png|16px]]<code>@idf</code> || 0..1 || 7-stellige Apothekenidentifikationsnummer
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@t ||Ausdruckdatum, Format YYYY-MM-DD ||
+
|[[Datei:Treetree.png|16px]]<code>@kik</code> || 0..1 || 9-stellige Krankenhaus IK-Nummer
 +
|-
 +
|[[Datei:Treetree.png|16px]]<code>@t</code> || 1..1 || Ausdruckdatum, Format YYYY-MM-DD oder YYYY-MM-DDThh:mm:ss
 
|}
 
|}
{{EndGreenBox}}
 
 
==Custodian==
 
 
Die Organisation, die mit der Verwaltung des Dokument betraut ist (custodian) wird im entsprechenden Element der Composition referenziert und dann als Entry im Bundle ausgeführt als Organization. Im Wesentlichen reicht hier die Andeutung einer Identifikation der Organisation wie im Beispiel zu sehen (urn:oid) oder über eine BSNR (das system-Element im Identifier trägt dann den Wert „http://kbv.de/BSNR“.
 
 
{{BeginBlueBox|Beispiel mit einer OID}}
 
<syntaxhighlight lang="xml">
 
<Organization>
 
    <identifier>
 
        <system value="urn:oid:1.2.276.0.76.4.17"/>
 
        <value value="218099900"/>
 
    </identifier>
 
</Organization>
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
  
{{BeginBlueBox|Identifier als BSNR}}
+
===Custodian===
<syntaxhighlight lang="xml">
+
Die Organisation, die mit der Verwaltung des Dokument betraut ist (custodian) wird im UKF zurzeit nicht repräsentiert.
<identifier>
 
  <system value="http://kbv.de/BSNR"/>
 
  <value value="218099900"/>
 
</identifier>
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
  
Weitere Informationen finden sich in der Beschreibung der entsprechenden FHIR Resource https://www.hl7.org/fhir/organization.html und den Datentypen https://www.hl7.org/fhir/datatypes.html.
+
===Abschnitte===
 +
Schließlich folgen die vier Abschnitte (Sections, analog zu der CDA- und FHIR-Definition).
  
{{BeginGreenBox|Ultrakurzformat}}
 
Im Ultrakurzformat wird die Organisation, die mit der Verwaltung des Dokument betraut ist (custodian), laut dieser Spezifikation zunächst NICHT angegeben. Zu einem späteren Zeitpunkt wird sie einem einzigen Element repräsentiert:
 
<syntaxhighlight lang="xml">
 
<C s="http://kbv.de/BSNR" v="218099900"/>
 
</syntaxhighlight>
 
Dabei bedeuten:
 
 
{| class="hl7table"
 
{| class="hl7table"
 
|-
 
|-
!Element/<br/>Attribut!!Beschreibung
+
!Section!!LOINC-Code
 
|-
 
|-
|C || Element (Custodian/Organization)
+
|Klinische Parameter (Körpergewicht, Kreatinin, …)
 +
|55752-0
 +
|-
 +
|Gesundheitsbelange (schwanger?, Entbindungstermin, stillend?)
 +
|75310-3
 +
|-
 +
|Allergien und Unverträglichkeiten
 +
|48765-2
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@s || Identifikations-System
+
|Aktuelle Medikation
 +
|19009-0
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@v || Identifikation (z. B. BSNR)
+
|Wichtige Angaben / Instruktionen
 +
|69730-0
 
|}
 
|}
Die OID (plus Extension) ist ein Identifier der Organisation, die das Dokument bewahrt und jederzeit reproduzieren kann.
+
<ref group="Tabelle">LOINC-Codes der eingesetzten Sections</ref> LOINC-Codes der eingesetzten Sections
{{EndGreenBox}}
 
  
==Abschnitt „Klinische Parameter“==
+
Im Ultrakurzformat werden die Klinischen Parameter (Section), Gesundheitsbelange in einem einzigen Element (O) zusammengefasst und repräsentiert, da es sich um Beobachtungen (Observation) handelt.
 +
 
 +
===Observation===
 +
 
 +
Im Ultrakurzformat werden die Klinischen Parameter und Gesundheitsbelange (siehe unten) in einem einzigen Element repräsentiert (es sind hier mehrere Beispiele aufgeführt).
  
Die Sections sind im hier definierten Format kurzgehalten und enthalten im Wesentlichen nur den entsprechenden LOINC-Code sowie Referenzen zu den eigentlichen Inhalten. Sie sind direkter Bestandteil der Composition (keine Referenz).
 
{{BeginBlueBox|Beispiel}}
 
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
<section>
+
<O w="89" h=177 c="1.3" p="1"/>
    <title value="Klinische Parameter"/>
+
</syntaxhighlight>
    <code>
+
<syntaxhighlight lang="xml">
        <coding>
+
<O h="180" w="80" edd="2017-08-30"/>
            <system value="http://loinc.org"/>
+
</syntaxhighlight>
            <code value="55752-0"/>
+
<syntaxhighlight lang="xml">
            <display value="Clinical information"/>
+
<O w="102">
        </coding>
 
    </code>
 
    <entry>
 
        <reference value="urn:uuid:23f6114c-994f-4b77-b7a9-5fa402aa93b1"/>
 
    </entry>
 
    <entry>
 
        <reference value="urn:uuid:f8611c65-fd9c-4fda-ac05-3ae005eedd91"/>
 
    </entry>
 
</section>
 
 
</syntaxhighlight>
 
</syntaxhighlight>
{{EndBlueBox}}
 
  
Weitere Informationen finden sich in der Beschreibung der entsprechenden FHIR Resource https://www.hl7.org/fhir/composition.html und den Datentypen https://www.hl7.org/fhir/datatypes.html.
+
Dabei sind die Einheiten zu Messwerten weggelassen, die Messwerte MÜSSEN den in der im Folgenden gezeigten Tabelle aufgeführten Einheiten ausgedrückt sein. Darüber hinaus kann für weitere Angaben Freitext benutzt werden.
 
 
{{BeginGreenBox|Ultrakurzformat}}
 
Im Ultrakurzformat werden die Klinischen Parameter (Section), Gesundheitsbelange und Allergien/Unverträglichkeiten (siehe unten) in einem einzigen Element repräsentiert. Zu den Details siehe folgender Abschnitt.
 
{{EndGreenBox}}
 
 
 
==Observation==
 
 
 
Die gerade beschriebene Section zu den Klinischen Parametern referenziert drei Beobachtungen (observation): Körpergewicht (LOINC 3142-7), Körpergröße (LOINC 8302-2) und Kreatinin (LOINC 2160-0). Die später beschriebene Section „Gesundheitsbelange“ ist ähnlich konstruiert, hier sind Status „Frau schwanger“ bzw. „Mutter stillend“ Gegenstand der Beobachtungen. In allen Fällen werden die Observation Resources nach der Andeutung des Profils mit dem fixierten Status „final“ versehen, tragen dann den jeweiligen LOINC Code vor und enthalten schließlich die Beobachtung. Eine Referenz auf den Patienten (Subject) ist anzugeben. Die Messergebnisse sind physikalische Quantitäten (wiederzugeben im valueQuantity-Element). Die Einheiten sind wie folgt festgelegt und werden im Ultrakurzformat mit angegeben.
 
  
 
{| class="hl7table"
 
{| class="hl7table"
Zeile 666: Zeile 387:
 
|-
 
|-
 
|Körpergewicht
 
|Körpergewicht
|3142-7
+
|29463-7
 
|kg
 
|kg
 
|-
 
|-
Zeile 679: Zeile 400:
 
<ref group="Tabelle">LOINC-Codes und Einheiten der eingesetzten Observations bei den Klinischen Parametern </ref> ''LOINC-Codes und Einheiten der eingesetzten Observations bei den Klinischen Parametern''
 
<ref group="Tabelle">LOINC-Codes und Einheiten der eingesetzten Observations bei den Klinischen Parametern </ref> ''LOINC-Codes und Einheiten der eingesetzten Observations bei den Klinischen Parametern''
  
{{BeginBlueBox|Beispiel Kreatinin, im Kontext der Beobachtung (Observation) LOINC 2160-0, Einheit ist „mg/dl“ (UCUM)}}
 
<syntaxhighlight lang="xml">
 
<valueQuantity>
 
    <value value="1.3"/>
 
    <unit value="mg/dl"/>
 
</valueQuantity>
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
{{BeginBlueBox|Beispiel Körpergewicht, im Kontext der Beobachtung (Observation) LOINC 3142-7, Einheit ist „kg“ (UCUM)}}
 
<syntaxhighlight lang="xml">
 
<valueQuantity>
 
    <value value="89.0"/>
 
    <unit value="kg"/>
 
</valueQuantity>
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
{{BeginBlueBox|Beispiel „Observation“ im Überblick}}
 
<syntaxhighlight lang="xml">
 
<Observation>
 
    <meta>
 
        <versionId value="201"/>
 
        <profile value="http://fhir.hl7.de/medikationsplan/observation"/>
 
    </meta>
 
    <patient>
 
        <reference value="urn:uuid:e3e65616-8fd4-427d-b560-d847c2ca0a3a"/>
 
    </patient>
 
    <status value="final"/>
 
    <code>
 
        <coding>
 
            <system value="http://loinc.org"/>
 
            <code value="3142-7"/>
 
            <display value="Body weight"/>
 
        </coding>
 
    </code>
 
    <valueQuantity>
 
        <value value="89"/>
 
        <unit value="kg"/>
 
        <system value="http://unitsofmeasure.org"/>
 
        <code value="kg"/>
 
    </valueQuantity>
 
</Observation>
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
 
Für den Status „schwanger“ (LOINC 11449-6) muss ein kodierter Wert aus dem Value Set [https://art-decor.org/art-decor/decor-valuesets--pmp-?valueSetRef=1.2.276.0.76.11.46 Schwangerschafts-Status] angebenen werden.
 
{{BeginBlueBox|Beispiel}}
 
<syntaxhighlight lang="xml">
 
<Observation>
 
    <meta>
 
        <versionId value="201"/>
 
        <profile value="http://fhir.hl7.de/medikationsplan/observation"/>
 
    </meta>
 
    <patient>
 
        <reference value="urn:uuid:e3e65616-8fd4-427d-b560-d847c2ca0a3a"/>
 
    </patient>
 
    <status value="final"/>
 
    <code>
 
        <coding>
 
            <system value="http://loinc.org"/>
 
            <code value="11449-6"/>
 
            <display value="Pregnancy status"/>
 
        </coding>
 
    </code>
 
    <valueCodeableConcept>
 
        <coding>
 
            <system value="http://hl7.de/1.2.276.0.76.11.46"/>
 
            <code value="1"/>
 
            <display value="Patient ist schwanger"/>
 
        </coding>
 
    </valueCodeableConcept>
 
</Observation>
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
 
Für den Status „stillend“ (LOINC 63895-7) sind die Beobachtungen Bool’sche Werte (ja/nein) und werden im Element valueCodeableConcept entsprechend der Tabelle 136 https://www.hl7.org/fhir/v2/0136/index.html wiedergegeben.
 
{{BeginBlueBox|Beispiel}}
 
<syntaxhighlight lang="xml">
 
<valueCodeableConcept>
 
  <coding>
 
      <system value="https://www.hl7.org/fhir/v2/0136"/>
 
      <code value="Y"/>
 
      <display value="Stillend"/>
 
  </coding>
 
</valueCodeableConcept>
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
 
Weitere Informationen finden sich in der Beschreibung der entsprechenden FHIR Resource https://www.hl7.org/fhir/observation.html und den Datentypen https://www.hl7.org/fhir/datatypes.html.
 
 
{{BeginGreenBox|Ultrakurzformat}}
 
Im Ultrakurzformat werden die Klinischen Parameter, Gesundheitsbelange und Allergien/Unverträglichkeiten (siehe unten) in einem einzigen Element repräsentiert (es sind hier mehrere Beispiele aufgeführt). Dabei sind die Einheiten zu Messwerten weggelassen, die Messwerte MÜSSEN den in der obigen Tabelle aufgeführten Einheiten ausgedrückt sein. Darüber hinaus kann für weitere Angaben Freitext aufgeführt werden.
 
<syntaxhighlight lang="xml">
 
<O w="89" c="1.3" p="1"/>
 
 
<O w="76" h="177" b="1"/>
 
 
<O w="102" a="Penizillin"/>
 
</syntaxhighlight>
 
 
Dabei bedeuten:
 
Dabei bedeuten:
 
{| class="hl7table"
 
{| class="hl7table"
 
|-
 
|-
!Element/<br/>Attribut!!Beschreibung
+
! style="text-align:left;" | Element/Attribut
|-
+
! style="text-align:left;" | Kardinalität
|O || Element (Observation)
+
! style="text-align:left;" | Beschreibung
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@w || Gewicht [kg], Druck "Gew.: x kg"
+
|<code>O</code> || optional || Element (Observation)<br />Invariante '''INV-O-1''': mindestens ein Attribut muss genannt sein, ansonsten muss das Element O weggelassen werden
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@h || Größe [cm], Druck "Größe: x cm"
+
|[[Datei:Treetree.png|16px]]<code>@w</code> || 0..1 || Gewicht [kg], Druck "Gew.: x kg"
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@c || Kreatinin [mg/dl], Druck "Kreatinin: x mg/dl"
+
|[[Datei:Treetree.png|16px]]<code>@h</code> || 0..1 || Größe [cm], Druck "Größe: x cm"
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@a || Allergie(n), Druck: "Allergie:"
+
|[[Datei:Treetree.png|16px]]<code>@c</code> || 0..1 || Kreatinin [mg/dl], Druck "Kreatinin: x mg/dl"
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@i || Unverträglichkeit(en), Druck: "Unvertr.:"
+
|[[Datei:Treetree.png|16px]]<code>@p</code> || 0..1 || schwanger, Regel: wenn schwanger p="1", sonst weglassen
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@p || schwanger, Regel: wenn schwanger p="1", sonst weglassen, Druck: "schwanger"
+
|[[Datei:Treetree.png|16px]]<code>@edd</code> || 0..1 || Erwarteter Geburtstermin, Format YYYY-MM-DD
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@b || stillend, Regel: wenn stillend b="1", sonst weglassen, Druck "stillend"
+
|[[Datei:Treetree.png|16px]]<code>@b</code> || 0..1 || stillend, Regel: wenn stillend b="1", sonst weglassen
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@x || zusätzlicher Freitext
+
|[[Datei:Treetree.png|16px]]<code>@x</code> || 0..1 || zusätzlicher Freitext
 
|}
 
|}
  
Dieses Element kommt im Ausdruck dem Parameter-Block gleich, die 3 Druck-Parameterzeilen werden aus Geschlecht (bei Patient, siehe oben) sowie den hier angegebenen optionalen Attributen sinnvoll in dieser Reihenfolge befüllt.
+
{{NoteBox|Es ist zu beachten, dass der Dezimaltrenner der Punkt "." ist und nicht das Komma.}}
  
Nach jeweils max. 25 Zeichen pro Zeile muss ein Umbruch erfolgen. Wenn die 3 Zeilen für die Anzeige nicht ausreichen, endet die 3. Zeile mit "..."
+
===Allergien und Unverträglichkeiten (AI)===
{{EndGreenBox}}
 
  
==Abschnitt „Allergien und Unverträglichkeiten“==
+
Im Ultrakurzformat werden die Allergien und Unverträglichkeiten mit dem Element AI wiedergegeben. Typisch ist dabei, dass im einfachsten Fall nur ein Freitext die Allergien/Unverträglichkeiten beschreiben. Bei entsprechender Fähigkeit des Systems kann zusätzlich eine Liste jeweils mit dem Agens, Codes, der Kritikalität (Bedrohlichkeit) und der Reaktion wiedergegeben werden.
 
 
Die Sections sind im hier definierten Format kurzgehalten und enthalten im Wesentlichen nur den entsprechenden LOINC-Code sowie Referenzen zu den eigentlichen Inhalten. Sie sind direkter Bestandteil der Composition (keine Referenz).
 
{{BeginBlueBox|Beispiel}}
 
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
<section>
+
<AI t="Erdnuss, Erdbeer"/>
    <title value="Allergien und Unverträglichkeiten"/>
 
    <code>
 
        <coding>
 
            <system value="http://loinc.org"/>
 
            <code value="48765-2"/>
 
            <display value="Allergies, adverse reactions, alerts"/>
 
        </coding>
 
    </code>
 
    <entry>
 
    <reference value="urn:uuid:2638074c-e12a-43ed-ba77-2d8ade3ab32b"/>
 
    </entry>
 
    ...
 
</section>
 
 
</syntaxhighlight>
 
</syntaxhighlight>
{{EndBlueBox}}
 
 
{{BeginGreenBox|Ultrakurzformat}}
 
Im Ultrakurzformat werden die Allergien und Unverträglichkeiten (Section) im O-Element (siehe #Observation) mitgegeben.
 
{{EndGreenBox}}
 
 
==AllergyIntolerance==
 
 
Die gerade beschriebene Section zu den Allergien bzw. Unverträglichkeiten referenziert die entsprechende Resource (AllergyIntolerance). Diese enthält eine Referenz auf den Patienten sowie Angaben zur Substanz (in Textform, möglich ist auch eine codierte Angabe) sowie die Angabe zum Typ (Allergie „allergy“ oder Unverträglichkeit „intolerance“).
 
 
{{BeginBlueBox|Beispiel}}
 
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
<AllergyIntolerance>
+
<AI t="Erdnuss, Erdbeer">
     <meta>
+
     <s s="Erdbeeren" r="Hautrötung"/>
        <versionId value="201"/>
+
     <s s="Erdnuss" c="H" dc="I120131" r="Schock"/>
        <profile value="http://fhir.hl7.de/medikationsplan/allergyintolerance"/>
+
</AI>
     </meta>
 
    <patient>
 
        <reference value="urn:uuid:e3e65616-8fd4-427d-b560-d847c2ca0a3a"/>
 
    </patient>
 
    <substance>
 
        <text value="Laktose"/>
 
    </substance>
 
    <type value="intolerance"/>
 
</AllergyIntolerance>
 
 
</syntaxhighlight>
 
</syntaxhighlight>
{{EndBlueBox}}
 
  
Weitere Informationen finden sich in der Beschreibung der entsprechenden FHIR Resource https://www.hl7.org/fhir/allergyintolerance.html und den Datentypen https://www.hl7.org/fhir/datatypes.html.
+
Dabei bedeuten:
 +
{| class="hl7table"
 +
|-
 +
! style="text-align:left;" | Element/Attribut
 +
! style="text-align:left;" | Kardinalität
 +
! style="text-align:left;" | Beschreibung
 +
|-
 +
|<code>AI</code> || 0..1 || Element (Allergy/Intolerance)
 +
|-
 +
|[[Datei:Treetree.png|16px]]<code>@t</code> || 1..1 || Das Attribut t (im Vorformat UKF-PMP O.ai) wird hier durch Zusammenfassen der Elemente s abgeleitet
 +
|-
 +
|[[Datei:Treetree.png|16px]]<code>s</code> || 0..* || Element zur Aufnahme von Informationen über das Agens, das Allergie/Unverträglichkeit auslöst<br>Invariante '''INV-AI-1''': Mindestes ein Attribut @s, @sc, @d oder @dc muss aufgeführt sein
 +
|-
 +
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@s</code> || 0..1 || Auslösendes Agens im Freitext
 +
|-
 +
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@sc</code> || 0..1 || Auslösendes Agens, codiert, siehe Anmerkung 1
 +
|-
 +
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@d</code> || 0..1 || Diagnose im Freitext
 +
|-
 +
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@dc</code> || 0..1 || Diagnosecode der Allergie/Unverträglichkeit, codiert, siehe Anmerkung 2
 +
|-
 +
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@c</code> || 0..1 || Kritikalität der Allergie/Unverträglichkeit, codiert, siehe Anmerkung 3
 +
|-
 +
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@r</code> || 0..1 || Reaktion auf die Allergie/Unverträglichkeit im Freitext
 +
|-
 +
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@rc</code> || 0..1 || Reaktion auf die Allergie/Unverträglichkeit, codiert, siehe Anmerkung 4
 +
|}
  
{{BeginGreenBox|Ultrakurzformat}}
+
Anmerkungen
Im Ultrakurzformat werden die Allergien und Unverträglichkeiten (Section) im O-Element (siehe #Observation) mitgegeben.
+
* 1: bisher ist hier keine feste Terminologie vorgesehen
{{EndGreenBox}}
+
* 2: hier ist die Alpha-ID vorgesehen, Value Set [http://art-decor.org/art-decor/decor-valuesets--pmp-?id=1.2.276.0.76.11.12 Allergien/Unvertäglichkeiten]
 +
* 3: hier ist als Terminologie ein Value Set für die [http://art-decor.org/art-decor/decor-valuesets--pmp-?id=2.16.840.1.113883.1.11.20549 Kritikalität] vorgesehen
 +
* 4: bisher ist hier keine feste Terminologie vorgesehen
  
==Abschnitt „Gesundheitsbelange“==
+
===Gesundheitsbelange===
 
+
Im Ultrakurzformat werden die Gesundheitsbelange (Section) im O-Element (siehe Observation) mitgegeben.
Die Sections sind im hier definierten Format kurzgehalten und enthalten im Wesentlichen nur den entsprechenden LOINC-Code sowie Referenzen (entry) zu den eigentlichen Inhalten. Sie sind direkter Bestandteil der Composition (keine Referenz).
 
{{BeginBlueBox|Beispiel}}
 
<syntaxhighlight lang="xml">
 
<section>
 
    <title value="Gesundheitsbelange"/>
 
    <code>
 
        <coding>
 
            <system value="http://loinc.org"/>
 
            <code value="75310-3"/>
 
            <display value="Health concerns"/>
 
        </coding>
 
    </code>
 
    <entry>
 
        <reference value="urn:uuid:d5a7160c-e0b3-42af-9212-82a2548f726c"/>
 
    </entry>
 
</section>
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
Diese Section kann Referenzen zu zwei Entries enthalten die Auskunft über „schwanger“ bzw. „stillend“ geben. Dieses sind Beobachtungen (siehe oben), es werden die folgenden LOINC-Codes verwendet.
 
  
 
{| class="hl7table"
 
{| class="hl7table"
 
|-
 
|-
!Parameter!!LOINC-Code!!Mögliche Werte
+
!Parameter !! LOINC-Code !! Mögliche Werte !! Repräsentieren im Element "O"
 
|-
 
|-
 
|Schwanger
 
|Schwanger
 
|11449-6
 
|11449-6
 
|laut Value Set [https://art-decor.org/art-decor/decor-valuesets--pmp-?valueSetRef=1.2.276.0.76.11.46 Schwangerschafts-Status]
 
|laut Value Set [https://art-decor.org/art-decor/decor-valuesets--pmp-?valueSetRef=1.2.276.0.76.11.46 Schwangerschafts-Status]
 +
|@p=1, wenn nicht schwanger wird p weggelassen
 +
|-
 +
|Erwarteter Geburtstermin
 +
|11778-8
 +
|Zeitangabe (Datum)
 +
|@edd="..."
 
|-
 
|-
 
|Stillend
 
|Stillend
 
|63895-7
 
|63895-7
|Y / N
+
|
 +
|@b=1, wenn nicht stillend wird b weggelassen
 
|}
 
|}
 
<ref group="Tabelle">LOINC-Codes und Wertemöglichkeiten der eingesetzten Observations bei den Gesundheitsbelangen</ref> ''LOINC-Codes und Wertemöglichkeiten der eingesetzten Observations bei den Gesundheitsbelangen''
 
<ref group="Tabelle">LOINC-Codes und Wertemöglichkeiten der eingesetzten Observations bei den Gesundheitsbelangen</ref> ''LOINC-Codes und Wertemöglichkeiten der eingesetzten Observations bei den Gesundheitsbelangen''
  
{{BeginGreenBox|Ultrakurzformat}}
+
===Abschnitt „Aktuelle Medikation“===
Im Ultrakurzformat werden die Gesundheitsbelange (Section) im O-Element (siehe #Observation) mitgegeben.
 
{{EndGreenBox}}
 
 
 
==Abschnitt „Aktuelle Medikation“==
 
 
 
Auch der eigentliche Medikationsplan mit allen Angaben wird an einer Section festgemacht. Diese hat den LOINC Code 19009-0 (Aktuelle Medikation). Bisher werden in diesem Format nur aktuelle Medikamente unterstützt. Ein Ausbau später mit entsprechend anderen LOINC-Codes kann auch abgesetzte oder abgelehnte/nicht vertragene Medikamente aufnehmen.
 
 
 
Die Angaben zu den Medikamenten stehen in den referenzierten Entries, allesamt MedicationStatement Resources. Bei einer eventuellen textlichen Wiedergabe der Medikationsdaten, generiert aus den Entries, kann eine Gruppierung vorgenommen werden wie zum Beispiel „Bedarfsmedikation (asNeeded-Indikator, siehe unten) oder auch vom Patienten besorgte Medikamente (informant = Patient, siehe unten).
 
  
{{BeginBlueBox|Beispiel}}
+
Der eigentliche Medikationsplan mit allen Angaben wird an einer Section festgemacht. Im Ultrakurzformat werden die Medikationsdaten (Section) in einem Element (M) mit möglichen Kind-Elementen repräsentiert. Medikationsdaten werden dabei in Blöcken zusammengefasst (S), die einen Titel (ggf. auch als Kode) enthalten können
<syntaxhighlight lang="xml">
 
<section>
 
    <title value="Aktuelle Medikation"/>
 
    <code>
 
        <coding>
 
            <system value="http://loinc.org"/>
 
            <code value="19009-0"/>
 
            <display value="Medication.current"/>
 
        </coding>
 
    </code>
 
    <entry>
 
        <reference value="urn:uuid:fc23ccc8-0b84-4680-bece-4e66b9de3392"/>
 
    </entry>
 
    ...
 
</section>
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
 
 
{{BeginGreenBox|Ultrakurzformat}}
 
Im Ultrakurzformat werden die Medikationsdaten (Section) in einem Element (M) mit möglichen Kind-Elementen repräsentiert. Medikationsdaten werden dabei in Blöcken zusammengefasst (S), die einen Titel (ggf. auch als Kode) enthalten können
 
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
 
<S c="412">
 
<S c="412">
Zeile 944: Zeile 517:
 
{| class="hl7table"
 
{| class="hl7table"
 
|-
 
|-
!Element/<br/>Attribut!!Beschreibung
+
! style="text-align:left;" | Element/Attribut
 +
! style="text-align:left;" | Kardinalität
 +
! style="text-align:left;" | Beschreibung
 
|-
 
|-
|S || Block-Element
+
|S || Block-Element ||
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@c || Titelcode (siehe Dokumentation in <ref name="mpakdae20"/>); @t und @c DARF NICHT gleichzeitig angegeben werden
+
|[[Datei:Treetree.png|16px]]@c || Titelcode des Abschnitts || siehe Anmerkung 1<br>Invariante '''INV-S-1''': @t und @c DARF NICHT gleichzeitig angegeben werden
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@t || Titel; @t und @c DARF NICHT gleichzeitig angegeben werden
+
|[[Datei:Treetree.png|16px]]@t || Titel des Abschnitts || Invariante '''INV-S-1''': @t und @c DARF NICHT gleichzeitig angegeben werden
 
|-
 
|-
|M oder X|| Kind-Elemente (MedicationStatement/Freitextangaben); siehe unten
+
|[[Datei:Treetree.png|16px]] M oder X|| Kind-Elemente || MedicationStatement/Freitextangaben als Kindelement, siehe unten
 
|}
 
|}
Die Kind-Elemente (MedicationStatement/Freitextangaben) werden im Folgenden im Detail beschrieben.
 
  
Für die Kodes (@c) sieht <ref name="mpakdae20"/> folgende Werte vor:
+
Anmerkungen:
{| class="wikitable"
+
* 1: Für die Codes (@c) sind die Werte im Value Set [http://art-decor.org/art-decor/decor-valuesets--pmp-?id=1.2.276.0.76.11.451 S_BMP_ZWISCHENUEBERSCHRIFT] wiedergegeben
! Kode
 
! Bedeutung (Druckausgabe)
 
|-
 
| 419
 
| Allergiehinweise
 
|-
 
| 416
 
| Anwendung unter die Haut
 
|-
 
| 411
 
| Bedarfsmedikation
 
|-
 
| 414
 
| Besondere Anwendung
 
|-
 
| 412
 
| Dauermedikation
 
|-
 
| 417
 
| Fertigspritze
 
|-
 
| 413
 
| Intramuskuläre Anwendung
 
|-
 
| 415
 
| Intravenöse Anwendung
 
|-
 
| 418
 
| Selbstmedikation
 
|-
 
| 422
 
| Wichtige Angaben
 
|-
 
| 421
 
| Wichtige Hinweise
 
|}
 
{{EndGreenBox}}
 
  
==MedicationStatement==
+
Die Kind-Elemente (MedicationStatement/Freitextangaben) werden im Folgenden im Detail beschrieben.
  
Die gerade beschriebene Section zur Medikamentenliste referenziert die entsprechende Resource (MedicationStatement). Diese enthält eine Referenz auf den Patienten.
+
===Medication Statement: Arzneimittel, Wirkstoffe (M)===
  
Ist der Patient die Quelle dieses Eintrags (zum Beispiel vom Patienten selbst besorgte Over-the-counter-Präparate) wird dies durch das optionale informationSource-Element mit der Referenz auf den Patienten angedeutet. Dieses Merkmal kann auch zu einer möglichen Gruppierung bei der textlichen Wiedergabe / Anzeige der Medikationsliste verwendet werden.
+
Die gerade beschriebene Section zur Medikamentenliste fasst schließlich die Details zu den Medikamenten-Einträgen zusammen. Diese enthält eine Referenz auf den Patienten.  
Es folgen optionale Angaben zum Dokumentationsdatum (dateAsserted).
 
  
Mit dem Status kann angegeben werden, ob das Medikament aktiv („active“) eingenommen wird oder nicht („completed“). In späteren Ausbaustufen sind auch weitere Werte möglich („entered-in-error“, „intended“).  
+
Im Ultrakurzformat werden die Medikation (MedicationStatement) in einem einzigen M-Element repräsentiert, welche von einem Block-Element (S, siehe oben) umklammert sind.  
  
Ebenfalls in Ausbaustufen kann ein Indikator (wasNotTaken) angegeben werden, dass das Medikament nicht genommen wurde (zum Beispiel wegen Unverträglichkeiten). Gründe können hier ebenfalls erfasst werden (reasonNotTaken). Der heutige Medikationsplan sieht dies allerdings noch nicht vor, es wird aber an dieser Stelle bereits erwähnt im Zusammenhang mit dem AMTS-Anwendungsfall.
+
Die Dosierung (D) und die Wirkstoffe (W) werden in Kind-Elementen zu M wiedergegeben.
  
Angaben dazu, warum das Medikament eingenommen wird, stehen im Element reasonForUseCodeableConcept. Dies wird zunächst nur als Text gefüllt werden (wie im Beispiel), kann später aber auch codiert geschehen.
+
Freitextangaben (X) können ebenfalls eingestreut sein.
  
Hinweise zum Medikationseintrag können im note-Element ihren Niederschlag finden.
+
Im Folgenden sind mehrere Beispiele aufgeführt.
 
 
Schließlich verweist die Resource auf die Angaben zum Medikament (Referenz auf Medication).
 
{{BeginBlueBox|Beispiel}}
 
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
<MedicationStatement>
+
<M id="1" p="230272" r="Herz/Blutdruck">
    <meta>
+
  <D m="1"/>
        <versionId value="201"/>
+
</M>
        <profile value="http://fhir.hl7.de/medikationsplan/medicationstatement"/>
 
    </meta>
 
    <patient>
 
        <reference value="urn:uuid:e3e65616-8fd4-427d-b560-d847c2ca0a3a"/>
 
    </patient>
 
    <informationSource>
 
        <reference value="urn:uuid:e3e65616-8fd4-427d-b560-d847c2ca0a3a"/>
 
    </informationSource>
 
    <dateAsserted value="2016-01-03"/>
 
    <status value="active"/>
 
    <wasNotTaken value="true"/>
 
    <reasonNotTaken>
 
        <coding>
 
            <display value="keine Compliance"/>
 
        </coding>
 
    </reasonNotTaken>
 
    <reasonForUseCodeableConcept>
 
        <text value="Muskelschmerzen"/>
 
    </reasonForUseCodeableConcept>
 
    <note value="gleich nach den Aufwachen"/>
 
    <medicationReference>
 
        <reference value="urn:uuid:9e42022c-79bb-4445-9d2b-84e3efab501f"/>
 
    </medicationReference>
 
    ...(Dosierungen)
 
</MedicationStatement>
 
 
</syntaxhighlight>
 
</syntaxhighlight>
{{EndBlueBox}}
 
 
Die Dosierungen werden nachfolgend auf die Referenz auf das Medikament angegeben. Da in der vorliegende fachinhaltliche Spezifikation zum Beispiel Dosierangaben mit vordefinierten Zeitandeutungen („morgens“, „mittags“, „abends“, „zur Nacht“) vorgesehen sind, können diese auch direkt mit den zugehörigen Mengenangaben spezifiziert werden. Es ist hierbei zu beachten, dass das gesamt dosage-Element dann so oft mit dem jeweiligen Code wiederholt wird, wie es nötig ist. Angaben wie 1-0-1-0 enthalten also vier dosage-Elemente mit den when-Codes PCM, PCD, PCV und HS und den Mengen 1, 0, 1, und 0.
 
 
Grundsätzlich kann für die Zeitandeutung (when) auf die Codetabelle https://www.hl7.org/fhir/valueset-event-timing.html zurückgegriffen werden.
 
 
Ist eine Dosis „bei Bedarf“ einzunehmen, wird dies mit dem asNeededBoolean-Element ausgedrückt (true/false = ja/nein). Damit lässt sich auch ausrücken: „morgens 1, mittags 0 und abends bei Bedarf 1“.
 
 
Die Mengenangaben stehen anschließend im quantityQuantity-Element. Die Einheiten werden als UCUM-Einheiten angegeben.
 
 
{{BeginBlueBox|Beispiel: morgens 1 bei Bedarf eine Kapsel (per os)}}
 
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
<dosage>
+
<M id="2" p="5988884" fd="Pflaster" i="alle 3 Tg erneuern auf anderer Hautstelle"/>
    <timing>
 
        <repeat>
 
            <period value="1"/>
 
    <periodUnits value="d"/>
 
            <when value="PCM"/>
 
        </repeat>
 
    </timing>
 
    <asNeededBoolean value="true"/>
 
    <route>
 
        <coding>
 
            <system value="http://hl7.org/fhir/v3/routeOfAdministration"/>
 
            <code value="PO"/>
 
            <display value="Swallow, oral"/>
 
        </coding>
 
    </route>
 
    <quantityQuantity>
 
        <value value="1"/>
 
      <unit value="Kps"/>
 
<system value="http://hl7.org/fhir/v3/orderableDrugForm"/>
 
      <code value="CAP"/>
 
    </quantityQuantity>
 
</dosage>
 
 
</syntaxhighlight>
 
</syntaxhighlight>
{{EndBlueBox}}
 
 
{{BeginBlueBox|Beispiel: mittags 10 ml}}
 
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
<dosage>
+
<M id="3" c="2016-01-01T12:45:00" p="558736"
    <timing>
+
  i="Wechseln der Injektionsstellen, unmittelbar vor einer Mahlzeit spritzen" r="Diabetes">
        <repeat>
+
  <D m="20" v="20" du="p"/>
            <period value="1"/>
+
</M>
    <periodUnits value="d"/>
 
    <when value="PCD"/>
 
        </repeat>
 
    </timing>
 
    <quantityQuantity>
 
        <value value="10"/>
 
<unit value="ml"/>
 
        <system value="http://unitsofmeasure.org"/>
 
        <code value="ml"/>
 
    </quantityQuantity>
 
</dosage>
 
 
</syntaxhighlight>
 
</syntaxhighlight>
{{EndBlueBox}}
 
 
Auch sind von-bis Angaben bei der Dosis möglich. Dazu wird das quantityRange-Element gefüllt.
 
 
{{BeginBlueBox|Beispiel: mittags 10-15 ml}}
 
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
<dosage>
+
<M id="4" p="6322472" c="2017-07-15T10:05:17"
    <timing>
+
  i="vom 27.06.2013, Dr. Ansgard Müller">
        <repeat>
+
  <D t="0,5-0-0-0-0,5-0" du="1"/>
            <period value="1"/>
+
</M>
    <periodUnits value="d"/>
 
    <when value="PCD"/>
 
        </repeat>
 
    </timing>
 
    <quantityRange>
 
        <low>
 
            <value value="10"/>
 
    <unit value="ml"/>
 
            <system value="http://unitsofmeasure.org"/>
 
            <code value="ml"/>
 
        </low>
 
        <high>
 
            <value value="15"/>
 
            <unit value="ml"/>
 
            <system value="http://unitsofmeasure.org"/>
 
            <code value="ml"/>
 
        </high>
 
    </quantityRange>
 
</dosage>
 
 
</syntaxhighlight>
 
</syntaxhighlight>
{{EndBlueBox}}
 
 
Eine Dosierung kann zur Not auch nur als Freitext durchgegeben werden.
 
 
{{BeginBlueBox|Beispiel}}
 
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
<dosage>
+
<M id="5" c="2017-07-15T11:02:14"
    <text value="Dosierung nach Freitext"/>
+
  ms="2017-07-15T15:00:00" me="2017-07-20T15:00:00"
</dosage>
+
  f="SUS"
</syntaxhighlight>
+
  i="für 5 Tage (1 Messlöffel=5ml)" r="Harnwegsinfekt">
{{EndBlueBox}}
+
  <D t="alle 8 Stunden 1" du="#"/>
 
+
  <W w="Trimethoprim" s="40" su="mg"/>
Weitere Informationen finden sich in der Beschreibung der entsprechenden FHIR Resource https://www.hl7.org/fhir/medicationstatement.html und den Datentypen https://www.hl7.org/fhir/datatypes.html.
+
  <W w="Sulfamethoxazol" s="200" su="mg"/>
 
+
</M>
{{BeginGreenBox|Ultrakurzformat}}
 
Im Ultrakurzformat werden die Medikation (MedicationStatement) in einem einzigen M-Element repräsentiert, welche von einem Block-Element (S, siehe oben) umklammert sind. Freitextangaben (X) können ebenfalls eingestreut sein.
 
 
 
Im Folgenden sind mehrere Beispiele aufgeführt.
 
<syntaxhighlight lang="xml">
 
<M p="811721" f="TAB" m="1"/>
 
 
 
<M p="9884609" f="FTA" m="1" i="bis Januar 2017"/>
 
 
 
<M p="5988884" fd="Pflaster" i="alle 3 Tg erneuern auf anderer Hautstelle"/>
 
 
 
<M p="6322472" t="0,5-0-0-0-0,5-0" du="1" i="Datum 27.06.2013, Dr. Ansgard Müller" />
 
 
 
<M p="1053429" t="bei Bedarf" du="4"
 
  i=" 19.03.2013, Dr. Paulsen, Hans; Einzeldosis 1, Max. dosis in 24 h 2" />
 
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Zeile 1.163: Zeile 580:
 
{| class="hl7table"
 
{| class="hl7table"
 
|-
 
|-
!Element/<br/>Attribut!!Beschreibung!! Referenz in <ref name="mpakdae20"/>
+
! style="text-align:left;" | Element/Attribut
 +
! style="text-align:left;" | Kardinalität
 +
! style="text-align:left;" | Beschreibung
 +
|-
 +
|<code>M</code> || 0..* || Medikation, Element (MedicationStatement)<br />Invariante '''INV-MS-1''': mindestens ein Attribut oder Wirkstoffe (W Kind-Elemente) müssen angegeben sein
 
|-
 
|-
|M || Medikation, Element (MedicationStatement); mindestens ein Attribut oder Wirkstoffe (Kind-Elemente) müssen angegeben sein ||
+
|[[Datei:Treetree.png|16px]]<code>@id</code> || 1..1 || Relative Id des Medikamenteneintrags im Plan, soll eine ganze positive Zahl sein und ergibt zusammen mit der ID des gesamten Planes eine eindeutige Identifikation des Medikations-Eintrags
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@p ||die Pharmazentralnummer PZN, falls angegeben|| 4.1
+
|[[Datei:Treetree.png|16px]]<code>@c</code>  || 1..1 || Erzeugungsdatum des Medikamenteneintrags, Format YYYY-MM-DDThh:mm:ss
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@a ||Handelsname, entweder definiert oder fehlend (dann bei Ausdruck ggf. aus PZN abgeleitet)||
+
|[[Datei:Treetree.png|16px]]<code>@p</code> || 0..1 || die Pharmazentralnummer PZN, falls angegeben
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@f ||Darreichungsform, IFA Codes (siehe auch http://art-decor.org/art-decor/decor-valuesets--pmp-?id=2.16.840.1.113883.2.6.60.4.11.2), entweder definiert oder fehlend (dann bei Ausdruck ggf. aus PZN abgeleitet); @f und @fd DARF NICHT gleichzeitg angegeben werden || 4.4
+
|[[Datei:Treetree.png|16px]]<code>@a</code> || 0..1 || Handelsname, entweder definiert oder fehlend (dann bei Ausdruck ggf. aus PZN abgeleitet)
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@fd ||Darreichungsform als Freitext, entweder definiert oder fehlend (dann bei Ausdruck ggf. aus PZN abgeleitet); @f und @fd DARF NICHT gleichzeitg angegeben werden||
+
|[[Datei:Treetree.png|16px]]<code>@f</code> || 0..1 || Darreichungsform, siehe Anmerkung 1, entweder definiert oder fehlend (dann bei Ausdruck ggf. aus PZN abgeleitet)<br />Invariante '''INV-MS-2''': @f und @fd DARF NICHT gleichzeitg angegeben werden
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@m || Dosierung für "morgens", wenn nicht angegeben = "0"; @m DARF NICHT gleichzeitig mit @t angegeben werden||
+
|[[Datei:Treetree.png|16px]]<code>@fd</code> || 0..1 || Darreichungsform als Freitext, entweder definiert oder fehlend (dann bei Ausdruck ggf. aus PZN abgeleitet)<br />Invariante '''INV-MS-2''': @f und @fd DARF NICHT gleichzeitg angegeben werden
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@d || Dosierung für "mittags", wenn nicht angegeben = "0"; @d DARF NICHT gleichzeitig mit @t angegeben werden||
+
|[[Datei:Treetree.png|16px]]<code>@ms</code> || 0..1 || Start der Medikamenteneinnahme, Format YYYY-MM-DDThh:mm:ss
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@v || Dosierung für "abends", wenn nicht angegeben = "0"; @d DARF NICHT gleichzeitig mit @t angegeben werden||
+
|[[Datei:Treetree.png|16px]]<code>@me</code> || 0..1 || Ende der Medikamenteneinnahme, Format YYYY-MM-DDThh:mm:ss
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@h || Dosierung für "zur Nacht", wenn nicht angegeben = "0"; wenn dieses Feld leer gedruckt werden soll muss " " (Leerzeichen) angegeben werden; @h DARF NICHT gleichzeitig mit @t angegeben werden||
+
|[[Datei:Treetree.png|16px]]<code>@i</code> || 0..1 || Hinweise/Instruktionen an den Patienten für die Einnahme, zum Beispiel "morgens nüchtern 30 min vor dem Frühstück"
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@du || Dosiereinheit kodiert; @du DARF NICHT gleichzeitig mit @dud angegeben werden ||Anhang 7
+
|[[Datei:Treetree.png|16px]]<code>@r</code> || 0..1 || Grund für die Einnahme im Freitext
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@dud || Freitext Dosiereinheit; @du DARF NICHT gleichzeitig mit @dud angegeben werden||
+
|[[Datei:Treetree.png|16px]]<code>D</code> || 0..* || Kind-Element(e): Dosierung.
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@t || Freitextdosierung; @t DARF NICHT gleichzeitig mit den Attributen @m, @d, @v oder @h angegeben werden||
+
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@m</code> || 0..1 || Dosierung für "morgens", wenn nicht angegeben = "0"<br />Invariante '''INV-MS-3''': @m DARF NICHT gleichzeitig mit @t angegeben werden
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@i || Hinweise/Instruktionen an den Patienten für die Einnahme, zum Beispiel "morgens nüchtern 30 min vor dem Frühstück"||
+
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@d</code> || 0..1 || Dosierung für "mittags", wenn nicht angegeben = "0"<br />Invariante '''INV-MS-4''': @d DARF NICHT gleichzeitig mit @t angegeben werden
 
|-
 
|-
|[[Datei:Treetree.png|16px]]@r || Grund für die Einnahme||
+
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@v</code> || 0..1 || Dosierung für "abends", wenn nicht angegeben = "0"<br />Invariante '''INV-MS-5''': @v DARF NICHT gleichzeitig mit @t angegeben werden
 
|-
 
|-
|[[Datei:Treetree.png|16px]]W || Kind-Element(e): Wirkstoff. Bei Kombipräperaten für jede Komponente ein Eintrag, im Druck n Zeilen. Ein leeres Element ist nicht erlaubt || 4.1
+
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@h</code> || 0..1 || Dosierung für "zur Nacht", wenn nicht angegeben = "0"; wenn dieses Feld leer gedruckt werden soll muss " " (Leerzeichen) angegeben werden; <br />Invariante '''INV-MS-6''': @h DARF NICHT gleichzeitig mit @t angegeben werden
 
|-
 
|-
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]@w || Wirkstoffname, entweder definiert oder fehlend (dann bei Ausdruck ggf. aus PZN abgeleitet)||
+
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@du</code> || 0..1 || Dosiereinheit kodiert<br />Invariante '''INV-MS-7''': @du DARF NICHT gleichzeitig mit @dud angegeben werden
 
|-
 
|-
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]@s || Stärke, entweder definiert oder fehlend (dann bei Ausdruck ggf. aus PZN abgeleitet) || 4.3
+
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@dud</code> || 0..1 || Freitext Dosiereinheit<br />Invariante '''INV-MS-7''': @du DARF NICHT gleichzeitig mit @dud angegeben werden
 +
|-
 +
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@t</code> || 0..1 || Freitextdosierung<br />Invariante '''INV-MS-8''': @t DARF NICHT gleichzeitig mit den Attributen @m, @d, @v oder @h angegeben werden
 +
|-
 +
|[[Datei:Treetree.png|16px]]<code>W</code> || 0..* || Kind-Element(e): Wirkstoff. Bei Kombipräperaten für jede Komponente ein Eintrag, im Druck n Zeilen.<br />Invariante '''INV-MS-9''': Ein leeres Element ist nicht erlaubt
 +
|-
 +
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@w</code> || 0..1 || Wirkstoffname, entweder definiert oder fehlend (dann bei Ausdruck ggf. aus PZN abgeleitet)
 +
|-
 +
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@ask</code> || 0..1 || ASK-Nummer zur Definition eines Wirkstoffs<br />Invariante INV-W-1: @ask DARF NICHT zusammen mit PZN M.@p angegeben werden, siehe Anmerkung 2
 +
|-
 +
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@atc</code> || 0..1 || ATC-Code zur Spezifizierung eines Wirkstoffs, siehe Anmerkung 2
 +
|-
 +
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@s</code> || 0..1 || Stärke, entweder definiert oder fehlend (dann bei Ausdruck ggf. aus PZN abgeleitet)
 +
|-
 +
|[[Datei:Treeblank.png|16px]][[Datei:Treetree.png|16px]]<code>@su</code> || 0..1 || Wirkstärke Einheit, entweder definiert oder fehlend (dann bei Ausdruck ggf. aus PZN abgeleitet)
 
|}
 
|}
 +
 +
Anmerkungen:
 +
* 1 : IFA Codes, siehe auch http://art-decor.org/art-decor/decor-valuesets--pmp-?id=2.16.840.1.113883.2.6.60.4.11.2)
 +
* 2: es kann erwartet werden, dass die Angabe von Wirkstoffen in der nahen Zukunft aus über europäischen Substanz-Indetifikatoren, z. B. IDMP angegeben werden können.
 +
 
Zu beachten ist, dass die im Folgenden beschriebenen Angaben zum Medikament hier bereits enthalten sind.
 
Zu beachten ist, dass die im Folgenden beschriebenen Angaben zum Medikament hier bereits enthalten sind.
  
Zeile 1.219: Zeile 659:
 
|}
 
|}
  
Freitextangaben werden im X-Element wiedergegeben, der Text selbst ist Element-Content. Im Folgenden sind mehrere Beispiele aufgeführt.
+
===Freitextangaben (X)===
<syntaxhighlight lang="xml" heading="Freitextangaben, z.B. längere Anweisungen, bei Rezepten">
+
Freitextangaben, z.B. längere Anweisungen, bei Rezepten etc, werden im X-Element wiedergegeben. Der Text selbst ist @t-Attribut untergebracht. Im Folgenden sind mehrere Beispiele aufgeführt.
<X>Anordnung zur regelmäßigen Gewichtsbestimmung~Außerdem BMI und RR u. P</X>
+
<syntaxhighlight lang="xml">
 
+
<X id="10" c="2017-07-15T14:02:14"
<X>Analekzemsalbe Milch, Thesit 2.5 HC 0.25 Milch Cordes ad 50.0</X>
+
  t="Anordnung zur regelmäßigen Gewichtsbestimmung~Außerdem BMI und RR u. P"/>
 +
</syntaxhighlight>
 +
<syntaxhighlight lang="xml">
 +
<X id="3 c="2017-07-15T11:02:14"
 +
  t="Analekzemsalbe Milch, Thesit 2.5 HC 0.25 Milch Cordes ad 50.0"/>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Zeile 1.229: Zeile 673:
 
{| class="hl7table"
 
{| class="hl7table"
 
|-
 
|-
!Element/<br/>Attribut!!Beschreibung!! Referenz in <ref name="mpakdae20"/>
+
! style="text-align:left;" | Element/Attribut
 +
! style="text-align:left;" | Kardinalität
 +
! style="text-align:left;" | Beschreibung
 +
|-
 +
| <code>X</code> || 0..* || Freitext, darf max. 3 Umbrüche enthalten "~"
 +
|-
 +
|[[Datei:Treetree.png|16px]]<code>@id</code> || 1..1 || Relative Id des Medikamenteneintrags im Plan, soll eine ganze positive Zahl sein und ergibt zusammen mit der ID des gesamten Planes eine eindeutige Identifikation des Medikations-Eintrags
 +
|-
 +
|[[Datei:Treetree.png|16px]]<code>@c</code> || 1..1 || Erzeugungsdatum des Medikamenteneintrags, Format YYYY-MM-DDThh:mm:ss
 
|-
 
|-
|X|| Freitext, darf max. 3 Umbrüche enthalten "~" ||
+
|[[Datei:Treetree.png|16px]]<code>@t</code>  || 1..1 || Freitext
 +
 
 
|}
 
|}
  
{{EndGreenBox}}
+
===Medication===
 
 
==Medication==
 
  
Die Resource zum Medikament beginnt typischerweise zunächst mit einem oder mehreren Codes für das Medikament.
+
Die Angaben zum Medikament beginnen typischerweise mit einem oder mehreren Codes für das Medikament.
  
 
Codierte Informationen zum Medikament (Medikamentencode) sind zum Beispiel als PZN (System-Identifier: http://www.ifaffm.de/pzn) oder als WHO-ATC-Code (System-Identifier: http://www.whocc.no/atc) anzugeben. Im Prinzip sind hier auch andere Medikamentencodes einsetzbar.
 
Codierte Informationen zum Medikament (Medikamentencode) sind zum Beispiel als PZN (System-Identifier: http://www.ifaffm.de/pzn) oder als WHO-ATC-Code (System-Identifier: http://www.whocc.no/atc) anzugeben. Im Prinzip sind hier auch andere Medikamentencodes einsetzbar.
  
Optional kann schließlich das Produkt (product) beschrieben werden.  
+
Die Angaben zum Medikament sind bereits unter Medication Statement (M-Element) beschriebenen.
  
Hier steht zunächst die Darreichungsform (form) codiert oder als Text im Vordergrund. Codes sollen hier aus dem Codesystem http://hl7.org/fhir/v3/orderableDrugForm gewählt werden.
+
===Medication Statement: Rezepturen (R)===
 +
Für den Fall, dass das Medikament in der Liste kein Fertigarzneimittel ist, sondern beispielsweise eine Rezeptur, kann dies mit einem etwas verkürzten Medication Statement übermittelt werden.  
  
Schließlich können Bestandteile (ingredients) mit Namen und der Stärke (amount als Ratio mit numerator und denominator -Element) wiedergegeben werden. Für codierte Wirkstärken sind Einheiten aus dem UCUM-System zu nutzen (System-Identifier http://unitsofmeasure.org).
+
Die Angaben zu einer Rezeptur sind bereits unter Medication Statement (M-Element) beschriebenen. Statt dem Element M wird aber das Element R verwendet.
 
 
{{BeginBlueBox|Beispiel}}
 
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
<Medication>
+
<R id="8" t="Pflegecreme (Basiscreme DAC, Nachtkerzenöl 10%)  -- täglich auf die betroffenen Stellen --" c="2017-07-15T10:05:17"/>
    <code>
 
        <coding>
 
            <system value="http://www.ifaffm.de/pzn"/>
 
            <code value="00148932"/>
 
            <display value="Clopidogrel AAA 75mg"/>
 
        </coding>
 
        <coding>
 
            <system value="http://www.whocc.no/atc"/>
 
            <code value="B01AC04"/>
 
            <display value="Clopidogrel"/>
 
        </coding>
 
    </code>
 
    <product>
 
        <form>
 
            <coding>
 
                <system value="http://hl7.org/fhir/v3/orderableDrugForm"/>
 
                <code value="TAB"/>
 
                <display value="TAB"/>
 
            </coding>
 
        </form>
 
        <ingredient>
 
            <item>
 
                <display value="Clopidogrel"/>
 
            </item>
 
            <amount>
 
                <numerator>
 
                    <value value="75"/>
 
                    <system value="http://unitsofmeasure.org"/>
 
                    <code value="mg"/>
 
                </numerator>
 
                <denominator>
 
                    <value value="1"/>
 
                    <system value="http://unitsofmeasure.org"/>
 
                    <code value="1"/>
 
                </denominator>
 
            </amount>
 
        </ingredient>
 
    </product>
 
</Medication>
 
 
</syntaxhighlight>
 
</syntaxhighlight>
{{EndBlueBox}}
 
  
Weitere Informationen finden sich in der Beschreibung der entsprechenden FHIR Resource https://www.hl7.org/fhir/medication.html und den Datentypen https://www.hl7.org/fhir/datatypes.html.
+
Dabei bedeuten:
 +
{| class="hl7table"
 +
|-
 +
! style="text-align:left;" | Element/Attribut
 +
! style="text-align:left;" | Kardinalität
 +
! style="text-align:left;" | Beschreibung
 +
|-
 +
|<code>R</code> || 0..* || Rezeptur-Eintrag, Element (MedicationStatement)
 +
|-
 +
|[[Datei:Treetree.png|16px]]<code>@...</code> || || mögliche Attribute und Regeln sind die des Elements M
 +
|}
  
{{BeginGreenBox|Ultrakurzformat}}
+
===Abschnitt "Wichtige Angaben / Instruktionen" (X)===
Zu beachten ist, dass die Angaben zum Medikament bereits unter MedicationStatement (M-Element) beschriebenen sind.
+
Schließlich können als letzte Section „Wichtige Angaben“ und „Instruktionen“ an den Patienten gegeben werden.  
{{EndGreenBox}}
 
  
==MedicationStatement (Rezepturen)==
 
Für den Fall, dass das Medikament in der Liste kein Fertigarzneimittel ist, sondern beispielsweise eine Rezeptur kann dies mit einem etwas verkürzten MedicationStatement übermittelt werden. Die Rezeptur steht dabei im medicationCodeableConcept-Element als Text (inline) und nicht in einer referenzierten Medication-Resource. Die anderen Möglichkeiten, die beim MedicationStatement bereits weiter oben beschrieben wurden, sind davon unberührt.
 
 
{{BeginBlueBox|Beispiel}}
 
<syntaxhighlight lang="xml">
 
<MedicationStatement>
 
    <patient>
 
        <reference value="urn:uuid:e3e65616-8fd4-427d-b560-d847c2ca0a3a"/>
 
    </patient>
 
    <status value="completed"/>
 
    <reasonForUseCodeableConcept>
 
        <text value="Hautentzündungen"/>
 
    </reasonForUseCodeableConcept>
 
    <note value="nach Bedarf auf die Haut auftragen"/>
 
    <medicationCodeableConcept>
 
        <text value="Erythromycin 1.0, Ultrasicc ad 50,0"/>
 
    </medicationCodeableConcept>
 
</MedicationStatement>
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
 
Weitere Informationen finden sich in der Beschreibung der entsprechenden FHIR Resource https://www.hl7.org/fhir/medicationstatement.html und den Datentypen https://www.hl7.org/fhir/datatypes.html.
 
 
{{BeginGreenBox|Ultrakurzformat}}
 
Die Angaben zu einer Rezeptur sind bereits unter MedicationStatement (M-Element) beschriebenen.
 
{{EndGreenBox}}
 
 
==Abschnitt „Wichtige Angaben / Instruktionen“==
 
Schließlich können in der Composition als letzte Section „Wichtige Angaben“ und „Instruktionen“ an den Patienten gegeben werden. Sie ist ebenso wie die anderen Sections direkter Bestandteil der Composition (keine Referenz) und enthält neben dem üblichen code-Element nur Text im text-Element mit dem status-Element „additional“ und keine Entry-Referenzen.
 
 
{{BeginBlueBox|Beispiel}}
 
<syntaxhighlight lang="xml">
 
<section>
 
    <title value="Wichtige Angaben / Instruktionen"/>
 
    <code>
 
        <coding>
 
            <system value="http://loinc.org"/>
 
            <code value="69730-0"/>
 
            <display value="Instructions"/>
 
        </coding>
 
    </code>
 
    <text>
 
        <status value="additional"/>
 
        <div xmlns="http://www.w3.org/1999/xhtml">
 
            (Wichtige Angaben / Instruktionen für den Patienten)
 
        </div>
 
    </text>
 
</section>
 
</syntaxhighlight>
 
{{EndBlueBox}}
 
 
Weitere Informationen finden sich in der Beschreibung der entsprechenden FHIR Resource https://www.hl7.org/fhir/composition.html und den Datentypen https://www.hl7.org/fhir/datatypes.html.
 
 
{{BeginGreenBox|Ultrakurzformat}}
 
 
Im Ultrakurzformat werden die Wichtige Angaben / Instruktionen (Section) in einem Block-Element (S) mit Kode 422 (im Attribut @c) und einem X-Kindelement repräsentiert:
 
Im Ultrakurzformat werden die Wichtige Angaben / Instruktionen (Section) in einem Block-Element (S) mit Kode 422 (im Attribut @c) und einem X-Kindelement repräsentiert:
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
 
<S c="422">
 
<S c="422">
  <X>Ganz wichtig: Impftermin am 15. März nicht vergessen!!!</X>
+
  <X>Ganz wichtig: Impftermin am 15. März nicht vergessen!!!</X>
 
</S>
 
</S>
 
</syntaxhighlight>
 
</syntaxhighlight>
 
Die Elemente sind oben beschrieben.
 
Die Elemente sind oben beschrieben.
|}
 
{{EndGreenBox}}
 
  
==Provenance==
+
==Übersicht über den Aufbau des Ultrakurzformat Patientenorientierter Medikationsplan PLUS Referenz (UKF-REF)==
 +
Das zweite Ultrakurzformat referenziert lediglich einen Medikationsplan (auf einem Server), anstatt ihn inhaltlich weiterzugeben. Das UKF-REF beinhaltet dabei nur einen "Link" (Referenz Ressourcen-Speicherort) auf den Plan und eine Andeutung des zugehörigen Patienten.
 +
<syntaxhighlight lang="xml">
 +
<MPR v="1" u="MPP" U="800932EEB79D4F389CEA34427B54193D"
 +
    url="https://mein.medikationsplan-plus.de/800932ee-b79d-4f38-9cea-34427b54193d">
 +
    <P t="Prof. Dr. med." g="Ivan" z="Freiherr" v="von und zu" f="Ivanov"
 +
        s="M" egk="F994842101" b="1958-02-13"/>
 +
</MPR>
 +
</syntaxhighlight>
  
Vorsorglich wird hier noch auf die Provenance Resource hingewiesen. Sie wird hier zwar zunächst nicht weiter beschrieben, aber ist der Ort, wo beispielsweise Signaturen angedeutet werden.
+
{| class="hl7table"
 +
|-
 +
! style="text-align:left;" | Element/Attribut
 +
! style="text-align:left;" | Kardinalität
 +
! style="text-align:left;" | Beschreibung
 +
|-
 +
|<code>MPR</code> || 1..1 || Referenz auf den Ressourcen-Speicherort
 +
|-
 +
|[[Datei:Treetree.png|16px]]<code>@v</code> || 1..1 || Version der Spezifikation des Medikationsplans Plus, zurzeit fixiert auf "1"
 +
|-
 +
|[[Datei:Treetree.png|16px]]<code>@u</code> || 1..1 || Type der Spezifikation des Medikationsplans, zurzeit fixiert auf "MPP" (Medikationsplan Plus)
 +
|-
 +
|[[Datei:Treetree.png|16px]]<code>@url</code> || 1..1 || Link auf den Ressourcen-Speicherort  zum Medikationsplan Plus des Patienten
 +
|-
 +
|[[Datei:Treetree.png|16px]]<code>@U</code> || 1..1 || konkrete Instanz-ID des Plans (gleich für alle Seiten des Plans); hier wird eine UUID ohne "-" Trennzeichen und A-F als Buchstaben verwendet
 +
|-
 +
|[[Datei:Treetree.png|16px]]<code>P</code> || 1..1 || Angaben zum Patienten wie oben beschrieben; dieses Element dient nur der Identifizierung des Patienten in der Referenz
 +
|}
  
Die Provenance Resource beschreibt Entitäten und Prozesse, die an der Erstellung und Weitergabe der Ressource beteiligt sind oder diese beeinflussen. Provenance stellt eine entscheidende Grundlage für die Beurteilung der Echtheit, zur Erlangung von vertrauenswürdiger Kommunikation und Reproduzierbarkeit dar.
+
[[Datei:Mpr-qr-code-beispiel.png|140px|right]] Derartige Instanzen sind natürlich auch wesentlich kleiner, als wenn der QR-Code beispielsweise alle Daten des Medikationsplans weitergeben muss. Das oben gezeigte Beispiel würde in einem üblichen QR-Code so wie gezeigt aussehen. Das Lesen ist auch mit weniger guten Scannern möglich. Die Software würde den Server entsprechend anrufen um die Medikationsdaten zu erhalten. Bitte beachten Sie, dass dann die Daten auf dem Server auch nicht im Ultrakurzformat gespeichert werden müssten, sondern direkt in einer vollständigen FHIR-Fassung. Diese wäre im Übrigen identisch zu den zu einer mobilen App transportierten Inhalten.
  
 
==Hinweise zu XML-Instanzen==
 
==Hinweise zu XML-Instanzen==
Zeile 1.380: Zeile 768:
 
*Nicht druckbare Zeichen sollen als "?" dargestellt werden.
 
*Nicht druckbare Zeichen sollen als "?" dargestellt werden.
  
==Betrachtungen zur Filegröße==
+
==Vollständige XML-Beispiele==
  
Mit dieser Spezifikation wurden Medikationspläne mit Hunderten Medikamenten-Einträgen getestet. Die dabei evaluierten Größen der Files, die zur Speicherung in diesem Format nötig sind, wurden in der folgenden Tabelle (N=232) für Medikationspläne mit unterschiedlich vielen Medikamenten eingetragen. Signaturen sind hierbei noch nicht berücksichtigt.
+
Nachfolgend vollständige Beispiele zum UKF-PMPP, das allerdings aus Darstellungs- und Lesbarkeitsgründen umgebrochen ist. Bitte beachten, dass im ISO/IEC 8859-1 Zeichensatz gar keine Zeilenumbrüche (Newline, Linefeed) etc. vorkommen.
  
Für alle Medikationspläne liegt die entsprechende Repräsentation in XML nach dieser Spezifikation und auch die entsprechende Wiedergabe in PDF vor.
+
=== Prof. Dr. med. Ivan Freiherr von und zu Ivanov===
 
+
<syntaxhighlight lang="xml">
{| class="hl7table"
 
!Anzahl<br/>Medikamente
 
!Anzahl Pläne<br/>in Stichprobe
 
!Mittlere<br/> Anzahl Bytes roh
 
!Mittlere<br/> Anzahl Bytes zip
 
!Mittlere<br/> Anzahl Bytes zip+B64
 
|-
 
| style="text-align: right;" | 0
 
| style="text-align: right;" | 1
 
| style="text-align: right;" | 149.0
 
| style="text-align: right;" | 257.0
 
| style="text-align: right;" | 344.0
 
|-
 
| style="text-align: right;" | 1
 
| style="text-align: right;" | 8
 
| style="text-align: right;" | 334.9
 
| style="text-align: right;" | 388.6
 
| style="text-align: right;" | 519.0
 
|-
 
| style="text-align: right;" | 2
 
| style="text-align: right;" | 14
 
| style="text-align: right;" | 387.6
 
| style="text-align: right;" | 417.5
 
| style="text-align: right;" | 558.3
 
|-
 
| style="text-align: right;" | 3
 
| style="text-align: right;" | 13
 
| style="text-align: right;" | 415.4
 
| style="text-align: right;" | 425.7
 
| style="text-align: right;" | 568.9
 
|-
 
| style="text-align: right;" | 4
 
| style="text-align: right;" | 17
 
| style="text-align: right;" | 498.0
 
| style="text-align: right;" | 455.4
 
| style="text-align: right;" | 608.7
 
|-
 
| style="text-align: right;" | 5
 
| style="text-align: right;" | 20
 
| style="text-align: right;" | 508.3
 
| style="text-align: right;" | 460.9
 
| style="text-align: right;" | 615.6
 
|-
 
| style="text-align: right;" | 6
 
| style="text-align: right;" | 11
 
| style="text-align: right;" | 564.9
 
| style="text-align: right;" | 486.9
 
| style="text-align: right;" | 650.2
 
|-
 
| style="text-align: right;" | 7
 
| style="text-align: right;" | 15
 
| style="text-align: right;" | 621.1
 
| style="text-align: right;" | 498.7
 
| style="text-align: right;" | 666.7
 
|-
 
| style="text-align: right;" | 8
 
| style="text-align: right;" | 17
 
| style="text-align: right;" | 672.2
 
| style="text-align: right;" | 530.3
 
| style="text-align: right;" | 708.0
 
|-
 
| style="text-align: right;" | 9
 
| style="text-align: right;" | 22
 
| style="text-align: right;" | 730.6
 
| style="text-align: right;" | 544.0
 
| style="text-align: right;" | 726.7
 
|-
 
| style="text-align: right;" | 10
 
| style="text-align: right;" | 20
 
| style="text-align: right;" | 776.4
 
| style="text-align: right;" | 563.1
 
| style="text-align: right;" | 752.0
 
|-
 
| style="text-align: right;" | 11
 
| style="text-align: right;" | 13
 
| style="text-align: right;" | 803.5
 
| style="text-align: right;" | 562.6
 
| style="text-align: right;" | 751.7
 
|-
 
| style="text-align: right;" | 12
 
| style="text-align: right;" | 18
 
| style="text-align: right;" | 898.2
 
| style="text-align: right;" | 597.7
 
| style="text-align: right;" | 798.9
 
|-
 
| style="text-align: right;" | 13
 
| style="text-align: right;" | 8
 
| style="text-align: right;" | 860.6
 
| style="text-align: right;" | 585.1
 
| style="text-align: right;" | 782.0
 
|-
 
| style="text-align: right;" | 14
 
| style="text-align: right;" | 9
 
| style="text-align: right;" | 1104.3
 
| style="text-align: right;" | 669.1
 
| style="text-align: right;" | 893.8
 
|-
 
| style="text-align: right;" | 15
 
| style="text-align: right;" | 23
 
| style="text-align: right;" | 1078.8
 
| style="text-align: right;" | 620.3
 
| style="text-align: right;" | 828.0
 
|-
 
| style="text-align: right;" | 19
 
| style="text-align: right;" | 2
 
| style="text-align: right;" | 1167.5
 
| style="text-align: right;" | 710.0
 
| style="text-align: right;" | 948.0
 
|-
 
| style="text-align: right;" | 20
 
| style="text-align: right;" | 1
 
| style="text-align: right;" | 1179.0
 
| style="text-align: right;" | 713.0
 
| style="text-align: right;" | 952.0
 
|}
 
 
 
Bei den hier dokumentierten insgesamt 1.940 Medikamenten bei 232 Plänen sind dies im Mittel 8.3 Medikamente und 701 Bytes pro Patientenplan. Das Verhältnis von Nutzzeichen zu Overhead beträgt im Mittel etwa 1:1.
 
 
 
Es ist zu beachten, dass dies die Mittelwerte für die unkomprimierte Fassung ist und dass komprimieren (und anschließendem Kodieren in Base-64) in der Regel (118 von 232 Fällen) überhaupt eine Verkürzung und im Mittel keine Längenvorteile (ZIP + B64 waren sogar um den Faktor 1.07 größer) mehr bringt, da das Format ohnehin schon sehr kurz ist.
 
 
 
Aus weiteren Untersuchungen mit 40 Medikamenten geht hervor, dass sich das Format in komprimierter Form sowohl in XML als auch im etwas kürzeren JSON-Format selbst bei 40 Medikamenten (möglicher AMTS-Anwendungsfall) nicht über 6 kBytes gehen.
 
 
 
=Referenzen und Verzeichnisse=
 
==Referenzen==
 
<references/>
 
==Abbildungen==
 
<references group="Abbildung" />
 
== Tabellen==
 
<references group="Tabelle" />
 
 
 
=Anlagen=
 
==Referenz auf das XML-Schema==
 
Das für das Ultrakurzformat zusammengestellt W3C-Schema ist hier zu finden
 
* http://download.hl7.de/ukf/ukf201.xsd Ultrakurzformat Version 2.01 (23 kB)
 
==XML-Beispiele, Ausdrucke==
 
Die zum oben erwähnten Set gehörigen XML-Beispielsdokumente (alle im ISO/IEC 8859-1 Zeichensatz wie gefordert) sowie die zugehörigen PDFs als ausgedruckter Plan finden sich hier:
 
*[[Datei:Document_ZIP.svg|16px]] http://download.hl7.de/ukf/Testfaelle_ukf201.zip Testfälle ZIP-Datei (226 kB)
 
*[[Datei:Document_PDF.svg|16px]] http://download.hl7.de/ukf/Testfaelle_ukf201.pdf Ausdruck Testfälle als PDF (26 MB)
 
 
 
==Vollständiges XML-Beispiel==
 
 
 
{{BeginGreenBox|Ultrakurzformat}}
 
Nachfolgend ein vollständiges Beispiel, das allerdings aus Darstellungs- und Lesbarkeitsgründen umgebrochen ist. Bitte beachten, dass im ISO/IEC 8859-1 Zeichensatz gar keine Zeilenumbrüche (Newline, Linefeed) etc. vorkommen.
 
<syntaxhighlight lang="xml" >
 
 
<MP v="1" u="MPP" U="CA620D79D334428CBA6203181EAA1378" l="de-DE">
 
<MP v="1" u="MPP" U="CA620D79D334428CBA6203181EAA1378" l="de-DE">
     <P t="Prof. Dr. med." g="Ivan" z="Freiherr" v="von und zu" f="Ivanov" s="M" egk="F994842101" b="1958-02-13"/>
+
     <P t="Prof. Dr. med." g="Ivan" z="Freiherr" v="von und zu" f="Ivanov"
     <A n="Sonnen-Apotheke" idf="3379589" s="Musterweg 1" z="01662" c="Meißen" p="03521-1234567" e="sonnen-apotheke@meissen.de" t="2017-07-15T10:11:12"/>
+
      s="M" egk="F994842101" b="1958-02-13"/>
 +
     <A n="Sonnen-Apotheke" idf="3379589" s="Musterweg 1" z="01662" c="Meißen"
 +
      p="03521-1234567" e="sonnen-apotheke@meissen.de" t="2017-07-15T10:11:12"/>
 
     <O w="102" h="175"/>
 
     <O w="102" h="175"/>
 
     <AI t="Penicillin">
 
     <AI t="Penicillin">
Zeile 1.554: Zeile 800:
 
     </S>
 
     </S>
 
     <S c="418">
 
     <S c="418">
         <M id="5" p="2246627" i="bei Bedarf 1 Tablette, bevorzugt abends" r="Heuschnupfen" c="2017-07-15T10:05:17">
+
         <M id="5" p="2246627" i="bei Bedarf 1 Tablette, bevorzugt abends"
             <D t="siehe Hinweistext" du="1"/>
+
          r="Heuschnupfen" c="2017-07-15T10:05:17">
 +
             <D t="siehe Hinweistext" du="1"/>
 
         </M>
 
         </M>
         <M id="6" p="3436979" i="bei Bedarf (Pollenflug) morgens und abends je 1 Sprühstoß pro Nasenloch" r="Heuschnupfen" c="2017-07-15T10:05:17">
+
         <M id="6" p="3436979"
 +
          i="bei Bedarf (Pollenflug) morgens und abends je 1 Sprühstoß pro Nasenloch"
 +
          r="Heuschnupfen" c="2017-07-15T10:05:17">
 
             <D m="1" v="1" du="o"/>
 
             <D m="1" v="1" du="o"/>
 
         </M>
 
         </M>
         <M id="7" p="4512286" i="Behandl. fortsetzen; mind. 2x/Woche auf erkrankten Nagel auftragen" r="Nagelpilz" c="2017-07-15T10:05:17">
+
         <M id="7" p="4512286"  
             <D t="siehe Hinweistext"/>
+
          i="Behandl. fortsetzen; mind. 2x/Woche auf erkrankten Nagel auftragen"
 +
          r="Nagelpilz" c="2017-07-15T10:05:17">
 +
             <D t="siehe Hinweistext"/>
 +
        </M>
 +
        <R id="8"
 +
          t="Pflegecreme (Basiscreme DAC, Nachtkerzenöl 10%)  -- täglich auf die betroffenen Stellen --"
 +
          c="2017-07-15T10:05:17"/>
 +
    </S>
 +
</MP>
 +
</syntaxhighlight>
 +
 
 +
===Sandra Sandfrau===
 +
<syntaxhighlight lang="xml">
 +
<MP v="1" u="MPP" U="56DEC1A02F9340A1BA73704ABEF8B704" l="de-DE">
 +
    <P g="Sandra" f="Sandfrau" egk="N454842101" b="1984-10-19"/>
 +
    <A n="Praxis Dr. Michael Wüster"
 +
      s="Hauptstr. 8" z="10555" c="Berlin"
 +
      p="030-1234568" e="dr.wuetser@kbv-net.de" t="2017-07-15T12:59:12"/>
 +
    <O w="80" h="171" p="1" c="1.3"/>
 +
    <AI t="Penicillin">
 +
        <s s="Penicillin" sc="J01C" dc="I12829" c="H" r="Ausschlag"/>
 +
    </AI>
 +
    <S c="411">
 +
        <M id="1" p="55509" c="2017-07-15T11:02:14"
 +
          me="2017-07-31T00:00:00" i="kompletter Sprühstoß" r="Heuschnupfen">
 +
          <D m="1" d="1" v="1" du="5"/>
 
         </M>
 
         </M>
         <R id="8" t="Pflegecreme (Basiscreme DAC, Nachtkerzenöl 10%)  -- täglich auf die betroffenen Stellen --" c="2017-07-15T10:05:17"/>
+
    </S>
 +
    <S t="Bitte beachten">
 +
         <X id="10" t="Bitte melden Sie sich sobald die Beschwerden nach 2 Wochen nicht nachlassen."
 +
          c="2017-07-15T11:02:14"/>
 
     </S>
 
     </S>
 
</MP>
 
</MP>
 
</syntaxhighlight>
 
</syntaxhighlight>
{{EndGreenBox}}
 

Aktuelle Version vom 9. Oktober 2018, 14:46 Uhr

Ultrakurzformat

Das Ultrakurzformat ist eine Familie von Struktur und Semantikvorgaben für die Wiedergabe von Gesundheitsinformationen auf "kleinstem Raum".

Die hier vorgestellten Ultrakurzformate

  • Ultrakurzformat Patientenorientierter Medikationsplan Plus (UKF-PMPP) für die inhaltliche Wiedergabe von Medikationsplänen
  • Ultrakurzformat Patientenorientierter Medikationsplan Plus Referenz (UKF-REF) für die Wiedergabe von Referenzen auf Medikationspläne

beruhen auf den zuvor vorgestellten FHIR-Profilen bzw. Vorarbeiten davon und wurde in einer angepassten Form auch als Technische Spezifikation für das Barcode-Format des Bundeseinheitlichen Medikationsplan verwendet. Der UKF-PMPP ist eine Fortschreibung des 2016 veröffentlichten UKF-PMP[1].

Die Ultrakurzformate sind nicht nur für den Barcode, sondern auch für die eGK und andere von der Kapazität her eingeschränkte Medien nutzbar. Mit der eGK soll es – so der Plan – zum Beispiel möglich sein, bis zu 40 Arzneimittel zu speichern und auch bisherige nicht mehr aktuell eingenommene bzw. abgesetzte Medikamente oder jedenfalls nicht einzunehmende Substanzen (zum Beispiel wegen Unverträglichkeiten oder Allergien) wiederzugeben.

Nichtsdestoweniger kann zumindest das Ultrakurzformat zur inhaltliche Wiedergabe von Medikationsplänen als zeitliche Zwischenlösung angesehen werden, denn mit dem Vorhandensein von Infrastrukturen zum Datenaustausch wie zum Beispiel einer Telematik-Infrastruktur und/oder der Verfügbarkeit mobiler Lösungen, gelten inhaltliche vollständige Wiedergaben von Inhalten obsolet.

Bezug des Ultrakurzformats zum Basisstandard FHIR

Allen Ultrakurzformaten ist gemein, dass sie auf FHIR bzw. FHIR-Profilen wie die in diesem Leitfaden vorgestellten beruhen, zum Beispiel Patient, AllergyIntolerance und MedicationStatement. Dabei wurden die üblichen Aspekte und Freiheiten in den Resources zunächst eingeschränkt und vorab in den Kurzformat-FHIR-Profilen festgelegt, dass die eigentlichen Instanzen („die Daten“) außerordentlich kurz gehalten werden können.

Das Ultrakurzformat reduziert dann von den FHIR-Profil-Definitionen ausgehend schließlich auf sehr kurze XML-Elemente und -Attribute, die in einer eins-zu-eins Beziehung zum zugrundeliegenden FHIR-Profil stehen. Dadurch können FHIR-Instanzen, die nach den Kurzformat-FHIR-Profilen erstellt sind und die Ultrakurzformat-Instanzen leicht ineinander überführt werden (Bijektivität).

Als Beispiel sei hier genannt, dass man bei der Übermittlung von Codes immer mit angeben muss, aus welchem Codesystem der Code entnommen wurde. Anders ließe sich der Code nicht korrekt interpretieren. Wird nun vorab (im Kurzformat-FHIR-Profil) festgelegt, dass an bestimmten Stellen nur Codes aus ganz bestimmten Codesystemen zur Anwendung kommen dürfen, erübrigt sich die Mitlieferung des Codesystems in der Instanz selbst (so genannte „kurze Terminologiebindung“).

Ähnliches gilt für bestimmte Dosierungsmuster, die festliegen. Die Angabe „morgens“ bedeutet an sich „Medikament morgens einnehmen („wann“) und dies jeden Tag wiederholen („repeat, period 1 d). Diese Statements können sich auf das „wann“ beschränken, denn dass sich dies (innerhalb ggf. vorgegebener Einnahmedauer-Grenzen) täglich wiederholt, ist bei diesem Muster klar.

Das bedeutet auch, dass Instanzen im Ultrakurzformat aufgrund der Einheit von Instanz und Kurzformat-FHIR-Profil nur durch die langen Strukturen und die im Profil definierten Festlegungen ergänzt werden müssen, um auch außerhalb der Spezifikation des Ultrakurzformats vollwertig gemäß dem allgemeinen FHIR-Profil für den Medikationsplan zu sein (vgl. auch folgende Tabelle).

Vollwertige und übliche FHIR Beispiele zum normalen Gebrauch in FHIR-Anwendungen Beispiel Ultrakurzformat mit sehr
kurzen XML-Elementen und -Attributen
<Bundle xmlns="http://hl7.org/fhir">
   <meta>
      <profile value="http://fhir.de/.../bundle"/>
   </meta>
   <type value="document"/>
   <entry>
      <fullUrl value="http://.../2aca0674..."/>
      <resource>
         <Composition>
            <meta>
               <profile value="http://fhir.de/.../composition"/>
            </meta>
            <identifier>
               <system value="http://mp.de/composition-identifier"/>
               <value value="2aca0674..."/>
            </identifier>
            <type>
               <coding>
                  <system value="http://loinc.org"/>
                  <code value="X_PMR"/>
               </coding>
            </type>
            <title value="Patientenbezogener Medikationsplan Plus"/>
            ...
            <status value="final"/>
            <confidentiality value="N"/>
        ...
</Bundle>
<MP v="1" u="MPP" 
    U="CA620D79D334428CBA6203181EAA1378"
    l="de-DE">
...
</MP>
<Observation>
    <meta>
        <profile value="http://fhir.hl7.de/.../bodyweight"/>
    </meta>
    <status value="final"/>
    <code>
        <coding>
            <system value="http://loinc.org"/>
            <code value="29463-7"/>
            <display value="Body weight"/>
        </coding>
    </code>
    <valueQuantity>
        <value value="89"/>
        <unit value="kg"/>
        <system value="http://unitsofmeasure.org"/>
        <code value="kg"/>
    </valueQuantity>
</Observation>
<O w="89" .../>
<Patient>
    <meta>
        <profile value="http://fhir.de/.../patient"/>
    </meta>
    <identifier>
        <system value="http://fhir.de/NamingSystem/gkv/kvid-10"/>
        <value value="G995030567"/>
    </identifier>
    <active value="true"/>
    <name>
        <text value="Dr. med. Maximilian Prinz von und zu Mustermännchen" />
        <family value="Prinz von und zu Mustermännchen">
            <extension url="http://fhir.de/.../humanname-namenszusatz">
                <valueString value="Prinz" />
            </extension>
            <extension url="http://hl7.org/fhir/.../humanname-own-prefix">
                <valueString value="von und zu" />
            </extension>
            <extension url="http://hl7.org/fhir/.../humanname-own-name">
                <valueString value="Mustermännchen" />
            </extension>
        </family>
        <given value="Maximilian"/>
        <prefix value="Dr. med.">
            <extension url="http://hl7.org/fhir/S...n/iso21090-EN-qualifier">
                <valueString value="AC"/>
            </extension>
        </prefix>
    </name>
    <gender value="male"/>
    <birthDate value="1970-03-04"/>
    <communication> 
        <language> 
          <coding> 
            <system value="urn:ietf:bcp:47"/> 
               <!-- IETF language tag -->
               <code value="de-DE"/> 
               <display value="Deutsch"/> 
          </coding> 
          <text value="Deutsch"/> 
        </language> 
        <preferred value="true"/> 
    </communication> 
</Patient>
<P egk="G995030567"
   t="Dr. med." g="Maximilian" z="Prinz"
   v="von und zu" f="Mustermännchen" 
   s="M" b="1970-03-04" cl="de-DE"/>
<MedicationStatement>
  ...
  <repeat>
      <period value="1"/>
      <periodUnits value="d"/>
      <when value="CM"/>
  </repeat>
  <doseQuantity>
      <value value="1"/>
      <system value="http://standardterms.edqm.eu"/>
      <code value="10210000"/>
  </doseQuantity>
    ...
</MedicationStatement>
...
<Medication>
  ...
  <code>
    <coding>
      <system value="http://www.ifaffm.de/pzn"/>
        <code value="0940890"/>
        <display value="Ferro sanol duodenal mite 50mg "/>
      </coding>
    </code>
</Medication>
<M id="1" p="0940890" r="Eisenmangel"
   c="2017-07-15T10:05:17">
   <D m="1" du="10210000"/>
</M>

Auf die Wiedergabe von Text-Elementen wie sie in FHIR definiert bzw. gefordert sind, um eine insgesamt lesbare Form der maschinenlesbaren Informationen anzugeben, wird im Ultrakurzformat ebenfalls verzichtet. Das käme der Tatsache gleich, dass das Barcode oder eGK-Format neben dem maschinenlesbaren Teil das Ganze auch noch als Text mit Aufmachung (Layout, Tabellenform etc.) wiedergibt, was außerhalb der Zielsetzung dieses Formats liegt.

Textwiedergaben können aber sowieso jederzeit aus den maschinenlesbaren Informationen generiert werden. Auch hierfür finden sich Beispiele für solche Transformationen in den Materialien.

Übersicht über die Komponenten des Ultrakurzformat Patientenorientierter Medikationsplan (UKF-PMPP)

Zur vereinfachten Übersicht sind im Folgenden die Elemente des Ultrakurzformats für den Medikationsplan Plus schematisch dargestellt.

Pmp-ukfpmppuebersicht.png

Pmp-ukfpmppuebersicht.png

[Abbildung 1] Übersicht über die Elemente des Ultrakurzformats für den Medikationsplan Plus

Root-Element Medikationsplan (MP)

Das "Root"-Element des Medikationsplan Plus im Ultrakurzformat heißt MP (ebenso wie bei anderen Medikationsplänen). Es kommt der FHIR-Kombination von Bundle und Composition gleich und vereint in sich

  • Informationen zum Medikationsplan selbst, z. B. Medikationsplan-Identifikation
  • den Patienten um den es geht
  • zum Ersteller/Ausdruckenden
    • Abschnitte (section) mit den Daten über
    • Klinische Parameter
    • Allergien und Unverträglichkeiten
    • Gesundheitsbelangen
    • Aktuelle Medikation (Medikamentenliste)
    • Wichtige Angaben / Instruktionen.

Im Ultrakurzformat wird das FHIR Bundle+Composition mitsamt LOINC Code für den Dokumententyp und die hier beschriebene Composition (das Dokument) "ineinandergeschoben" und in einem einzigen Element repräsentiert. Auch auf die Angabe eines XML-Namespaces wird verzichtet, dieser ist für das Ultrakurzformat xmlns="http://fhir.hl7.de/ukfc".

<MP 
  <MP v="1" u="MPP" U="56DEC1A02F9340A1BA73704ABEF8B704" l="de-DE">
  ...
</MP>

Dabei bedeuten:

Element/Attribut Kardinalität Beschreibung
MP 1..1 Root-Element (Bundle+Composition): Medikationsplan Ultrakurzformat
Treetree.png@v 1..1 Version der Spezifikation des Medikationsplans Plus, zurzeit fixiert auf "1"
Treetree.png@u 1..1 Type der Spezifikation des Medikationsplans, zurzeit fixiert auf "MPP" (Medikationsplan Plus)
Treetree.png@U 1..1 konkrete Instanz-ID des Plans (gleich für alle Seiten des Plans); hier wird eine UUID ohne "-" Trennzeichen und A-F als Buchstaben verwendet
Treetree.png@a 0..1 Aktuelle Seite, mit 1 startend; nur bei mehrseitigen Plänen zu verwenden
Treetree.png@z 0..1 Gesamtseitenanzahl; nur bei mehrseitigen Plänen zu verwenden
Treetree.png@l 0..1 Sprache des Plans im Format ss-CC (nach BCP-47, http://tools.ietf.org/html/bcp47), z. B. "de-DE", "de-CH", "en-US" etc.

Im folgenden Auszug ist gezeigt, wie der Patient (P) und der Ersteller/Autor (A) und weiteren Informationen (O) und (AI) als Kind-Elemente innerhalb des eben beschriebenen Bundle+Composition-Elements für den Medikationsplan (MP) eingebettet sind.

<MP ...>
    <P .../>
    <A .../>
    <O .../>
    <AI .../>
    <S>
        <M>
            <D .../>
            <W .../>
        </M>
    </S>
</MP>

Diese Kind-Elemente werden im Detail in den folgenden Abschnitten beschrieben.

Patient (P)

Im Ultrakurzformat wird der Patient in einem einzigen Element repräsentiert:

<P g="Michael" f="Mustermann" egk="G996253153" s="M" b="1950-01-22"/>
<P t="Dr." g="Jürgen" z="Graf" v="von und zu" f="Wernersen" b="1940-03-24" egk="A123456789" s="M"/>

Dabei bedeuten:

Element/Attribut Kardinalität Beschreibung
P required Element (Patient)
Treetree.png@t 0..1 Titel des Patienten, z. B. "Dr."
Treetree.png@g 1..1 Vorname(n) des Patienten
Treetree.png@z 0..1 Namenszusatz des Patienten, z. B. "Gräfin"
Treetree.png@v 0..1 Vorsatzwort des Patienten, z. B. "von"
Treetree.png@f 1..1 Familienname(n) des Patienten
Treetree.png@egk 0..1 eGK-Nummer (optional), Format: A000000000)
Treetree.png@s optional Geschlecht des Patienten (M, F, UN). Dieses Feld ist kodiert und kommen aus dem Value Set AdministrativeGender welches auch für die CDA-Fassung verwendet wird.
Treetree.png@b optional Geburtsdatum des Patienten, Formate: YYYY-MM-DD, YYYY-MM (wenn Tag nicht bekannt), YYYY (wenn Monat und Tag nicht bekannt)

Autor/Ersteller/Ausdruckender (A)

Im Ultrakurzformat wird der Autor in einem Element und Kind-Elementen repräsentiert:

 <A n="Dr. Fritz Überall"
    s="Hauptstraße 55" z="01234" c="Am Ort"
    lanr="1656304456" 
    p="04562-12345" e="f.ueberall@mein-netz.de" t="2016-02-16"/>
<A n="Praxis Dr. Michael Müller"
   s="Schloßstr. 22" z="10555" c="Berlin"
   p="030-1234567" e="dr.mueller@kbv-net.de" t="2017-07-15T12:59:12"/>
<A n="Sonnen-Apotheke" 
   s="Musterweg 1" z="01662" c="Meißen"
   idf="3379589" 
   p="03521-1234567" e="sonnen-apotheke@meissen.de" t="2017-07-15T10:11:12"/>

Dabei bedeuten:

Element/Attribut Kardinalität Beschreibung
A Element (Autor)
Treetree.png@n 1..1 Name der aktuell ausdruckende Instanz (Einrichtung, Leistungsträger)
Treetree.png@s 0..1 Straße
Treetree.png@z 0..1 Postleitzahl
Treetree.png@o 0..1 Ort
Treetree.png@p 0..1 Telefonnummer
Treetree.png@e 0..1 Emailadresse
Treetree.png@lanr 0..1 Lebenslange Arztnummer LANR
Treetree.png@idf 0..1 7-stellige Apothekenidentifikationsnummer
Treetree.png@kik 0..1 9-stellige Krankenhaus IK-Nummer
Treetree.png@t 1..1 Ausdruckdatum, Format YYYY-MM-DD oder YYYY-MM-DDThh:mm:ss

Custodian

Die Organisation, die mit der Verwaltung des Dokument betraut ist (custodian) wird im UKF zurzeit nicht repräsentiert.

Abschnitte

Schließlich folgen die vier Abschnitte (Sections, analog zu der CDA- und FHIR-Definition).

Section LOINC-Code
Klinische Parameter (Körpergewicht, Kreatinin, …) 55752-0
Gesundheitsbelange (schwanger?, Entbindungstermin, stillend?) 75310-3
Allergien und Unverträglichkeiten 48765-2
Aktuelle Medikation 19009-0
Wichtige Angaben / Instruktionen 69730-0

[Tabelle 1] LOINC-Codes der eingesetzten Sections

Im Ultrakurzformat werden die Klinischen Parameter (Section), Gesundheitsbelange in einem einzigen Element (O) zusammengefasst und repräsentiert, da es sich um Beobachtungen (Observation) handelt.

Observation

Im Ultrakurzformat werden die Klinischen Parameter und Gesundheitsbelange (siehe unten) in einem einzigen Element repräsentiert (es sind hier mehrere Beispiele aufgeführt).

<O w="89" h=177 c="1.3" p="1"/>
<O h="180" w="80" edd="2017-08-30"/>
<O w="102">

Dabei sind die Einheiten zu Messwerten weggelassen, die Messwerte MÜSSEN den in der im Folgenden gezeigten Tabelle aufgeführten Einheiten ausgedrückt sein. Darüber hinaus kann für weitere Angaben Freitext benutzt werden.

Parameter LOINC-Code Meßwert-Einheit (UCUM)
Körpergewicht 29463-7 kg
Körpergröße 8302-2 cm
Kreatinin 2160-0 mg/dl

[Tabelle 2] LOINC-Codes und Einheiten der eingesetzten Observations bei den Klinischen Parametern

Dabei bedeuten:

Element/Attribut Kardinalität Beschreibung
O optional Element (Observation)
Invariante INV-O-1: mindestens ein Attribut muss genannt sein, ansonsten muss das Element O weggelassen werden
Treetree.png@w 0..1 Gewicht [kg], Druck "Gew.: x kg"
Treetree.png@h 0..1 Größe [cm], Druck "Größe: x cm"
Treetree.png@c 0..1 Kreatinin [mg/dl], Druck "Kreatinin: x mg/dl"
Treetree.png@p 0..1 schwanger, Regel: wenn schwanger p="1", sonst weglassen
Treetree.png@edd 0..1 Erwarteter Geburtstermin, Format YYYY-MM-DD
Treetree.png@b 0..1 stillend, Regel: wenn stillend b="1", sonst weglassen
Treetree.png@x 0..1 zusätzlicher Freitext

Allergien und Unverträglichkeiten (AI)

Im Ultrakurzformat werden die Allergien und Unverträglichkeiten mit dem Element AI wiedergegeben. Typisch ist dabei, dass im einfachsten Fall nur ein Freitext die Allergien/Unverträglichkeiten beschreiben. Bei entsprechender Fähigkeit des Systems kann zusätzlich eine Liste jeweils mit dem Agens, Codes, der Kritikalität (Bedrohlichkeit) und der Reaktion wiedergegeben werden.

<AI t="Erdnuss, Erdbeer"/>
<AI t="Erdnuss, Erdbeer">
    <s s="Erdbeeren" r="Hautrötung"/>
    <s s="Erdnuss" c="H" dc="I120131" r="Schock"/>
</AI>

Dabei bedeuten:

Element/Attribut Kardinalität Beschreibung
AI 0..1 Element (Allergy/Intolerance)
Treetree.png@t 1..1 Das Attribut t (im Vorformat UKF-PMP O.ai) wird hier durch Zusammenfassen der Elemente s abgeleitet
Treetree.pngs 0..* Element zur Aufnahme von Informationen über das Agens, das Allergie/Unverträglichkeit auslöst
Invariante INV-AI-1: Mindestes ein Attribut @s, @sc, @d oder @dc muss aufgeführt sein
Treeblank.pngTreetree.png@s 0..1 Auslösendes Agens im Freitext
Treeblank.pngTreetree.png@sc 0..1 Auslösendes Agens, codiert, siehe Anmerkung 1
Treeblank.pngTreetree.png@d 0..1 Diagnose im Freitext
Treeblank.pngTreetree.png@dc 0..1 Diagnosecode der Allergie/Unverträglichkeit, codiert, siehe Anmerkung 2
Treeblank.pngTreetree.png@c 0..1 Kritikalität der Allergie/Unverträglichkeit, codiert, siehe Anmerkung 3
Treeblank.pngTreetree.png@r 0..1 Reaktion auf die Allergie/Unverträglichkeit im Freitext
Treeblank.pngTreetree.png@rc 0..1 Reaktion auf die Allergie/Unverträglichkeit, codiert, siehe Anmerkung 4

Anmerkungen

  • 1: bisher ist hier keine feste Terminologie vorgesehen
  • 2: hier ist die Alpha-ID vorgesehen, Value Set Allergien/Unvertäglichkeiten
  • 3: hier ist als Terminologie ein Value Set für die Kritikalität vorgesehen
  • 4: bisher ist hier keine feste Terminologie vorgesehen

Gesundheitsbelange

Im Ultrakurzformat werden die Gesundheitsbelange (Section) im O-Element (siehe Observation) mitgegeben.

Parameter LOINC-Code Mögliche Werte Repräsentieren im Element "O"
Schwanger 11449-6 laut Value Set Schwangerschafts-Status @p=1, wenn nicht schwanger wird p weggelassen
Erwarteter Geburtstermin 11778-8 Zeitangabe (Datum) @edd="..."
Stillend 63895-7 @b=1, wenn nicht stillend wird b weggelassen

[Tabelle 3] LOINC-Codes und Wertemöglichkeiten der eingesetzten Observations bei den Gesundheitsbelangen

Abschnitt „Aktuelle Medikation“

Der eigentliche Medikationsplan mit allen Angaben wird an einer Section festgemacht. Im Ultrakurzformat werden die Medikationsdaten (Section) in einem Element (M) mit möglichen Kind-Elementen repräsentiert. Medikationsdaten werden dabei in Blöcken zusammengefasst (S), die einen Titel (ggf. auch als Kode) enthalten können

<S c="412">
  <M p="2532770" fd="TAB" m="1"/>
  <M p="4261973" fd="RET" i="bei Bedarf"/>
</S>
<S t="Fremdmedikation">
  <M p="3576232" fd="FTA" m="1"/>
  <M p="940890" fd="KMP" d="1"/>
</S>

Dabei bedeuten:

Element/Attribut Kardinalität Beschreibung
S Block-Element
Treetree.png@c Titelcode des Abschnitts siehe Anmerkung 1
Invariante INV-S-1: @t und @c DARF NICHT gleichzeitig angegeben werden
Treetree.png@t Titel des Abschnitts Invariante INV-S-1: @t und @c DARF NICHT gleichzeitig angegeben werden
Treetree.png M oder X Kind-Elemente MedicationStatement/Freitextangaben als Kindelement, siehe unten

Anmerkungen:

Die Kind-Elemente (MedicationStatement/Freitextangaben) werden im Folgenden im Detail beschrieben.

Medication Statement: Arzneimittel, Wirkstoffe (M)

Die gerade beschriebene Section zur Medikamentenliste fasst schließlich die Details zu den Medikamenten-Einträgen zusammen. Diese enthält eine Referenz auf den Patienten.

Im Ultrakurzformat werden die Medikation (MedicationStatement) in einem einzigen M-Element repräsentiert, welche von einem Block-Element (S, siehe oben) umklammert sind.

Die Dosierung (D) und die Wirkstoffe (W) werden in Kind-Elementen zu M wiedergegeben.

Freitextangaben (X) können ebenfalls eingestreut sein.

Im Folgenden sind mehrere Beispiele aufgeführt.

<M id="1" p="230272" r="Herz/Blutdruck">
   <D m="1"/>
</M>
<M id="2" p="5988884" fd="Pflaster" i="alle 3 Tg erneuern auf anderer Hautstelle"/>
<M id="3" c="2016-01-01T12:45:00" p="558736"
   i="Wechseln der Injektionsstellen, unmittelbar vor einer Mahlzeit spritzen" r="Diabetes">
   <D m="20" v="20" du="p"/>
</M>
<M id="4" p="6322472" c="2017-07-15T10:05:17"
   i="vom 27.06.2013, Dr. Ansgard Müller">
   <D t="0,5-0-0-0-0,5-0" du="1"/>
</M>
<M id="5" c="2017-07-15T11:02:14"
   ms="2017-07-15T15:00:00" me="2017-07-20T15:00:00"
   f="SUS"
   i="für 5 Tage (1 Messlöffel=5ml)" r="Harnwegsinfekt">
   <D t="alle 8 Stunden 1" du="#"/>
   <W w="Trimethoprim" s="40" su="mg"/>
   <W w="Sulfamethoxazol" s="200" su="mg"/>
</M>

Dabei bedeuten:

Element/Attribut Kardinalität Beschreibung
M 0..* Medikation, Element (MedicationStatement)
Invariante INV-MS-1: mindestens ein Attribut oder Wirkstoffe (W Kind-Elemente) müssen angegeben sein
Treetree.png@id 1..1 Relative Id des Medikamenteneintrags im Plan, soll eine ganze positive Zahl sein und ergibt zusammen mit der ID des gesamten Planes eine eindeutige Identifikation des Medikations-Eintrags
Treetree.png@c 1..1 Erzeugungsdatum des Medikamenteneintrags, Format YYYY-MM-DDThh:mm:ss
Treetree.png@p 0..1 die Pharmazentralnummer PZN, falls angegeben
Treetree.png@a 0..1 Handelsname, entweder definiert oder fehlend (dann bei Ausdruck ggf. aus PZN abgeleitet)
Treetree.png@f 0..1 Darreichungsform, siehe Anmerkung 1, entweder definiert oder fehlend (dann bei Ausdruck ggf. aus PZN abgeleitet)
Invariante INV-MS-2: @f und @fd DARF NICHT gleichzeitg angegeben werden
Treetree.png@fd 0..1 Darreichungsform als Freitext, entweder definiert oder fehlend (dann bei Ausdruck ggf. aus PZN abgeleitet)
Invariante INV-MS-2: @f und @fd DARF NICHT gleichzeitg angegeben werden
Treetree.png@ms 0..1 Start der Medikamenteneinnahme, Format YYYY-MM-DDThh:mm:ss
Treetree.png@me 0..1 Ende der Medikamenteneinnahme, Format YYYY-MM-DDThh:mm:ss
Treetree.png@i 0..1 Hinweise/Instruktionen an den Patienten für die Einnahme, zum Beispiel "morgens nüchtern 30 min vor dem Frühstück"
Treetree.png@r 0..1 Grund für die Einnahme im Freitext
Treetree.pngD 0..* Kind-Element(e): Dosierung.
Treeblank.pngTreetree.png@m 0..1 Dosierung für "morgens", wenn nicht angegeben = "0"
Invariante INV-MS-3: @m DARF NICHT gleichzeitig mit @t angegeben werden
Treeblank.pngTreetree.png@d 0..1 Dosierung für "mittags", wenn nicht angegeben = "0"
Invariante INV-MS-4: @d DARF NICHT gleichzeitig mit @t angegeben werden
Treeblank.pngTreetree.png@v 0..1 Dosierung für "abends", wenn nicht angegeben = "0"
Invariante INV-MS-5: @v DARF NICHT gleichzeitig mit @t angegeben werden
Treeblank.pngTreetree.png@h 0..1 Dosierung für "zur Nacht", wenn nicht angegeben = "0"; wenn dieses Feld leer gedruckt werden soll muss " " (Leerzeichen) angegeben werden;
Invariante INV-MS-6: @h DARF NICHT gleichzeitig mit @t angegeben werden
Treeblank.pngTreetree.png@du 0..1 Dosiereinheit kodiert
Invariante INV-MS-7: @du DARF NICHT gleichzeitig mit @dud angegeben werden
Treeblank.pngTreetree.png@dud 0..1 Freitext Dosiereinheit
Invariante INV-MS-7: @du DARF NICHT gleichzeitig mit @dud angegeben werden
Treeblank.pngTreetree.png@t 0..1 Freitextdosierung
Invariante INV-MS-8: @t DARF NICHT gleichzeitig mit den Attributen @m, @d, @v oder @h angegeben werden
Treetree.pngW 0..* Kind-Element(e): Wirkstoff. Bei Kombipräperaten für jede Komponente ein Eintrag, im Druck n Zeilen.
Invariante INV-MS-9: Ein leeres Element ist nicht erlaubt
Treeblank.pngTreetree.png@w 0..1 Wirkstoffname, entweder definiert oder fehlend (dann bei Ausdruck ggf. aus PZN abgeleitet)
Treeblank.pngTreetree.png@ask 0..1 ASK-Nummer zur Definition eines Wirkstoffs
Invariante INV-W-1: @ask DARF NICHT zusammen mit PZN M.@p angegeben werden, siehe Anmerkung 2
Treeblank.pngTreetree.png@atc 0..1 ATC-Code zur Spezifizierung eines Wirkstoffs, siehe Anmerkung 2
Treeblank.pngTreetree.png@s 0..1 Stärke, entweder definiert oder fehlend (dann bei Ausdruck ggf. aus PZN abgeleitet)
Treeblank.pngTreetree.png@su 0..1 Wirkstärke Einheit, entweder definiert oder fehlend (dann bei Ausdruck ggf. aus PZN abgeleitet)

Anmerkungen:

Zu beachten ist, dass die im Folgenden beschriebenen Angaben zum Medikament hier bereits enthalten sind.

Für die Dosierangaben in den Attributen @m, @d, @v und @h sind folgende Angabemuster und -werte zulässig:

dddd mit d als Ziffer 1-9, bis zu vier Ziffern
d,dd mit d als Ziffer 0-9, max. zwei Nachkommastellen
1/2 für ein Halb
2/3 für zwei Drittel
1/3 für ein Drittel
1/4 für ein Viertel
1/8 für ein Achtel

Freitextangaben (X)

Freitextangaben, z.B. längere Anweisungen, bei Rezepten etc, werden im X-Element wiedergegeben. Der Text selbst ist @t-Attribut untergebracht. Im Folgenden sind mehrere Beispiele aufgeführt.

<X id="10" c="2017-07-15T14:02:14"
   t="Anordnung zur regelmäßigen Gewichtsbestimmung~Außerdem BMI und RR u. P"/>
<X id="3 c="2017-07-15T11:02:14"
   t="Analekzemsalbe Milch, Thesit 2.5 HC 0.25 Milch Cordes ad 50.0"/>

Dabei bedeuten:

Element/Attribut Kardinalität Beschreibung
X 0..* Freitext, darf max. 3 Umbrüche enthalten "~"
Treetree.png@id 1..1 Relative Id des Medikamenteneintrags im Plan, soll eine ganze positive Zahl sein und ergibt zusammen mit der ID des gesamten Planes eine eindeutige Identifikation des Medikations-Eintrags
Treetree.png@c 1..1 Erzeugungsdatum des Medikamenteneintrags, Format YYYY-MM-DDThh:mm:ss
Treetree.png@t 1..1 Freitext

Medication

Die Angaben zum Medikament beginnen typischerweise mit einem oder mehreren Codes für das Medikament.

Codierte Informationen zum Medikament (Medikamentencode) sind zum Beispiel als PZN (System-Identifier: http://www.ifaffm.de/pzn) oder als WHO-ATC-Code (System-Identifier: http://www.whocc.no/atc) anzugeben. Im Prinzip sind hier auch andere Medikamentencodes einsetzbar.

Die Angaben zum Medikament sind bereits unter Medication Statement (M-Element) beschriebenen.

Medication Statement: Rezepturen (R)

Für den Fall, dass das Medikament in der Liste kein Fertigarzneimittel ist, sondern beispielsweise eine Rezeptur, kann dies mit einem etwas verkürzten Medication Statement übermittelt werden.

Die Angaben zu einer Rezeptur sind bereits unter Medication Statement (M-Element) beschriebenen. Statt dem Element M wird aber das Element R verwendet.

<R id="8" t="Pflegecreme (Basiscreme DAC, Nachtkerzenöl 10%)  -- täglich auf die betroffenen Stellen --" c="2017-07-15T10:05:17"/>

Dabei bedeuten:

Element/Attribut Kardinalität Beschreibung
R 0..* Rezeptur-Eintrag, Element (MedicationStatement)
Treetree.png@... mögliche Attribute und Regeln sind die des Elements M

Abschnitt "Wichtige Angaben / Instruktionen" (X)

Schließlich können als letzte Section „Wichtige Angaben“ und „Instruktionen“ an den Patienten gegeben werden.

Im Ultrakurzformat werden die Wichtige Angaben / Instruktionen (Section) in einem Block-Element (S) mit Kode 422 (im Attribut @c) und einem X-Kindelement repräsentiert:

<S c="422">
   <X>Ganz wichtig: Impftermin am 15. März nicht vergessen!!!</X>
</S>

Die Elemente sind oben beschrieben.

Übersicht über den Aufbau des Ultrakurzformat Patientenorientierter Medikationsplan PLUS Referenz (UKF-REF)

Das zweite Ultrakurzformat referenziert lediglich einen Medikationsplan (auf einem Server), anstatt ihn inhaltlich weiterzugeben. Das UKF-REF beinhaltet dabei nur einen "Link" (Referenz Ressourcen-Speicherort) auf den Plan und eine Andeutung des zugehörigen Patienten.

<MPR v="1" u="MPP" U="800932EEB79D4F389CEA34427B54193D"
     url="https://mein.medikationsplan-plus.de/800932ee-b79d-4f38-9cea-34427b54193d">
     <P t="Prof. Dr. med." g="Ivan" z="Freiherr" v="von und zu" f="Ivanov"
        s="M" egk="F994842101" b="1958-02-13"/>
</MPR>
Element/Attribut Kardinalität Beschreibung
MPR 1..1 Referenz auf den Ressourcen-Speicherort
Treetree.png@v 1..1 Version der Spezifikation des Medikationsplans Plus, zurzeit fixiert auf "1"
Treetree.png@u 1..1 Type der Spezifikation des Medikationsplans, zurzeit fixiert auf "MPP" (Medikationsplan Plus)
Treetree.png@url 1..1 Link auf den Ressourcen-Speicherort zum Medikationsplan Plus des Patienten
Treetree.png@U 1..1 konkrete Instanz-ID des Plans (gleich für alle Seiten des Plans); hier wird eine UUID ohne "-" Trennzeichen und A-F als Buchstaben verwendet
Treetree.pngP 1..1 Angaben zum Patienten wie oben beschrieben; dieses Element dient nur der Identifizierung des Patienten in der Referenz
Mpr-qr-code-beispiel.png

Derartige Instanzen sind natürlich auch wesentlich kleiner, als wenn der QR-Code beispielsweise alle Daten des Medikationsplans weitergeben muss. Das oben gezeigte Beispiel würde in einem üblichen QR-Code so wie gezeigt aussehen. Das Lesen ist auch mit weniger guten Scannern möglich. Die Software würde den Server entsprechend anrufen um die Medikationsdaten zu erhalten. Bitte beachten Sie, dass dann die Daten auf dem Server auch nicht im Ultrakurzformat gespeichert werden müssten, sondern direkt in einer vollständigen FHIR-Fassung. Diese wäre im Übrigen identisch zu den zu einer mobilen App transportierten Inhalten.

Hinweise zu XML-Instanzen

Folgende Hinweise zur Erstellung von XML-Dokumentinstanzen von Medikationsplänen nach dieser Spezifikation sind zu beachten:

  • Als Zeichensatz ist für Medikationspläne nach dieser Spezifikation ausschließlich der Zeichensatz ISO/IEC 8859-1 (siehe auch [2]) inklusive aller Inhalte vorgeschrieben.
  • Es dürfen demnach keine nicht-spezifizierten Zeichen nach ISO/IEC 8859-1 (z. B. newline, tab) enthalten sein
  • Es wird kein XML-Prolog angegeben.
  • Demzufolge fehlen auch Encoding- und Versions-Deklarationen; beim Parsen ist anzunehmen, dass den XML-Instanzen <?xml version="1.0" encoding="ISO-8859-1"?> voransteht, beim Serialisieren muss der XML-Prolog weggelassen werden.
  • Es werden keine Namespaces im XML-Rootelement angegeben
  • Es werden keine Schemahinweise oder sonstige Attribute im XML-Rootelement angegeben
  • Es ist zu beachten, dass das Mikrozeichen µ im UTF-8 Encoding zweimal vorkommt und in das einzige Zeichen nach ISO/IEC 8859-1 umgewandelt wird
  • Nicht druckbare Zeichen sollen als "?" dargestellt werden.

Vollständige XML-Beispiele

Nachfolgend vollständige Beispiele zum UKF-PMPP, das allerdings aus Darstellungs- und Lesbarkeitsgründen umgebrochen ist. Bitte beachten, dass im ISO/IEC 8859-1 Zeichensatz gar keine Zeilenumbrüche (Newline, Linefeed) etc. vorkommen.

Prof. Dr. med. Ivan Freiherr von und zu Ivanov

<MP v="1" u="MPP" U="CA620D79D334428CBA6203181EAA1378" l="de-DE">
    <P t="Prof. Dr. med." g="Ivan" z="Freiherr" v="von und zu" f="Ivanov"
       s="M" egk="F994842101" b="1958-02-13"/>
    <A n="Sonnen-Apotheke" idf="3379589" s="Musterweg 1" z="01662" c="Meißen"
       p="03521-1234567" e="sonnen-apotheke@meissen.de" t="2017-07-15T10:11:12"/>
    <O w="102" h="175"/>
    <AI t="Penicillin">
        <s s="Penicillin" sc="J01C" dc="I12829" c="H" r="Ausschlag"/>
    </AI>
    <S>
        <M id="1" p="5701380" r="Schilddrüse" c="2017-07-15T10:05:17">
            <D m="1" du="1"/>
        </M>
        <M id="2" p="1016440" r="Bluthochdruck" c="2017-07-15T10:05:17">
            <D m="1" du="1"/>
        </M>
        <M id="3" p="602905" r="Magenbeschwerden" c="2017-07-15T10:05:17">
            <D m="1" du="1"/>
        </M>
        <M id="4" p="3436979"
           i="bei Bedarf (Pollenflug) morgens und abends je 1 Sprühstoß pro Nasenloch" 
           r="Heuschnupfen" c="2017-07-15T10:05:17">
            <D m="1" v="1" du="o"/>
        </M>
    </S>
    <S c="418">
        <M id="5" p="2246627" i="bei Bedarf 1 Tablette, bevorzugt abends"
           r="Heuschnupfen" c="2017-07-15T10:05:17">
            <D t="siehe Hinweistext" du="1"/>
        </M>
        <M id="6" p="3436979"
           i="bei Bedarf (Pollenflug) morgens und abends je 1 Sprühstoß pro Nasenloch"
           r="Heuschnupfen" c="2017-07-15T10:05:17">
            <D m="1" v="1" du="o"/>
        </M>
        <M id="7" p="4512286" 
           i="Behandl. fortsetzen; mind. 2x/Woche auf erkrankten Nagel auftragen"
           r="Nagelpilz" c="2017-07-15T10:05:17">
            <D t="siehe Hinweistext"/>
        </M>
        <R id="8"
           t="Pflegecreme (Basiscreme DAC, Nachtkerzenöl 10%)  -- täglich auf die betroffenen Stellen --"
           c="2017-07-15T10:05:17"/>
    </S>
</MP>

Sandra Sandfrau

<MP v="1" u="MPP" U="56DEC1A02F9340A1BA73704ABEF8B704" l="de-DE">
    <P g="Sandra" f="Sandfrau" egk="N454842101" b="1984-10-19"/>
    <A n="Praxis Dr. Michael Wüster"
       s="Hauptstr. 8" z="10555" c="Berlin"
       p="030-1234568" e="dr.wuetser@kbv-net.de" t="2017-07-15T12:59:12"/>
    <O w="80" h="171" p="1" c="1.3"/>
    <AI t="Penicillin">
        <s s="Penicillin" sc="J01C" dc="I12829" c="H" r="Ausschlag"/>
    </AI>
    <S c="411">
        <M id="1" p="55509" c="2017-07-15T11:02:14"
           me="2017-07-31T00:00:00" i="kompletter Sprühstoß" r="Heuschnupfen">
           <D m="1" d="1" v="1" du="5"/>
        </M>
    </S>
    <S t="Bitte beachten">
        <X id="10" t="Bitte melden Sie sich sobald die Beschwerden nach 2 Wochen nicht nachlassen."
           c="2017-07-15T11:02:14"/>
    </S>
</MP>
  1. Addendum zum Implementierungsleitfaden Patientenbezogener Medikationsplan: Ultrakurzformat für kapazitätslimitierte Datenträger (UKFPMP) http://wiki.hl7.de/index.php?title=IG:Ultrakurzformat_Patientenbezogener_Medikationsplan
  2. Zeichensatz ISO/IEC 8859-1 https://de.wikipedia.org/wiki/ISO_8859-1


Referenzfehler: Es sind <ref>-Tags für die Gruppe „Abbildung“ vorhanden, jedoch wurde kein dazugehöriges <references group="Abbildung" />-Tag gefunden oder ein schließendes </ref> fehlt.
Referenzfehler: Es sind <ref>-Tags für die Gruppe „Tabelle“ vorhanden, jedoch wurde kein dazugehöriges <references group="Tabelle" />-Tag gefunden oder ein schließendes </ref> fehlt.