progress IG patient includes

gematik · Feb 22, 2024 · 3bb36bc · 3bb36bc
1 parent d5f02f9
commit 3bb36bc
Show file tree

Hide file tree

Showing 5 changed files with 85 additions and 5 deletions.
diff --git a/ImplementationGuide/Implementierungsleitfaden_ISiKBasismodul.json b/ImplementationGuide/Implementierungsleitfaden_ISiKBasismodul.json
@@ -154,6 +154,11 @@
                   "title": "Interaktionen",
                   "generation": "markdown"
                 },
+                {
+                  "nameUrl": "ImplementationGuide/markdown/Patient/Patient_Includes.md",
+                  "title": "Verkettete Suchparameter",
+                  "generation": "markdown"
+                },
                 {
                   "nameUrl": "ImplementationGuide/markdown/Patient/Patient_Beispiele.md",
                   "title": "Beispiele",

diff --git a/ImplementationGuide/markdown/Patient/Patient_Includes.md b/ImplementationGuide/markdown/Patient/Patient_Includes.md
@@ -0,0 +1,71 @@
+### Verkettete Suchparameter (Chaining und Reverse Chaining)
+
+Für Suchparameter vom Typ 'Reference' MÜSSEN die Festlegungen für [Chaining](https://hl7.org/fhir/R4/search.html#chaining) und [Reverse Chaining](https://hl7.org/fhir/R4/search.html#has) verpflichtend implementiert werden. Chaining und Reverse Chaining MUSS für alle Suchparameter über alle Ebenen und Datenobjekte hinweg (potentiell in Kombination) unterstützt werden.
+
+Alle zu unterstützenden verketteten Suchparameter auf den entsprechenden Referenzen sind im CapabilityStatement unter ```CapabilityStatement.rest.resource.searchInclude``` bzw. ```CapabilityStatement.rest.resource.searchRevInclude``` angegeben. Siehe {{pagelink:ImplementationGuide/markdown/CapabilityStatement.md}}
+
+Weitere Informationen und Beispiele zur Suche nach verketteten Parametern finden sich in {{pagelink:ImplementationGuide/markdown/UebergreifendeFestlegungen/UebergreifendeFestlegungen_Suchparameter.md, text:diesem IG unter Suchparameter}} und in der FHIR-Basisspezifikation im [Abschnitt "Chained Parameters"](https://hl7.org/fhir/R4/search.html#chaining) und im [Abschnitt "Reverse Chaining"](https://hl7.org/fhir/R4/search.html#has).
+
+Die verketteten Suchparameter des Profils ```Patient``` hängen wie folgt mit den festgelegten {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Anwendungsfällen (Use Cases)}}  zusammen:
+
+1. Der verkette Suchparameter ```Composition:patient``` unterstüzt den Anwendungsfall:
+
+    Um eine {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Grundlagen-Funktion}} zu ermöglichen, in der für einen Patienten all seine Dokumenten-Kontexte identifizierte werden können.
+
+1. Der verkette Suchparameter ```Composition:subject``` unterstüzt den Anwendungsfall:
+
+    Um eine {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Grundlagen-Funktion}} zu ermöglichen, in der für eine Person all ihre Dokumenten-Kontexte identifizierte werden können.
+
+1. Der verkette Suchparameter ```Composition:author``` unterstüzt den Anwendungsfall:
+
+    Um eine {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Grundlagen-Funktion}} zu ermöglichen, in der für einen Urheber all seine Dokumenten-Kontexte identifizierte werden können.
+
+1. Der verkette Suchparameter ```Condition:patient``` unterstüzt den Anwendungsfall:
+
+    Um für einen Patienten {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:eindeutig}} zu all seine Diagnosen zu finden und eine {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Verwechslung}} auszuschließen.
+
+1. Der verkette Suchparameter ```Condition:subject``` unterstüzt den Anwendungsfall:
+
+    Um für eine Person {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:eindeutig}} zu all ihre zugehörigen Diagnosen zu finden und eine {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Verwechslung}} auszuschließen.
+
+1. Der verkette Suchparameter ```Procedure:patient``` unterstüzt den Anwendungsfall:
+
+    Um für einen Patienten {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:eindeutig}} zu all seine Behandlungsprozeduren zu finden und eine {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Verwechslung}} auszuschließen.
+
+1. Der verkette Suchparameter ```Procedure:subject``` unterstüzt den Anwendungsfall:
+
+    Um für eine Person {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:eindeutig}} zu all ihre zugehörigen Behandlungsprozeduren zu finden und eine {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Verwechslung}} auszuschließen.
+
+1. Der verkette Suchparameter ```Encounter:patient``` unterstüzt den Anwendungsfall:
+
+    Um für einen Patienten {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:eindeutig}} die komplette Fallhistorie mit allen Kontakten zu finden und eine {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Verwechslung}} auszuschließen.
+
+1. Der verkette Suchparameter ```Encounter:subject``` unterstüzt den Anwendungsfall:
+
+    Um für eine Person {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:eindeutig}} die komplette Fallhistorie mit allen Kontakten zu finden und eine {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Verwechslung}} auszuschließen.
+
+1. Der verkette Suchparameter ```Account:patient``` unterstüzt den Anwendungsfall:
+
+    Um für einen Patienten {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:eindeutig}} die komplette Abrechnungshistorie mit allen Kosten zu finden und eine falsche {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Abrechnung}} auszuschließen.
+
+1. Der verkette Suchparameter ```Account:subject``` unterstüzt den Anwendungsfall:
+
+    Um für eine Person {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:eindeutig}} die komplette Abrechnungshistorie mit allen Kosten zu finden und eine falsche {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Abrechnung}} auszuschließen.
+
+1. Der verkette Suchparameter ```Coverage:patient``` unterstüzt den Anwendungsfall:
+
+    Um für einen Patienten das korrekte {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Versicherungsverhältnis}} zuzuzordnen und eine korrekte {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Abrechnung}} zu gewährtleisten.
+
+1. Der verkette Suchparameter ```Coverage:subscriber``` unterstüzt den Anwendungsfall:
+
+    Um für einen Versicherungsnehmer das korrekte {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Versicherungsverhältnis}} zuzuzordnen und eine korrekte {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Abrechnung}} zu gewährtleisten.
+
+1. Der verkette Suchparameter ```Coverage:beneficiary``` unterstüzt den Anwendungsfall:
+
+    Um für eine versicherte Person das korrekte {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Versicherungsverhältnis}} zuzuzordnen und eine korrekte {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Abrechnung}} zu gewährtleisten.
+
+1. Der verkette Suchparameter ```Coverage:payor``` unterstüzt den Anwendungsfall:
+
+    Um für einen zahlendes Unternehmen alle betreuten {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Versicherungsverhältnisse}} zuzuzordnen und eine korrekte {{pagelink:ImplementationGuide/markdown/Zusammenfassung/UseCases.md, text:Abrechnung}} zu gewährtleisten.
+
+---
diff --git a/...markdown/UebergreifendeFestlegungen/UebergreifendeFestlegungen_Suchparameter.md b/...markdown/UebergreifendeFestlegungen/UebergreifendeFestlegungen_Suchparameter.md
@@ -89,7 +89,7 @@ Diese Suche gibt alle Patienten zurück zum Client, welche innerhalb `Procedure.
 ``[base]/Patient?_has:Procedure:patient:encounter.identifier=12345``
 Diese Suche gibt alle Patienten zurück zum Client, welche innerhalb `Procedure.subject` auf einen Patienten verweisen und einen deren Procedure auf einen Encounter verweist z.B. mit der Aufnahmenummer '1234-5'.
 
-``[base]/Procedure?_has:Encounter:diagnosis:diagnosis:Condition.code=http://fhir.de/CodeSystem/bfarm/icd-10-gm|F16.1``
+``[base]/Procedure?_has:Encounter:diagnosis:Condition.code=http://fhir.de/CodeSystem/bfarm/icd-10-gm|F16.1``
 Diese Suche gibt alle Prozeduren zurück zum Client, welche innerhalb `Encounter.diagnosis.condition` auf einen Encounter verweisen, der wiederrum mit einer Condition verlinkt ist mit dem ICD-10-GM Code 'F16.1'.
 
 ## Verpflichtende Suchparameter (Alle Datenobjekte)
@@ -109,7 +109,8 @@ Folgende Suchparameter MÜSSEN für alle bestätigungsrelevante Datenojekte impl
 
 * ``_has``
 
-    - Siehe Abschnitt "Allgemeine Hinweise zu Suchparametern".
+    - Für Beispiele, siehe oben Abschnitt "Allgemeine Hinweise zu Suchparametern".
+    - Anwendungshinweise: Weitere Informationen zur Suche nach "_has" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Reverse Chaining"](https://www.hl7.org/fhir/R4/search.html#has).
 
 * ``_count``
 
@@ -123,15 +124,15 @@ Folgende Suchparameter MÜSSEN für alle bestätigungsrelevante Datenojekte impl
 * ``_include``
 
     - Beispiele: ``GET [base]/Encounter?_include=Patient:subject``
-    - Anwendungshinweise: Weitere Informationen zur Suche nach "_tag" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Including other resources in result"](https://www.hl7.org/fhir/R4/search.html#revinclude).
+    - Anwendungshinweise: Weitere Informationen zur Suche nach "_include" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Including other resources in result"](https://www.hl7.org/fhir/R4/search.html#revinclude).
     - Alle Referenzen für die ein Chaining unterstützt wird MUSS auch der _include-Parameter implementiert werden. Alle unterstützten Include-Referenzen MÜSSEN im CapabilityStatement unter ```CapabilityStatement.rest.resource.searchInclude``` angegeben werden. Siehe {{pagelink:ImplementationGuide/markdown/CapabilityStatement.md}}.
 
     Der ```:iterate``` Modifier KANN unterstützt werden.
 
 * ``_revinclude``
 
     - Beispiele: ``GET [base]/Patient?_revinclude=Encounter:subject``
-    - Anwendungshinweise: Weitere Informationen zur Suche nach "_tag" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Including other resources in result"](https://www.hl7.org/fhir/R4/search.html#revinclude).
+    - Anwendungshinweise: Weitere Informationen zur Suche nach "_revinclude" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Including other resources in result"](https://www.hl7.org/fhir/R4/search.html#revinclude).
     - Alle Referenzen für die ein Chaining unterstützt wird MUSS auch der _include-Parameter implementiert werden. Alle unterstützten Include-Referenzen MÜSSEN im CapabilityStatement unter ```CapabilityStatement.rest.resource.searchRevInclude``` angegeben werden. Siehe {{pagelink:ImplementationGuide/markdown/CapabilityStatement.md}}.
 
     Der ```:iterate``` Modifier KANN unterstützt werden.

diff --git a/ImplementationGuide/markdown/Zusammenfassung.md b/ImplementationGuide/markdown/Zusammenfassung.md
@@ -6,6 +6,6 @@ Herausforderungen stellen dabei die Vielzahl der Schnittstellen von informations
 
 Im Folgenden leiten wir - die gematik GmbH - her, warum die bestehenden Integrationsansätze im Krankenhaus noch unzureichend sind und durch die im Bestätigungsverfahren „Interoperabler Datenaustausch durch Informationssysteme im Krankenhaus“ (ISiK) spezifizierten Ansätze ergänzt werden, um die Vielzahl sinnvoller Integrationsszenarien effizient abzudecken.
 
-# Grafische Zusammenfassung des Implementations Guides
+# Grafische Zusammenfassung des Implementation Guides
 
 {{index:current}}
diff --git a/Material/images/src/plantuml/usecases.puml b/Material/images/src/plantuml/usecases.puml
@@ -29,12 +29,15 @@ storage gnrlUC as "Allgemein" {
     (Digitalisierung)
     (Dokumentation)
     (Abrechnung)
+    (Wirtschaftlichkeit)
+    (Versicherungsverhältnis)
     (Strukturierung)
     (Organisationsstruktur)
     (Archivierung)
     (Delegation)
     (Konsultation)
     (Transparenz)
+    (Information &\nHistorie)
     storage patientUC as "Patienten-Management"{
         (Aufnahme) 
         (Behandlungs-Journey)