From 6ed944ee276bc11f102589bb256307090286782e Mon Sep 17 00:00:00 2001 From: ThomasDeBe Date: Fri, 15 Nov 2024 12:47:26 +0100 Subject: [PATCH 1/2] refactored IG allgemeine leistungszustand pages --- ...-Leistungszustand-ECOG-Observation.page.md | 150 ++++++++++++++++++ ...ungszustand-Karnofsky-Observation.page.md} | 14 +- .../Allgemeiner-Leistungszustand/toc.yaml | 6 +- 3 files changed, 160 insertions(+), 10 deletions(-) create mode 100644 implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Allgemeiner-Leistungszustand/Allgemeiner-Leistungszustand-ECOG-Observation.page.md rename implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Allgemeiner-Leistungszustand/{Allgemeiner-Leistungszustand-Observation.page.md => Allgemeiner-Leistungszustand-Karnofsky-Observation.page.md} (96%) diff --git a/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Allgemeiner-Leistungszustand/Allgemeiner-Leistungszustand-ECOG-Observation.page.md b/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Allgemeiner-Leistungszustand/Allgemeiner-Leistungszustand-ECOG-Observation.page.md new file mode 100644 index 00000000..8cec4d9b --- /dev/null +++ b/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Allgemeiner-Leistungszustand/Allgemeiner-Leistungszustand-ECOG-Observation.page.md @@ -0,0 +1,150 @@ +--- +parent: +topic: AllgemeinerLeistungszustandObservation +subject: https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-allgemeiner-leistungszustand-ecog +--- + + +## {{page-title}} + +### Kontext +Dieses Profil beschreibt den allgemeinen Leistungszustand eines Patienten in der Onkologie nach ECOG. + +Die Erfassung des allgemeine Leistungszustand wird im oBDS vorgeschrieben. +Dabei wird die eigentliche Meldung als ECOG kodiert und übertragen, wobei die Antwortmöglichkeiten ein Mapping vom Karnofsky-Score ermöglichen. + +Im bisherigen oBDS und in den vorliegenden FHIR-Profilen ist sowohl eine Dokumentation des ECOG mit den Antwortmöglichkeiten 0-4 als auch des Karnofsky-Scores mit 10%, 20% etc. gestattet. +Der aktuelle Umsetzungsleitfaden enthält jedoch einen Hinweis, dass in Zukunft ausschließlich der ECOG gemeldet werden soll. https://plattform65c.atlassian.net/wiki/spaces/UMK/pages/15532323/Allgemeiner+Leistungszustand+Typ + +Für den Fall, dass in den Befunden nur Bezug auf den Allgemeinzustand genommen wird, ohne dabei in ECOG oder Karnofsky zu kodieren, empfiehlt der Dokumentationsleitfaden der Plattform §65c die Entwicklung hausinterner Richtlinien zur besseren Reproduzierbarkeit. https://plattform65c.atlassian.net/wiki/spaces/Dokumentat/pages/86310992/Allgemeiner+Leistungszustand + + +@``` +from + StructureDefinition +where + url = 'https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-allgemeiner-leistungszustand-ecog' +select + Name: name, Status: status, Version: version, Canonical: url, Basis: baseDefinition +``` + +### Inhalt + + + {{tree, buttons}} + + @``` + from + StructureDefinition + where + url = 'https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-allgemeiner-leistungszustand-ecog' + select + Beschreibung: description + with + no header + ``` + @``` + from + StructureDefinition + where + url = 'https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-allgemeiner-leistungszustand-ecog' + for + differential.element + where + mustSupport = true + select Feldname: id, Kurzbeschreibung: short, Hinweise: comment + ``` + + {{xml}} + {{json}} + {{link}} + + +--- + +Mapping Datensatz zu FHIR + +@``` +from StructureDefinition +where url = 'https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/LogicalModel/Onkologie' + for differential.element where id.contains('AllgemeinerLeistungszustand') + select + Datensatz: short, + Erklaerung: definition, + FHIR: mapping[0].map + +``` + +--- + +Mapping [Einheitlicher onkologischer Basisdatensatz (oBDS)](https://basisdatensatz.de/basisdatensatz) zu FHIR + +@``` +from StructureDefinition +where url = 'https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-allgemeiner-leistungszustand-ecog' + for differential.element + where mapping.identity='oBDS' + select + oBDS: mapping.map, + Definition: mapping.comment, + FHIR: path +``` + +--- + +**Suchparameter** + +Folgende Suchparameter sind für das Modul Onkologie relevant, auch in Kombination: + +1. Der Suchparameter ```_id``` MUSS unterstützt werden: + + Beispiele: + + ```GET [base]/Observation?_id=1234``` + + Anwendungshinweise: Weitere Informationen zur Suche nach "_id" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Parameters for all resources"](http://hl7.org/fhir/R4/search.html#all). + +2. Der Suchparameter "_profile" MUSS unterstützt werden: + + Beispiele: + + ```GET [base]/Observation?_profile=https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-allgemeiner-leistungszustand``` + + Anwendungshinweise: Weitere Informationen zur Suche nach "_profile" finden sich in der [FHIR-Basisspezifikation - Abschnitt "token"](http://hl7.org/fhir/R4/search.html#all). +3. Der Suchparameter "code" MUSS unterstützt werden: + + Beispiele: + + ```GET [base]/Observation?code=http://fhir.de/CodeSystem/sct|184305005``` + + Anwendungshinweise: Weitere Informationen zur Suche nach "code" finden sich in der FHIR-Basisspezifikation - Abschnitt "token". + +4. Der Suchparameter "subject" MUSS unterstützt werden: + + Beispiele: + + ```GET [base]/Observation?subject=Patient/example``` + + Anwendungshinweise: Weitere Informationen zur Suche nach "subject" finden sich in der FHIR-Basisspezifikation - Abschnitt "reference". + +5. Der Suchparameter "encounter" MUSS unterstützt werden: + + Beispiele: + + ```GET [base]/Observation?encounter=Encounter/example``` + + Anwendungshinweise: Weitere Informationen zur Suche nach "encounter" finden sich in der FHIR-Basisspezifikation - Abschnitt "reference". + +6. Der Suchparameter "value-concept" MUSS unterstützt werden: + + Beispiele: + + ```GET [base]/Observation?value-concept=https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/CodeSystem/mii-cs-onko-allgemeiner-leistungszustand-ecog|2``` + + Anwendungshinweise: Weitere Informationen zur Suche nach "encounter" finden sich in der FHIR-Basisspezifikation - Abschnitt "reference". + +**Beispiele** + +{{json:mii-exa-onko-allgemeiner-leistungszustand-ecog-1}} + +--- \ No newline at end of file diff --git a/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Allgemeiner-Leistungszustand/Allgemeiner-Leistungszustand-Observation.page.md b/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Allgemeiner-Leistungszustand/Allgemeiner-Leistungszustand-Karnofsky-Observation.page.md similarity index 96% rename from implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Allgemeiner-Leistungszustand/Allgemeiner-Leistungszustand-Observation.page.md rename to implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Allgemeiner-Leistungszustand/Allgemeiner-Leistungszustand-Karnofsky-Observation.page.md index c74613ca..48f8822b 100644 --- a/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Allgemeiner-Leistungszustand/Allgemeiner-Leistungszustand-Observation.page.md +++ b/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Allgemeiner-Leistungszustand/Allgemeiner-Leistungszustand-Karnofsky-Observation.page.md @@ -1,14 +1,14 @@ --- parent: topic: AllgemeinerLeistungszustandObservation -subject: https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-allgemeiner-leistungszustand +subject: https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-allgemeiner-leistungszustand-karnofsky --- ## {{page-title}} ### Kontext -Dieses Profil beschreibt den allgemeinen Leistungszustand eines Patienten in der Onkologie. +Dieses Profil beschreibt den allgemeinen Leistungszustand eines Patienten in der Onkologie nach Karnofsky. Die Erfassung des allgemeine Leistungszustand wird im oBDS vorgeschrieben. Dabei wird die eigentliche Meldung als ECOG kodiert und übertragen, wobei die Antwortmöglichkeiten ein Mapping vom Karnofsky-Score ermöglichen. @@ -19,13 +19,11 @@ Der aktuelle Umsetzungsleitfaden enthält jedoch einen Hinweis, dass in Zukunft Für den Fall, dass in den Befunden nur Bezug auf den Allgemeinzustand genommen wird, ohne dabei in ECOG oder Karnofsky zu kodieren, empfiehlt der Dokumentationsleitfaden der Plattform §65c die Entwicklung hausinterner Richtlinien zur besseren Reproduzierbarkeit. https://plattform65c.atlassian.net/wiki/spaces/Dokumentat/pages/86310992/Allgemeiner+Leistungszustand -Daher enthält das vorliegende Profil nur Kodierungen für die Angabe des ECOG-Leistungszustandes. - @``` from StructureDefinition where - url = 'https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-allgemeiner-leistungszustand' + url = 'https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-allgemeiner-leistungszustand-karnofsky' select Name: name, Status: status, Version: version, Canonical: url, Basis: baseDefinition ``` @@ -39,7 +37,7 @@ select from StructureDefinition where - url = 'https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-allgemeiner-leistungszustand' + url = 'https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-allgemeiner-leistungszustand-karnofsky' select Beschreibung: description with @@ -49,7 +47,7 @@ select from StructureDefinition where - url = 'https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-allgemeiner-leistungszustand' + url = 'https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-allgemeiner-leistungszustand-karnofsky' for differential.element where @@ -83,7 +81,7 @@ Mapping [Einheitlicher onkologischer Basisdatensatz (oBDS)](https://basisdatensa @``` from StructureDefinition -where url = 'https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-allgemeiner-leistungszustand' +where url = 'https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/StructureDefinition/mii-pr-onko-allgemeiner-leistungszustand-karnofsky' for differential.element where mapping.identity='oBDS' select diff --git a/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Allgemeiner-Leistungszustand/toc.yaml b/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Allgemeiner-Leistungszustand/toc.yaml index 83d2be67..9e1e4b7a 100644 --- a/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Allgemeiner-Leistungszustand/toc.yaml +++ b/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Allgemeiner-Leistungszustand/toc.yaml @@ -1,4 +1,6 @@ - name: Index filename: Index.page.md -- name: 'Allgemeiner Leistungszustand: Observation' - filename: Allgemeiner-Leistungszustand-Observation.page.md +- name: 'Allg. Leistungszustand ECOG: Observation' + filename: Allgemeiner-Leistungszustand-ECOG-Observation.page.md +- name: 'Allg. Leistungszustand Karnofsky: Observation' + filename: Allgemeiner-Leistungszustand-Karnofsky-Observation.page.md From 151a302459bef4af1960ff0a2ad656f8ccc918a6 Mon Sep 17 00:00:00 2001 From: ThomasDeBe Date: Fri, 15 Nov 2024 12:53:55 +0100 Subject: [PATCH 2/2] updated IG and Release Notes --- .../MIIIGModulOnkologie/Release-Notes.page.md | 5 +++-- .../Nebenwirkung/Nebenwirkung-AdverseEvent.page.md | 6 +++--- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/Release-Notes.page.md b/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/Release-Notes.page.md index 1c6abeee..b168ff1e 100644 --- a/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/Release-Notes.page.md +++ b/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/Release-Notes.page.md @@ -15,15 +15,16 @@ Hier sind alle Änderungen aufgelistet. - Änderung des Pathologie-Befund-Codes `DiagnosticReport.code` auf LOINC `22034-3 Pathology Report Cancer Narrative` - Fernmetasen (Observation): Lokalisation der Fernmetastasen von `bodySite` nach `valueCodeableConcept` verschoben, um konform mit den Pathologiebefund-Patho Findings zu sein - Specimen (Specimen): Probennummer von `Specimen.identifier` nach `Specimen.accessionIdentifier` verschoben -- Allgemeiner Leistungszustand (Observation): Aufsplitten und verschiebendes Wertes unter `Observation.valueCodeableConcepts` in einzelne Felder für ECOG (`component[ecog]`) und Karnofsky (`component[karnofsky]`), inkl. Anpassung der CodeSystems und ValueSets +- Allgemeiner Leistungszustand (Observation): Aufsplitten in einzelne Observations für ECOG und Karnofsky , inkl. Anpassung der CodeSystems und ValueSets - Strahlentherapie (Procedure): "Stellung zur OP"-Extension umbenannt von "Stellung" in "StellungZurOp" - Systemische Therapie (Procedure): "Stellung zur OP"-Extension umbenannt von "Stellung" in "StellungZurOp" - Tod (Observation): Lockerung der Kardinalitäten von Todesursache(`valueCodeableConcept`), Todesdatum(`effective`) und Zusammenhang mit Tumorerkrankung(`interpretation`) von 1..1 auf 0..1, da Informationen im Krankenhaus nicht immer bekannt und von den Krebsregistern häufig über Todesmeldungen in Standesämtern abgefragt +- Nebenwirkungen (AdverseEvent): Ändern des CTCAE-Grads von `AdverseEvent.severity` zu `AdverseEvent.seriousness` ### Dokumentation und Implementation Guide - Erarbeitung und Dokumentation von Kodierempfehlungen für `category` und `code` der Strahlentherapie und Systemischen / Abwartenden Therapie - Aktualisierung der UML-Diagramme -- Anpassen der Beispieldatei +- Anpassen der Beispieldateien ### SNOMED-CT Mappings diff --git a/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Nebenwirkung/Nebenwirkung-AdverseEvent.page.md b/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Nebenwirkung/Nebenwirkung-AdverseEvent.page.md index 5df06485..ff0e9520 100644 --- a/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Nebenwirkung/Nebenwirkung-AdverseEvent.page.md +++ b/implementation-guides/ImplementationGuide-2024.x-DE/MIIIGModulOnkologie/TechnischeImplementierung/FHIR-Profile/Nebenwirkung/Nebenwirkung-AdverseEvent.page.md @@ -115,13 +115,13 @@ Folgende Suchparameter sind für das Modul Onkologie relevant, auch in Kombinati Anwendungshinweise: Weitere Informationen zur Suche nach "event" finden sich in der [FHIR-Basisspezifikation - Abschnitt "token"](http://hl7.org/fhir/R4/search.html#all). -4. Der Suchparameter ```serverity``` MUSS unterstützt werden: +4. Der Suchparameter ```seriousness``` MUSS unterstützt werden: Beispiele: - ```GET [base]/AdverseEvent?severity=https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/CodeSystem/mii-vs-onko-nebenwirkung-ctcae-grad|4``` + ```GET [base]/AdverseEvent?seriousness=https://www.medizininformatik-initiative.de/fhir/ext/modul-onko/CodeSystem/mii-vs-onko-nebenwirkung-ctcae-grad|4``` - Anwendungshinweise: Weitere Informationen zur Suche nach "severity" finden sich in der [FHIR-Basisspezifikation - Abschnitt "token"](http://hl7.org/fhir/R4/search.html#all). + Anwendungshinweise: Weitere Informationen zur Suche nach "seriousness" finden sich in der [FHIR-Basisspezifikation - Abschnitt "token"](http://hl7.org/fhir/R4/search.html#all). 5. Der Suchparameter ```suspectEntity.instance``` MUSS unterstützt werden: