Ihevs:DocumentEntry.formatCode: Unterschied zwischen den Versionen
Foemig (Diskussion | Beiträge) (Initialfassung) |
Foemig (Diskussion | Beiträge) K |
||
Zeile 1: | Zeile 1: | ||
− | =DocumentEntry.formatCode= | + | ==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. | 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. | ||
Zeile 31: | Zeile 31: | ||
Innerhalb von Deutschland sollen URN-Codes dem folgenden Aufbau genügen: | Innerhalb von Deutschland sollen URN-Codes dem folgenden Aufbau genügen: | ||
− | ==CDA-Dokumente== | + | ===CDA-Dokumente=== |
{| border=1 | {| border=1 | ||
|- | |- | ||
Zeile 64: | Zeile 64: | ||
urn:ihe-d:pcc:arztbrief:2014:crossXmlBody | urn:ihe-d:pcc:arztbrief:2014:crossXmlBody | ||
− | ==Nicht CDA-Dokumente== | + | ===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: | 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: | ||
Zeile 92: | Zeile 92: | ||
− | ==Links== | + | ===Links=== |
* RFC 3406 (2002) URN Namespace Definition Mechanisms. Online, verfügbar unter http://tools.ietf.org/html/rfc3406* Internet Assigned Numbers Authority (IANA). Media Types. Online, verfügbar unter http://www.iana.org/assignments/media-types/media-types.xhtml | * RFC 3406 (2002) URN Namespace Definition Mechanisms. Online, verfügbar unter http://tools.ietf.org/html/rfc3406* Internet Assigned Numbers Authority (IANA). Media Types. Online, verfügbar unter http://www.iana.org/assignments/media-types/media-types.xhtml | ||
* RFC 2288 (1998) Using Existing Bibliographic Identifiers as Uniform Resource Names. Online, verfügbar unter http://tools.ietf.org/html/rfc2288 | * RFC 2288 (1998) Using Existing Bibliographic Identifiers as Uniform Resource Names. Online, verfügbar unter http://tools.ietf.org/html/rfc2288 |
Version vom 27. April 2016, 15:47 Uhr
Inhaltsverzeichnis
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
- RFC 3406 (2002) URN Namespace Definition Mechanisms. Online, verfügbar unter http://tools.ietf.org/html/rfc3406* Internet Assigned Numbers Authority (IANA). Media Types. Online, verfügbar unter http://www.iana.org/assignments/media-types/media-types.xhtml
- RFC 2288 (1998) Using Existing Bibliographic Identifiers as Uniform Resource Names. Online, verfügbar unter http://tools.ietf.org/html/rfc2288
- RFC 2141 (1997).URN Syntax. Online, verfügbar unter https://www.ietf.org/rfc/rfc2141.txt
- RFC 3151 (2001) A URN Namespace for Public Identifiers. Online, verfügbar unter https://tools.ietf.org/html/rfc3151