Ihevs:DocumentEntry.formatCode

Aus Hl7wiki
(Teildokument von )
Wechseln zu: Navigation, Suche
Dieses Material ist Teil des Leitfadens [[Category:|Ihevs:DocumentEntry.formatCode]].
  • Direkt im Wiki geändert werden sollten Schreibfehler, ergänzende Hinweise.
  • Offene Fragen, die der Diskussionen bedürfen, sollten auf der Diskussionsseite aufgenommen werden.
  • Liste der Seiten dieses Leitfadens: [[:Category:|hier]], Liste der Seiten, in denen dieses Material verwendet (transkludiert) siehe hier .

DocumentEntry.formatCode

Der Code spezifiziert das Format des Dokumentes. Zusammen mit dem typeCode soll der formatCode für hinreichende Information sorgen, um einem potenziellen XDS-Dokument-Verbraucher die Entscheidung zu ermöglichen, ob er das Dokumentenformat verarbeiten kann.

Das formatCode muss dabei hinreichend eindeutig formuliert sein, um die Verarbeitung/Anzeige des von der Registry angeforderten Dokumentes zu gewährleisten. D.h. die jeweiligen Werte des formatCodes stellen eine Sammlung von Schlüsselwörtern dar, die dem Anwender der Dokumente die Bedeutung der Dokumentenart erläutert.

formatCodes können durch verschiedene Organisationen definiert werden, insbesondere durch die Betreiber einer XDS-Domäne.

formatCodes, welche von IHE ITI definiert werden, haben immer das Präfix 

urn:ihe:iti:

Beipiele hierzu finden sich im Wiki von IHE International (http://wiki.ihe.net/index.php?title=IHE_Format_Codes). Wenn andere IHE Domänen formatCodes definieren, so sollen sie das Präfix 

urn:ihe:’domain initials’:

benutzen, wobei „domain initials“ die Domäne selbst repräsentiert. Wenn ein Betreiber einer XDS-Domäne einen eigenen formatCode definiert, so muss das Präfix 

urn:ad:’creating entity’:

verwendet werden, wobei „creating entity“ die definierende Institution vertritt. Definiert beispielsweise die Domäne „Gesundheitsversorgung Deutschland“, welche die Abkürung „GesDe“ nutzt, formatCodes, so lautet das Präfix „urn:ad:GesDe:“. Idealerweise wird für die AD die OID verwendet, da die OID der AD im Gegensatz zu freitextlichen Bezeichnern immer eindeutig ist. Damit wird zugleich die Vorgabe bzgl. der Vergabe des namespace identifier entsprochen, dass dieser mehr als zwei Zeichen umfassen muss .

formatCodes, welche von IHE Deutschland herausgegeben werden, haben immer das Präfix 

urn:ihe-d:

URN-Codes können außerhalb des Einsatzes für formatCodes auch für andere Zwecke verwendet werden. Daher werden die URN-Codes in zwei URN-Codesystemen angegeben: 1) MIME-Codes, 2) Non-MIME-Codes. MIME-Types wird immer das Präfix „urn:ihe-d:mime:“ vorangestellt, Non-MIME-Codes das Präfix „urn:ihe-d:xxxyyyzzz:“. Aus diesen Codesystemen sowie aus international verfügbaren Angaben von IHE zum Einsatz von formatCodes wird das ValueSet für formatCodes zusammengestellt.

