[geprüfte Version] | [Markierung ausstehend] |
|
|
− | ==Dokumentenstruktur== | + | ==Übersicht der Zeitelemente im Header== |
− | ===XML Prolog (XML Metainformationen)===
| + | Dieses Kapitel gibt einen Überblick über die Elemente des CDA Headers mit Zeitangaben und ihre Zusammenhänge. |
− | ====Zeichencodierung====
| + | {{ILF:Übersicht der Zeitelemente im Header}} |
− | CDA-Dokumente MÜSSEN mit '''UTF-8''' (''8-Bit Universal Character Set Transformation Format'', nach RFC 3629 / STD 63 (2003)) codiert werden.
| + | </div> |
− | <pre class="ilfbox_code">
| + | <!-- Querformat --> |
− | <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
| + | <div class="landscape"> |
− | :
| |
− | </pre>
| |
− | | |
− | ====Hinterlegung eines Stylesheets====
| |
− | Um ein CDA-Dokument in einem Webbrowser anzeigen zu können, muss es nach HTML tranformiert werden. Das kann durch eine XSLT-Transformation (ein so genanntes "Stylesheet") geschehen. Ist das Stylesheet im angegebenen Pfad erreichbar, wird dieses beim Öffnen des CDA-Dokuments mit einem Browser üblicherweise automatisch auf das CDA-Dokument angewandt und die Darstellung gerendert.
| |
− | ELGA stellt zur einheitlichen Darstellung von CDA-Dokumenten ein "Referenz-Stylesheet" zur Verfügung (verfügbar unter http://www.elga.gv.at/cda). Da der Zugriff auf XSLT-Programme von den meisten Browsern eingeschränkt ist, wird kein absoluter Pfad auf eine Webressource angegeben.
| |
− | <pre class="ilfbox_code">
| |
− | <?xml-stylesheet type="text/xsl" href="ELGA_Stylesheet_v1.0.xsl"?>
| |
− | </pre>
| |
− | # Das Stylesheet MUSS angegeben werden '''''[M]'''''.
| |
− | # Die Angabe eines Pfades ist NICHT ERLAUBT.
| |
− | # Defaultwert ist <code>href="ELGA_Stylesheet_v1.0.xsl"</code>, ein anderes Stylesheet KANN in speziellen Leitfäden vorgeschrieben werden.
| |
− | | |
− | ===Wurzelelement clinicalDocument===
| |
− | CDA-Dokumente beginnen mit dem Wurzelelement '''''ClinicalDocument''''', der grobe Aufbau ist im folgenden Übersichtsbeispiel gegeben.
| |
− | Der XML-Namespace für CDA Release 2.0 Dokumente ist '''<nowiki>urn:hl7-org:v3</nowiki>''' (Default-Namespace). Dieser MUSS in jeder CDA XML Instanz genannt werden. Zusätzlich MÜSSEN für Schema-Erweiterungen folgende Namespaces angegenben werden: '''<nowiki>
| |
− | xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:pharm="urn:ihe:pharm:medication" xmlns:sdtc="urn:hl7-org:sdtc" xmlns:ips="urn:hl7-org:ips" xmlns:hl7at="urn:hl7-at:v3" </nowiki>'''
| |
− | {{BeginYellowBox}}
| |
− | '''Hinweis''': Die im Art-Decor vorgestellten Namespaces "hl7:" oder "cda:" werden nicht in den letztendlichen eHealth-Austria Dokumenten genutzt! Das HL7-International-Namespace, welches im Art-Decor unter "hl7:" oder "cda:" geführt wird, ist in den eHealth-Austria Dokumenten als Default-Namespace für alle eHealth-Austria-Dokumente geführt: "<ClinicalDocument xmlns="urn:hl7-org:v3" ... >". Somit ist bei Elementen, bei welchem das Namespace-Präfix weggelassen wurde, dieser sofort "urn:hl7-org:v3" - das Default-Namespace.
| |
− | {{EndYellowBox}}
| |
− | In speziellen Leitfäden können weitere neben den hier vordefinierten namespace-Präfixe angegeben werden.
| |
− | <pre class="ilfbox_code">
| |
− | <ClinicalDocument xmlns="urn:hl7-org:v3" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:pharm="urn:ihe:pharm:medication" xmlns:sdtc="urn:hl7-org:sdtc" xmlns:ips="urn:hl7-org:ips" xmlns:hl7at="urn:hl7-at:v3">
| |
− | <!-- CDA Header -->
| |
− | … siehe Beschreibung CDA R2 Header …
| |
− | <!-- CDA Body -->
| |
− | <component>
| |
− | <structuredBody>
| |
− | … siehe Beschreibung CDA R2 Body …
| |
− | </structuredBody>
| |
− | </component>
| |
− | </ClinicalDocument>
| |
− | </pre>
| |
− | | |
− | ===Hoheitsbereich des Dokuments ("realmCode")===
| |
− | Dieses Element kennzeichnet, dass das Dokument aus dem Hoheitsbereich Österreich stammt. | |
− | ====Spezifikation====
| |
− | {{:1.2.40.0.34.6.0.11.1.10/dynamic}}
| |
− | ===Dokumentformat ("typeId")===
| |
− | Dieses Element kennzeichnet, dass das Dokument im Format CDA R2 vorliegt.
| |
− | ====Spezifikation====
| |
− | {{:1.2.40.0.34.6.0.11.1.30/dynamic}}
| |
− | | |
− | ===ELGA Implementierungsleitfaden-Kennzeichnung ("templateId")===
| |
− | Mittels ''templateId''-Elementen können Teile von CDA-Dokumenten hinsichtlich ihrer Konformität zu bestimmten Templates gekennzeichnet werden. Auch Konformität zu Spezifikationen wie Implementierungsleitfäden kann ausgedrückt werden.
| |
− | | |
− | Der Einsatz von so genannten "templateId"-Elementen sichert zu, dass eine CDA-Instanz nicht nur CDA konform ist, sondern auch dem referenzierten Template oder Implementierungsleitfaden entspricht. Mit ''Zusicherung'' ist dabei nur eine informelle Behauptung des Verfassers gemeint und nicht notwendigerweise auch eine erfolgreich durchgeführte Validierung.
| |
− | | |
− | Ein CDA Dokument, welches den Vorgaben einer bestimmten Template entspricht, ist berechtigt und verpflichtet, die entsprechende templateId-Kennung einzutragen.
| |
− | | |
− | ====Strukturbeispiel====
| |
− | <pre class="ilfbox_code">
| |
− | <!— Folgt dem vorliegenden Implementierungsleitfaden-Template -->
| |
− | <templateId root="1.2.40.0.34.11.1"/>
| |
− | <!— Beliebig viele weitere templateIds, falls das Dokumente noch weiteren Templates, Implementierungsleitfäden oder Spezifikationen folgt -->
| |
− | <templateId root="…"/>
| |
− | :
| |
− | </pre>
| |
− | | |
− | ====Spezifikation====
| |
− | | |
− | Die OID des vorliegenden Implementierungsleitfadens MUSS im @''root'' Attribut des Elements angegeben werden.
| |
− | | |
− | Mit Angabe dieses Elements wird ausgesagt, dass das vorliegende CDA-Dokument zu diesem Implementierungsleitfaden konform ist.
| |
− | {| class="wikitable" width="100%" | |
− | |-
| |
− | ! colspan="2" | Element/Attribut
| |
− | ! | DT
| |
− | ! | Kard
| |
− | ! | Konf
| |
− | ! | Beschreibung
| |
− | |-
| |
− | | colspan="2" | templateId[1]
| |
− | | | II
| |
− | | | 1..1
| |
− | | | M
| |
− | | | eHealth Austria Dokumente ("Allgemeiner Leitfaden")<br />'''Fester Wert: @root = "1.2.40.0.34.6.0.11.0.1"'''
| |
− | |-
| |
− | | colspan="2" | templateId[2]
| |
− | | | II
| |
− | | | 1..1
| |
− | | | M
| |
− | | | OID des (speziellen) Implementierungsleitfadens. Dient als informative Referenz.<br />'''Beispiel''': @root = "1.2.40.0.34.7.1.7.0"
| |
− | |-
| |
− | | colspan="2" | templateId[3]
| |
− | | | II
| |
− | | | 1..1
| |
− | | | M
| |
− | | | TemplateId für ein im speziellen Implementierungsleitfaden definiertes Dokument<br />'''Beispiel''': @root = "1.2.40.0.34.6.0.11.0.4" (Leitfaden e-Impfpass "Kompletter Immunisierungsstatus")
| |
− | |-
| |
− | | |
− | |-
| |
− | | colspan="2" | templateId[n]
| |
− | | | II
| |
− | | | 0..*
| |
− | | | O
| |
− | | | Weitere TemplateIds, um Konformität zu weiteren (internationalen) Leitfäden zu dokumentieren. Dient als informative Referenz. <br />'''Beispiel''': @root="1.3.6.1.4.1.19376.1.5.3.1.1.18.1.2" (Immunization Content (IC) Content Module, IHE PCC Technical Framework Revision 11.0 - November 11, 2016)
| |
− | |}
| |
− | {{BeginILFBox}} | |
− | ''Verweis auf speziellen Implementierungsleitfaden:''<br/>
| |
− | Die templateIds[2-n] werden speziellen Implementierungsleitfaden gemäß der Dokumentenklasse angegeben.
| |
− | {{EndILFBox}}
| |
− | | |
− | ===Dokumenten-Id ("id")===
| |
− | Weltweit eindeutiger Instanzidentifikator des Dokuments.
| |
− | ====Spezifikation====
| |
− | {{:1.2.40.0.34.6.0.11.1.1/dynamic}}
| |
− | | |
− | ===Dokumentenklasse ("code")===
| |
− | Der "Code des Dokuments" (im CDA das Element ''ClinicalDocument/code'') bezeichnet die "'''Dokumentenklasse'''" bzw den präziseren "'''Dokumententyp'''".
| |
− | | |
− | Beispiele für die Klasseneinteilung der Dokumente:
| |
− | *Dokumentenklasse: Entlassungsbrief
| |
− | **Dokumententyp: "[[ILF:Entlassungsbrief (Ärztlich)|Entlassungsbrief aus stationärer Behandlung (Ärztlich)]]"
| |
− | **Dokumententyp: "[[ILF:Entlassungsbrief (Pflege)|Entlassungsbrief aus stationärer Behandlung (Pflege)]]"
| |
− | *Dokumentenklasse: [[ILF:Laborbefund|Laborbefund]]
| |
− | *Dokumentenklasse: [[ILF:Befund bildgebende Diagnostik|Befundbericht Befund bildgebende Diagnostik]]
| |
− | *…
| |
− | Für das Mapping in XDS siehe den entsprechenden Leitfaden "[[ILF:XDS_Metadaten_2020|ELGA XDS Metadaten]]".
| |
− | {{BeginILFBox}}
| |
− | ''<u>Verweis auf speziellen Implementierungsleitfaden:</u>''<br/>
| |
− | Die gültigen Wertebereiche dieses Elements entnehmen Sie bitte den entsprechenden speziellen Implementierungsleitfaden gemäß der Dokumentenklasse bzw dem Dokumententyp.
| |
− | {{EndILFBox}}
| |
− | ====Spezifikation====
| |
− | {{:1.2.40.0.34.6.0.11.1.16/dynamic}}
| |
− | | |
− | ===Titel des Dokuments ("title")===
| |
− | "Titel" (im CDA das Element ''ClinicalDocument/title'') bezeichnet die verpflichtende "'''Dokumentenüberschrift'''" (zusätzlich zur Dokumentenklasse).
| |
− | | |
− | Beispiele für Titel der Dokumente:
| |
− | *"Arztbrief"
| |
− | *"Entlassungsbrief der gynäkologischen Abteilung des SMZ Ost"
| |
− | *"Vorläufiger Entlassungsbrief"
| |
− | *"Befundbericht"
| |
− | *…
| |
− | ====Strukturbeispiel====
| |
− | <pre class="ilfbox_code">
| |
− | <title>Entlassungsbrief</title>
| |
− | </pre> | |
− | | |
− | ====Spezifikation====
| |
− | {| class="wikitable" width="100%"
| |
− | |-
| |
− | ! style="text-align:left" width="20%" | Element/Attribut ||style="text-align:left" width="5%" | DT ||style="text-align:left" width="5%" | Kard ||style="text-align:left" width="5%" | Konf ||style="text-align:left" width="65%" | Beschreibung | |
− | | |
− | |- style="background:#FFFFFF"
| |
− | | style="text-align:left" | title|| ST|| 1..1 || M || Dokumententitel<br/>
| |
− | Der Sinn der Benennung MUSS mit der Dokumentenklasse übereinstimmen.
| |
− | {{BeginYellowBox}}
| |
− | Die Verwendung von Zeichenketten für Line Feed (lf), Carriage Return (cr) sowie Tabulator ist innerhalb des title generell NICHT ERLAUBT.
| |
− | {{EndYellowBox}}
| |
− | |-
| |
− | |}
| |
− | | |
− | ===Status des Dokuments ("sdtc:statusCode")===
| |
− | Der Status eines Dokuments wird im CDA-Element ''ClinicalDocument/sdtc:statusCode'' gespeichert.
| |
− | ====Spezifikation====
| |
− | {{:1.2.40.0.34.6.0.11.1.45/dynamic}}
| |
− | | |
− | ===Terminologiedatum ("hl7at:terminologyDate")===
| |
− | Das ''Terminologiedatum'' gibt an, dass ein Dokument mit den Terminologien zum Stand eines bestimmten Datums erstellt wurde. Das Datum wird in einem eigens für die HL7-Austria Domäne geschaffenen Element "hl7at:terminologyDate" angegeben.
| |
− | ====Spezifikation====
| |
− | {{:1.2.40.0.34.6.0.11.1.46/dynamic}}
| |
− | | |
− | ===FormatCode ("hl7at:formatCode")===
| |
− | Die XDS-Metadaten enthalten ein Element ''formatCode'', das das Format des Dokuments bezüglich seiner semantischen Interoperabilität beschreibt. Im CDA-Schema wurde für die HL7-Austria Domäne ein genau entsprechendes Element geschaffen.
| |
− | ====Spezifikation====
| |
− | {{:1.2.40.0.34.6.0.11.1.47/dynamic}}
| |
− | | |
− | ===Fachliche Zuordnung des Dokuments ("hl7at:practiceSettingCode")===
| |
− | Die "fachliche Zuordnung des Dokuments" wird im CDA-Element ''ClinicalDocument/hl7at:practiceSettingCode'' gespeichert.
| |
− | | |
− | ====Spezifikation====
| |
− | {{:1.2.40.0.34.6.0.11.1.44/dynamic}}
| |
− | | |
− | ===Erstellungsdatum des Dokuments ("effectiveTime")===
| |
− | ====Spezifikation====
| |
− | {{:1.2.40.0.34.6.0.11.1.11/dynamic}}
| |
− | | |
− | ===Vertraulichkeitscode ("confidentialityCode")===
| |
− | ====Spezifikation====
| |
− | {{:1.2.40.0.34.6.0.11.1.12/dynamic}}
| |
− | | |
− | ===Sprachcode des Dokuments ("languageCode")===
| |
− | ====Spezifikation====
| |
− | {{:1.2.40.0.34.6.0.11.1.13/dynamic}}
| |
− | | |
− | ===Versionierung des Dokuments ("setId" und "versionNumber")===
| |
− | Mit den Attributen ''setId'' und ''versionNumber'' kann eine Versionskennung des Dokuments erreicht werden. Die ''setId'' bezeichnet das Set von Dokumenten, die zu einer Reihe von Versionen gehören. Sie bleibt über alle Versionen der Dokumente gleich (initialer Wert bleibt erhalten). Die ''versionNumber'' ist eine natürliche Zahl für die fortlaufende Versionszählung. Die versionNumber von neuen Dokumenten wird mit 1 festgelegt, mit jeder neuen Version wird diese Zahl hochgezählt, die setId bleibt gleich (muss mit der setId der Vorversion übereinstimmen).
| |
− | {{BeginYellowBox}}
| |
− | <u>Achtung:</u> Manche Validatoren erkennen es als Fehler, wenn die SetID und ID gleich sind.
| |
− | {{EndYellowBox}}
| |
− | Für die direkte Referenzierung zwischen Dokumenten siehe "[[#Bezug_zu_vorgehenden_Dokumenten|Bezug zu vorgehenden Dokumenten]]".
| |
− | ====Spezifikation====
| |
− | {{:1.2.40.0.34.6.0.11.1.15/dynamic}}
| |