Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

update: content-mode Requirement #367

Merged
merged 14 commits into from
Feb 29, 2024
Merged

update: content-mode Requirement #367

Show file tree
Hide file tree
Changes from 8 commits
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
cd9a862
update: content-mode Requirement
f-peverali Feb 22, 2024
1068d26
add UC description
f-peverali Feb 22, 2024
135cb11
Update ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md
f-peverali Feb 22, 2024
68dfc54
Update ValueSet_Interaktionen.md
alexey-tschudnowsky Feb 23, 2024
6a7cb7d
Merge pull request #370 from gematik/alexey-tschudnowsky-patch-1
f-peverali Feb 23, 2024
f99c751
update requirements on ISIKKatalog ANFISK211
f-peverali Feb 27, 2024
65ea73c
auto-generated FHIR files by GitHub Actions (CI FSH to FHIR Validation)
f-peverali Feb 27, 2024
5978aa8
Merge branch 'TC_3.0.4' into feature/rm-requirement-improve-descripti…
f-peverali Feb 27, 2024
a559f84
Update ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md
f-peverali Feb 28, 2024
469d796
Update ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md
f-peverali Feb 28, 2024
6f82395
update after review
f-peverali Feb 28, 2024
316296e
Update ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md
f-peverali Feb 29, 2024
33d808c
Update ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md
f-peverali Feb 29, 2024
278756f
revert. SHALL for two CONDITIONAL parameters
f-peverali Feb 29, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions ImplementationGuide/markdown/DecisionLog.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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)
Expand All @@ -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

Expand Down
39 changes: 3 additions & 36 deletions ImplementationGuide/markdown/Katalog/CodeSystem_Interaktionen.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,56 +1,23 @@
### 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.
f-peverali marked this conversation as resolved.
Show resolved Hide resolved
f-peverali marked this conversation as resolved.
Show resolved Hide resolved

Folgende Suchparameter sind für das Bestätigungsverfahren relevant, auch in Kombination:
f-peverali marked this conversation as resolved.
Show resolved Hide resolved

1. Der Suchparameter "_id" MUSS unterstützt werden:
1. Der Suchparameter "_id" SOLL unterstützt werden:
f-peverali marked this conversation as resolved.
Show resolved Hide resolved
f-peverali marked this conversation as resolved.
Show resolved Hide resolved

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" SOLL unterstützt werden:
f-peverali marked this conversation as resolved.
Show resolved Hide resolved

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).

---
6 changes: 6 additions & 0 deletions ImplementationGuide/markdown/Katalog/CodeSystem_Motivation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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).
f-peverali marked this conversation as resolved.
Show resolved Hide resolved

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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nitpick (non-blocking): ich nehme an, der Absatz begründet warum das Profil auf optional gesetzt wurde. Einem Leser ist allerdings die Historie und der Entscheidungsprozess nicht bekannt, sodass der Absatz gefühlt kontextlos rüberkommt. Vllt. sollten wir den Motivationsabschnitt in 2 logische Teile trennen - 1. was sind die CodeSysteme und wozu werden sie im ISIK-Kontext verwendet und 2. Bestätigungsrelevanz (ggf. mit Begründung)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@alexzautke schaust du dir nochmal an, ob der Absatz passt?

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.

---
4 changes: 3 additions & 1 deletion ImplementationGuide/markdown/ReleaseNotes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
15 changes: 10 additions & 5 deletions ImplementationGuide/markdown/ValueSet/ValueSet_Interaktionen.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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).

---
---
102 changes: 1 addition & 101 deletions ...urces/fsh-generated/resources/CapabilityStatement-ISiKCapabilityStatementBasisServer.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
32 changes: 5 additions & 27 deletions Resources/input/fsh/ISiKCapabilityStatement.fsh
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
f-peverali marked this conversation as resolved.
Show resolved Hide resolved
* 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
f-peverali marked this conversation as resolved.
Show resolved Hide resolved
* 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
Expand Down