320
Bearbeitungen
Änderungen
→XDS-I Metadaten für DICOM KOS Objekte
Die Personen und/oder Maschinen, die das Dokument erstellt haben. Dieses Attribut enthält die Subattribute: authorInstitution, authorPerson, authorRole, authorSpecialty (und authorTelecommunication).
====authorInstitution====
Das ''authorInstitution'' Element beschreibt die Organisation (GDA), in dessen Gültigkeitsbereich das ein Dokument oder Bilddatenobjekt erstellt wurde. Zur Befüllung dieser Information gibt es mehrere Möglichkeiten, beispielsweise über InstitutionName aus dem DICOM Header der Studie: Institution Name“, (0008,0080) oder wenn dort nicht verfügbar, muss er aus anderen Quellen ermittelt und eingetragen werden.
Im Fall eines CDA R2 Dokuments gilt folgende Verknüpfung mit den CDA Header Elementen:
# GDAsDie ''authorInstitution'' benötigt einen Namen und eine OID, in dessen Gültigkeitsbereich Dokumente erstellt die aus dem GDA-Index abgleitet werden können sind seitens der Basiskomponente „GDA Index“ mit einer eindeutigen OID ausgestattet. kann# Falls mehrere ID*''id'' OID der Organisation aus dem GDA-Elemente angegeben sind, ist id[1] Index (die erste IDmuss ermittelt werden) zu verwenden. #*''name'' Name der Organisation als String
{{BeginYellowBox}}
Das AuthorInstitution-Element ist von besonderer Wichtigkeit, da sie vom ELGA Berechtigungssystem bei Registrierung geprüft wird.
{{EndYellowBox}}
=====Spezifikation=====
<span >$instname</span> … ClinicalDocument/author/assignedAuthor/representedOrganizationName der Organisation, die die Studie erstellt hat
<span>$id ... OID der Organisation aus dem GDA-Index</span>
<pre class="ilfbox_code">
<Classification classificationScheme="urn:uuid:93606bcf-9494-43ec-9b4e-a7748d1a838d"
Dies entspricht einer Transformation auf den HL7 v2 XON Datentyp gemäß [IHE ITI-TF3].
====authorPerson====
Das Element ''authorPerson'' beschreibt die Identifikation und demographische Informationen der Person oder das Gerät/die Software, welche die Bilddaten inhaltlich erstellt hat.
=====Spezifikation für Personen=====
'''authorPerson''' wird als ebRIM Slot gemäß folgender Vorschrift zusammengesetzt:
<pre class="ilfbox_code">
<Classification classificationScheme="urn:uuid:93606bcf-9494-43ec-9b4e-a7748d1a838d"
<Slot name="authorPerson">
<ValueList>
<Value>2323^Hummel^Frank^^^^^MusterDoc^&amp;1.2.40.0.34.99.4613.3.3&amp;ISO
</Value>
</ValueList>
</Slot>
</Classification></pre>
Dies entspricht einer Transformation auf den HL7 v2 XCN Datentyp gemäß [IHE ITI-TF3].
=====Spezifikation für Software und Geräte=====
'''authorPerson''' wird als ebRIM Slot gemäß folgender Vorschrift zusammengesetzt:
<Classification classificationScheme="urn:uuid:93606bcf-9494-43ec-9b4e-a7748d1a838d"
classifiedObject="urn:uuid:f0573b34-ea9a-4c6d-8556-5cffbe50f027"
<Slot name="authorPerson">
<ValueList>
<Value>^Good Health SystemCT^Best Health Software ApplicationGeräthersteller^Gerätename</Value>
</ValueList>
</Slot>
====authorRole====
Das ''authorRole'' Element beschreibt die Rolle, die der inhaltliche Autor des Dokuments (bzw. das erstellende Gerät) zum Zeitpunkt der Dokumentation innehatte. Dieser Leitfaden beschreibt keine Einschränkungen für die Verwendung.
Beispiel:
====authorSpeciality====
Beispiel:
*„Facharzt für Radiologie“
*„Facharzt für Nuklearmedizin“
<br />
======Spezifikation======
'''authorSpeciality''' wird als ebRIM Slot gemäß folgender Vorschrift zusammengesetzt:
<pre class="ilfbox_code">
<Classification classificationScheme="urn:uuid:93606bcf-9494-43ec-9b4e-a7748d1a838d"
<Slot name="authorSpeciality">
<ValueList>
<Value>Anästhesiologie und IntensivmedizinFachärztin/Facharzt für Radiologie</Value>
</ValueList>
</Slot>
</pre>
{{BeginYellowBox}}
Wenn eine Person als Autor vorhanden ist, MUSS der Wert einem DisplayName aus dem Value Set „ELGA_AuthorSpeciality“ entsprechen. Im Fall von Geräten oder Software als Autor sowie in ODD bleibt MUSS das Element leerbleiben.
{{EndYellowBox}}
===classCode (und classCodeDisplayName)===
Das ''classCode'' Element beschreibt die Dokumentenklasse klassifiziert (grobe Granularität) der das Dokument angehört registrierte Objekt und ist relevant für das BerechtigungssystemBerechti-gungssystem.
Unterscheidung classCode/typeCode:
|Dokumentenklasse in feiner Granularität.<br /> Siehe Kapitel [[ILF:XDS Metadaten 2020#typeCode_.28und_typeCodeDisplayName.29|4.2.15]]
|}
====Spezifikation====
'''classCode (und classCodeDisplayName)''' wird als ebRIM Classification gemäß folgender Vorschrift zusammengesetzt:<br />
$code = ClinicalDocument/code/translation/@code"55113-5"<br />$displayName = ClinicalDocument/code/translation/@displayName"Key images Document Radiology"<br />$codeSystem = ClinicalDocument/code/translation/@codeSystem"2.16.840.1.113883.6.1"<br />
<pre class="ilfbox_code">
<Classification classificationScheme="urn:uuid:41a5887f-8865-4c09-adf7-e362475b143a"
In Registries, die nicht ausschließlich für ELGA Verwendung finden (z.B. auch für andere eHealth-Anwendungen) sollten ebenfalls einheitliche Codes für die Dokumentenklasse und den Dokumententyp angewendet werden. Eine entsprechende Liste “hl7-austria-Dokumentenklassen” OID {1.2.40.0.34.10.86} wird von der HL7 Austria standardisiert (http://www.hl7.at).
[https://termpub.gesundheit.gv.at/TermBrowser/gui/main/main.zul?loadType=ValueSet&loadName=HL7-at_XDS-Dokumentenklassen Direktlink]
===confidentialityCode===
Das ''confidentialityCode'' Element beschreibt die Vertraulichkeitsstufe des DokumentsDICOM KOS Objektes.
Die Konzeption des ELGA Berechtigungssystems sieht vor, den Zugriff auf Dokumente ausschließlich aus-schließlich in der ELGA Infrastruktur zu verwalten, dementsprechend wird dieses Element vorerst nicht genutzt, bzw. fix auf „normal“ (N) gesetzt. Die Angabe dieses verpflichtenden XDS Metadaten Elements ist dennoch erforderlich und . Es wird fix auf "N" (normal) gesetzt.der Vertraulichkeitscode gemäß folgender Spezifikation übernommen:
====Spezifikation====
confidentialityCode wird als ebRIM Slot gemäß folgendem Beispiel abgebildetfolgender Vorschrift zusammengesetzt: $code = "N"<br />$displayName = "normal"<br />$codeSystem = "2.16.840.1.113883.5.25" <br/>
<pre class="ilfbox_code">
===creationTime===
Das creationTime Element beschreibt den Zeitpunkt der DokumentenerstellungErstellung des registrieren Doku-ments oder Objektes. Das XDS Profil schreibt vorEs soll die Zeit angegeben werden, dass sämtliche Zeiten in UTC vorliegen MÜSSEN.die diese Erstellungszeit am besten beschreibt:
[[#%20ftnref1|[3]]] <nowiki>http://dicom.nema.org/medical/dicom/current/output/chtml/part03/sect_C.12.html#sect_C.12.1.1.8</nowiki>
====Spezifikation====
'''creationTime''' wird als ebRIM Slot gemäß folgender Vorschrift zusammengesetzt:<br/>ClinicalDocument/effectiveTime/@value $date = (0008,0020) Study Date – oder (0008,0023) Content Date $time = "20200511193000(0008,0030) Study Time - oder (0008,0033) Content Time +0200"(0008,0201) Timezone Offset from UTC concat( @date, @time )<br /><pre class="ilfbox_code">
<ExtrinsicObject mimeType="text/xml"
objectType="urn:uuid:7edca82f-054d-47f2-a032-9b2a5b5186c1"
<Slot name="creationTime">
<ValueList>
<Value>2020051117300020100511134500</Value>
</ValueList>
</Slot>
</pre>
{{BeginYellowBox}}
===eventCodeList (und eventCodeListDisplayName)===
====Spezifikation====
'''eventCodeList (und eventCodeListDisplayName)''' wird als ebRIM Slot gemäß folgender Vorschrift zusammengesetzt:<br/>
Für jedes documentationOf Element 1..n:<br/>
<span >$code </span>= ClinicalDocument/documentationOf[n]/serviceEvent/code/@APPC code(alle Achsen) z.B. "2.4.0.5-3-3"<br/><span >$displayName</span> = ClinicalDocument/documentationOf[n]/serviceEvent/code/@APPC displayNamez.B. "CT.Unpaarig.Unbestimmte Prozedur.Lendenwirbelsäule"<br/><span >$codeSystem</span> = ClinicalDocument/documentationOf[n]/serviceEvent/code/@codeSystemOID des Codesystems APPC: 1.2.40.0.34.5.38<br/>
<pre class="ilfbox_code">
<Classification
</Classification>
</pre>
===languageCode===
Das ''languageCode'' Element beschreibt den Sprachcode in dem das ein Dokument oder Objekt verfasst bzw. beschlagwortet ist. Im Fall eines CDA R2 Dokuments gilt folgende Verknüpfung mit den CDA Header ElementenDerzeit wird ein fester Wert vorgeschrieben:'''de-AT'''
====Spezifikation====
'''languageCode''' wird als ebRIM Slot gemäß folgender Vorschrift zusammengesetzt:
<pre class="ilfbox_code">
<ExtrinsicObject mimeType="text/xml"
===legalAuthenticator===
Für CDA R2 Dokumente gilt folgende Verknüpfung mit den CDA Header Elementen:# Laut Festlegung die serviceStopTime steht kein Mapping zur Verfügung und wird die Person, welche das Dokument vidiert hat, im Element „legalAuthenticator“ abgelegt:## ClinicalDocument/legalAuthenticator/assignedEntity{{BeginYellowBox}}'''ACHTUNG:''' Nach DocumentEntry.legalAuthenticator kann jeweils nur das erste Element (ClinicalDocument/LegalAuthenticatordaher nicht angegeben [1NP]) übernommen werden.{{EndYellowBox}}# Die vidierende Person## Ein Personenelement in CDA beinhaltet unter anderem die folgenden Unterelemente:### id … ID der Person mit den folgenden Attributen:#### @root … Root OID des ID Pools, oder direkte die OID der Person (ohne @extension-Attribut)#### @extension … Eigentliche ID des Elements aus dem gegebenen ID Pool (falls die @root nicht direkt die Person identifiziert)### assignedEntity#### Enthält ein HL7 Personen-Element, welches das Namen-Element zur Person enthält##### Name
====Spezifikation====
'''legalAuthenticatorserviceStartTime''' wird als ebRIM Slot gemäß folgender Vorschrift zusammengesetzt:<br/>
Study Date,
<ExtrinsicObject mimeType="text/xml"
objectType="urn:uuid:7edca82f-054d-47f2-a032-9b2a5b5186c1"
status="urn:oasis:names:tc:ebxml-regrep:StatusType:Approved"
id="urn:uuid:1e2ede82-8570-4be2-bd46-de986a4333be">
<Slot name="legalAuthenticatorserviceStartTime">
<ValueList>
<Value>1234^Musterdoktor^Herbert^^^Dr.^^^&amp;1.2.3.4.5.6.7.8.9&amp;ISO20100511134500</Value>
</ValueList>
</Slot>
</ExtrinsicObject>
</pre>
Eine OID zur Definition des Namensraumes des verwendeten Patientenidentifikators muss entsprechend vorhanden sein.
====Spezifikation====
'''serviceStartTimesourcePatientId''' wird wird als ebRIM Slot gemäß folgender Vorschrift zusammengesetzt:ClinicalDocument/documentationOf/serviceEvent/effectiveTime/low/@value = "20200511193000+0200"<pre class$patientID ="ilfbox_code">(0010,0020) Patient ID<ExtrinsicObject mimeType="text/xml" objectType$oid ="urn:uuid:7edca82f-054d-47f2-a032-9b2a5b5186c1"OID des lokalen Patientenidentifikators status="urn:oasis:names:tc:ebxml-regrep:StatusType:Approved" id="urn:uuid:1e2ede82-8570-4be2-bd46-de986a4333be"> <Slot name="serviceStartTime"> <ValueList> <Value>20200511173000</Value> </ValueList> </Slot></ExtrinsicObject></pre>{{BeginYellowBox}}Dieses Element MUSS – entsprechend der tatsächlichen Angabe in CDA – entweder mit 8 Stellen concat(YYYYMMDD) oder 14 Stellen (YYYYMMDDhhmmss) angegeben werden. Ein „Kürzen“ auf andere Formate ist nicht zulässig.
"^^^&amp;",
$oid,
"&amp;ISO"
<pre class="ilfbox_code">
<ExtrinsicObject mimeType="text/xml"
status="urn:oasis:names:tc:ebxml-regrep:StatusType:Approved"
id="urn:uuid:1e2ede82-8570-4be2-bd46-de986a4333be">
<Slot name="serviceStopTimesourcePatientId">
<ValueList>
</ValueList>
</Slot>
</ExtrinsicObject>
</pre>
{{EndYellowBox}}
===sourcePatientId=Spezifikation (empfohlene Variante)====Das ''sourcePatientId'sourcePatientInfo''' Element beschreibt die Patienten ID des Patienten im lokalen Informationssystem des GDA.wird als ebRIM Slot gemäß folgender Vorschrift zusammengesetzt:
$name = "^^^&amp;",
$gender = "&amp;ISO"
<ExtrinsicObject mimeType="text/xml"
objectType="urn:uuid:7edca82f-054d-47f2-a032-9b2a5b5186c1"
status="urn:oasis:names:tc:ebxml-regrep:StatusType:Approved"
id="urn:uuid:1e2ede82-8570-4be2-bd46-de986a4333be">
<Slot name="sourcePatientIdsourcePatientInfo">
<ValueList>
<Value>4711^^^&amp;1.2.PID-3.4.|$id</Value><Value>PID-5.6.|$name</Value><Value>PID-7.|$birthtime</Value><Value>PID-8.9&amp;ISO|$gender</Value><Value>PID-11|$addr</Value>
</ValueList>
</Slot>
</ExtrinsicObject>
</pre><br />Dies entspricht einer Transformation auf ===title===Das ''title'' Element beschreibt den HL7 v2 CX Datentyp gemäß [IHE ITI-TF3]lesbaren Titel des registrierten Objektes.
====Spezifikation====
'''title''' wird als ebRIM "Name/@value"-Attribut im Container "ExtrinsicObject" gemäß folgender Vorschrift zusammengesetzt:
<ExtrinsicObject mimeType="text/xml"
objectType="urn:uuid:7edca82f-054d-47f2-a032-9b2a5b5186c1"
id="urn:uuid:1e2ede82-8570-4be2-bd46-de986a4333be">
<Name>
<LocalizedString charset="UTF-8" value="Entlassungsbrief der chirurgischen AbteilungDX Digitales Röntgen des Schädels" xml:lang="de-AT" />
</Name>
</ExtrinsicObject>
{| class="wikitable"
|- style="background:white"
| '''typeCode'''| '''Dokumentenklasse in feiner Granularität (Spezialisierung).'''
|- style="background:white"
| classCode| Dokumentenklasse in grober Granularität.<br/> Siehe Kapitel [[ILF:XDS Metadaten 2020#classCode_.28und_classCodeDisplayName.29|classCode]]
|}
Im Fall eines CDA R2 Dokuments gilt folgende Verknüpfung mit den CDA Header Elementen:
# Im CDA wird die Klassifizierung des Dokuments wie folgt abgelegt:## ClinicalDocument/code# Laut Vorgabe der ELGA Gesundheitsdaten ist die Angabe des Dokumentencodes ein verpflichtendes Element.# Ein Code-Element in CDA beinhaltet unter anderem die folgenden Attribute:## @code … Codierter Wert der Dokumentenklasse### Bsp: Code „11490-0“## @displayName … Lesbarer Wert der Dokumentenklasse### Bsp: „Discharge summarization note (physician)”## @codeSystem … Codierter Wert des zugrundliegenden Codesystems### Bsp: „2.16.840.1.113883.6.1“# Laut Vorgabe der ELGA Gesundheitsdaten ist die Angabe dieser 3 Attribute des Elements code verpflichtend.
====Spezifikation====
'''typeCode (und typeCodeDisplayName)''' wird wird als ebRIM Classification zum DocumentEntry umgesetzt und gemäß folgender Vorschrift zusammengesetzt:
<span > $code</span> = ClinicalDocument/code/@code<br/><span > $displayName</span> = ClinicalDocument/code/@displayName<br/><span > $codeSystem</span> = ClinicalDocument/code/@codeSystem<br/>
<pre class="ilfbox_code">
<Classification
Im Fall eines CDA R2 Dokuments gilt folgende Verknüpfung mit den CDA Header Elementen:
# Laut Vorgabe der ELGA Gesundheitsdaten ist die Angabe einer ID für das Dokument verpflichtend:## ClinicalDocument/id
====Spezifikation====
uniqueId wird als ebRIM ExternalIdentifier zum DocumentEntry gemäß folgender Vorschrift zusammengesetzt:<br/>
Fall 1<br/>
Attribut ClinicalDocument/id/@extension ist nicht vorhanden
$value = concat(ClinicalDocument/id/@root)
Fall 2<br/>
Attribut ClinicalDocument/id/@extension ist vorhanden
Im Fall eines CDA R2 Dokuments gilt folgende Verknüpfung mit den CDA Header Elementen:
# Laut Vorgabe der ELGA Dokumenten Leitfäden ist die Angabe einer setId für das Dokument verpflichtend: ## ClinicalDocument/setId
====Spezifikation====
Mögliche Werte laut IHE sind:
* Approved* Deprecated
Dieses Attribut wird im Zuge des Einbringens von neuen Dokumenten („Submission“) durch die empfangende XDS Registry immer auf “'''Approved'''” gesetzt.
Im CDA-Schema wurde für die HL7-Austria Domäne ein genau entsprechendes Element geschaffen, "hl7at:formatCode".
====Bildungsregel für den formatCodeDisplayName ====
TODO: Prüfen, ob diese Bildungsregel noch gültig ist. Weiters ist FormatCodeDisplayName ist nicht Teil des CDA, allerdings 1..1 M nach IHE XDS.
'''Beispiele:'''
* '''ELGA Entlassungsbrief Ärztlich, EIS Basic v2.06:PDF'''* '''ELGA Entlassungsbrief Pflege, EIS Enhanced v2.06+'''* '''ELGA Laborbefund, EIS Full Support v2.06+'''
====Spezifikation====
'''formatCode (und formatCodeDisplayName) '''wird als ebRIM Classification gemäß folgender Vorschrift zusammengesetzt:<br/><span >$code</span> = ClinicalDocument/hl7at:formatCode/@code <br/><span >$displayName</span> = gemäß Liste der in ELGA gültigen FormatCodes<br/><span >$codeSystem</span> = OID der Liste der in ELGA gültigen FormatCodes, fixiert mit OID 1.2.40.0.34.5.37 von [https://termpub.gesundheit.gv.at:443/TermBrowser/gui/main/main.zul?loadType=ValueSet&loadName=ELGA_FormatCode_VS ELGA_FormatCode_VS]
<pre class="ilfbox_code">
<Classification
'''healthcareFacilityTypeCode (und healthcareFacilityTypeCodeDisplayName)''' wird als ebRIM Classification gemäß folgender Vorschrift zusammengesetzt:
<span >$code </span>= ClinicalDocument/componentOf/encompassingEncounter/location/healthCareFacility/code/@code
<span >$displayName </span>= ClinicalDocument/componentOf/encompassingEncounter/location/healthCareFacility/code/@displayName
<span >$codeSystem </span>= ClinicalDocument/componentOf/encompassingEncounter/location/healthCareFacility/code/@codeSystem
<pre class="ilfbox_code">
'''mimeType''' wird im Attribut @mimeType des ebRIM ExtrinsicObject abgebildet, das das DocumentEntry repräsentiert.
Folgende Mime-Types sind für Dokumente zugelassen:<br/>CDA R2: '''text/xml'''<br/>DICOM/KOS: '''application/dicom'''<br/>
<pre class="ilfbox_code">
Im Fall eines CDA R2 Dokuments gilt folgende Verknüpfung mit den CDA Header Elementen:
# Im CDA werden die Informationen über Dokumente, die mit dem eingebrachten Dokumenten in einer bestimmten Relation stehen, in folgendem Element abgelegt:## ClinicalDocument/relatedDocument# Der Typ der Relation MUSS verpflichtend in folgendem Attribut angegeben werden:## ClinicalDocument/relatedDocument/@typeCode## Folgende Relationen sind in ELGA erlaubt (siehe „[[ILF:Allgemeiner Implementierungsleitfaden 2020|Allgemeiner Implementierungsleitfaden für ELGA CDA Dokumente]]“ [1]):### Versionierung (RPLC)# Das zugrundeliegende Dokument (auf welches die Art der Relation wirkt), wird in folgendem Element angegeben:## ClinicalDocument/relatedDocument/parentDocument
====Spezifikation====
ClinicalDocument/relatedDocument/@typeCode
'''practiceSettingCode (und practiceSettingCodeDisplayName)''' wird als ebRIM Classificationgemäß folgender Vorschrift zusammengesetzt:
<span >$code</span> = ClinicalDocument/hl7at:practiceSettingCode/@code<br/><span >$displayName</span> = ClinicalDocument/hl7at:practiceSettingCode/@displayName<br/><span >$codeSystem</span> = ClinicalDocument/hl7at:practiceSettingCode/@codeSystem<br/>
<pre class="ilfbox_code">
<Classification
</pre>
===objectType ===
Das objectType Element gibt den Typ des XDS DocumentEntry wieder. Entsprechend den IHE XDS Vorgaben wird zwischen den Typen „stabiles Dokument“ (stable document, SD) und „On-demand Dokument“ (on-demand document, ODD) unterschieden. Der objectType ist als ebRIM ExtrinsicObjectist/@objectType Attribut umgesetzt und jeweils durch eine fixe UUID identifiziert.
===elgaFlag===
Das elgaFlag dient zur Kennzeichnung eines Dokuments als „ELGA-Dokument“<sup>18</sup>. Ein XDS Source des ELGA-Bereiches sendet eine „XDS.b Provide and Register Transaktion [ITI-41]“, eine „XDS.b Register Document Transaktion [ITI-42]“ oder eine „XDS Update Document [ITI-57]“ an die ELGA-Zugriffssteuerungsfassade (ZGF). Hierbei wird das Attribut „elgaFlag“ entsprechend dem Ergebnis der Berechtigungsprüfung dieser Transaktionen gemäß individueller Zugriffsberechtigungen des Patienten von der ELGA-Zugriffssteuerungsfassade (ZGF) explizit gesetzt. „elgaFlag“ kann folgende Werte annehmen:
* "true" oder* "false"
====Spezifikation====
<!--Anhänge-->
<references />
=XDS Metadaten für CDA Dokumente=