From cd9a8626f037c42ba1c867eff55ff618dbe9bb5f Mon Sep 17 00:00:00 2001 From: f-peverali <112709306+f-peverali@users.noreply.github.com> Date: Thu, 22 Feb 2024 10:17:06 +0100 Subject: [PATCH 01/12] update: content-mode Requirement --- .../markdown/Katalog/CodeSystem_Interaktionen.md | 2 +- ImplementationGuide/markdown/ReleaseNotes.md | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md b/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md index 4196437a..bdcd0052 100644 --- a/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md +++ b/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md @@ -45,7 +45,7 @@ Folgende Suchparameter sind für das Bestätigungsverfahren relevant, auch in Ko 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: +1. Der Suchparameter "content-mode" KANN unterstützt werden: Beispiele: diff --git a/ImplementationGuide/markdown/ReleaseNotes.md b/ImplementationGuide/markdown/ReleaseNotes.md index 674da7cf..8ccf8385 100644 --- a/ImplementationGuide/markdown/ReleaseNotes.md +++ b/ImplementationGuide/markdown/ReleaseNotes.md @@ -11,6 +11,7 @@ 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 +* Änderung der Anforderung zu KANN für Suchparameter "content-mode": ---- Version: 3.0.3 From 1068d260b733cf00816cdad144fb61fe17340a83 Mon Sep 17 00:00:00 2001 From: f-peverali <112709306+f-peverali@users.noreply.github.com> Date: Thu, 22 Feb 2024 10:34:12 +0100 Subject: [PATCH 02/12] add UC description --- ImplementationGuide/markdown/ReleaseNotes.md | 4 ++-- .../markdown/ValueSet/ValueSet_Interaktionen.md | 14 ++++++++++---- 2 files changed, 12 insertions(+), 6 deletions(-) diff --git a/ImplementationGuide/markdown/ReleaseNotes.md b/ImplementationGuide/markdown/ReleaseNotes.md index 8ccf8385..8c723129 100644 --- a/ImplementationGuide/markdown/ReleaseNotes.md +++ b/ImplementationGuide/markdown/ReleaseNotes.md @@ -10,8 +10,8 @@ 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 -* Änderung der Anforderung zu KANN für Suchparameter "content-mode": +* 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 Suchparameter "content-mode": https://github.com/gematik/spec-ISiK-Basismodul/pull/367 ---- Version: 3.0.3 diff --git a/ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md b/ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md index b571c463..6a0a3f45 100644 --- a/ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md +++ b/ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md @@ -51,11 +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-Type ermittelt werden. Diese Informationen sind relevant im Kontext von: + - Hausinternen Prozeduren/Diagnosen-Codes + - Kodierung von Encounter-Informationen z.B. Wahlleistungen und Kodierung des Typs einer Location können in Form von ValueSets abgerufen werden + + Use Cases im Zusammenhang: + + (A) Zur Entwicklungszeit können passende ValueSets von einem Server spezifisch für eine Ressource abgerufen werden. Dies dient dem Exponieren relevanter Kataloge und ist notwendig für die Vereinfachung der Integration, z.B. eines Patientenportals mit einem KIS. 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 wird die dynamische Abfrage der genannten ValueSets ermöglicht, was für die Synchronisierung der ValueSets gegenüber einem Client notwendig ist. + 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). From 135cb11f02b70331481fb5e14ce7dfa8cf1e316e Mon Sep 17 00:00:00 2001 From: f-peverali <112709306+f-peverali@users.noreply.github.com> Date: Thu, 22 Feb 2024 16:03:59 +0100 Subject: [PATCH 03/12] Update ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md Co-authored-by: Alexander Zautke --- ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md b/ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md index 6a0a3f45..6d66cee3 100644 --- a/ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md +++ b/ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md @@ -58,7 +58,7 @@ Folgende Suchparameter sind für das Bestätigungsverfahren relevant, auch in Ko Use Cases im Zusammenhang: - (A) Zur Entwicklungszeit können passende ValueSets von einem Server spezifisch für eine Ressource abgerufen werden. Dies dient dem Exponieren relevanter Kataloge und ist notwendig für die Vereinfachung der Integration, z.B. eines Patientenportals mit einem KIS. 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). + (A) Zur Konfigurationszeit können passende ValueSets von einem Server spezifisch für eine Ressource abgerufen werden. Dies dient dem Exponieren relevanter Kataloge und ist notwendig für die Vereinfachung der Integration, z.B. eines Patientenportals mit einem KIS. 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 wird die dynamische Abfrage der genannten ValueSets ermöglicht, was für die Synchronisierung der ValueSets gegenüber einem Client notwendig ist. From 68dfc54167ac2dc4c89ff19eacff661266285443 Mon Sep 17 00:00:00 2001 From: alexey-tschudnowsky Date: Fri, 23 Feb 2024 07:39:13 +0100 Subject: [PATCH 04/12] Update ValueSet_Interaktionen.md --- .../markdown/ValueSet/ValueSet_Interaktionen.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md b/ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md index 6d66cee3..86a258b2 100644 --- a/ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md +++ b/ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md @@ -52,17 +52,16 @@ 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: + 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 und Kodierung des Typs einer Location können in Form von ValueSets abgerufen werden + - 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 eine Ressource abgerufen werden. Dies dient dem Exponieren relevanter Kataloge und ist notwendig für die Vereinfachung der Integration, z.B. eines Patientenportals mit einem KIS. 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 wird die dynamische Abfrage der genannten ValueSets ermöglicht, was für die Synchronisierung der ValueSets gegenüber einem Client notwendig ist. + (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). ---- \ No newline at end of file +--- From f99c751e7ba2b44a0b16f2a21722d1bb664a79b9 Mon Sep 17 00:00:00 2001 From: f-peverali <112709306+f-peverali@users.noreply.github.com> Date: Tue, 27 Feb 2024 13:41:00 +0100 Subject: [PATCH 05/12] update requirements on ISIKKatalog ANFISK211 --- ImplementationGuide/markdown/DecisionLog.md | 8 ++++ .../Katalog/CodeSystem_Interaktionen.md | 39 ++----------------- .../markdown/Katalog/CodeSystem_Motivation.md | 6 +++ .../input/fsh/ISiKCapabilityStatement.fsh | 32 +++------------ 4 files changed, 22 insertions(+), 63 deletions(-) diff --git a/ImplementationGuide/markdown/DecisionLog.md b/ImplementationGuide/markdown/DecisionLog.md index e5ab113a..d3111627 100644 --- a/ImplementationGuide/markdown/DecisionLog.md +++ b/ImplementationGuide/markdown/DecisionLog.md @@ -1,5 +1,13 @@ # 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.2 diff --git a/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md b/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md index bdcd0052..cefe9a62 100644 --- a/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md +++ b/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md @@ -1,10 +1,10 @@ ### Interaktionen -Für die Ressource CodeSystem MUSS die REST-Interaktion "READ" implementiert werden. +Für die Ressource CodeSystem SOLL die REST-Interaktion "READ" implementiert werden. Folgende Suchparameter sind für das Bestätigungsverfahren relevant, auch in Kombination: -1. Der Suchparameter "_id" MUSS unterstützt werden: +1. Der Suchparameter "_id" SOLL unterstützt werden: Beispiele: @@ -12,7 +12,7 @@ Folgende Suchparameter sind für das Bestätigungsverfahren relevant, auch in Ko 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" SOLL unterstützt werden: Beispiele: @@ -20,37 +20,4 @@ Folgende Suchparameter sind für das Bestätigungsverfahren relevant, auch in Ko 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" KANN 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). - --- \ No newline at end of file diff --git a/ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md b/ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md index bdabb341..2f1ddae0 100644 --- a/ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md +++ b/ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md @@ -1,6 +1,12 @@ ### Motivation +Dieses Profil MUSS im Rahmen der Bestätigung NICHT unterstützt werden. Falls das Profil unterstützt werden soll, SOLLEN die hier definierten Festlegungen greifen (auch im Bestätigungsverfahren). + ISiK erlaubt in diversen Kontexten die Erweiterung der Kodierung durch Krankenhaus- / Systeminterne Kodierungen. + Eine maschinenlesbare Repräsentation dieser Kodierungen erlaubt es Clients dazugehörige Anzeigetext und Definitionen zu verarbeiten. +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. + --- \ No newline at end of file diff --git a/Resources/input/fsh/ISiKCapabilityStatement.fsh b/Resources/input/fsh/ISiKCapabilityStatement.fsh index c0aaabab..d0082055 100644 --- a/Resources/input/fsh/ISiKCapabilityStatement.fsh +++ b/Resources/input/fsh/ISiKCapabilityStatement.fsh @@ -597,47 +597,25 @@ 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 +* rest.resource[=].searchParam[=].extension.valueCode = #MAY * rest.resource[=].searchParam[=].name = "_id" * rest.resource[=].searchParam[=].definition = "http://hl7.org/fhir/SearchParameter/Resource-id" * rest.resource[=].searchParam[=].type = #token * rest.resource[=].searchParam[+].extension.url = $capabilitystatement-expectation -* rest.resource[=].searchParam[=].extension.valueCode = #SHALL +* rest.resource[=].searchParam[=].extension.valueCode = #MAY * 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 From 65ea73c797bc177408ebed2bfbe9b506c3c39e34 Mon Sep 17 00:00:00 2001 From: f-peverali Date: Tue, 27 Feb 2024 12:43:13 +0000 Subject: [PATCH 06/12] auto-generated FHIR files by GitHub Actions (CI FSH to FHIR Validation) --- ...nt-ISiKCapabilityStatementBasisServer.json | 102 +----------------- 1 file changed, 1 insertion(+), 101 deletions(-) diff --git a/Resources/fsh-generated/resources/CapabilityStatement-ISiKCapabilityStatementBasisServer.json b/Resources/fsh-generated/resources/CapabilityStatement-ISiKCapabilityStatementBasisServer.json index eacb53a3..4cd96102 100644 --- a/Resources/fsh-generated/resources/CapabilityStatement-ISiKCapabilityStatementBasisServer.json +++ b/Resources/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", From a559f844e09935e3e15e3975dcac6a8e63c14500 Mon Sep 17 00:00:00 2001 From: f-peverali <112709306+f-peverali@users.noreply.github.com> Date: Wed, 28 Feb 2024 17:13:11 +0100 Subject: [PATCH 07/12] Update ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md --- .../markdown/Katalog/CodeSystem_Interaktionen.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md b/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md index cefe9a62..fc190a20 100644 --- a/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md +++ b/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md @@ -1,6 +1,6 @@ ### Interaktionen -Für die Ressource CodeSystem SOLL 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: From 469d796c8781a07576f8a7cc66e9c56c4c7b5259 Mon Sep 17 00:00:00 2001 From: f-peverali <112709306+f-peverali@users.noreply.github.com> Date: Wed, 28 Feb 2024 17:13:43 +0100 Subject: [PATCH 08/12] Update ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md --- .../markdown/Katalog/CodeSystem_Interaktionen.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md b/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md index fc190a20..424368a8 100644 --- a/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md +++ b/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md @@ -4,7 +4,7 @@ Für die Ressource CodeSystem MUSS die REST-Interaktion "READ" implementiert wer Folgende Suchparameter sind für das Bestätigungsverfahren relevant, auch in Kombination: -1. Der Suchparameter "_id" SOLL unterstützt werden: +1. Der Suchparameter "_id" MUSS unterstützt werden, falls die Resource CodeSystem umgesetzt wird: Beispiele: From 6f82395a38479bc47372c9d44978c9ba78ce9b76 Mon Sep 17 00:00:00 2001 From: f-peverali <112709306+f-peverali@users.noreply.github.com> Date: Wed, 28 Feb 2024 17:29:02 +0100 Subject: [PATCH 09/12] update after review --- .../markdown/Katalog/CodeSystem_Interaktionen.md | 2 +- .../markdown/Katalog/CodeSystem_Motivation.md | 10 +++++++--- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md b/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md index 424368a8..bec9df1b 100644 --- a/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md +++ b/ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md @@ -12,7 +12,7 @@ Folgende Suchparameter sind für das Bestätigungsverfahren relevant, auch in Ko 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" SOLL unterstützt werden: +1. Der Suchparameter "url" MUSS unterstützt werden, falls die Resource CodeSystem umgesetzt wird: Beispiele: diff --git a/ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md b/ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md index 2f1ddae0..e9144e88 100644 --- a/ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md +++ b/ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md @@ -1,12 +1,16 @@ ### Motivation -Dieses Profil MUSS im Rahmen der Bestätigung NICHT unterstützt werden. Falls das Profil unterstützt werden soll, SOLLEN die hier definierten Festlegungen greifen (auch im Bestätigungsverfahren). - -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 eine solche erweitere Kodierung. 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 implizit 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). + --- \ No newline at end of file From 316296ee138fd4363f0d5994b04ee436966ea920 Mon Sep 17 00:00:00 2001 From: f-peverali <112709306+f-peverali@users.noreply.github.com> Date: Thu, 29 Feb 2024 10:31:23 +0100 Subject: [PATCH 10/12] Update ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md Co-authored-by: Alexander Zautke --- ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md b/ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md index e9144e88..0195d696 100644 --- a/ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md +++ b/ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md @@ -1,7 +1,7 @@ ### Motivation #### Katalog -ISiK erlaubt in diversen Kontexten die Erweiterung der Kodierung durch Krankenhaus-/Systeminterne Kodierungen. Das Profil ISiKKatalog (CodeSystem) als Profil erlaubt eine solche erweitere Kodierung. +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. From 33d808ce9e820bf19426d793db665013ead919f4 Mon Sep 17 00:00:00 2001 From: f-peverali <112709306+f-peverali@users.noreply.github.com> Date: Thu, 29 Feb 2024 10:37:12 +0100 Subject: [PATCH 11/12] Update ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md --- ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md b/ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md index 0195d696..21465881 100644 --- a/ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md +++ b/ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md @@ -5,7 +5,7 @@ ISiK erlaubt in diversen Kontexten die Erweiterung der Kodierung durch Krankenha 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 implizit definierte [ValueSets zu expandieren](https://hl7.org/fhir/R4/valueset-operation-expand.html). +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. From 278756f44e12401b193dc7f96ea6f24cb8beddaf Mon Sep 17 00:00:00 2001 From: f-peverali <112709306+f-peverali@users.noreply.github.com> Date: Thu, 29 Feb 2024 10:42:11 +0100 Subject: [PATCH 12/12] revert. SHALL for two CONDITIONAL parameters --- Resources/input/fsh/ISiKCapabilityStatement.fsh | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Resources/input/fsh/ISiKCapabilityStatement.fsh b/Resources/input/fsh/ISiKCapabilityStatement.fsh index d0082055..097e16ce 100644 --- a/Resources/input/fsh/ISiKCapabilityStatement.fsh +++ b/Resources/input/fsh/ISiKCapabilityStatement.fsh @@ -607,12 +607,12 @@ Usage: #definition * 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 = #MAY +* rest.resource[=].searchParam[=].extension.valueCode = #SHALL * rest.resource[=].searchParam[=].name = "_id" * rest.resource[=].searchParam[=].definition = "http://hl7.org/fhir/SearchParameter/Resource-id" * rest.resource[=].searchParam[=].type = #token * rest.resource[=].searchParam[+].extension.url = $capabilitystatement-expectation -* rest.resource[=].searchParam[=].extension.valueCode = #MAY +* rest.resource[=].searchParam[=].extension.valueCode = #SHALL * rest.resource[=].searchParam[=].name = "url" * rest.resource[=].searchParam[=].definition = "http://hl7.org/fhir/SearchParameter/conformance-url" * rest.resource[=].searchParam[=].type = #uri