HL7 CDA-Datei öffnen: so wird aus XML ein lesbarer Arztbrief

In fünf Schritten

1. Datei erkennen

   Die Dateiendung allein sagt nichts über den Inhalt. Öffnen Sie die Datei in einem Texteditor: Sie muss mit dem Element ClinicalDocument im Namensraum urn:hl7-org:v3 beginnen.

   <?xml version="1.0" encoding="UTF-8"?>
   <ClinicalDocument xmlns="urn:hl7-org:v3">
     <typeId root="2.16.840.1.113883.1.3" extension="POCD_HD000040"/>
     <id root="…" extension="…"/>
     <code code="…" codeSystem="2.16.840.1.113883.6.1"/>
     …
   </ClinicalDocument>

2. Im Viewer öffnen

   Ziehen Sie die Datei in das Feld auf der Startseite, wählen Sie sie aus oder fügen Sie den XML-Text ein. Die Datei wird nicht übertragen.

3. Ansicht wählen

   „Dokument“ zeigt den Brief mit Inhaltsverzeichnis. „Strukturdaten“ listet Kopf und codierte Einträge als Tabellen. „Roh-XML“ zeigt den Quelltext, wahlweise eingerückt.

4. Hinweise lesen

   Über dem Dokument stehen Plausibilitätshinweise, etwa wenn Kopfbestandteile fehlen. Sie ersetzen keine Validierung.

5. Drucken oder als PDF sichern

   „Druckansicht“ öffnet den Druckdialog des Browsers. Gedruckt wird nur das Dokument. Wählen Sie dort „Als PDF speichern“, wenn Sie eine Datei brauchen.

Warum eine CDA-Datei im Browser unlesbar aussieht

CDA trennt Inhalt und Darstellung. Der Standard verlangt, dass jedes Dokument seine klinischen Informationen in lesbarer Form enthält, und dass sich der Inhalt mit „einem einzigen Stylesheet und marktüblichen Browsern“ darstellen lässt (Quelle: VHitG-Arztbrief-Leitfaden v1.50 (HL7 Deutschland), Kapitel 3.3.6). Die Darstellung selbst liefert die Datei nicht mit. Die Datei kann über die Verarbeitungsanweisung xml-stylesheet mit einem XSL-Stylesheet verknüpft sein. Die drei C-CDA-Beispiele von HL7 im Viewer enthalten genau diese Zeile mit href="CDA.xsl". Liegt das Stylesheet nicht neben der Datei, bleibt dem Browser nur der Elementbaum.

Warum dieser Viewer ohne XSLT arbeitet

Chromium hat XSLT (einschließlich der XSLTProcessor-API und der Verarbeitungsanweisung xml-stylesheet) offiziell als veraltet erklärt. Nach der Planung von Chrome stoppt XSLT in Chrome 158 am 17. November 2026 für alle Nutzer außer Teilnehmern des Origin Trials und einer Enterprise Policy, in Chrome 176 am 17. August 2027 für alle. Firefox und WebKit haben ebenfalls Pläne zur Entfernung angedeutet (Quelle: Chrome for Developers, Removing XSLT for a more secure browser). Ein Verfahren, das nur auf einem Stylesheet im Browser beruht, kann damit ausfallen.

Der CDA-Viewer liest die Datei deshalb mit dem XML-Parser des Browsers (DOMParser) und erzeugt die Ansicht mit eigenem Code. Das hat zwei Folgen: Er braucht kein Stylesheet, und er kann den Text der Abschnitte streng filtern. Aus dem Narrativtext übernimmt er nur eine feste Liste von Elementen (Absätze, Listen, Tabellen, Hervorhebungen, Links mit http, https oder mailto). Skripte, Formulare, Bilder und unbekannte Elemente erscheinen nicht; bei unbekannten Elementen bleibt nur der Text.

Fehlermeldungen und was sie bedeuten

Die Meldungen unten stammen aus dem Viewer. Fehler erscheinen als Klartext im Statusbereich über der Ansicht, nicht als Skriptfehler.

Die Datei ist kein wohlgeformtes XML.

Der Viewer prüft zuerst selbst auf bestimmte Fehler (nicht geschlossene Elemente, nacktes &, fehlendes Wurzelelement) und nennt Zeile und Spalte. Bei anderen Fehlern gilt die Meldung des XML-Parsers im Browser. Mögliche Ursachen: abgeschnittene Datei, nicht maskierte Zeichen wie & oder < im Text, oder die Datei ist gar kein XML (zum Beispiel ein PDF oder eine HL7-v2-Nachricht mit senkrechten Strichen).

Kein CDA-Dokument: Wurzelelement ist „Bundle“.

Das Wurzelelement ist nicht ClinicalDocument. Bei Bundle oder Composition handelt es sich um FHIR, bei Elementen wie PRPA_IN201301UV02 um eine HL7-v3-Nachricht. Beides sind keine CDA-Dokumente. Zum Unterschied siehe Was ist HL7 CDA?.

Die Datei enthält eine DOCTYPE- oder ENTITY-Deklaration und wird nicht geladen.

CDA-Dokumente brauchen keine DOCTYPE-Deklaration. Der Viewer lädt solche Dateien nicht, um Angriffe über Entity-Expansion auszuschließen. Entfernen Sie die Zeile, wenn Sie der Datei vertrauen.

Die Datei ist größer als 15 MB.

Der Viewer ist für Dokumente im Bereich weniger Megabyte gedacht. Große Dateien können eingebettete Anhänge enthalten, etwa ein PDF in einem nonXMLBody.

Das Wurzelelement liegt nicht im Namensraum „urn:hl7-org:v3“

Das Dokument heißt zwar ClinicalDocument, hat aber keinen oder einen anderen Namensraum. Der Viewer zeigt es trotzdem an und warnt. Prüfen Sie das Attribut xmlns am Wurzelelement.

Der structuredBody enthält keine Abschnitte (section).

Kein Fehler im Viewer: Das Dokument hat einen Body ohne Abschnitte. Beim eArztbrief nach KBV-Richtlinie ist das erlaubt, der Inhalt steht dann im PDF/A. Mehr unter Arztbrief lesen.

Der Body ist ein nonXMLBody …

Der Inhalt steckt als eingebettetes Dokument im XML. Der Viewer zeigt nur den Kopf und markiert die Stelle.

… Text-Verweis(e) (reference value="#…") zeigen auf eine ID, die im Dokument nicht vorkommt.

Ein codierter Eintrag verweist auf eine Stelle im Text, die es nicht gibt. Das deutet auf einen Fehler im erzeugenden System hin. Der Viewer zeigt die Daten trotzdem an.

Andere XML-Formate im Browser lesen

Ist Ihre Datei FHIR statt CDA, eine HL7-v2-Nachricht oder eine E-Rechnung, finden Sie unten passende Werkzeuge.