FHIR-Bundle anzeigen und lesen

Wofür es Bundles gibt

Nach der Spezifikation fasst ein Bundle Ressourcen zusammen, zum Beispiel als Ergebnis einer Suche, als Versionsverlauf (history), als Nachricht, als Dokument oder als Transaktion, die mehrere Ressourcen auf einem Server in einem Schritt anlegt, ändert oder löscht. Welche Art vorliegt, steht in Bundle.type: document | message | transaction | transaction-response | batch | batch-response | history | searchset | collection. Das Feld ist ein Pflichtfeld (1..1); fehlt es, meldet der Viewer das.

Ein Bundle ist nicht dasselbe wie contained: Contained-Ressourcen existieren nur im Kontext ihrer Elternressource, Bundle-Einträge können dagegen eigenständig abrufbar sein.

So lesen Sie ein Bundle im Viewer

1. Kopfzeile: Neben Format und Ressourcentyp stehen die Zahl der Einträge und type. Im Beispiel oben: 11 Einträge, type: collection. Die „Bundle-Übersicht“ darunter zählt je Ressourcentyp: Patient 4, Observation 7.
2. Typ-Filter und Suche: Ein Klick auf einen Typ blendet die Einträge der anderen Typen aus. Das Suchfeld filtert die Eintragsliste.
3. Eintrag wählen: Karte, Baum und FHIRPath beziehen sich auf den gewählten Eintrag; im FHIRPath-Tab können Sie auch das ganze Bundle auswerten.
4. Referenzen folgen: Ein Verweis führt zum Zieleintrag, mit „← Zurück“ kehren Sie um. Beim Ziel steht unter „Referenziert von“, welche Einträge auf ihn zeigen.
5. Hinweise lesen: Die Liste „Plausibilitätshinweise“ nennt auffällige Stellen; ein Klick auf die Stelle springt zum betroffenen Eintrag.

Wie Referenzen aufgelöst werden

Eine Referenz wie "reference": "Patient/example" ist ein Verweis, kein Einbetten. Der Viewer sucht das Ziel in dieser Reihenfolge: zuerst einen Eintrag, dessen fullUrl passt (auch eine relative Referenz wird gegen die Basis der fullUrl aufgelöst), bei Versionsangaben passend zur meta.versionId; bei einer Referenz nur mit identifier einen Eintrag mit diesem Identifier; bei #id eine contained-Ressource. Findet er nichts über die fullUrl, versucht er Typ und id und markiert das als Info, weil die Spezifikation dafür nichts festlegt. Externe URLs löst die Seite nicht auf, weil sie keine Netzwerkanfragen stellt; sie erscheinen als Info.

Zur Einordnung der Referenzarten steht in der Spezifikation: ein Literalverweis (reference) und ein logischer Verweis (identifier) sind beide möglich.

Welche Bundle-Regeln der Viewer prüft

Nicht geprüft werden bdl-2, bdl-5 und bdl-8 sowie alle Regeln der enthaltenen Ressourcen. Zusätzlich gibt es eine Warnung, wenn fullUrl außerhalb von transaction und batch fehlt. Der Viewer bleibt damit eine Lesehilfe und ersetzt keine Validierung.

Die drei Bundle-Beispiele

• Bundle mit Referenzen (collection): Patient 4, Observation 7 (Anzahl der Einträge). Gut, um Klicks von einer Observation zum Patienten zu üben. Zwei Hinweise (Info): eine Referenz auf einen externen Server und eine, die nur über Typ und id gefunden wird.
• Suchergebnis (searchset): MedicationRequest 1, Medication 1. Eine MedicationRequest und das Arzneimittel, auf das sie über medicationReference verweist. Der Viewer meldet hier, dass der Patient Patient/347 nicht im Bundle liegt: ein Suchergebnis enthält nicht automatisch alle referenzierten Ressourcen.
• Transaktion (transaction): Patient 5, (nur request) 4, Parameters 1. Jeder Eintrag trägt request mit Methode und URL, etwa POST Patient, PUT Patient/123 und DELETE Patient/234; Regel bdl-3 verlangt genau das.

Passend dazu

Mit dem FHIRPath-Tester zählen Sie zum Beispiel die Observations eines Bundles. Wie Ressourcen allgemein aufgebaut sind, steht unter Was ist FHIR?.