Medication IG DE, published by HL7 Deutschland e.V.. This guide is not an authorized publication; it is the continuous build for version 2.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7germany/medication-ig-de-r4/ and changes regularly. See the Directory of published versions

Dosis Textgenerierung

Die normative Spezifikation des Algorithmus zur Erzeugung menschenlesbarer Dosierungstexte ist in ein eigenständiges Repository ausgelagert:

➜ hl7germany/dgMP-DosageTextgenerierung-Skript

Dort sind Algorithmenbeschreibung, Beispielimplementierung und Versionsverlauf zu finden.

Vorbedingung: validierte Ressource

Die Textgenerierung setzt eine gegen das Profil validierte Ressource voraus. Der Algorithmus ist kein Validator und ersetzt keinen: Er prüft weder Wertebereiche (etwa DosageDoseValuePositive, TimingValuesPositive) noch Kardinalitäten oder Invarianten, die den Text nicht berühren. Er bricht nur ab, wenn der Text nicht bildbar wäre, wenn er eine Angabe der Ressource unterschlagen würde, wenn sich gelesene Angaben widersprechen (etwa zwei Dosen zur selben Uhrzeit) oder wenn ein Feld nicht den JSON-Datentyp seines FHIR-Typs hat.

Daraus folgt für alle Systeme:

• Die Profilvalidierung MUSS vor der Textgenerierung erfolgen. Eine nicht validierte Ressource kann je nach fehlendem Feld zu einem unvollständigen Text oder zu einem Laufzeitfehler führen.
• Ausgenommen ist der Freitext-Fallback der Migration von 1.0.7 auf 2.0.0. Dort wird der Text aus Dosierungen erzeugt, die das Profil 2.0.0 nicht erfüllen, und nur als Freitext übernommen.
• Ein erfolgreich erzeugter Dosierungstext ist kein Nachweis der Profilkonformität. Insbesondere erzeugt der Algorithmus auch für Konstellationen einen Text, die das Profil als Fehler oder Warnung führt (zum Beispiel eine Dosis von 0).

Algorithmusversion

Die zu verwendende Version des Algorithmus ist nicht in diesem IG festgelegt, sondern wird verbindlich über die Releasezyklen des dgMP-Projekts bestimmt. Die jeweils gültige Version ist den Release-Notes zu entnehmen.

Bei der Bereitstellung des Dosierungstextes ist die verwendete Version in der Extension GeneratedDosageInstructionsMeta anzugeben (Feld algorithmVersion). Der vollständige Ablauf ist unter Bereitstellung des Dosierungstextes beschrieben.

In diesem Guide verwendete Version

Die Beispieltexte dieses Guide wurden mit der Algorithmusversion 2.0.0-rc.3 erzeugt. Die Angabe dient allein der Nachvollziehbarkeit — sie legt nicht fest, welche Version zu verwenden ist. Dieselbe Version steht als algorithmVersion in jeder Beispielressource, sodass sich jeder abgebildete Text seiner Herkunft zuordnen lässt.