Die Codes für das ValueSet „formatCode“ werden in art-decor zusammen mit den anderen von IHE Deutschland erstellten ValueSets veröffentlicht (http://art-decor.org/art-decor/decor-valuesets--ihede-).

Innerhalb von Deutschland sollen URN-Codes dem folgenden Aufbau genügen:

CDA-Dokumente

CDA-Dokumente ohne binärem Inhalt 
urn:ihe-d:xxxyyyzzz:’Bezeichner’:’Jahr’

bzw. 

urn:ad:’creating entity’:’Bezeichner’:’Jahr’
CDA-Dokumente mit einem Body, der aus einem binärem Inhalt besteht 
urn:ihe-d:xxxyyyzzz:’Bezeichner’:’Jahr’:’nonXmlBody’

bzw. 

urn:ad:’creating entity’:’Bezeichner’:’Jahr’:’nonXmlBody’
CDA-Dokumente mit einem Body, der aus einer XML-Inhalten und mind. einer eingebettenen binärem Datei besteht 
urn:ihe-d:xxxyyyzzz:’Bezeichner’:’Jahr’:’crossXmlBody’

bzw. 

urn:ad:’creating entity’:’Bezeichner’:’Jahr’:’crossXmlBody’

wobei „Bezeichner“ für den Inhalt des Dokumentes steht, „Jahr“ für das Jahr der Veröffentlichung. Sollten innerhalb eines Jahres mehr als eine Version erscheinen, wird zusätzlich die zweistellige Monatszahl der Angabe des Jahres hinzugefügt, getrennt von einem Bindestrich ‘-‘. (Beispiel: 2010-07).

Beispiel: Der 2014 von HL7 Deutschland veröffentlichte CDA-Arztbrief wird entsprechend der obigen Beschreibung wie folgt abgebildet:

a) Arztbrief: Level1-3 ohne binärem Inhalt 

urn:ihe-d:pcc:arztbrief:2014

b) Arztbrief: Level 1 CDA mit Body bestehend aus einer PDF-Datei (http://wiki.hl7.de/index.php?title=cdaab2:Beispiel_(vollst%C3%A4ndig)) 

urn:ihe-d:pcc:arztbrief:2014:nonXmlBody

c) Arztbrief: sowohl mit XML-Inhalt wie auch mindestens einer eingebetteten binären Datei 

urn:ihe-d:pcc:arztbrief:2014:crossXmlBody

Nicht CDA-Dokumente

Nicht CDA-Dokumente sollten über eine möglichst genaue Beschreibung des Dokumentenformats abgebildet werden. Ist dies nicht möglich, so soll der MIME-Type entsprechen der Liste von IANA genutzt werden:

IHE Deutschland 
urn:ihe-d:xxxyyyzzz:‘Bezeichner‘:Jahr
urn:ihe-d:mime:‘mime‘:Jahr
Betreiber einer XDS-Domäne 
urn:ad:’creating entity’:’Bezeichner’
urn:ad:’creating entity’:’mime’
urn:ad:’pdfA1’

Bezeichner = Typisierung des Formats, wenn kein genauerer Bezeichner da ist, Angabe mime-type

Auch hier steht „Bezeichner“ für den Inhalt des Dokumentes und „Jahr“ für das Jahr der Veröffentlichung, welches wann immer möglich angegeben werden sollte. Werden innerhalb eines Jahres mehr als eine Version des Formates veröffentlicht, so wird auch hier zusätzlich die zweistellige Monatszahl der Angabe des Jahres hinzugefügt, getrennt von einem Bindestrich ‘-‘. (Beispiel: 2010-07).

Beispiel: um ein pdf darzustellen kann der Format-Code „urn:ihe-d:mime:application/pdf“ unter Nutzung des MIMe-Types verwendet werden. Spezifischer wäre die Nutzung eines Bezeichners „PDF/A-1“, um das hiermit bezeichnete pdf-Format für die elektronische Archivierung abzubilden: „urn:ihe-d:xxxyyyzzz:PDF/A-1“ In beiden Fällen kommt „/“ vor, was in dieser Form nicht in einer URN verwendet werden darf . Entsprechend Kapitel 5.2 „Encoding Considerations and Lexical Equivalence“ von RFC 2288 muss „/“ %-encoded werden (siehe auch RFC 2141 ). Dementsprechend sind die Angaben aus dem Beispiel wie folgt umzusetzen (%2F repräsentiert „/“, siehe RFC 3151 ): a) urn:ihe-d:application %2Fpdf b) urn:ihe-d:PDF %2FA-1


Links

Abgerufen von „https://wiki.hl7.de/index.php?title=Ihevs:DocumentEntry.formatCode&oldid=29121“