FHIR-Explorer · Editor-Guide
Der Editor, Schritt für Schritt
Vom ersten Klick bis zum Export: Diese Seite zeigt, wie du mit dem FHIR-Explorer arbeitest. Alle Screenshots lassen sich per Klick vergrößern.
So ist der Editor aufgebaut
Drei Begriffe reichen, um sich zurechtzufinden:
Projekt
Ein importiertes FHIR-Package samt seiner Abhängigkeiten — z. B. die deutschen Basisprofile. Projekte liefern die Profile und Terminologien.
Dataset
Deine eigene Sammlung von Ressourcen innerhalb eines Projekts — etwa das Beispiel „Praxisteam“ oder ein Testdatensatz für dein Vorhaben.
Editor
Die Bearbeitungsansicht eines Datasets: Ressourcenliste, Formular, JSON und Validierung nebeneinander.
Die Projektübersicht: importierte Projekte mit ihren Datasets.
Schnellstart: mit dem Beispiel beginnen
Der einfachste Weg in den Editor führt über das vorkonfigurierte Beispiel „Praxisteam“. Es lädt mit einem Klick, ohne Import und ohne Vorwissen — inklusive Projekt, Dataset und sieben zusammenhängenden Ressourcen.
Eigenes Package importieren
Für die Arbeit mit echten Spezifikationen importierst du das zugehörige FHIR-Package. Der Import läuft vollständig in deinem Browser:
- Öffne den Importer und gib Package-ID und Version an — oder folge einem vorbefüllten Link von dieser Website.
- Lade das Package über den angezeigten Registry-Link herunter (.tgz-Datei).
- Ziehe die Datei per Drag & Drop in den Importer. Fehlende Abhängigkeiten werden erkannt und lassen sich genauso nachladen.
- Sobald alles aufgelöst ist, erscheint das Projekt in der Übersicht — dort legst du ein Dataset an und startest den Editor.
Der Importer erkennt Abhängigkeiten automatisch und zeigt, was noch fehlt.
Ressourcen ansehen und bearbeiten
Im Editor wählst du links eine Ressource und bearbeitest sie in der Mitte als Formular. Die Felder stammen direkt aus dem Profil — inklusive Beschreibungen, Kardinalitäten und passender Auswahllisten. Rechts läuft das JSON synchron mit und lässt sich auch direkt bearbeiten.
- Neue Ressource anlegen: über „Neue Ressource“ und die Auswahl des Ressourcentyps bzw. Profils.
- Felder ergänzen: „Feld hinzufügen“ zeigt alle laut Profil möglichen Felder.
- Referenzen setzen: per Dropdown auf vorhandene Ressourcen des Datasets — oder Zielressource direkt anlegen.
Der Editor mit dem Beispiel „Praxisteam“: Formular, JSON und Validierung nebeneinander.
Neue Ressource auf Basis eines Profils anlegen.
Felder ergänzen — nur das, was das Profil erlaubt.
Live validieren
Beim Bearbeiten prüft der Editor laufend Pflichtfelder, Kardinalitäten, Wertebereiche und Referenzen. Fehler und Warnungen erscheinen direkt neben der Ressource — mit Hinweis auf das betroffene Feld, nicht als kryptische Fehlermeldung.
Die Validierung zeigt, wo genau etwas nicht zum Profil passt.
Zusammenhänge visualisieren
Über „Visualisieren“ öffnet sich das Beziehungsdiagramm des Datasets: Jede Ressource ist ein Kasten, jede Referenz ein Pfeil. In den Einstellungen bestimmst du pro Ressourcentyp, welche Felder angezeigt werden — praktisch für Workshops und Reviews mit gemischtem Publikum.
Das Beziehungsdiagramm des Beispiels „Praxisteam“.
Exportieren und weitergeben
Ergebnisse lassen sich reproduzierbar weitergeben: Datasets als FHIR-Ressourcen oder Searchset-Bundle, ganze Projekte inklusive Datasets als JSON oder ZIP. So können Kolleg:innen deinen Stand im eigenen Browser öffnen — mit derselben Datei, die auch der Importer versteht.
Export-Optionen für Datasets und Projekte.
Deine Daten, deine Kontrolle
- Alles läuft clientseitig: Packages, Projekte und Datasets liegen ausschließlich im Speicher deines Browsers.
- Es gibt kein Konto und keinen Server, der deine Inhalte speichert.
- Über die Einstellungen der Projektübersicht kannst du einzelne Projekte oder alle lokalen Daten vollständig löschen.
- Die Oberfläche gibt es auf Deutsch, Englisch, Französisch, Spanisch und Italienisch — umschaltbar direkt im Editor.
Am schnellsten lernst du den Editor im Editor
Starte mit dem Beispiel — oder importiere direkt dein erstes Package.