Medication IG DE
2.0.0-ballot - ballot

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

Schema mit Wochentags-Bezug

Dieses Modell beschreibt eine Anwendung, deren Rhythmus sich über die Woche erstreckt: Das Arzneimittel wird nicht täglich, sondern nur an bestimmten Wochentagen angewendet.

Zu welcher Tages- oder Uhrzeit die Anwendung an diesen Tagen erfolgt, ist nicht Gegenstand dieses Modells. Soll zusätzlich die Tageszeit oder Uhrzeit festgelegt werden, ist das Schema für Kombinationen von Wochentagen zu verwenden.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. WeekdaySchemeLogical 0..* Base Fachliches Informationsmodell für das Schema mit Wochentags-Bezug
... generierterText 0..1 string Vollständige Dosierungsangabe als für Menschen lesbarer Text, generiert gemäß Dosis Textgenerierung
... dosierungsdetails 1..* Base Strukturierte Angaben zur Dosierung
.... hinweis 0..1 string Ergänzender Anwendungshinweis im Freitext, der sich nicht strukturiert abbilden lässt, aber für die sichere, korrekte oder verständliche Anwendung wichtig ist (z.B. „mit ausreichend Wasser einnehmen“ oder „nicht auf nüchternen Magen“).
.... dosis 1..1 Base Menge des Arzneimittels je Anwendung.
..... wert 1..1 decimal Zahlenwert der Menge; bei einer Bereichsangabe die untere Grenze (z.B. 1).
..... wertBis 0..1 decimal Obere Grenze bei einer Bereichs- oder Obergrenzenangabe (z.B. 2 für „1 bis 2 Tabletten“ oder „bis zu 2 Tabletten“). Bei einem festen Wert bleibt dieses Feld leer.
..... einheit 1..1 Coding Einheit der Menge, z.B. Tablette, Milligramm (mg) oder Milliliter (ml).
Binding: https://fhir.kbv.de/ValueSet/KBV_VS_SFHIR_BMP_DOSIEREINHEIT (required)
.... zeitangaben 0..1 Base Angaben dazu, wann die Dosierung angewendet wird.
..... zeitrahmen 0..1 Base Zeitraum, für den die Dosieranweisung gilt. Er legt fest, ab wann, bis wann oder für wie lange angewendet werden soll, entweder über eine Dauer (z.B. „für eine Woche“) oder über ein Start- und/oder Enddatum.
...... dauer 0..1 Base Dauer der Anwendung. Nicht gleichzeitig mit Start- oder Enddatum anzugeben.
....... wert 1..1 decimal Zahlenwert der Dauer; bei einer Bereichsangabe die untere Grenze (z.B. 1).
....... wertBis 0..1 decimal Obere Grenze bei einer Bereichs- oder Obergrenzenangabe (z.B. 2 für „1 bis 2 Wochen“ oder „bis zu 2 Wochen“).
....... einheit 1..1 Coding Zeiteinheit der Dauer: Tag, Woche oder Monat.
Binding: Duration UnitsOfTime dgMP ValueSet (required)
...... startzeitpunkt 0..1 Base Zeitpunkt, ab dem die Dosierangabe gilt. Kann allein oder gemeinsam mit einem Endzeitpunkt angegeben werden.
....... startdatum 1..1 date Datum, ab dem die Anwendung beginnen soll.
....... startuhrzeit 0..1 time Uhrzeit am Startdatum, falls der Beginn auf die Uhrzeit genau festgelegt werden soll. Nur zusammen mit einem Startdatum zulässig.
...... endzeitpunkt 0..1 Base Zeitpunkt, bis zu dem die Dosierangabe gilt. Kann allein oder gemeinsam mit einem Startzeitpunkt angegeben werden.
....... enddatum 1..1 date Datum, bis zu dem die Anwendung fortgeführt werden soll.
....... enduhrzeit 0..1 time Uhrzeit am Enddatum, falls das Ende auf die Uhrzeit genau festgelegt werden soll. Nur zusammen mit einem Enddatum zulässig.
..... wochentage 1..* Coding Wochentag(e) der Anwendung, ausgedrückt als montags | dienstags | mittwochs | donnerstags | freitags | samstags | sonntags.
Binding: DaysOfWeek (required)
.... bedarfsmedikation 0..1 boolean Kennzeichen, dass die Anwendung nur bei tatsächlichem Bedarf erfolgen soll.
.... einnahmeanlass 0..1 string Anlass oder Bedingung, bei der das Arzneimittel im Bedarfsfall angewendet werden soll (z.B. „bei Schmerzen“ oder „bei Fieber über 38,5 °C“).

