Funktionen und Interaktionen
Launch eines Formular-Renderers
Der Aufruf eines Formular-Renderes kann mit verschiedenen Methoden erfolgen.
Fremdaufruf
Die Methode des Fremdaufrufes versucht eine Brückentechnologie bereitzustellen, die es heutigen Anwendungssystemen, die noch nicht über eine SMART-Launch-Funktionalität verfügen, dennoch mit einfachsten Mitteln einen Formular-Renderer integrieren zu können. Der Fremdaufruf ist jedoch bewusst nur rudimentär definiert, da mittelfristig die Umstellung auf den SMART-App-Launch dringendst empfohlen wird.
Beim Fremdaufruf muss sichergestellt sein, dass ein adäquater Sicherheitsmechanismus zum Einsatz kommt, damit der Aufruf nicht bestehende Berechtigungsstrukturen außer Kraft setzt.
Die vorgeschlagenen Übergabe-Parameter sind:
- [obligatorisch] Patientennummer (gängig PID; Identifier am ISiKPatient)
- Ist für die Herstellung eines passenden Launch-Context nach SDC unabdingbar
- [optional] Abrechnungsnummer (gängig Fallnummer; Identifier am ISiKAbrechnungsfall)
- Mit der Abrechnungsnummer kann eingeschränkt werden, welche Encounter für die Extraktion von Daten ausgewählt werden können. Der richtige Encounter muss gemäß der Beschreibungen in ISiK Basis Stufe 5: Herstellung von Patient- und Encounterkontext manuell gewahlt werden
- [optional] Aufnahmenummer (Identifier am ISiKKontaktGesundheitseinrichtung)
- Mit der Aufnahmenummer kann der richtige Encounter bereits mit übergeben werden
- [optional] Canonical der FormularDefinition
- Mittels der Canonical einer FormularDefinition kann der richtige Fragebogen schon vorausgewählt werden
- [obliagtorisch] URL des FHIR-Endpunktes, der für die Ermittlung von Daten zur Vorbelegung sowie die Rückübermittlung der FormularDaten verwendet werden soll.
SMART-App-Launch
Der standardisierte Aufruf einer beliebigen webbbasierten Applikation aus einem klinischen Primärsystem heraus wird im Modul ISiK-Connect beschrieben und sollte für den Aufruf eines Formular-Renderers mit Übergabe eines Benutzer-, Patienten- und Encounterkontextes präferiert zum Einsatz kommen.
Stand-Alone-Launch
Beim Stand-Alone Launch startet der Benutzer den Formular-Renderer ohne Kontext. Der Patienten- und Encounter-Kontext wird im Formular-Renderer gemäß der Beschreibungen in ISiK Basis Stufe 5: Herstellung von Patient- und Encounterkontext vom Anwender manuell getroffen.
Beim Stand-Alone-Launch muss sichergestellt sein, dass ein adäquater Sicherheitsmechanismus zum Einsatz kommt, damit bestehende Berechtigungsstrukturen nicht außer Kraft gesetzt werden.
Interaktion: FormularDefinitionsVerwaltung
Die Interaktion FormularDefinitionsVerwaltung dient der Bereitstellung von FormularDefinitionen. In der ersten Ausbaustufe dieses Moduls wird diese Funktionalität als integraler Bestandteil von FormularRenderern angenommen. Perspektivisch sollten FormularRenderer jedoch in der Lage sein, auch auf externe Quellen, die als FormularDefinitionBereitsteller agieren, zugreifen zu können, beispielsweise auf nationale Formular-Verzeichnisse oder Formulardefintionen, die vom aufrufenden System (FormularLauncher) bereitgestellt werden.
Interaktion: FormularDatenVorbelegung
Ein FormularRenderer prüft eine FormularDefinition auf entsprechende Annotationen für die automatische Vorbelegung.
Dies kann entweder mittels der Expression based population
oder der Observation based prepopulation geschehen.
Die folgenden Core und SDC Extensions sind für die Vorbelegung in dieser Stufe relevant. Unter Extensions sind mehr Informationen dazu zu finden.
Funktion: FormularDatenValidierung
Bei der Formulardatenvalidierung handelt es sich formal nicht um eine Interaktion, da diese derzeit als eine Aktion angenommen wird, die vom FormularRenderer eigenständig ausgeführt wird. Gemäß FHIR-Spezifikation ist die Validierung jedoch auch als ein Service mittels der $validate-Operation implementierbar.
In künftigen Ausbaustufen des ISiK-Formular-Moduls ist auch eine Einbindung externer Validierungs-Services denkbar. Daher wird diese Funktion bereits in dieser Stufe als potentielle Interaktion betrachtet.
Die Datenextraktion wird in dieser Stufe zunächst ausschließlich von FormularRenderer implementiert. Hierbei ist zu beachten, dass FormularDaten (QuestionnaireResponse-Ressourcen) nicht gegen ein QuestionnaireResponse-Profil zu validieren sind, sondern gegen die zugrundeliegende FormularDefinition (Questionnaire).
Warnung | Missing Feature |
---|---|
Die Validierung von QuestionnaireResponse-Ressourcen gegen Questionnaires wird nicht von allen Validatoren unterstützt! |
Die folgenden Core und SDC Extensions sind für die Validierung in dieser Stufe relevant. Unter Extensions sind mehr Informationen dazu zu finden.
Interaktion: FormularDatenExtraktion
Bei der Formulardatenextraktion handelt es sich formal nicht um eine Interaktion, da diese derzeit als eine Aktion angenommen wird, die vom FormularRenderer eigenständig ausgeführt wird. Gemäß SDC-Spezifikation ist die FormularDaten-Extraktion jedoch auch als ein Service mittels der $extract-Operation implementierbar.
In künftigen Ausbaustufen des ISiK-Formular-Moduls ist auch eine Einbindung externer Extractions-Services denkbar. Daher wird diese Funktion bereits in dieser Stufe als potentielle Interaktion betrachtet.
Die Datenextraktion wird in dieser Stufe zunächst ausschließlich von FormularRenderer implementiert und beschränkt sich auf die Methode der Observation based extraction.
Die folgenden Core und SDC Extensions sind für die Extraktion in dieser Stufe relevant. Unter Extensions sind mehr Informationen dazu zu finden.
Interaktion: FormularDaten-Rückübermittlung
Die Rückübermittlung von FormularDaten erfolgt gemäß den Festlegungen in ISiK Basis Stufe-5: Datenübermittlung aus Subsystemen
Work in Progress | Fehlendes Artefakt |
---|---|
In der weiteren Entwicklung dieses Moduls wird ein Dokumenten-Profil festgelegt, das die Rückübermittlung von FormularDaten, FormularDefintionen und Strukturierten Inhalten, sowie die Erstellung von Narrativen für die menschenlesbare Darstellung von Formularinhalten spezifiziert |