update: content-mode Requirement (#367)

* update: content-mode Requirement * add UC description * Update ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md Co-authored-by: Alexander Zautke <[email protected]> * Update ValueSet_Interaktionen.md * update requirements on ISIKKatalog ANFISK211 * auto-generated FHIR files by GitHub Actions (CI FSH to FHIR Validation) * Update ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md * Update ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md * update after review * Update ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md Co-authored-by: Alexander Zautke <[email protected]> * Update ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md * revert. SHALL for two CONDITIONAL parameters --------- Co-authored-by: Alexander Zautke <[email protected]> Co-authored-by: alexey-tschudnowsky <[email protected]> Co-authored-by: f-peverali <[email protected]>
gematik · Feb 29, 2024 · 5f2fd18 · 5f2fd18
1 parent be3a156
commit 5f2fd18
Show file tree

Hide file tree

Showing 7 changed files with 41 additions and 169 deletions.
diff --git a/ImplementationGuide/markdown/DecisionLog.md b/ImplementationGuide/markdown/DecisionLog.md
@@ -1,5 +1,14 @@
 # Decision Log
 
+
+Datum 27.02.
+* 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.
+  * Nur die Suchparameter "_id" Und "url" sind MUSS-Anforderungen (auch nur, wenn die Ressource optional unterstützt wird), da ein bekanntes Codesystem abrufbar sein sollte, wenn die Ressource an sich unterstützt wird.
+  *Anmerkungen und MUST-SUpport Felder bleiben unberührt (SOLL).
+
+----
 Version Technical Correction 3.0.4
 
 * Problem: In der [Extension Abrechnungsart](http://fhir.de/StructureDefinition/ExtensionAbrechnungsDiagnoseProzedur) ist eine eindeutige Zuweisung zwischen Use und Referenz nicht möglich aufgrund der Kardinalität von Use - (vergleiche ANFISK-206)
@@ -8,6 +17,7 @@ Version Technical Correction 3.0.4
     * In den Basisprofilen sollte die Extension angepasst werden, sodass Use auf 0..1 gesetzt wird
     * ggf. erneute Prüfung der Codes unter "Use" prüfen
 
+
 ----
 Version: Technical Correction 3.0.2
 

diff --git a/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md b/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md
@@ -1,56 +1,23 @@
 ### Interaktionen
 
-Für die Ressource CodeSystem MUSS die REST-Interaktion "READ" implementiert werden.
+Für die Ressource CodeSystem MUSS die REST-Interaktion "READ" implementiert werden, falls die Resource CodeSystem umgesetzt wird.
 
 Folgende Suchparameter sind für das Bestätigungsverfahren relevant, auch in Kombination:
 
-1. Der Suchparameter "_id" MUSS unterstützt werden:
+1. Der Suchparameter "_id" MUSS unterstützt werden, falls die Resource CodeSystem umgesetzt wird:
 
     Beispiele:
 
     ```GET [base]/CodeSystem?_id=103270```
 
     Anwendungshinweise: Weitere Informationen zur Suche nach "_id" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Parameters for all resources"](https://hl7.org/fhir/R4/search.html#all).
 
-1. Der Suchparameter "url" MUSS unterstützt werden:
+1. Der Suchparameter "url" MUSS unterstützt werden, falls die Resource CodeSystem umgesetzt wird:
 
     Beispiele:
 
     ```GET [base]/CodeSystem?url=http://example.org/fhir/CodeSystem/test```
 
     Anwendungshinweise: Weitere Informationen zur Suche nach "CodeSystem.url" finden sich in der [FHIR-Basisspezifikation - Abschnitt "uri"](https://www.hl7.org/fhir/R4/search.html#uri).
 
-1. Der Suchparameter "name" MUSS unterstützt werden:
-
-    Beispiele:
-
-    ```GET [base]/CodeSystem?name=TestCodeSystem```
-
-    Anwendungshinweise: Weitere Informationen zur Suche nach "CodeSystem.name" finden sich in der [FHIR-Basisspezifikation - Abschnitt "String Search"](https://hl7.org/fhir/R4/search.html#string).
-
-1. Der Suchparameter "status" MUSS unterstützt werden:
-
-    Beispiele:
-
-    ```GET [base]/CodeSystem?status=active```
-
-    Anwendungshinweise: Weitere Informationen zur Suche nach "CodeSystem.status" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Token Search""](https://hl7.org/fhir/R4/search.html#token).
-
-
-1. Der Suchparameter "version" MUSS unterstützt werden:
-
-    Beispiele:
-
-    ```GET [base]/CodeSystem?version=1.0.0```
-
-    Anwendungshinweise: Weitere Informationen zur Suche nach "CodeSystem.version" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Token Search"](https://hl7.org/fhir/R4/search.html#token).
-
-1. Der Suchparameter "content-mode" MUSS unterstützt werden:
-
-    Beispiele:
-
-    ```GET [base]/CodeSystem?content-mode=complete```
-
-    Anwendungshinweise: Weitere Informationen zur Suche nach "CodeSystem.content" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Token Search"](https://hl7.org/fhir/R4/search.html#token).
-
 ---
diff --git a/ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md b/ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md
@@ -1,6 +1,16 @@
 ### Motivation
 
-ISiK erlaubt in diversen Kontexten die Erweiterung der Kodierung durch Krankenhaus- / Systeminterne Kodierungen.
+#### Katalog
+ISiK erlaubt in diversen Kontexten die Erweiterung der Kodierung durch Krankenhaus-/Systeminterne Kodierungen. Das Profil ISiKKatalog (CodeSystem) als Profil erlaubt die Repräsentation der dazugehörigen Codes und Displaywerte. 
+
 Eine maschinenlesbare Repräsentation dieser Kodierungen erlaubt es Clients dazugehörige Anzeigetext und Definitionen zu verarbeiten.
 
+Ein Codesystem eignet sich auch dazu, auf dessen Basis definierte [ValueSets zu expandieren](https://hl7.org/fhir/R4/valueset-operation-expand.html).
+Da ISiKValueSet expandierte Valuesets vorsieht, ist eine dynamische Expansion in der Regel nicht erforderlich.
+Darüber hinausgehend ist ein Use Case im Kontext der Katalogabfrage folgender: Ein Client möchte eine Expansion neu generieren (z.B. mit anderen Expansionen-Parametern), um das ValueSet beispielsweise in einer anderen Sprache auszugeben. 
+
+#### Normativer Status und Bestätigung
+
+Dieses Profil MUSS im Rahmen der Bestätigung NICHT unterstützt werden. Falls das Profil unterstützt werden soll, MÜSSEN die hier definierten Festlegungen greifen (auch im Bestätigungsverfahren). 
+
 ---
diff --git a/ImplementationGuide/markdown/ReleaseNotes.md b/ImplementationGuide/markdown/ReleaseNotes.md
@@ -10,9 +10,11 @@ Datum: tbd
 
 * Entfernen der Festlegungen zum .identifier in ISiKVersicherungsverhaeltnisGesetzlich: https://github.com/gematik/spec-ISiK-Basismodul/pull/362
 * Korrektur der Anforderung zur Encounter-Kontaktebene: https://github.com/gematik/spec-ISiK-Basismodul/pull/363
-* Hinweis zur Nutzung des Suchparameter "context-type-value" hinzugefügt: https://github.com/gematik/spec-ISiK-Basismodul/pull/364
+* Hinweis zur Nutzung des Suchparameter "context-type-value" hinzugefügt: https://github.com/gematik/spec-ISiK-Basismodul/pull/367
+* Änderung der Anforderung zu KANN für Profil ISIKKatalog: https://github.com/gematik/spec-ISiK-Basismodul/pull/367
 * Lockerung für Extension Kardinalität in Account zu ..* und hinzufügen einer: eschreibung:https://github.com/gematik/spec-ISiK-Basismodul/pull/366/files 
 
+
 ----
 Version: 3.0.3
 

diff --git a/ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md b/ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md
@@ -51,12 +51,17 @@ Folgende Suchparameter sind für das Bestätigungsverfahren relevant, auch in Ko
 
     ```GET [base]/ValueSet?context-type-value=http://terminology.hl7.org/CodeSystem/usage-context-type|focus$http://hl7.org/fhir/resource-types|Encounter```
 
-    Mit dieser Abfrage können hausinterne Kataloge anhand des Ressource Type ermittelt werden. Diese Informationen sind relevant im Kontext von:
--  Hausinternen Prozeduren/Diagnosen-Codes
--  Kodierung von Encounter-Informationen z.B. Wahlleistungen, Kodierung des Typs einer Location
 
-    Auch im Kontext der [Terminvereinbarung durch einen Termin-Requestor wird die Abfrage genutzt](https://simplifier.net/guide/isik-terminplanung-v3/ImplementationGuide-markdown-Datenobjekte-Operations?version=current).
+    Mit dieser Abfrage können hausinterne Kataloge anhand des Ressource-Typs ermittelt werden. Diese Informationen sind u.a. relevant im Kontext von:
+    -  Hausinternen Prozeduren/Diagnosen-Codes
+    -  Kodierung von Encounter-Informationen (z.B. Wahlleistungen,  Orttypen) 
+
+    Use Cases im Zusammenhang:
+
+    (A) Zur Konfigurationszeit können passende ValueSets von einem Server spezifisch für einen Ressourcentyp abgerufen und vorbereitend auf eine Systemintegration begutachtet bzw. in Client-Systeme eingebunden werden. In diesem Sinne wird die Abfrage im Kontext der [Terminvereinbarung durch einen Termin-Requestor genutzt](https://simplifier.net/guide/isik-terminplanung-v3/ImplementationGuide-markdown-Datenobjekte-Operations?version=current).
+
+    (B) Zur Laufzeit können spezifische ValueSets synchronisiert bzw. direkt in die Eingabemasken von Clients eingebunden werden.   
 
     Anwendungshinweise: Weitere Informationen zur Suche nach "CodeSystem.useContext" finden sich in der [FHIR-Basisspezifikation - Abschnitt "Composite Search Parameters"](https://www.hl7.org/fhir/R4/search.html#composite).
 
----
+---
diff --git a/...urces/fsh-generated/resources/CapabilityStatement-ISiKCapabilityStatementBasisServer.json b/...urces/fsh-generated/resources/CapabilityStatement-ISiKCapabilityStatementBasisServer.json
@@ -1548,107 +1548,7 @@
           "extension": [
             {
               "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
-              "valueCode": "SHALL"
-            }
-          ],
-          "type": "CodeSystem",
-          "supportedProfile": [
-            "https://gematik.de/fhir/isik/v3/Basismodul/StructureDefinition/ISiKCodeSystem"
-          ],
-          "interaction": [
-            {
-              "extension": [
-                {
-                  "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
-                  "valueCode": "SHALL"
-                }
-              ],
-              "code": "read"
-            },
-            {
-              "extension": [
-                {
-                  "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
-                  "valueCode": "SHALL"
-                }
-              ],
-              "code": "search-type"
-            }
-          ],
-          "searchParam": [
-            {
-              "extension": [
-                {
-                  "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
-                  "valueCode": "SHALL"
-                }
-              ],
-              "name": "_id",
-              "definition": "http://hl7.org/fhir/SearchParameter/Resource-id",
-              "type": "token"
-            },
-            {
-              "extension": [
-                {
-                  "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
-                  "valueCode": "SHALL"
-                }
-              ],
-              "name": "url",
-              "definition": "http://hl7.org/fhir/SearchParameter/conformance-url",
-              "type": "uri"
-            },
-            {
-              "extension": [
-                {
-                  "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
-                  "valueCode": "SHALL"
-                }
-              ],
-              "name": "name",
-              "definition": "http://hl7.org/fhir/SearchParameter/conformance-name",
-              "type": "string"
-            },
-            {
-              "extension": [
-                {
-                  "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
-                  "valueCode": "SHALL"
-                }
-              ],
-              "name": "status",
-              "definition": "http://hl7.org/fhir/SearchParameter/conformance-status",
-              "type": "token"
-            },
-            {
-              "extension": [
-                {
-                  "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
-                  "valueCode": "SHALL"
-                }
-              ],
-              "name": "version",
-              "definition": "http://hl7.org/fhir/SearchParameter/conformance-version",
-              "type": "token"
-            },
-            {
-              "extension": [
-                {
-                  "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
-                  "valueCode": "SHALL"
-                }
-              ],
-              "name": "content-mode",
-              "definition": "http://hl7.org/fhir/SearchParameter/CodeSystem-content-mode",
-              "type": "token"
-            }
-          ]
-        },
-        {
-          "extension": [
-            {
-              "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
-              "valueCode": "SHALL"
+              "valueCode": "MAY"
             }
           ],
           "type": "ValueSet",

diff --git a/Resources/input/fsh/ISiKCapabilityStatement.fsh b/Resources/input/fsh/ISiKCapabilityStatement.fsh
@@ -597,14 +597,14 @@ Usage: #definition
 * rest.resource[=].searchParam[=].definition = "http://hl7.org/fhir/SearchParameter/Practitioner-name"
 * rest.resource[=].searchParam[=].type = #string
 * rest.resource[+].extension.url = $capabilitystatement-expectation
-* rest.resource[=].extension.valueCode = #SHALL
+* rest.resource[=].extension.valueCode = #MAY
 * rest.resource[=].type = #CodeSystem
 * rest.resource[=].supportedProfile = "https://gematik.de/fhir/isik/v3/Basismodul/StructureDefinition/ISiKCodeSystem"
 * rest.resource[=].interaction[0].extension.url = $capabilitystatement-expectation
-* rest.resource[=].interaction[=].extension.valueCode = #SHALL
+* rest.resource[=].interaction[=].extension.valueCode = #MAY
 * rest.resource[=].interaction[=].code = #read
 * rest.resource[=].interaction[+].extension.url = $capabilitystatement-expectation
-* rest.resource[=].interaction[=].extension.valueCode = #SHALL
+* rest.resource[=].interaction[=].extension.valueCode = #MAY
 * rest.resource[=].interaction[=].code = #search-type
 * rest.resource[=].searchParam[0].extension.url = $capabilitystatement-expectation
 * rest.resource[=].searchParam[=].extension.valueCode = #SHALL
@@ -616,28 +616,6 @@ Usage: #definition
 * rest.resource[=].searchParam[=].name = "url"
 * rest.resource[=].searchParam[=].definition = "http://hl7.org/fhir/SearchParameter/conformance-url"
 * rest.resource[=].searchParam[=].type = #uri
-* rest.resource[=].searchParam[+].extension.url = $capabilitystatement-expectation
-* rest.resource[=].searchParam[=].extension.valueCode = #SHALL
-* rest.resource[=].searchParam[=].name = "name"
-* rest.resource[=].searchParam[=].definition = "http://hl7.org/fhir/SearchParameter/conformance-name"
-* rest.resource[=].searchParam[=].type = #string
-* rest.resource[=].searchParam[+].extension.url = $capabilitystatement-expectation
-* rest.resource[=].searchParam[=].extension.valueCode = #SHALL
-* rest.resource[=].searchParam[=].name = "status"
-* rest.resource[=].searchParam[=].definition = "http://hl7.org/fhir/SearchParameter/conformance-status"
-* rest.resource[=].searchParam[=].type = #token
-* rest.resource[=].searchParam[+].extension.url = $capabilitystatement-expectation
-* rest.resource[=].searchParam[=].extension.valueCode = #SHALL
-* rest.resource[=].searchParam[=].name = "version"
-* rest.resource[=].searchParam[=].definition = "http://hl7.org/fhir/SearchParameter/conformance-version"
-* rest.resource[=].searchParam[=].type = #token
-* rest.resource[=].searchParam[+].extension.url = $capabilitystatement-expectation
-* rest.resource[=].searchParam[=].extension.valueCode = #SHALL
-* rest.resource[=].searchParam[=].name = "content-mode"
-* rest.resource[=].searchParam[=].definition = "http://hl7.org/fhir/SearchParameter/CodeSystem-content-mode"
-* rest.resource[=].searchParam[=].type = #token
-* rest.resource[+].extension.url = $capabilitystatement-expectation
-* rest.resource[=].extension.valueCode = #SHALL
 * rest.resource[=].type = #ValueSet
 * rest.resource[=].supportedProfile = "https://gematik.de/fhir/isik/v3/Basismodul/StructureDefinition/ISiKValueSet"
 * rest.resource[=].interaction[0].extension.url = $capabilitystatement-expectation