Skip to content

Commit

Permalink
Merge pull request #102 from medizininformatik-initiative/dev/v2025
Browse files Browse the repository at this point in the history
Dev/v2025
  • Loading branch information
julsas authored Dec 16, 2024
2 parents baa941d + 8ac9673 commit 49a334c
Show file tree
Hide file tree
Showing 16 changed files with 50 additions and 28 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@
},
{
"code": "25316-40-9",
"system": "urn:oid:2.16.840.1.113883.6.61",
"system": "http://terminology.hl7.org/CodeSystem/CAS",
"display": "Doxorubicin hydrochloride"
}
]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@
},
{
"code": "11116-97-5",
"system": "urn:oid:2.16.840.1.113883.6.61",
"system": "http://terminology.hl7.org/CodeSystem/CAS",
"display": "Calcium lactate gluconate"
},
{
Expand Down Expand Up @@ -110,7 +110,7 @@
},
{
"code": "471-34-1",
"system": "urn:oid:2.16.840.1.113883.6.61",
"system": "http://terminology.hl7.org/CodeSystem/CAS",
"display": "Calcium carbonate"
},
{
Expand Down Expand Up @@ -174,7 +174,7 @@
},
{
"code": "14127-61-8",
"system": "urn:oid:2.16.840.1.113883.6.61",
"system": "http://terminology.hl7.org/CodeSystem/CAS",
"display": "Calcium cation"
},
{
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@
},
{
"code": "50-99-7",
"system": "urn:oid:2.16.840.1.113883.6.61",
"system": "http://terminology.hl7.org/CodeSystem/CAS",
"display": "Glucose"
},
{
Expand Down Expand Up @@ -97,7 +97,7 @@
},
{
"code": "7732-18-5",
"system": "urn:oid:2.16.840.1.113883.6.61",
"system": "http://terminology.hl7.org/CodeSystem/CAS",
"display": "WATER"
},
{
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@
},
{
"code": "52-24-4",
"system": "urn:oid:2.16.840.1.113883.6.61",
"system": "http://terminology.hl7.org/CodeSystem/CAS",
"display": "thiotepa"
}
]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -695,7 +695,7 @@
"min": 0,
"max": "*",
"patternCoding": {
"system": "urn:oid:2.16.840.1.113883.6.61"
"system": "http://terminology.hl7.org/CodeSystem/CAS"
},
"mustSupport": true
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Im Folgenden werden die Use Cases des Moduls, sowie die dazugehörigen FHIR-Prof

| Veröffentlichung | |
|---------|---|
| Datum | 14.11.2024 |
| Datum | 16.12.2024 |
| Version | 2025.0.0 |
| Status | active |
| Realm | DE |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,20 @@

**Version: 2025.0.0**

Datum 16.12.2024

