Medication IG DE
1.0.0-ballot1 - 1.0.0

This page is part of the Medication IG DE (vballot1: Releases Ballot 1) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

Textgenerierung

Überführung von Dosierung zu Text

Hinweis:
Ein Großteil der Logik basiert auf den Empfehlungen aus Dose to Text Translation (UK Core Implementation Guide for Medicines).

Für eine menschenlesbare Darstellung der Dosierung ist das Feld .text derart zu befüllen, dass die strukturierten Dosierinformationen textuell dargestellt werden.
Diese Seite beschreibt den Algorithmus, wie die strukturierten Dosierinformationen in einen String überführt werden können.

Grundlegende Festlegungen

Der generierte Text, der sich aus einer Dosierung ableitet muss im digital gestützten Medikationsprozess (dgMP) immer exakt der strukturierten Darstellung entsprechen. Diese Seite beschreibt die Spezifikation dieses Algorithmus, der in einer Python Referenzimplementierung umgesetzt wurde. Für Informationen wie im dgMP sichergestellt wird, dass der Text an einer Dosierung korrekt ist siehe Infrastruktur zur Bereitstellung des Textes der Dosierung.

Algorithmus zur Textgenerierung

Das Skript unterstützt aktuell nur eine Teilmenge der möglichen Felder für Dosierungsangaben.
Nicht unterstützte Felder führen dazu, dass die Konfiguration als „nicht unterstützt“ zurückgewiesen wird. Die nicht unterstützten Felder werden explizit benannt. Die unterstützten Felder in Dosage sind:

  • text
  • doseAndRate.doseQuantity
  • timing.repeat.boundsDuration
  • timing.repeat.frequency
  • timing.repeat.frequencyMax
  • timing.repeat.period
  • timing.repeat.periodMax
  • timing.repeat.periodUnit
  • timing.repeat.dayOfWeek
  • timing.repeat.timeOfDay
  • timing.repeat.when

Für alle anderen Felder (z. B. doseAndRate.doseRange, doseAndRate.rateQuantity, timing.event, timing.repeat.count, asNeededBoolean, route, site usw.) gibt das Skript zurück: Die Dosiskonfiguration mit den Feldern wird derzeit nicht unterstützt. Die Fachdienste in der TI werden diese Instanzen entsprechend auch zurückweisen.

Die Umwandlung der strukturierten Felder erfolgt nur, wenn ausschließlich unterstützte Felder verwendet werden.

Versionierung des Algorithmus

Die Aktuelle Version des Algortimus mit unterstützten Felder ist in der Python Referenzimplementierung unter __version__ angegeben und reflektiert die Version des IG's.

Komponenten und Trennzeichen

Die einzelnen Komponenten der Dosierungsanweisung werden durch „ — “ (Leerzeichen-Gedankenstrich-Leerzeichen) getrennt. Die Reihenfolge der Komponenten entspricht der folgenden Logik:

  1. Zeitabschnitt
    a) frequency UND period UND/ODER
    b) dayOfWeek
  2. Dosis (doseAndRate.doseQuantity)
  3. Geplante Frequenz innerhalb des Zeitabschnitts
    a) timeOfDay
    b) when
  4. Gesamtdauer der Anwendung (timing.repeat.boundsDuration)

Validierung und Fehlerbehandlung

Wenn in der Dosierungskonfiguration Felder verwendet werden, die aktuell nicht unterstützt sind, wird eine entsprechende Fehlermeldung generiert, z. B.: Die Dosiskonfiguration mit den Feldern timing.event, doseAndRate[0].doseRange wird derzeit nicht unterstützt.

Die Prüfung erfolgt sowohl für Felder auf oberster Ebene der Dosierung, als auch für Unterfelder (z. B. innerhalb von doseAndRate oder timing).

Erweiterbarkeit

Die Skriptstruktur ist so angelegt, dass künftig weitere Felder durch einfaches Entfernen von Kommentaren und Anpassen der Validierungslogik unterstützt werden können. Die Liste der unterstützten Felder sollte mit jeder Version gepflegt und dokumentiert werden.

Beispiel für unterstützte Felder

Für eine Auflistung von Unterstüzten und nicht-unterstützten Dosierkonfigurationen siehe Beispiele für Dosierungen.

Weiterführende Hinweise

Die vollständige Liste der unterstützten und nicht unterstützten Felder ist im Quelltext dokumentiert und sollte bei Erweiterungen aktualisiert werden.

Die Logik zur eigentlichen Textgenerierung (z. B. Pluralbildung, Formatierung der Zeitangaben) orientiert sich an folgenden Empfehlungen:

und wird kontinuierlich weiterentwickelt.

Hinweis:
Diese Seite beschreibt den aktuellen Stand der unterstützten Felder und die daraus resultierende Textgenerierung.
Für die vollständige Abdeckung aller FHIR-Dosierungsfelder ist eine schrittweise Erweiterung des Skripts vorgesehen.