Änderungen

Wechseln zu: Navigation, Suche

ILF:XDS Metadaten (Version 3)

690 Bytes hinzugefügt, 16:26, 31. Aug. 2021
K
keine Bearbeitungszusammenfassung
{{#seo:
|title=XDS Metadaten 3.0.01
|titlemode=append
|keywords= XDS Metadaten, Metadaten, XDS, CDA, CDA Dokumente
|description=Dieses Dokument definiert die Metadaten beim Einbringen von CDA-Dokumenten in die österreichische ELGA Infrastruktur über das IHE Profil Cross-Enterprise Document Sharing (XDS).
}}
{{#customtitle:XDS Metadaten (Version 3.0.0)}}
<!--
{{Underconstruction}}
-->
<!--
Implementierungsleitfaden "XDS Metadaten (Version 3.0.0)"
-->
|Group = ELGA CDA Implementierungsleitfäden
|Title = ELGA XDS Metadaten (XDSDocumentEntry)
|Subtitle = Leitfaden zur Registrierung von CDA Dokumenten mit IHE Cross-Enterprise Document Sharing in ELGA (Version 3)[1.2.40.0.34.7.6.9.3]
|Short = XDS Metadaten
|Namespace = elga-cdaxds-2.06.2
|Type = Implementierungsleitfaden
|Version = 3.0.01+2021mmdd
|Submitted = ELGA GmbH
|Date = Februar März 2021
|Copyright = 2011-
|Status = KommentierungFinal
|Period = n.a.
|OID = 1.2.40.0.34.7.6.9.3
Die Lizenzinformationen und Richtlinien zum geistigen Eigentum von IHE International sind beschrieben in Anhang A der IHE International Principles of Governance<ref name="IHE Governance">[https://www.ihe.net/wp-content/uploads/2018/07/IHE-International-Principles-of-Governance.pdf IHE Principles of Governance]</ref> .
<!-- Seitenumbruch --><p style="page-break-before: always"></p>
===Urheber- und Nutzungsrechte von anderen Quellen ("Third Party IP")===
<div style="border: thin #77c123 solid;width:100%; margin-left: 10px">
Ein Leitfaden in seiner jeweils aktuell gültigen Fassung sowie die aktualisierten Terminologien sind vom zuständigen Minister auf [http://www.gesundheit.gv.at www.gesundheit.gv.at] zu veröffentlichen. Der Zeitplan zur Bereitstellung der Datenaustauschformate wird durch das Gesundheitstelematikgesetz 2012 und darauf basierenden Durchführungsverordnungen durch den zuständigen Bundesminister vorgegeben. Hauptversionen, also Aktualisierungen des Implementierungsleitfadens, welche zusätzliche verpflichtende Konformitätskriterien enthalten ("Mandatory" (M), "Required" (R) und "Fixed" (F)), sind mit ihren Fristen zur Bereitstellung per Verordnung kundzumachen. Andere Aktualisierungen (Nebenversionen) dürfen auch ohne Änderung dieser Verordnung unter www.gesundheit.gv.at veröffentlicht werden.
Die Anwendung dieses Implementierungsleitfadens hat im Einklang mit der Rechtsordnung der Republik Österreich österreichischem und europäischem Recht, insbesondere mit den relevanten Materiengesetzen (z.B. Ärztegesetz 1998, Apothekenbetriebsordnung 2005, Krankenanstalten- und Kuranstaltengesetz, Gesundheits- und Krankenpflegegesetz, Rezeptpflichtgesetz, Datenschutzgesetz 2000, Gesundheitstelematikgesetz 2012, DSGVO) zu erfolgen. Technische Möglichkeiten können gesetzliche Bestimmungen selbstverständlich nicht verändern, vielmehr sind die technischen Möglichkeiten im Einklang mit den Gesetzen zu nutzen.
Die Einhaltung der gesetzlichen Bestimmungen liegt im Verantwortungsbereich der Ersteller der CDA-Dokumente.
Weiters bezieht sich dieser Leitfaden auf den internationalen Standard "HL7® Clinical Document Architecture, Release 2.0" (CDA ®)<ref name="CDA"></ref>, für die das Copyright © von Health Level Seven International<ref name="HL7">Health Level Seven International [http://www.hl7.org www.hl7.org]</ref> gilt. 2009 wurde die Release 2.0 als ISO-Standard ISO/HL7 27932:2009 publiziert<ref name="ISO CDA">ISO/HL7 27932:2009 Data Exchange Standards — HL7 Clinical Document Architecture, Release 2 [https://www.iso.org/standard/44429.html https://www.iso.org/standard/44429.html]</ref>. CDA definiert die Struktur und Semantik von "medizinischen Dokumenten" zum Austausch zwischen Gesundheitsdiensteanbietern und Patienten. Es enthält alle Metadaten zur Weiterverarbeitung und einen lesbaren textuellen Inhalt und kann diese Informationen auch maschinenlesbar tragen.
Die Dokumentmetadaten für CDA Dokumente im Österreichischen Gesundheitswesen werden grundsätzlich vom "Allgemeinen CDA Implementierungsleitfaden" <ref name="ALF">Allgemeiner Implementierungsleitfaden für CDA Dokumente [[https://wiki.hl7.at/index.php?title=ILF:Allgemeiner_Implementierungsleitfaden_(Version_3) https://wiki.hl7.at/index.php?title=ILF:Allgemeiner_Implementierungsleitfaden_(Version_3)]]</ref> definiert.
Die HL7 Standards können über die HL7 Anwendergruppe Österreich (HL7 Austria)<ref>HL7 Austria [http://www.hl7.at/ www.hl7.at]</ref>, die offizielle Vertretung von Health Level Seven International in Österreich bezogen werden. Alle auf nationale Verhältnisse angepassten und veröffentlichten HL7-Spezifikationen können ohne Lizenz- und Nutzungsgebühren in jeder Art von Anwendungssoftware verwendet werden.
{{BeginILFBox}}
Gemeinsam mit diesem Leitfaden werden auf der Website der ELGA GmbH ([http://www.elga.gv.at/CDA Website der ELGA GmbH]) weitere Dateien und Dokumente zur Unterstützung bereitgestellt:
*ELGA-Gesamtarchitektur<ref name="ELGA-Gesamtarchitektur">ELGA-Gesamtarchitektur 2.30a [http://www.elga.gv.at/technischer-hintergrund/technischer-aufbau-im-ueberblick/ ELGA Gesamtarchitektur 2http://www.elga.gv.30aat/technischer-hintergrund/technischer-aufbau-im-ueberblick/]</ref>
*Beispieldokumente
*Referenz-Stylesheet (Tool zur Darstellung im Browser - Konvertierung in HTML)
|- style="background:#FFEBAD"
| colspan="2" style="text-align:left" |Herausgeber, Projektleiter, CDA-Koordinator
|- style="background:#FFFFFF"
|ELGA GmbH||Stefan Sabutsch
|- style="background:#FFEBAD"
| colspan="2" style="text-align:left" |Autoren
|- style="background:#FFFFFF"
|CodeWerk Software Services and Development GmbH||Jürgen Brandstätter
|- style="background:#FFFFFF"|DICOM Austria|Emmanuel Helm|-|DICOM Austria|Silvia Winkler|-
|ELGA GmbH, HL7 Austria||Stefan Sabutsch
|- style="background:#FFFFFF"
|ELGA GmbH||Oliver Kuttin
|- style="background:#FFFFFF"|ELGA GmbH|Stefan Repas|-
|Wiener Krankenanstaltenverbund||Konrad Hölzl
|}
<sup>1</sup> Namen ohne Titel
 
<!--Einleitung-->
==Gegenstand dieses Dokuments==
Dieses Dokument definiert die Metadaten beim Einbringen von Dokumenten in Form von Befunden<ref name="ALF"></ref> oder Bilddaten in die ELGA Infrastruktur über das IHE Profil Cross-Enterprise Document Sharing (XDS)<ref name="IHE ITI"></ref>. Die hier definierten Regeln sind von den folgenden "Technical Frameworks" der IHE abgeleitet:
* Grundlegende Spezifikation der Metadaten in einem XDS System, gültig für alle Dokumente (Metadaten der XDSDocumentEntry Objekte): ''IT Infrastructure Technical Framwork (ITI), Volume 3, Rev. 12.0 (22.4.2016) Final Text ''<ref name="ITITF3">IHE ITI TF-3 Cross-Transaction Specifications and Content Specifications, Revision 12.0 (2016) [https://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_TF_Rev12.2_Vol3_FT_2016-04-22.pdf https://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_TF_Rev12.2_Vol3_FT_2016-04-22.pdf], zuletzt besucht am 25.01.2021</ref>
Ausgehend von obiger Basis definiert das vorliegende Dokument die genaue Spezifikation der Befüllung der XDS Metadaten speziell für die Anwendung im Rahmen der österreichischen Gesundheitsakte ELGA. Die Spezifikation wurde im Zusammenhang mit dem "Allgemeinen Implementierungsleitfaden"<ref name="ALF"></ref>, den "ELGA CDA Implementierungsleitfäden" und dem Leitfaden zur Erstellung und Verwendung von KOS Objekten für den ELGA Bilddatenaustausch<ref name="KOS-Leitfaden">DICOM Austria: Leitfaden zur Erstellung und Verwendung von KOS Objekten für den ELGA Bilddatenaustausch [https://collab.dicom-austria.at/pages/viewpage.action?pageId=27033635 DICOM Austria KOS Leitfaden], zuletzt besucht am 19.02.2021</ref> erstellt.
===Größenbeschränkung ===
ELGA schreibt für die Größe der eingebrachten CDA eine Maximalgröße von 20 MB vor. Größere Dokumente sind abzulehnen. Es liegt generell in der Verantwortung des Erstellers und des ELGA Bereiches, die Größe der über ELGA bereitgestellten CDA-Dateien auf eine sinnvolle und angemessene Größe zu beschränken. Siehe Kapitel 6.10 des[[ILF:Allgemeiner Implementierungsleitfaden_2020#Gr.C3.B6.C3.9Fenbeschr.C3.A4nkung_von_eingebetteten_Objekten Allgemeinen Implementierungsleitfadens |Allgemeiner Implementierungsleitfadenfür ELGA CDA Dokumente, Kapitel 6.10]].
==Allgemeines zu XDS-Metadaten==
* über den GDA, welcher das Dokument erstellt hat
* über weitere systemrelevante Informationen (z.B. Dokumentgröße, Mime-Type, etc.).
Die Spezifikation, welche Metadaten in welchem Format und Datentyp angegeben werden müssen, ist im IHE "IT-Infrastructure" (ITI) Technical Framework, Volume 3 festgelegt (IHE ITITF-TF33)<ref name="ITITF3"/>.
Die Angabe der Metadaten muss von der Anwendung vorgenommen werden, die das Dokument einbringt.
{{EndYellowBox}}
'''Hinweis:''' Siehe auch Vorschriften zur Befüllung der Dokument-Metadaten aus Dokumenten des IHE IT Infrastructure Technical Framworks(ITI), Volume 3, Rev. 17.0 Final Text<ref name="ITITF3"/>.
===Metadaten aus unstrukturierten Dokumenten===
===Metadaten aus "On-Demand Documents" (ODD) ===
Über XDS können auch Dokumente abgerufen werden, die zum Abfragezeitpunkt automatisch generiert werden. Für diese Dokumente werden Verweise in der Registry eingetragen, damit sie bei der Abfrage auch gefunden werden können. Die Metadaten von ODD unterscheiden sich notwendigerweise von den Metadaten der "stabilen Dokumente" (SD), da sie erst bei Generierung des Dokuments vorhanden sind.
Die genaue Beschreibung für On-Demand Documents findet sich IT Infrastructure Technical Framwork (ITI), Volume 3, Rev. 17.0 Final Text<ref name="ITITF3"/>.
===Metadaten aus Bilddaten (KOS)===
|'''M [1..1]'''
|K
|Medizinisch relevantes Datum, je nach Definition im speziellen LeitfadenZeitpunkt der Erstellung des registrierten Dokuments oder Objektes
|-
| colspan="2" |'''eventCodeList'''
| colspan="2" |'''referenceIdList'''
|'''M [1..*]'''
|K/E1
|Liste von Identifikatoren. Die Semantik der jeweiligen Identifier ist in dem Data Typ CXi codiert
|-
Die folgende Tabelle gibt einen Überblick über alle XDS-Metadaten-Elemente. Die Spalten zeigen jeweils den Namen des Metadaten-Elements, dessen Optionalität in IHE bzw. ELGA für das Einbringen von Dokumenten, sowie die Quelle aus der die Informationen stammen.
In der Tabelle 4 6 werden die XDS-Metadaten-Elemente mit der minimalen Anzahl des Vorkommens der Elemente (Optionalität), jeweils für Stable Documents (SD) und On-Demand-Documents (ODD) angegeben.
''Tabelle 4: Legende zur Spalte "Quelle" der folgenden Tabelle''
<sup>9</sup> SD: "Stable Document": Stabiles Dokument, das als Datei gespeichert und registriert zur Verfügung steht.<br />
<sup>10</sup> ODD: "On-demand Document": Dokument, das nur als Verweis in der Registry existiert und erst zum Abfragezeitpunkt generiert wird. <br />
<sup>11</sup> Der Inhalt des typeCodes soll mit dem contentTypeCode des SubmissionSets Submission Sets übereinstimmen.<br />
<sup>12</sup> MUSS vorhanden sein, wenn eine "parentDocumentRelationship" existiert. <br />
<sup>13</sup> MUSS gemeinsam mit einer "parentDocumentId" angegeben sein.<br />
<p style="page-break-before: always"></p>
=XDS-I Metadaten für DICOM KOS Objekte=
Die folgenden Kapitel spezifizieren die XDS-I Metadaten von DICOM KOS-Objekten für deren Verwendung in ELGA. Nicht weiter eingeschränkte Metadaten sind nicht angeführt. Für diese gelten die generellen Vorgaben wie in IHE IT Infrastructure Technical Framework, vol3, rev. 17, Vol 3 "Table 4.2.3.2-1 DocumentEntry Metadata Attribute Definition" angeführt<ref name="ITITF3"/>.
Die folgende Tabelle gibt einen Überblick jener XDS-I Metadaten-Elemente, die direkt aus dem DICOM KOS bzw. der zugrundeliegenden DICOM Study abgeleitet werden können. Die Spalten zeigen jeweils den Namen des Metadaten-Elements, dessen Optionalität in ELGA für das Einbringen von DICOM KOS Objekten, sowie die Quelle aus der die Informationen stammen.
id="urn:uuid:33adae7e-f1ed-4345-acab-73f59bc1d037" nodeRepresentation="">
<Slot name="authorPerson">
<ValueList> <Value>11375^Musterdoc^Josef^Maria^Msc^DI DrDIDr^^^&amp;amp;1.2.40.0.34.99.4613.3.3&amp;amp;ISO </Value>
</ValueList>
</Slot>
</Slot>
</Classification></pre>
Dies folgt dem Mapping von DICOM Datentyp PN (der auch aus mehreren Komponenten besteht) auf die XCN Komponenten wie in IHE RAD TF-2 Rev.19 2020<ref name="IHERADTF2">IHE Radiology (RAD) Technical Framework Volume 2x Rev.19, 2020 [https://ihe.net/uploadedFiles/Documents/Radiology/IHE_RAD_TF_Vol2.pdf https://ihe.net/uploadedFiles/Documents/Radiology/IHE_RAD_TF_Vol2.pdf]</ref>, "Table 4.68.4.1.2.3-3: XCN Data type mapping" vorgegeben.
=====Spezifikation für Software und Geräte=====
====authorRole====
Das ''authorRole'' Element beschreibt die Rolle, die der inhaltliche Autor (bzw. das erstellende Gerät) zum Zeitpunkt der KOS-Objekt Generation Erzeugung innehatte.
Dieser Leitfaden beschreibt keine Einschränkungen für die Verwendung.
====submissionSet.contentTypeCode====
Der contentTypeCode des SubmissionSets Submission Sets wird als ebRIM Classification umgesetzt und soll dieselben Werte wie typeCode des DocumentEntry tragen.
$code = "55113-5"
#Versionsklammer über die zusammengehörenden Versionen (ownDocument_setId, M [1..1])
#Verlinkung zwischen e-Befunden (CDA) und DICOM Studien über KOS-Objekte (Accession Number, M R [10..1])
#Verlinkung zwischen DICOM KOS-Objekten und einer Aufenthaltszahl (encounterId, O [0..1])
Dieser Datentyp ist in IHE ITI Data Types in folgender Weise spezifiziert:<ref name="ITITF3"/>
<!-- Seitenumbruch --><p style="page-break-before: always"></p>
{| class="wikitable" width="100%"
!Data Type||Source Standard||Encoding Specification
=====Spezifikation=====
Bei der Registrierung von KOS Objekten MUSS SOLL eine Accession Number in den XDS-I Metadaten in der ReferenceIdList angegeben werden. Diese dient als Basis für die Verlinkung mit einem Befund der bildgebenden Diagnostik (diagnostic image report). Wird in der ReferenceIdList der XDS-I Metadaten keine Accession Number angeführt, ist eine Verlinkung nicht möglich. Der Wert eines Listelementes innerhalb einer referenceIdList hat dem HL7 Datentyp CXi zu folgen (siehe oben).
Für Befunde der Bildgebenden Diagnostik (diagnostic image report) kann die Accession Number in den XDS-I Metadaten in der ReferenceIdList angegeben werden, wenn eine Verlinkung gewünscht wird.
Der Wert eines Listelementes innerhalb einer referenceIdList hat dem HL7 Datentyp CXi zu folgen (siehe oben).
Accession Number wird wird als ebRIM Slot gemäß folgender Vorschrift zusammengesetzt:
=XDS Metadaten für CDA Dokumente=
Die folgenden Kapitel spezifizieren die XDS-Metadaten von HL7 CDA-Dokumenten für deren Verwendung in ELGA. Nicht angegebene Metadaten sind nicht weiter eingeschränkt. Für diese gelten die generellen Vorgaben wie in IHE IT Infrastructure Technical Framework, vol3, revVol. 17, 3 "Table 4.2.3.2-1 DocumentEntry Metadata Attribute Definition" angeführt.<ref name="ITITF3"/>
==XDS Metadaten 1: aus dem CDA-Inhalt abgeleitet==
===creationTime===
Dokumentiert das Erstellungsdatum bzw. den ZeitpunktMedizinisch relevantes Datum, an dem das Dokument inhaltlich fertiggestellt wurdeje nach Definition im speziellen Leitfaden. Das XDS Profil schreibt vor, dass sämtliche Zeiten in UTC vorliegen MÜSSENDieses Datum kann für die chronologische Sortierung der Befunde bei der Anzeige der Dokumentenliste verwendet werden.
Im Fall eines CDA R2 Dokuments gilt folgende Verknüpfung mit den CDA Header Elementen:
#Im CDA wird dieser Zeitpunkt wie folgt abgelegt:##<br />ClinicalDocument/effectiveTime#Laut Vorgabe der ELGA Gesundheitsdaten ist die Angabe des Erstellungsdatums ein verpflichtendes Elementverpflichtend.
#Im CDA wird jeweils das medizinisch zutreffendste Datum angeführt. Die Bedeutung des Datums ist für jede einzelne Dokumentenklasse im zugehörigen speziellen Leitfaden separat definiert.
#Ein einfaches Zeitelement (HL7 TS) in CDA beinhaltet unter anderem die folgenden Attribute:#<br />@value … enthält das Datum in folgenden möglichen Formen
##YYYYMMDD
##YYYYMMDDhhmmss[+/-]HHMM (Zeitzone)###<br />Bsp: 20081224082015+0100###<br />Für: 24.12.2008, 08:20:14, Zeitzone GMT+1# Das XDS Profil schreibt vor, dass sämtliche Zeiten in UTC vorliegen MÜSSEN. 
{{BeginYellowBox}}
CreationTime entfällt bei On-Demand DocumentsDocumenten.
{{EndYellowBox}}
 
Das Aktualisierungsdatum von Dokumenten (Update-Datum) kann über submissionTime (in XDS.submissionSet) erkannt werden.
====Spezifikation====
##ClinicalDocument/recordTarget/patientRole/id
#Laut Vorgabe der ELGA Gesundheitsdaten ist die Angabe von mindestens den folgenden zwei IDs des Patienten im CDA verpflichtend bzw. verpflichtend, wenn bekannt:
##id[1] … Lokale ID des Patienten vom einbringenden (lokalen) System
##id[2] … Österreichische Sozialversicherungsnummer (nur wenn bekannt)<br /><span style="color:red;">Achtung: Diese ID gelangt nicht in die Metadaten!</span>
</pre>
Dies entspricht einer Transformation auf den HL7 v2 CX Datentyp gemäß IHE ITI TF-3<ref name="ITITF3"/>.
{{BeginYellowBox}}
Ein spezieller Leitfaden kann eine abweichende Mapping-Vorschrift definieren!
{{EndYellowBox}}
===sourcePatientInfo===
====submissionSet.contentTypeCode====
Der contentTypeCode des SubmissionSets Submission Sets wird als ebRIM Classification umgesetzt und soll dieselben Werte wie typeCode des DocumentEntry tragen.
$code = ClinicalDocument/code/@code
====Referenz zwischen Dokument und Studie (Accession Number)====
Um eine Verknüpfung zwischen den über ein KOS Objekt referenzierten Bilddaten und den zugehörigen Befunden herzustellen, wird ein weiterer Identifier benötigt, der sowohl bei der Aufnahme (''acquisition, store'') als auch bei der Befundschreibung (''report'') verfügbar ist. Dies trifft auf die Accession Number zu (dasjenige bzw. ein vergleichbares Element, das im implementierten Workflow zur Verknüpfung von Studie und Befund verwendet wird).
=====Spezifikation=====
Bei der Registrierung von KOS Objekten MUSS eine Accession Number in den XDS-I Metadaten in der ReferenceIdList angegeben werden.
Für Befunde der Bildgebenden bildgebenden Diagnostik (diagnostic image report) KANN die als Accession Number in den jene aus der ReferenceIdList der XDS-I Metadaten in der ReferenceIdList angegeben werdendes KOS Objektes, wenn mit dem eine Verlinkung gewünscht wirdhergestellt werden soll, genutzt werden. Der Wert eines Listelementes innerhalb einer referenceIdList hat dem HL7 Datentyp CXi zu folgen (siehe oben). Accession Number wird wird als ebRIM Slot gemäß folgender Vorschrift zusammengesetzt:
</pre>Siehe auch IHE RAD TF3 4.68.4.1.2.4.1 "Linking Report to Set of DICOM Instances"
<br />
 
====Verlinkung via Aufenthaltszahl (encounterId)====
Durch encounterId wird die Verlinkung sämtlicher Befunde oder Bilddaten (siehe Kapitel [[ILF:XDS_Metadaten_(Version_3)#referenceIdList|referenceIdList]] für Dicom KOS-Objekte), die im Rahmen eines Aufenthaltes verfasst wurden, in den XDS-Metadaten unterstützt. Dies geschieht, indem dieselbe Aufenthaltszahl als encounterId in den XDS-/XDS-I Metadaten der zu gruppierenden Objekte strukturiert wird.
<Slot name="<nowiki>urn:ihe:iti:xds:2013:referenceIdList</nowiki>">
<ValueList>
<Value>Az123456^^^&amp;amp;1.2.40.0.34.99.4613.3.4&amp;amp;ISO^<nowiki>urn:ihe:iti:xds:2015:encounterId</nowiki> </Value> </ValueList>
</Slot>
</ExtrinsicObject>
2.168
Bearbeitungen

Navigationsmenü