doco Documentation for this format

Beispiel

{
  "resourceType" : "MedicationRequest",
  "id" : "Example-MR-Dosage-weekday-2t",
  "meta" : {
    "profile" : [
      🔗 "http://ig.fhir.de/igs/medication/StructureDefinition/MedicationRequestDgMP"
    ]
  },
  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: MedicationRequest Example-MR-Dosage-weekday-2t</b></p><a name=\"Example-MR-Dosage-weekday-2t\"> </a><a name=\"hcExample-MR-Dosage-weekday-2t\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"StructureDefinition-MedicationRequestDgMP.html\">Medication Request dgMP</a></p></div><p><b>status</b>: Active</p><p><b>intent</b>: Order</p><p><b>medication</b>: <span title=\"Codes:\">Ibuprofen 400mg</span></p><p><b>subject</b>: Patient</p><blockquote><p><b>dosageInstruction</b></p><p><b>timing</b>: Once</p><h3>DoseAndRates</h3><table class=\"grid\"><tr><td style=\"display: none\">-</td><td><b>Dose[x]</b></td></tr><tr><td style=\"display: none\">*</td><td>2 Stück<span style=\"background: LightGoldenRodYellow\"> (Details: KBV_CS_SFHIR_BMP_DOSIEREINHEIT  code1 = '1')</span></td></tr></table></blockquote></div>"
  },
  "status" : "active",
  "intent" : "order",
  "medicationCodeableConcept" : {
    "text" : "Ibuprofen 400mg"
  },
  "subject" : {
    "display" : "Patient"
  },
  "dosageInstruction" : [
    {
      "timing" : {
        "repeat" : {
          "dayOfWeek" : [
            "tue",
            "thu"
          ]
        }
      },
      "doseAndRate" : [
        {
          "doseQuantity" : {
            "value" : 2,
            "unit" : "Stück",
            "system" : "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BMP_DOSIEREINHEIT",
            "code" : "1"
          }
        }
      ]
    }
  ]
}

Folgende Beispiele sind in diesem IG dargestellt:

Beispiel Beipspiel Datei
Dienstags und Donnerstags je 2 Stück Example-MR-Dosage-weekday-2t
Unsortierte Wochentage Example-MR-Dosage-weekday-unsorted
Dienstags, Donnerstags und Samstags je 2 Stück Example-MR-Dosage-weekday-3t
Montags 2 Stück, Donnerstags 1 Stück Example-MR-Dosage-weekday-2t-1t
Montags 2 Tabl. für 10 Wochen Example-MR-Dosage-weekday-2t-bound

Angabe und Erkennung der Dosierart

Diese Dosierungsart wird daran erkannt, dass unter Dosage.timing.repeat

  • dayOfWeek
  • opt. Angabe von frequency (muss bei Angabe der Anzahl der dayOfWeek-Elemente entsprechen)
  • opt. Angabe des Paars period = 1 und periodUnit = wk als redundante Angabe
  • opt. Angabe von bounds[x]

angegeben ist. An diesem Feld wird dann kodiert der Wochentag angegeben an der eine konkrete Dosierung einzunehmen ist.

Folgende FHIR-Path Expression auf Ebene von Dosage.timing.repeat liefert die Angabe, ob es sich um das Schema handelt:

timing.repeat.dayOfWeek.exists() and
timing.repeat.when.empty() and
timing.repeat.timeOfDay.empty()

Die wöchentliche Wiederholung ist durch dayOfWeek bereits eindeutig. Als Legacy-Angaben zulässig sind hier frequency — entsprechend der Anzahl der dayOfWeek-Elemente — sowie das Paar period = 1 und periodUnit = wk. Jede andere Periode ist mit dayOfWeek nicht kombinierbar, ebenso wenig frequencyMax und periodMax.

Soll das Arzneimittel in derselben Dosierung an mehreren Tagen angewandt werden, wird dies über mehrere Angaben von dayOfWeek ausgedrückt. Die angegebene Dosierung ist dann zu jedem der genannten Tage anzuwenden.

Beispiel:

  • Dosage.timing.repeat.dayOfWeek = "mon", "fri"
  • Dosage.doseAndRate.doseQuantity = 1 Stück bedeutet, dass eine Stück jeweils am Montag und Freitag einzunehmen ist.

Lesende Systeme werten entsprechend auch Dosage.timing.repeat aus. Wenn nur .dayOfWeek angegeben ist, ist dem Nutzer anzuzeigen, dass die Dosierung nach Wochentagen definiert ist.