Änderungen

Wechseln zu: Navigation, Suche

ILF:Allgemeiner Implementierungsleitfaden (Version 3)

94 Bytes hinzugefügt, 14:51, 20. Jan. 2021
<pre class="ILFgreen"> durch <pre class="ilfbox_code"> ersetzen
border: thin black solid;
background-color:#F4C789;
padding: 5px 5px 5px 5px;
margin-left:6px;
width:70%;
}
.ILFgreen{
border: thin black solid;
background-color:#E0FFE0;
padding: 5px 5px 5px 5px;
margin-left:6px;
{{EndILFBox}}
====Themenbezogenes CDA Beispiel-Fragment im XML Format:====
<pre class="ILFgreenilfbox_code">
<BEISPIEL>
<languageCode code="de-AT" />
Beispiel für ein Element, welches mit dem @''nullFlavor'' versehen wurde:
<pre class="ILFgreenilfbox_code">
<id nullFlavor="UNK" />
</pre>
Tabellarische Darstellung gilt auch für unbekannte und fehlende Informationen, zusätzlich KANN die Nicht-Information optisch hervorgehoben werden.
<pre class="ILFgreenilfbox_code">
<title>Allergien und Intoleranzen</title>
<text>
Diese erste Situation wird mit dem folgenden Beispiel verdeutlicht.
<pre class="ILFgreenilfbox_code">
<code codeSystem="1.2.40.0.34.5.174" nullFlavor="OTH">
<originalText>
Das folgende Beispiel bezieht sich auf die zweite Situation:
<pre class="ILFgreenilfbox_code">
<value xsi:type="CD" nullFlavor="NA">
<originalText>
<pre class="ILFgreenilfbox_code">
<value xsi:type="CD" codeSystem="2.16.840.1.113883.6.96" nullFlavor="OTH">
[
Im Falle der ''coding strength'' CWE (coded with extensions) wird der nullFlavor "NA" vorgeschlagen und ebenso die Angabe des korrekten Codes im <translation>-Teilelement. Dies ermöglicht die Angabe, dass eine Zuordnung zu dem Referenz-Value Set versucht wurde, aber keine geeigneten Zielcodes identifiziert wurden.
<pre class="ILFgreenilfbox_code">
<value xsi:type="CD" codeSystem="2.16.840.1.113883.6.96" nullFlavor="NA">
[
1. Fall: Ein einzelner lokaler Code wird auf einen Code im Referenz-Value Set gemappt
<pre class="ILFgreenilfbox_code">
<value xsi:type="CD" code="42338000" codeSystem="2.16.840.1.113883.6.96"
displayName="Salmonella gastroenteritis">
2. Fall: Mehrere lokale Codes werden auf das Referenz-Value Set gemappt
<pre class="ILFgreenilfbox_code">
<value xsi:type="CD" code="C50.9" codeSystem="1.2.40.0.34.5.171"
codeSystemName="ICD-10 BMGF"
3. Fall: Ein lokaler Code entstammt derselben Terminologie wie das Referenz-Value Set, besitzt aber eine unterschiedliche Granularität.
<pre class="ILFgreenilfbox_code">
<code code="60591-5" codeSystem="2.16.840.1.113883.6.1"
codeSystemName="LOINC" displayName="Patient Summary">
Beispiel 1: Ohne Code-Mapping
<pre class="ILFgreenilfbox_code">
<code code="60591-5" codeSystem="2.16.840.1.113883.6.1"
codeSystemName="LOINC" displayName="Patient Summary">
Beispiel 2: Mit Code-Mapping und Referenz zum narrativen Text
<pre class="ILFgreenilfbox_code">
<value xsi:type="CD" code="42338000" codeSystem="2.16.840.1.113883.6.96"
displayName="Salmonella-gastroenteritis">
Beispiel:
<pre class="ILFgreenilfbox_code">
<section>
<templateId root="2.16.840.1.113883.3.1937.777.13.10.5"/>
Ein Datum, das mit YYYYMMDD angegeben wurde, wird standardgemäß interpretiert als YYYYMMDD000000 – also der Tag um 0:00:00 Uhr. Wenn also als Zeitraum z.B.: der ganze 1. Dezember 2017 angegeben werden soll, MUSS das so erfolgen:
<pre class="ILFgreenilfbox_code">
<low value="20171201"/>
<high value="20171202"/>
Für mehr Klarheit empfiehlt sich daher die zusätzliche Angabe der Zeit mit Zeitzone:
<pre class="ILFgreenilfbox_code">
<low value="20171201000000+0100"/>
<high value="20171201235959+0100"/>
====Strukturbeispiele====
'''Methode 1:'''
<pre class="ILFgreenilfbox_code">
<!-- Angabe einer OID als direkten Identifikator -->
<id root="1.2.40.0.34.99.111.0.1"
<br />
'''Methode 2:'''
<pre class="ILFgreenilfbox_code">
<!—
Angabe der OID der ID-Liste in @root
</pre>
'''Methode 3:'''
<pre class="ILFgreenilfbox_code">
<!-- Angabe einer UUID als extension zur OID "2.25" -->
<id root="2.25" extension="urn:uuid:19FEE6C3-6B35-4C5B-B1CC-2B5B4001AB2" assigningAuthorityName="KH Eisenstadt" />
====Strukturbeispiel====
<pre class="ILFgreenilfbox_code">
<languageCode code="de-AT" />
</pre>
=====Minimal-Variante um einen Code eindeutig darzustellen:=====
<pre class="ILFgreenilfbox_code">
<code code="E10"
codeSystem="1.2.40.0.34.5.56"/>
=====Gebräuchlichste Variante mit zusätzlichem Klartext für Code und Codesystem=====
<pre class="ILFgreenilfbox_code">
<code code="E10"
displayName="Primär insulinabhängiger Diabetes mellitus, Typ-2-Diabetes"
=====Vollständige-Variante mit direkter Angabe des Textinhalts=====
<pre class="ILFgreenilfbox_code">
<code code="E10"
displayName="Primär insulinabhängiger Diabetes mellitus, Typ-2-Diabetes"
=====Vollständige-Variante mit Referenz in den narrativen Textbereich=====
<pre class="ILFgreenilfbox_code">
<code code="E11"
displayName="Primär insulinabhängiger Diabetes mellitus, Typ-2-Diabetes"
=====Vollständige-Variante mit Referenz in den narrativen Textbereich und Übersetzung in zwei andere Code-Systeme=====
<pre class="ILFgreenilfbox_code">
<code code="E10"
displayName="Primär insulinabhängiger Diabetes mellitus, Typ-2-Diabetes"
====Strukturbeispiel====
<pre class="ILFgreenilfbox_code">
<effectiveTime value="20081224"/> <!-- Datum 24.12.2008 -->
</pre>
a) Winterzeit, Österreich (MEZ)
<pre class="ILFgreenilfbox_code">
<effectiveTime value="20081224150000+0100"/>
<!-- Datum 24.12.2008, um 15:00 Uhr in Europa/Wien (bei Winterzeit) -->
</pre>
b) Sommerzeit, Österreich (MESZ)
<pre class="ILFgreenilfbox_code">
<effectiveTime value="20080824150000+0200"/>
<!-- Datum 24.08.2008, um 15:00 Uhr in Europa/Wien (bei Sommerzeit) -->
====Strukturbeispiel====
Datum: "Juni 2008"
<pre class="ILFgreenilfbox_code">
<effectiveTime value="200806"/>
</pre>
===Zeitintervall: Intervall-Zeitelement IVL_TS===
====Strukturbeispiel====
<pre class="ILFgreenilfbox_code">
<effectiveTime>
<low value="..."/> <!-- Zeitpunkt von -->
Ein Datum, das mit yyyymmdd angegeben wurde, wird gemäß Standard HL7 CDA Rel.2 interpretiert als yyyymmdd000000 – also der Tag um 0:00:00 Uhr. Wenn also als Zeitraum z.B.: der ganze 1.Dezember 2013 angegeben werden soll, MUSS das so erfolgen:
<pre class="ILFgreenilfbox_code">
<low value="20131201"/>
<high value="20131202"/>
</pre>
Für mehr Klarheit empfiehlt sich daher die zusätzliche Angabe der Zeit mit Zeitzone:
<pre class="ILFgreenilfbox_code">
<low value="20131201000000+0100"/>
<high value="20131201235959+0100"/>
|}
====Strukturbeispiele====
<pre class="ILFgreenilfbox_code">
<!-- pro Tag -->
<effectiveTime xsi:type='PIVL_TS' institutionSpecified='true'>
====Strukturbeispiele====
<pre class="ILFgreenilfbox_code">
<!-- morgens -->
<effectiveTime xsi:type='EIVL_TS'>
====Strukturbeispiele====
<pre class="ILFgreenilfbox_code">
<!-- 1 Zeitangabe bestehend aus 2 Zeit-Komponenten, jeden Dienstag und Donnerstag pro Woche -->
====Strukturbeispiele====
=====Beispiele für Präfixe in TEL Elementen=====
<pre class="ILFgreenilfbox_code">
<telecom value="tel:+43.1.40400"/>
<telecom value="fax:(02236)83.12323-12"/>
=====Beispiel für die Angabe einer Mobilnummer=====
<pre class="ILFgreenilfbox_code">
<telecom use="MC" value="tel:+43.660.1234567"/>
</pre>
=====Strukturbeispiele=====
Beispiele für ''name''-Elemente in Granularitätsstufe 1:
<pre class="ILFgreenilfbox_code">
<name>Dr. Herbert Mustermann</name>
</pre><br/>
<pre class="ILFgreenilfbox_code">
<name use="A">Dr. Kurt Ostbahn </name>
</pre>
=====Strukturbeispiel=====
Beispiel für ein ''name''-Element in Granularitätsstufe 2:
<pre class="ILFgreenilfbox_code">
<name>
<prefix qualifier="PR">OMedR</prefix>
Es gibt auch nicht näher bestimmte Prefixe/Suffixe, z.B. trifft das für die Angabe von "Junior" oder "Senior" bzw "Jun."/"Sen" oder "Jr."/"Sr" zu.
<pre class="ILFgreenilfbox_code">
<name>
<given>Herbert</given>
====Strukturbeispiel====
Beispiel für die Angabe eines Organisationsnamens:
<pre class="ILFgreenilfbox_code">
<name>Krankenhaus Wels</name>
</pre>
====Strukturbeispiel====
Beispiel für ein ''addr''-Element in Granularitätsstufe 1:
<pre class="ILFgreenilfbox_code">
<addr use="HP">Musterstraße 13a, 1220 Wien, Österreich</addr>
</pre>
====Strukturbeispiel====
Beispiel für ein ''addr''-Element in Granularitätsstufe 2:
<pre class="ILFgreenilfbox_code">
<addr>
<streetAddressLine>Musterstraße 11a/2/1</streetAddressLine>
====Strukturbeispiel====
Beispiel für ein ''addr''-Element in Granularitätsstufe 3:
<pre class="ILFgreenilfbox_code">
<addr>
<streetName>Musterstraße</streetName>
===Strukturbeispiele===
Die Dokumentation eines '''numerischen Ergebniswertes''' erfolgt in diesem Fall als Attribut.
<pre class="ILFgreenilfbox_code">
<value xsi:type="PQ" value="49.7" unit="%"/>
</pre>
Die Codierung von '''textuellen Ergebnissen''' erfolgt in der Regel durch den “ST” Datentyp. Die Angabe des Ergebnisses erfolgt hier als Wert des Elementes.
<pre class="ILFgreenilfbox_code">
<value xsi:type="ST">strohgelb</value>
</pre>
Auch für '''dimensionslose Einheiten''' wird in UCUM häufig eine Einheit angegeben, wie z.B. "[ph]" für den pH-Wert. Wenn keine UCUM-Einheit vorgeschlagen ist, können dimensionslose Einheiten auch mit @unit="1" dargestellt werden, hier für INR:
<pre class="ILFgreenilfbox_code">
<value xsi:type="PQ" value="1.1" unit="1"/>
</pre>
Für '''Verhältnisangaben''', wie sie etwa für '''Titer''' verwendet werden (z.B. „1:128“) steht der Datentyp RTO (Ratio) zur Verfügung. Ein Anwendungsbeispiel:
<pre class="ILFgreenilfbox_code">
<value xsi:type="RTO">
<numerator value="1" xsi:type="INT"/>
'''Intervalle''' können mit dem Datentyp IVL angegeben werden, z.B. „20-30 mg/L“:
<pre class="ILFgreenilfbox_code">
<value xsi:type="IVL_PQ" >
<low value="20" unit="mg/dl" inclusive="true"/>
====Strukturbeispiele====
<pre class="ILFgreenilfbox_code">
<!-- Verhältnisangabe ohne physikalische Größe, z.B. Titer 1:120 -->
<value xsi:type="RTO">
'''Beispiel'''
<pre class="ILFgreenilfbox_code">
<observation><br />
<br />
====Strukturbeispiel====
<pre class="ILFgreenilfbox_code">
<assignedPerson>
<name>
====Strukturbeispiel====
<pre class="ILFgreenilfbox_code">
<serviceProviderOrganization>
<id root="1.2.40.0.34.3.1.xxx" assigningAuthorityName="GDA Index"/>
====Strukturbeispiel====
<pre class="ILFgreenilfbox_code">
<assignedEntity>
<id root="1.2.40.0.34.99.111.1.3"
====Zeichencodierung====
CDA-Dokumente MÜSSEN mit '''UTF-8''' (''8-Bit Universal Character Set Transformation Format'', nach RFC 3629 / STD 63 (2003)) codiert werden.
<pre class="ILFgreenilfbox_code">
<?xml version="1.0" encoding="UTF-8" standalone=”yes”?>
:
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="ILFgreenilfbox_code">
<?xml-stylesheet type="text/xsl" href="ELGA_Stylesheet_v1.0.xsl"?>
</pre>
{{EndYellowBox}}
In speziellen Leitfäden können weitere neben den hier vordefinierten namespace-Präfixe angegeben werden.
<pre class="ILFgreenilfbox_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 -->
====Strukturbeispiel====
<pre class="ILFgreenilfbox_code">
<!— Folgt dem vorliegenden Implementierungsleitfaden-Template -->
<templateId root="1.2.40.0.34.11.1"/>
*…
====Strukturbeispiel====
<pre class="ILFgreenilfbox_code">
<title>Entlassungsbrief</title>
</pre>
====Strukturbeispiel====
<pre class="ILFgreenilfbox_code">
<ClinicalDocument xmlns="urn:hl7-org:v3">
:
Der ''structuredBody'' eines CDA Release 2.0 Dokuments setzt sich aus ein oder mehreren Komponenten (''component'') zusammen, wobei jede Komponente wiederum aus einer oder mehreren Sektionen (''section'') und gegebenenfalls aus einem oder mehreren maschinenlesbaren ''entry''-Elementen (siehe [[ILF:Allgemeiner_Implementierungsleitfaden_2020#CDA Level 1 bis 3|CDA Level 1 bis 3]]) besteht.
====Strukturbeispiel====
<pre class="ILFgreenilfbox_code">
<ClinicalDocument xmlns="urn:hl7-org:v3">
:
CDA Level 1 sind alle Dokumente mit einem CDA „nonXMLBody“ und jene mit Sektionen ohne Codierung:
<pre class="ILFgreenilfbox_code">
<section>
<title>Aufnahmegrund</title>
Auf dieser Ebene kommen so genannte '''Section-Level-Templates''' zur Anwendung. Diese machen Abschnitte maschinenauswertbar, d.h. durch Applikationen identifizierbar und ermöglichen eine Überprüfung des CDA-Dokuments dahingehend, ob es spezifische Abschnitte, Paragrafen und andere Strukturbestandteile aufweist.
<pre class="ILFgreenilfbox_code">
<section>
<code
Alle relevanten medizinischen Daten MÜSSEN im „menschenlesbaren Teil“, dem narrativen Block (title und text-Elemente der Sections) enthalten sein. Für die maschinenlesbaren Einträge (''entry'') kommen '''Entry-Level-Templates''' zum Einsatz. Dies MÜSSEN inhaltlich konsistent zum lesbaren Textbereich sein und sollen zusätzlich die entsprechenden Inhaltsstellen im Textbereich referenzieren. Zusätzliche maschinenlesbare Informationen können angegeben werden, sofern sie nicht dargestellt werden müssen und auch nicht Bestandteil des signierten Originalbefundes sind. Sind die narrativen Daten direkt von den maschinenlesbaren abgeleitet und daher inhaltlich gleich, wird das im Entry durch das Attribut typeCode="DRIV" angegeben. Hier kann ausschließlich der maschinenlesbare Teil ohne Informationsverlust zur Weiterverarbeitung verwendet werden.
<pre class="ILFgreenilfbox_code">
<section>
<code
=====Strukturbeispiel=====
Eine Liste hat das folgende Aussehen:
<pre class="ILFgreenilfbox_code">
<text>
:
=====Strukturbeispiel=====
Eine Tabelle hat das folgende Aussehen:
<pre class="ILFgreenilfbox_code">
<text>
:
Zur Strukturierung eines längeren Textes kann das ''paragraph'' Tag verwendet werden.
=====Strukturbeispiel=====
<pre class="ILFgreenilfbox_code">
<text>
:
Darunter findet sich ein Text, der fett gedruckt erscheinen soll.
<pre class="ILFgreenilfbox_code">
<text>
:
Das ''br''-Element <br/> kann benutzt werden, um im laufenden Text einen „harten“ Zeilumbruch zu erzwingen. Dies unterscheidet es vom ''paragraph''-Element, da der Zeilenumbruch keinen Inhalt hat. Empfänger sind angehalten, dieses Element als Zeilenumbruch darzustellen.
=====Strukturbeispiel=====
<pre class="ILFgreenilfbox_code">
<text>
:
Ein Textbereich kann mit dem Element ''sup'' umspannt werden, um ihn Superscript (hochgestellt) darzustellen. Er kann mit sub umspannt werden, um ihn Subscript (tiefgestellt) darzustellen.
=====Strukturbeispiel=====
<pre class="ILFgreenilfbox_code">
<text>
:
=====Strukturbeispiel=====
Die Fußnotenreferenzen werden fortlaufend nummeriert und durch einen ''<sup>'' Tag hochgestellt. Der Text wird unter ''<tfoot>'' mit dem ''<footnote>'' Tag gekennzeichnet. Die ID gibt eine eindeutige Referenz auf den Text einer Fußnote.
<pre class="ILFgreenilfbox_code">
<table>
<thead>
'''Beispiel:'''
<pre class="ILFgreenilfbox_code">
Verwendung von Revisionsmarken in CDA / XML:
{{EndILFBox}}
=====Strukturbeispiel=====
<pre class="ILFgreenilfbox_code">
<ClinicalDocument xmlns="urn:hl7-org:v3">
:
=====Eingebettetes PDF=====
Das folgende Beispiel beschreibt einen eingebetteten Befund, der in der Sektion „Beigelegte Befunde“ angegeben wurde.
<pre class="ILFgreenilfbox_code">
<section>
<!-- Inhalt der Section, mit Title, Text... -->
=====Eingebettetes Bild=====
Das folgende Beispiel beschreibt einen Befund am linken Zeigefinger, der zusätzlich mit einem Bild dokumentiert ist.
<pre class="ILFgreenilfbox_code">
<section>
<!-- Inhalt der Section, mit Title, Text... -->
Beispiel mit deutscher Übersektion:
<pre class="ILFgreenilfbox_code">
<section>
<templateId root="1.2.40.0.34.11.2.2.13" assigningAuthorityName="ELGA"/>
1.104
Bearbeitungen

Navigationsmenü