ELGA e-Medikation (R4) DRAFT
0.1.1 - ci-build
ELGA e-Medikation (R4) DRAFT, published by ELGA GmbH. This guide is not an authorized publication; it is the continuous build for version 0.1.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7Austria/ELGA-e-Medikation-R4/ and changes regularly. See the Directory of published versions
Ein berechtigter GDA kann den Medikationsplan von ELGA-Teilnehmer:innen lesen.
Ein:e ELGA-Teilnehmer:in kann seinen:ihren Medikationsplan über das Zugangsportal einsehen.
Sowohl berechtigte GDA als auch ELGA-Teilnehmer können auf einzelne Planeinträge lesend zugreifen und diese durchsuchen (Planentry-Search).
Die fachlichen Anforderungen werden im UC_eMed_01 Medikationsplan lesen beschrieben.
Für den lesenden Zugriff auf Medikationspläne werden zwei Zugriffsarten unterschieden:
Plan-Read zum Abruf des aktuellen Medikationsplans, der für eine mögliche Bearbeitung aufbereitet ist.
Plan-History-Search zum Abruf historischer Versionen des Medikationsplans.
Plan-Read dient dem Abruf des Medikationsplans in einem für die Bearbeitung durch den GDA aufbereiteten Zustand.
Hierfür erzeugt die Fachanwendung aus der aktuellen Version der List-Ressource sowie den von ihr referenzierten Ressourcen ein temporäres Collection-Bundle zur Auslieferung. Der Abruf erfolgt über die Custom Operation $plan-read.
POST $plan-read
Nachfolgend kann der Medikationsplan vom GDA bearbeitet und mittels Plan-Write gespeichert werden.
Nach Eingang eines $plan-read prüft die Fachanwendung den Zustand des Medikationsplans.
Dabei werden folgende Fälle unterschieden:
Abschließend erzeugt die Fachanwendung aus der aktuellen Version der List-Ressource und den referenzierten Ressourcenversionen ein Collection-Bundle zur Auslieferung.
Die persistierten Ressourcen werden dabei nicht verändert.
Beim Plan-History-Search rekonstruiert die Fachanwendung historische Versionen des Medikationsplans aus versionierten List-Ressourcen sowie den von diesen referenzierten Ressourcenversionen und liefert diese unverändert aus. Dadurch entspricht jedes ausgelieferte Collection Bundle exakt dem historischen Stand des Medikationsplans zum jeweiligen Zeitpunkt.
Der Abruf erfolgt mittels GET unter Angabe geeigneter Suchparameter:
Die erzeugten Collection Bundles dienen ausschließlich der Auslieferung und werden nicht persistiert.
Beim Plan-History-Search erfolgt keine Änderung der Medikationspläne durch die Fachanwendung. Insbesondere werden keine Inhalte, Statusinformationen oder Kennzeichnungen (Flags) verändert.
Der Zugriff dient ausschließlich der Anzeige bzw. Informationsabfrage persistierter Medikationsplanversionen.
In Arbeit.
Die initiale Erstellung eines Medikationsplans erfolgt ausschließlich durch die e-Medikation-Fachanwendung. Sie wird ausgelöst, wenn im Rahmen eines erstmaligen Aufrufs von $plan-read noch kein Medikationsplan für den ELGA-Teilnehmer existiert.
Der dabei erzeugte initiale Medikationsplan besitzt den Wert List.emptyReason = notstarted. Dieser kennzeichnet ausschließlich den Initialzustand des Medikationsplans und bedeutet, dass bisher noch keine Medikationsplaneinträge erfasst wurden. Er trifft jedoch keine Aussage darüber, ob der Patient Medikamente einnimmt.
Die Initialisierung kann sowohl durch ein GDA-System als auch durch den ELGA-Teilnehmer über das Portal ausgelöst werden, indem erstmals ein Plan-Read durchgeführt wird.
Der Planentry-Search dient der gezielten Suche nach Medikationsplaneinträgen eines ELGA-Teilnehmers. Als Medikationsplaneintrag gilt eine im Medikationsplan referenzierte Version einer MedicationRequest-Ressource mit category = "Planeintrag".
Die Suche ermöglicht berechtigten GDA sowie ELGA-Teilnehmer:innen den Zugriff auf aktuelle und historische Medikationsplaneinträge unabhängig von einer bestimmten Medikationsplanversion.
Der Abruf erfolgt mittels GET unter Angabe geeigneter Suchparameter:
Die Suchergebnisse ermöglichen die Nachverfolgung von Änderungen an Medikationsplaneinträgen, beispielsweise hinsichtlich Präparat, Dosierung oder Einnahmeanweisung.
Die gefundenen Medikationsplaneinträge können anschließend als Ausgangspunkt für weitere Abfragen verwendet werden, um jene Ressourcen zu ermittelnt, die genau auf diese Planeintragversion referenzieren:
In Arbeit.