- Dependency auf de.basisprofil.r4 aktualisiert auf Version 1.5.0. Die Änderung hat keine Auswirkung auf Implementierungen dieses Moduls.
- Profile enthalten zusätzliche Beschreibungen und Übersetzungen für Implementierer und das Forschungsdatenportal für Gesundheit (FDPG).
- Suchparameter aus diesem Modul entfernt. SearchParameter-Ressourcen werden nun zentral im Modul Meta verwaltet.
- CodeSystem Ressourcen für ATC und ASK wurden entfernt. Diese können nun über die Service Unit Terminologische Dienste (SU-TermServ) bezogen werden: https://www.ontoserver.mii-termserv.de/
- Referenzen auf Medication-Ressource innerhalb des Moduls jetzt eingeschränkt auf Profil MII_PR_Medikation_Medication.
- Profil MII_PR_Medikation_MedicationRequest (MedicationRequest) entfernen der MustSupport-Labels auf `MedicationRequest.recorder` und `MedicationRequest.detectedIssue`. Siehe: https://github.com/medizininformatik-initiative/kerndatensatzmodul-medikation/issues/96
- Das CodeSystem [Chemical Abstracts Service (CAS)](https://terminology.hl7.org/CodeSystem-CAS.html) verwendet ab dieser Version die Canonical URL `http://terminology.hl7.org/CodeSystem/CAS`, statt `urn:oid:2.16.840.1.113883.6.61`. Siehe: https://github.com/medizininformatik-initiative/kerndatensatzmodul-medikation/issues/70

**Version: 2024.0.0**

Datum 24.05.2023

- Die veröffentlichten FHIR-Packages verwenden nun [Calender Versioning (CalVer)](https://calver.org/) nach dem Schema YYYY.MINOR.PATCH. Damit wird ein Releasezyklus im Jahresrhythmus etabliert. Die Jahresversion (YYYY) zeigt das Jahr an, in dem das Kerndatensatzmodul angewendet wird. MINOR-Versionen werden bei Einführung neuer Funktionen, Erweiterungen oder substantieller Änderungen veröffentlicht. PATCH-Versionen umfassen Bugfixes oder textuelle Korrekturen.
- Die Benennung der Conformance-Ressourcen und Beispielinstanzen folgt nun einheitlichen [MII-Namenskonventionen](https://github.com/medizininformatik-initiative/kerndatensatz-meta/wiki/Namenskonventionen-f%C3%BCr-FHIR%E2%80%90Ressourcen-in-der-MII).
- Ressourcen verwenden in diesem Release modulübergreifend SNOMED CT in der Version `http://snomed.info/sct/900000000000207008/version/20230731`, um eine stabile [ValueSet-Expansion](http://hl7.org/fhir/R4/valueset.html#expansion) sicherzustellen.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,12 +1,28 @@
---
parent:
topic: FHIRProfile
---
## FHIR-Profile
### FHIR Profile

Die Arbeiten der Kerndatensatzspezifikationen basieren, wo möglich, auf internationalen Standards und Terminologien. Insbesondere sei hier die [International Patient Summary](http://hl7.org/fhir/uv/ips/history.html) hervorgehoben. Eine Anpassung an die allgemeinen Gegebenheiten des deutschen Gesundheitswesens erfolgt durch die Verwendung der [Deutschen Basisprofile](https://simplifier.net/basisprofil-de-r4) von HL7 Deutschland.
Die Arbeiten der Kerndatensatzspezifikationen basieren, wo möglich, auf internationalen Standards und Terminologien. Insbesondere sei hier die [ International Patient Summary](http://hl7.org/fhir/uv/ips/STU1/) hervorgehoben. Eine Anpassung an die allgemeinen Gegebenheiten des deutschen Gesundheitswesens erfolgt durch die Verwendung der [Deutschen Basisprofile](https://ig.fhir.de/basisprofile-de/1.5.0/Home.html) von HL7 Deutschland. Außerdem wird Kompatibilität zu den FHIR-Spezifikationen der [Kassenärztlichen Bundesvereinigung (KBV)](https://simplifier.net/organization/kassenrztlichebundesvereinigungkbv) und der [gematik](https://simplifier.net/organization/gematik) angestrebt.

Alle Elemente des Kerndatensatzes, angepasst an die Details und Anforderungen für die Use Cases der Medizininformatik-Initative, werden nachfolgend in Form von FHIR StructureDefinitions beschrieben. Die Notwendigkeit der Anpassung der FHIR-Profile wird in textueller Form unterhalb der jeweiligen Profile erläutert.
Alle Elemente des Kerndatensatzes, angepasst an die Details und Anforderungen für die Use Cases der Medizininformatik-Initative, werden nachfolgend in Form von FHIR StructureDefinitions beschrieben. Die Notwendigkeit der Anpassung der FHIR-Profile wird in textueller Form unterhalb des Profils erläutert.

### Anforderungsdokumentation

Anforderungen in dieser Spezifikation werden durch folgende in Großbuchstaben geschriebenen Schlüsselworte basierend auf [RFC-2119](https://datatracker.ietf.org/doc/html/rfc2119) gekennzeichnet:

| Deutsch | Englisch |
|------------------------------ |--------------------- |
| MUSS / MÜSSEN | MUST / SHALL |
| DARF NICHT / DÜRFEN NICHT | MUST NOT / SHALL NOT |
| VERPFLICHTEND | REQUIRED |
| SOLLTE / SOLLTEN | SHOULD |
| SOLLTE NICHT / SOLLTEN NICHT | SHOULD NOT |
| EMPFOHLEN | RECOMMENDED |
| KANN / OPTIONAL | MAY |

### Verpflichtende / must-support Elemente

| Hinweis | Verpflichtende / must-support Elemente |
|---------|---------------------|
| {{render:implementation-guides/ImplementationGuide-Common/images/Warning.jpg}} | Für verpflichtende oder als must-support markierten Elemente sei an dieser Stelle auf die entsprechenden [Regeln der IPS](http://hl7.org/fhir/uv/ips/STU1/design.html#must-support) verwiesen, die auch für diesen ImplementationGuide gelten. |
| {{render:implementation-guides/ImplementationGuide-Common/images/Warning.jpg}} | Für verpflichtende oder als must-support markierten Elemente sei an dieser Stelle auf die entsprechenden [Regeln der IPS](http://hl7.org/fhir/uv/ips/STU1/design.html#must-support) verwiesen, die auch für diesen ImplementationGuide gelten. |
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ expand: 1

**Beschreibung**

Die Extension Wirkstoffrelation erlaubt es, Referenzen zwischen den Wirkstoffen abzubilden. Somit kann ein Wirkstoff, der als "genauer" Wirkstoff klassifiziert ist, eindeutig einem "allgemeinen" Wirkstoff zugeordnet werden. Dies erlaubt bspw. die Umrechnung, dass "10mg Bisoprolol hemifumarat" "8,49mg Bisoprolol" entsprechen.
Die Extension Wirkstoffrelation erlaubt es, Referenzen zwischen den Wirkstoffen abzubilden. Somit KANN ein Wirkstoff, der als "genauer" Wirkstoff klassifiziert ist, eindeutig einem "allgemeinen" Wirkstoff zugeordnet werden. Dies erlaubt bspw. die Umrechnung, dass "10mg Bisoprolol hemifumarat" "8,49mg Bisoprolol" entsprechen.

@```
from
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ expand: 1

**Beschreibung**

Für Wirkstoffe soll die Möglichkeit gegeben werden, bei der Berechnung der Dosisangaben zwischen dem genauen Wirkstoff (der ein Salz, Ester etc. sein kann) und dem reinen Wirkstoff zu unterscheiden, und anzugeben, ob die Berechnung auf dem Derivat (seltener) oder der reinen/"allgemeinen" Substanz (meist) beruht. Aus diesem Grund wurde eine Extension definiert, welche zusätzlich zur Wirkstoffcodierung angegeben werden kann. Diese Extension verweist auf ein ValueSet mit Codes für:
Durch die Extension KANN bei der Berechnung der Dosisangaben zwischen dem genauen Wirkstoff (der ein Salz, Ester etc. sein kann) und dem reinen Wirkstoff unterschieden werden, um anzugeben, ob die Berechnung auf dem Derivat (seltener) oder der reinen/"allgemeinen" Substanz (meist) beruht. Aus diesem Grund wurde eine Extension definiert, welche zusätzlich zur Wirkstoffcodierung angegeben werden KANN. Diese Extension verweist auf ein ValueSet mit Codes für:
* `IN` (ingredient - allgemeiner Wirkstoff),
* `PIN` (precise ingredient - genauer Wirkstoff),
* oder `MIN` (multiple ingredients - Kombinationscode für mehrere Wirkstoffe).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ subject: https://www.medizininformatik-initiative.de/fhir/core/modul-medikation/

## Medication

Die Medikation, die angesetzt, geplant oder verabreicht wird. Es kann sich um ein Fertigarzneimittel oder eine Rezeptur handeln. Auch die Angabe nur des Wirkstoffes ist möglich. Die Angabe mindestens eines Wirkstoffes wird verlangt.
Die Medikation, die angesetzt, geplant oder verabreicht wird. Es kann sich um ein Fertigarzneimittel oder eine Rezeptur handeln. Auch die Angabe nur des Wirkstoffes ist möglich. Mindestens ein Wirkstoff MUSS angegeben werden.

@```
from
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ subject: https://www.medizininformatik-initiative.de/fhir/core/modul-medikation/

## MedicationStatement

Das MedicationStatement dokumentiert die Verordnung eines Arzneimittels oder den Konsum durch einen Patienten. MedicationStatement kann anzeigen, dass der Patient ein Medikament zur Zeit einnimmt, in der Vergangenheit genommen hat oder in Zukunft einnehmen wird. Dabei kann es sich sowohl um verschreibungspflichtige Medikamente handeln, wie auch um OTC-Präparate, welche ein Patient in Eigenverantwortung einnimmt.
Das MedicationStatement dokumentiert die Verordnung eines Arzneimittels oder den Konsum durch einen Patienten. MedicationStatement KANN anzeigen, dass der Patient ein Medikament zur Zeit einnimmt, in der Vergangenheit genommen hat oder in Zukunft einnehmen wird. Dabei KANN es sich sowohl um verschreibungspflichtige Medikamente handeln, wie auch um OTC-Präparate, welche ein Patient in Eigenverantwortung einnimmt.

Der Hauptunterschied zwischen der konkreten Verabreichung einer Medikation (MedicationAdministration) und dem MedicationStatement besteht darin, dass die Medikamentenverabreichung über vollständige Verabreichungsinformationen verfügt und auf den tatsächlichen Informationen der Person basiert, die das Medikament verabreicht hat. MedicationStatement hat im Vergleich eher den Charakter z.B. eines Medikationsplans. Es ist nicht klar, ob der Patient diese Arzneimittel tatsächlich eingenommen hat oder diese verabreicht wurden.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -78,7 +78,7 @@ Canonical: https://www.medizininformatik-initiative.de/fhir/core/modul-medikatio
| http<nolink>://fhir.de/CodeSystem/bfarm/atc | ATC [Anatomisch-therapeutisch-chemische Klassifikation](https://www.dimdi.de/dynamic/de/arzneimittel/atc-klassifikation/)| deutsche Fassung | |
| http<nolink>://fhir.de/CodeSystem/ask | Arzneistoffkatalog -Nummer | | 1.2.276.0.76.5.308 |
| http<nolink>://fdasis.nlm.nih.gov | UNII [Unique Ingredient Identifier](http://www.fda.gov/Drugs/InformationOnDrugs/ucm142438.htm) | [Using UNII with FHIR](http://hl7.org/fhir/unii.html) | 2.16.840.1.113883.4.9 |
| urn:oid:2.16.840.1.113883.6.61 | [CAS registry system](https://www.cas.org/support/documentation/chemical-substances) | unique numerical identifier of a substance in the CAS Registry system | 2.16.840.1.113883.6.61 |
| http<nolink>://terminology.hl7.org/CodeSystem/CAS | [CAS registry system](https://www.cas.org/support/documentation/chemical-substances) | unique numerical identifier of a substance in the CAS Registry system | 2.16.840.1.113883.6.61 |
| http<nolink>://standardterms.edqm.eu | EDQM [Standard Terms](https://standardterms.edqm.eu/) | | 0.4.0.127.0.16.1.1.2.1 |
| http<nolink>://snomed.info/sct | SNOMED CT [snomed.org](http://snomed.org/) | [Using SNOMED CT with FHIR](http://hl7.org/fhir/snomedct.html) | 2.16.840.1.113883.6.96 |
| http<nolink>://unitsofmeasure.org | UCUM [unitsofmeasure.org](http://unitsofmeasure.org/) | [Using UCUM with FHIR](http://hl7.org/fhir/ucum.html) | 2.16.840.1.113883.6.8 |
Expand Down
3 changes: 2 additions & 1 deletion input/fsh/Aliase.fsh
Original file line number Diff line number Diff line change
Expand Up @@ -17,4 +17,5 @@ Alias: $sct-no-ver = http://snomed.info/sct
Alias: $cs-ops = http://fhir.de/CodeSystem/bfarm/ops
Alias: $list-example-use-codes = http://terminology.hl7.org/CodeSystem/list-example-use-codes
Alias: $ihe-xds-fallkontext = http://ihe-d.de/CodeSystems/FallkontextBeiDokumentenerstellung
Alias: $pzn-vs = http://fhir.de/ValueSet/ifa/pzn
Alias: $pzn-vs = http://fhir.de/ValueSet/ifa/pzn
Alias: $cas = http://terminology.hl7.org/CodeSystem/CAS
14 changes: 7 additions & 7 deletions input/fsh/instances/Instances.fsh
Original file line number Diff line number Diff line change
Expand Up @@ -24,14 +24,14 @@ Usage: #example
* form = $standardterms#11210000 "Solution for infusion"
* ingredient[0].isActive = true
* ingredient[=].itemCodeableConcept.coding[0] = $cs-ask#12829 "Glucose"
* ingredient[=].itemCodeableConcept.coding[+] = urn:oid:2.16.840.1.113883.6.61#50-99-7 "Glucose"
* ingredient[=].itemCodeableConcept.coding[+] = $cas#50-99-7 "Glucose"
* ingredient[=].itemCodeableConcept.coding[+] = $fdasis#5SL0G7R0OK "ANHYDROUS DEXTROSE"
* ingredient[=].itemCodeableConcept.coding[+] = $sct#67079006 "Glucose (substance)"
* ingredient[=].strength.denominator = 1000 'ml' "ml"
* ingredient[=].strength.numerator = 50 'g' "g"
* ingredient[+].isActive = false
* ingredient[=].itemCodeableConcept.coding[0] = $cs-ask#00343 "Wasser für Injektionszwecke"
* ingredient[=].itemCodeableConcept.coding[+] = urn:oid:2.16.840.1.113883.6.61#7732-18-5 "WATER"
* ingredient[=].itemCodeableConcept.coding[+] = $cas#7732-18-5 "WATER"
* ingredient[=].itemCodeableConcept.coding[+] = $fdasis#059QF0KO0R "WATER"
* ingredient[=].itemCodeableConcept.coding[+] = $sct#11713004 "Water (substance)"
* status = #active
Expand All @@ -49,15 +49,15 @@ Usage: #example
* ingredient[=].extension.url = "https://www.medizininformatik-initiative.de/fhir/core/modul-medikation/StructureDefinition/wirkstofftyp"
* ingredient[=].extension.valueCoding = $cs-wirkstofftyp#PIN
* ingredient[=].itemCodeableConcept.coding[0] = $fdasis#472LWJ3Y9N "CALCIUM LACTATE GLUCONATE"
* ingredient[=].itemCodeableConcept.coding[+] = urn:oid:2.16.840.1.113883.6.61#11116-97-5 "Calcium lactate gluconate"
* ingredient[=].itemCodeableConcept.coding[+] = $cas#11116-97-5 "Calcium lactate gluconate"
* ingredient[=].itemCodeableConcept.coding[+] = $sct#422232005 "Calcium lactate gluconate (substance)"
* ingredient[=].strength.numerator = 2945.15 'mg' "milligram"
* ingredient[=].strength.denominator = 1 http://standardterms.edqm.eu#10222000 "Effervescent tablet"
* ingredient[+].id = "ing_2"
* ingredient[=].extension.url = "https://www.medizininformatik-initiative.de/fhir/core/modul-medikation/StructureDefinition/wirkstofftyp"
* ingredient[=].extension.valueCoding = $cs-wirkstofftyp#PIN
* ingredient[=].itemCodeableConcept.coding[0] = $fdasis#H0G9379FGK "CALCIUM CARBONATE"
* ingredient[=].itemCodeableConcept.coding[+] = urn:oid:2.16.840.1.113883.6.61#471-34-1 "Calcium carbonate"
* ingredient[=].itemCodeableConcept.coding[+] = $cas#471-34-1 "Calcium carbonate"
* ingredient[=].itemCodeableConcept.coding[+] = $sct#387307005 "Calcium carbonate (substance)"
* ingredient[=].strength.numerator = 300 'mg' "milligram"
* ingredient[=].strength.denominator = 1 http://standardterms.edqm.eu#10222000 "Effervescent tablet"
Expand All @@ -71,7 +71,7 @@ Usage: #example
* ingredient[=].extension[=].extension.valueUri = "#ing_2"
* ingredient[=].extension[=].url = "https://www.medizininformatik-initiative.de/fhir/core/modul-medikation/StructureDefinition/wirkstoffrelation"
* ingredient[=].itemCodeableConcept.coding[0] = $fdasis#2M83C4R6ZB "CALCIUM CATION"
* ingredient[=].itemCodeableConcept.coding[+] = urn:oid:2.16.840.1.113883.6.61#14127-61-8 "Calcium cation"
* ingredient[=].itemCodeableConcept.coding[+] = $cas#14127-61-8 "Calcium cation"
* ingredient[=].itemCodeableConcept.coding[+] = $sct#5540006 "Calcium (substance)"
* ingredient[=].strength.numerator = 500.54 'mg' "milligram"
* ingredient[=].strength.denominator = 1 http://standardterms.edqm.eu#10222000 "Effervescent tablet"
Expand All @@ -86,7 +86,7 @@ Usage: #example
* status = #active
* form = $standardterms#11213000 "Concentrate for solution for infusion"
* ingredient.itemCodeableConcept.coding[0] = $fdasis#82F2G7BL4E "Doxorubicin hydrochloride"
* ingredient.itemCodeableConcept.coding[+] = urn:oid:2.16.840.1.113883.6.61#25316-40-9 "Doxorubicin hydrochloride"
* ingredient.itemCodeableConcept.coding[+] = $cas#25316-40-9 "Doxorubicin hydrochloride"
* ingredient.isActive = true
* ingredient.strength.numerator = 50 'mg' "mg"
* ingredient.strength.denominator = 25 'ml' "ml"
Expand Down Expand Up @@ -125,7 +125,7 @@ Usage: #example
* ingredient.extension.valueCoding = $cs-wirkstofftyp#IN "ingredient"
* ingredient.itemCodeableConcept.coding[0] = $fdasis#905Z5W3GKH "thiotepa"
* ingredient.itemCodeableConcept.coding[+] = $cs-ask#7962 "thiotepa"
* ingredient.itemCodeableConcept.coding[+] = urn:oid:2.16.840.1.113883.6.61#52-24-4 "thiotepa"
* ingredient.itemCodeableConcept.coding[+] = $cas#52-24-4 "thiotepa"

Instance: mii-exa-medikation-medication-dolomo
InstanceOf: mii-pr-medikation-medication
Expand Down
2 changes: 1 addition & 1 deletion input/fsh/profiles/Profile-Medication.fsh
Original file line number Diff line number Diff line change
Expand Up @@ -118,7 +118,7 @@ Description: "Dieses Profil beschreibt die Medikation, die angesetzt, geplant od
* ingredient.itemCodeableConcept.coding[CAS] ^sliceName = "CAS"
* ingredient.itemCodeableConcept.coding[CAS] ^short = "CAS Code"
* ingredient.itemCodeableConcept.coding[CAS] ^definition = "Chemical abstract codes (CAS)"
* ingredient.itemCodeableConcept.coding[CAS] ^patternCoding.system = "urn:oid:2.16.840.1.113883.6.61"
* ingredient.itemCodeableConcept.coding[CAS] ^patternCoding.system = "http://terminology.hl7.org/CodeSystem/CAS"
* ingredient.itemCodeableConcept.coding[CAS] ^mustSupport = true
* ingredient.itemCodeableConcept.coding[CAS].system 1.. MS
* ingredient.itemCodeableConcept.coding[CAS].code 1.. MS
Expand Down

0 comments on commit 49a334c

Please sign in to comment.