Merge pull request #358 from gematik/feature/ISIK-Organization-PTData…

…-521 Feature/isik organization pt data 521
gematik · Mar 20, 2024 · a36f7c1 · a36f7c1
2 parents 0500238 + cabc473
commit a36f7c1
Show file tree

Hide file tree

Showing 37 changed files with 3,269 additions and 14 deletions.
diff --git a/ImplementationGuide/Implementierungsleitfaden_ISiKBasismodul.json b/ImplementationGuide/Implementierungsleitfaden_ISiKBasismodul.json
@@ -640,6 +640,70 @@
                 }
               ]
             },
+            {
+              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/Datenobjekte_Organisation.md",
+              "title": "Organisation (Organization)",
+              "generation": "markdown",
+              "page": [
+                {
+                  "nameUrl": "ImplementationGuide/markdown/Organisation/Organisation_Motivation.md",
+                  "title": "Motivation",
+                  "generation": "markdown"
+                },
+                {
+                  "nameUrl": "ImplementationGuide/markdown/Organisation/Organisation_Kompatibilitaet.md",
+                  "title": "Kompatibilität",
+                  "generation": "markdown"
+                },
+                {
+                  "nameUrl": "ImplementationGuide/markdown/Organisation/Organisation_Profil.md",
+                  "title": "Profil",
+                  "generation": "markdown"
+                },
+                {
+                  "nameUrl": "ImplementationGuide/markdown/Organisation/Organisation_AnmerkungenZuDenMustSupportFeldern.md",
+                  "title": "Anmerkungen",
+                  "generation": "markdown"
+                },
+                {
+                  "nameUrl": "ImplementationGuide/markdown/Organisation/Organisation_Beispiele.md",
+                  "title": "Beispiele",
+                  "generation": "markdown"
+                }
+              ]
+            },
+            {
+              "nameUrl": "ImplementationGuide/markdown/Datenobjekte/Datenobjekte_Standort.md",
+              "title": "Standort (Location)",
+              "generation": "markdown",
+              "page": [
+                {
+                  "nameUrl": "ImplementationGuide/markdown/Standort/Standort_Motivation.md",
+                  "title": "Motivation",
+                  "generation": "markdown"
+                },
+                {
+                  "nameUrl": "ImplementationGuide/markdown/Standort/Standort_Kompatibilitaet.md",
+                  "title": "Kompatibilität",
+                  "generation": "markdown"
+                },
+                {
+                  "nameUrl": "ImplementationGuide/markdown/Standort/Standort_Profil.md",
+                  "title": "Profil",
+                  "generation": "markdown"
+                },
+                {
+                  "nameUrl": "ImplementationGuide/markdown/Standort/Standort_AnmerkungenZuDenMustSupportFeldern.md",
+                  "title": "Anmerkungen",
+                  "generation": "markdown"
+                },
+                {
+                  "nameUrl": "ImplementationGuide/markdown/Standort/Standort_Beispiele.md",
+                  "title": "Beispiele",
+                  "generation": "markdown"
+                }
+              ]
+            },
             {
               "nameUrl": "ImplementationGuide/markdown/Datenobjekte/Datenobjekte_Binary.md",
               "title": "Binary (Binary)",

diff --git a/ImplementationGuide/markdown/Datenobjekte/Datenobjekte_Organisation.md b/ImplementationGuide/markdown/Datenobjekte/Datenobjekte_Organisation.md
@@ -0,0 +1,5 @@
+## Organisation [(Organization)](https://hl7.org/fhir/R4/organization.html)
+
+Die nachfolgenden Festlegungen spezifizieren die Abbildung von Minimalanforderungen für die Bereitstellung von Daten zur Aufbauorganisation im Rahmen des Bestätigungsverfahrens der gematik.
+
+---
diff --git a/ImplementationGuide/markdown/Datenobjekte/Datenobjekte_Standort.md b/ImplementationGuide/markdown/Datenobjekte/Datenobjekte_Standort.md
@@ -0,0 +1,5 @@
+## Standort [(Location)](https://hl7.org/fhir/R4/location.html)
+
+Die nachfolgenden Festlegungen spezifizieren die Abbildung von Minimalanforderungen für die Bereitstellung von Standortdaten im Rahmen des Bestätigungsverfahrens der gematik.
+
+---
diff --git a/ImplementationGuide/markdown/DecisionLog.md b/ImplementationGuide/markdown/DecisionLog.md
@@ -1,12 +1,16 @@
 # Decision Log
 
-11.3.
+18.03.2024
+* Problem: Auswahl der Suchparameter für Organisation und Standort
+*Lösung: Die Suchparameter Liste wurde geprüft in Hinblick auf naheligende Suchabfragen rund um Organisation und Standort (Location). In Bezug auf Standort wurden vorerst nicht berücksichtigt die Suchparameter: "endpoint", konkrete "address"-Paramter - z.B. address-city etc. -, "mode" und "name"
+
+11.3.2024
 * Problem: Zum Kontext des Problems rund um spezifische Profile für Versicherten-IDs für GKV und PKV siehe https://chat.fhir.org/#narrow/stream/179183-german-.28d-a-ch.29/topic/Community-Feedback.20zum.20PKV-Identifier (bzw. PTData-718)
 VersichertenId-GKV
 * Lösung: siehe https://github.com/gematik/spec-ISiK-Basismodul/pull/382
 
 
-Datum 27.02.
+Datum 27.02.2024
 * Problem: Die MUSS-Anforderungen im Kontext von ISIKKatalog scheinen zu umfassend zu sein.
 * Lösung: Schwächung der Anforderungen für das Profil als ganzes:
   * Ressource ISIKKatalog als optional kennzeichnen (im Capability Statement). Alle anderen Suchparameter entfernen - genauso für IG. Nur für diese bleiben Test-Cases (optional) erhalten.

diff --git a/...nGuide/markdown/Organisation/Organisation_AnmerkungenZuDenMustSupportFeldern.md b/...nGuide/markdown/Organisation/Organisation_AnmerkungenZuDenMustSupportFeldern.md
@@ -0,0 +1,17 @@
+### Anmerkungen zu Must-Support-Feldern
+
+<fql output = "table" headers="true">
+
+        from 
+            StructureDefinition 
+        where 
+            url = %canonical
+        for 
+            differential.element 
+            where 
+                mustSupport = true 
+            select Feldname: id, Kurzbeschreibung: short, Hinweise: comment
+</fql>
+
+
+---
diff --git a/ImplementationGuide/markdown/Organisation/Organisation_Beispiele.md b/ImplementationGuide/markdown/Organisation/Organisation_Beispiele.md
@@ -0,0 +1,9 @@
+### Beispiele
+Valides Minimalbeispiel eines Krankenhauses:
+{{json:KrankenhausOrganisationBeispiel}}
+
+Valides Minimalbeispiel einer Fachabteilung:
+{{json:AbteilungAllgemeinchirurgieOrganisationBeispiel}}
+
+
+
diff --git a/ImplementationGuide/markdown/Organisation/Organisation_Interaktionen.md b/ImplementationGuide/markdown/Organisation/Organisation_Interaktionen.md
@@ -0,0 +1,71 @@
+### Interaktionen
+
+Sofern die Ressourcen zur Organisation unterstützt werden, SOLL die REST-Interaktion "READ" implementiert werden.
+
+Interaktionen zur Organisation werden derzeit für das Bestätigungsverfahren nicht festgelegt.
+
+Auf folgende Suchparameter sei aufgrund der Relevanz hingewiesen - diese SOLLEN (in Einzelfällen KÖNNEN) implementiert werden, falls die oben genannten Ressourcen unterstützt werden:
+
+1. Der Suchparameter "identifier" SOLL unterstützt werden:
+
+    Beispiele:
+
+    ```GET [base]/Organization?identifier=http://fhir.de/sid/arge-ik/iknr|260120196```
+
+    ```GET [base]/Organization?identifier=http://fhir.de/StructureDefinition/identifier-bsnr|345678975```
+
+    ```GET [base]/Organization?identifier=345678975```
+
+    Anwendungshinweise: Weitere Informationen zur Suche nach "Organization.identifier" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Token Search"](https://hl7.org/fhir/R4/search.html#token).
+
+1. Der Suchparameter "active" SOLL unterstützt werden:
+
+    Beispiele:
+
+    ```GET [base]/Organization?active=true```
+
+    Anwendungshinweise: Weitere Informationen zur Suche nach "Oganization.active" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Token Search"](https://hl7.org/fhir/R4/search.html#token).
+
+1. Der Suchparameter "type" SOLL unterstützt werden:
+
+    Beispiele:
+
+    ```GET [base]/Organization?type=dept```
+
+    Anwendungshinweise: Weitere Informationen zur Suche nach "Oganization.type" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Token Search"](https://hl7.org/fhir/R4/search.html#token).
+
+1. Der Suchparameter "name" SOLL unterstützt werden (dies gilt auch für das Element .alias):
+
+    Beispiele:
+
+    ```GET [base]/Organization?name=FA-Gynäkologie```
+
+    ```GET [base]/Organization?name=GYN```
+
+    Anwendungshinweise: Weitere Informationen zur Suche nach "Oganization.name" und "Oganization.alias" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Token Search"](https://hl7.org/fhir/R4/search.html#token).
+
+1. Der Suchparameter "address" SOLL unterstützt werden:
+
+    Beispiele
+
+    ```GET [base]/Organization?address=Berlin```
+
+    Anwendungshinweise: Weitere Informationen zur Suche nach "Organization.address" finden sich in der [FHIR-Basisspezifikation - Abschnitt "String Search"](https://hl7.org/fhir/R4/search.html#string).
+
+
+1. Der Suchparameter "partof" in Kombination mit einem identifier-Modifier SOLL unterstützt werden :
+
+    Beispiele:
+
+    ```GET [base]/Organization?partof:identifier=260120196```
+
+    Anwendungshinweise: Weitere Informationen zur Suche nach "Oganization.name" und "Oganization.alias" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Token Search"](https://hl7.org/fhir/R4/search.html#token).
+
+1. Der Suchparameter "endpoint" in Kombination mit einem identifier-Modifier KANN unterstützt werden:
+
+    Beispiele:
+
+    ```GET [base]/Organization?endpoint:identifier=123456```
+
+    Anwendungshinweise: Weitere Informationen zur Suche nach "Organization.endpoint" finden sich in der [FHIR-Basisspezifikation - Abschnitt "String Search"](https://hl7.org/fhir/R4/search.html#string).
+
diff --git a/ImplementationGuide/markdown/Organisation/Organisation_Kompatibilitaet.md b/ImplementationGuide/markdown/Organisation/Organisation_Kompatibilitaet.md
@@ -0,0 +1,5 @@
+### Kompatibilität
+
+Für das Profil ISiKOrganisation wurde bis zum Zeitpunkt der Veröffentlichung kein Abgleich der Kompatibilität zu anderen Profilen (der KBV und der Medizininformatik-Initiative) durchgeführt.
+
+---
diff --git a/ImplementationGuide/markdown/Organisation/Organisation_Motivation.md b/ImplementationGuide/markdown/Organisation/Organisation_Motivation.md
@@ -0,0 +1,20 @@
+### Motivation
+
+Die Abbildung der Aufbauorganisation eines Krankenhauses dient der Festlegung von Zuständigkeiten und (Entscheidungs-)Verantwortungen von Organisationseinheiten (z.B. Fachkliniken, Fachabteilungen und -bereichen etc.) in strukturierter Form. 
+
+In FHIR wird die Organisation (Organization) vom Standort (Location) eindeutig abgegrenzt.
+
+Die Erfassung der Organisation in strukturierter Form ermöglicht u.a.:
+- Zuweisungen von Diensten an bestimmte Bereiche der Aufbauorganisation im Rahmen des Terminmanagements
+- Die Raum- und Betten-Belegung in strukturierter Form (interdisziplinär)
+
+Auch die Erfassung des Krankenhauses als Ganzem ist relevant.
+Entsprechend fokussieren die folgenden Profile zur Organisation auf das Krankenhaus als Ganzes und die Fachabteilung als Organisation.
+
+---
+
+#### Normativer Status und Bestätigung
+
+Diese Profile MÜSSEN im Rahmen der Bestätigung NICHT unterstützt werden. Falls ein Profil unterstützt wird, SOLLEN die hier definierten Festlegungen greifen.
+
+---
diff --git a/ImplementationGuide/markdown/Organisation/Organisation_Profil.md b/ImplementationGuide/markdown/Organisation/Organisation_Profil.md
@@ -0,0 +1,60 @@
+### FHIR-Profil
+
+Das Profil ISiKOrganisation soll auch ein Krankenhaus als Ganzes abbilden können:
+
+@```
+from StructureDefinition where url = 'https://gematik.de/fhir/isik/StructureDefinition/ISiKOrganisation' select Name: name, Canonical: url
+```
+{{tree:https://gematik.de/fhir/isik/StructureDefinition/ISiKOrganisation, hybrid}}
+
+Folgende FHIRPath-Constraints sind im Profil zu beachten:
+
+@``` from StructureDefinition where url = 'https://gematik.de/fhir/isik/StructureDefinition/ISiKOrganisation' for differential.element.constraint select key, severity, human, expression```
+
+**Terminology Bindings**
+
+@```
+from StructureDefinition
+where url in ('https://gematik.de/fhir/isik/StructureDefinition/ISiKOrganisation' )
+for differential.element
+select
+Path: path,
+join binding.where(valueSet.exists())
+{
+  Name: valueSet.substring((9 + valueSet.indexOf('ValueSet/'))),
+  Strength: strength,
+  URL: valueSet
+}
+```
+
+---
+
+Das Profil ISiKOrganisationFachabteilung soll eine einzelne Fachabteilung abbilden:
+
+@```
+from StructureDefinition where url = 'https://gematik.de/fhir/isik/StructureDefinition/ISiKOrganisationFachabteilung' select Name: name, Canonical: url
+```
+{{tree:https://gematik.de/fhir/isik/StructureDefinition/ISiKOrganisationFachabteilung, hybrid}}
+
+Folgende FHIRPath-Constraints sind im Profil zu beachten:
+
+@``` from StructureDefinition where url = 'https://gematik.de/fhir/isik/StructureDefinition/ISiKOrganisationFachabteilung' for differential.element.constraint select key, severity, human, expression```
+
+
+**Terminology Bindings**
+
+@```
+from StructureDefinition
+where url in ('https://gematik.de/fhir/isik/StructureDefinition/ISiKOrganisationFachabteilung' )
+for differential.element
+select
+Path: path,
+join binding.where(valueSet.exists())
+{
+  Name: valueSet.substring((9 + valueSet.indexOf('ValueSet/'))),
+  Strength: strength,
+  URL: valueSet
+}
+```
+
+---
diff --git a/...mentationGuide/markdown/Standort/Standort_AnmerkungenZuDenMustSupportFeldern.md b/...mentationGuide/markdown/Standort/Standort_AnmerkungenZuDenMustSupportFeldern.md
@@ -0,0 +1,16 @@
+### Anmerkungen zu Must-Support-Feldern
+
+<fql output = "table" headers="true">
+
+        from 
+            StructureDefinition 
+        where 
+            url = %canonical
+        for 
+            differential.element 
+            where 
+                mustSupport = true 
+            select Feldname: id, Kurzbeschreibung: short, Hinweise: comment
+</fql>
+
+---
diff --git a/ImplementationGuide/markdown/Standort/Standort_Beispiele.md b/ImplementationGuide/markdown/Standort/Standort_Beispiele.md
@@ -0,0 +1,9 @@
+### Beispiele
+
+Valides Minimalbeispiel zum Standort Bettenstellplatz:
+{{json:BettStandortBeispiel}}
+
+
+Valides Minimalbeispiel zum Standort Raum:
+{{json:RaumStandortBeispiel}}
+