Merge branch 'TC_4.0.2' into file-reference-basis

gematik · Dec 5, 2024 · 68ab35a · 68ab35a
2 parents 5b12d2d + ae1a62d
commit 68ab35a
Show file tree

Hide file tree

Showing 30 changed files with 954 additions and 463 deletions.
diff --git a/.github/workflows/TC-version-update.yml b/.github/workflows/TC-version-update.yml
@@ -0,0 +1,40 @@
+name: TC version update
+
+# Controls when the action will run. 
+on:
+    push:
+      branches:
+        - 'TC-*'
+        - 'TC_*'
+
+
+    # Allows you to run this workflow manually from the Actions tab
+    workflow_dispatch:        
+
+# setup python and run script 
+jobs:
+    build:
+        runs-on: ubuntu-latest
+        steps:
+          - name: checkout repo content
+            uses: actions/checkout@v2 # checkout the repository content
+
+          - name: setup python
+            uses: actions/setup-python@v4
+            with:
+              python-version: '3.10' # install the python version needed
+
+          - name: install python packages
+            run: |
+              python -m pip install --upgrade pip
+              pip install pyyaml
+    
+          - name: execute py script # run main.py
+            run: python ./scripts/release_publish.py -b
+
+          - name: Add & Commit
+            uses: EndBug/add-and-commit@v9
+            with:
+              committer_name: GitHub Actions Bot
+              committer_email: [email protected]
+              message: auto-generated file update of TC version by GitHub Actions
diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
@@ -15,11 +15,10 @@ on:
   # Allows you to run this workflow manually from the Actions tab      
   workflow_dispatch: 
 
-
 jobs:
   call-tool-update:
     uses: gematik/spec-isik-basismodul/.github/workflows/main.yml@main-stufe-4
     secrets:
       SIMPLIFIER_USERNAME: ${{ secrets.SIMPLIFIER_USERNAME }}
       SIMPLIFIER_PASSWORD: ${{ secrets.SIMPLIFIER_PASSWORD }}
-      WORKFLOW_PERMISSION_GITHUB: ${{ secrets.WORKFLOW_PERMISSION_GITHUB }}      
+      WORKFLOW_PERMISSION_GITHUB: ${{ secrets.WORKFLOW_PERMISSION_GITHUB }}      
diff --git a/ImplementationGuide/markdown/Datenobjekte/CapabilityStatement.md b/ImplementationGuide/markdown/Datenobjekte/CapabilityStatement.md
@@ -15,6 +15,8 @@ Die Verwendung der [CapabilityStatement-Expectation](https://hl7.org/fhir/R4/ext
 
 ## CapabilityStatement (Requirement) ISiK-Terminplanung
 
+Das nachfolgende CapabilityStatement repräsentiert die Anforderungen an ein Termin-Repository.
+
 [Link Simplifier Profil Übersicht](https://simplifier.net/isik-terminplanung-v4/isikcapabilitystatementterminplanungserver)
 
 {{render:https://gematik.de/fhir/isik/CapabilityStatement/ISiKCapabilityStatementTerminplanungServer}}
diff --git a/ImplementationGuide/markdown/Einfuehrung.md b/ImplementationGuide/markdown/Einfuehrung.md
@@ -1,41 +1,41 @@
-<img src="https://raw.githubusercontent.com/gematik/spec-ISiK-Terminplanung/rc/main-stufe-4/Material/images/Gematik_Logo_Flag.svg" alt="gematik logo" width="400"/>
-
-----
-Version: 4.0.0
-
-Datum: 26.06.2024
-
-Status: Active
-
-Realm: Deutschland
-
-----
-
-# Interoperabler Datenaustausch durch Informationssysteme im Krankenhaus (ISiK)
-
-Die gematik wurde vom Gesetzgeber beauftragt, im Benehmen mit der Deutschen Krankenhausgesellschaft (DKG) und den maßgeblichen Bundesverbänden der Industrie im Gesundheitswesen, verbindliche Standards für den Austausch von Gesundheitsdaten mit Informationssystemen im Krankenhaus zu erarbeiten. Dieser FHIR ImplementationGuide (IG) beschreibt die für diesen Zweck entwickelten FHIR Profile und das [REST](https://de.wikipedia.org/wiki/Representational_State_Transfer)-basierte Application Programming Interface (API). Die REST-API wird im Wesentlichen [vom FHIR Standard vorgegeben](https://www.hl7.org/fhir/R4/http.html). Dieser Leitfaden konkretisiert die ISiK-relevanten Funktionen der Standard-REST-API und trifft inhaltliche Festlegungen zu den ISiK-relevanten Ressourcen in Form von Ressourcen-Profilen.
-
-Hersteller bestätigungsrelevanter Systeme sollen durch diesen IG in die Lage versetzt werden, eine konforme Implementierung zu erstellen und das Bestätigungsverfahren der gematik erfolgreich zu absolvieren.
-
-Weitere Informationen siehe [§373 SGB V](https://www.gesetze-im-internet.de/sgb_5/__373.html).
-
-Hinweis: Sowohl für die Implementierung der ISiK-Spezifikation als auch für den Betrieb eines Produktes, das die ISiK-Spezifikation implementiert, ist eine SNOMED-CT-Lizenz notwendig. Diese kann beim [National Release Center für SNOMED CT in Deutschland](https://www.bfarm.de/DE/Kodiersysteme/Terminologien/SNOMED-CT/_node.html) beantragt werden.
-
-**Kontakt**
-
-Bringen Sie allgemeine Fragen und Anmerkungen gerne über unser Anfrageportal ein: [Anfragen ISiK + ISiP](https://service.gematik.de/servicedesk/customer/portal/16)
-
-Falls Sie keinen Zugang zum Anfrageportal haben und dieses nutzen wollen, senden Sie uns bitte eine Nachricht an die Adresse isik [ at ] gematik.de mit dem Betreff "Portalzugang".
-
-**Herausgeber**
-
-gematik GmbH
-
-[Impressum](https://www.gematik.de/impressum/)
-
-**Gender-Hinweis**
-
-Zugunsten des Leseflusses wird in dieser Publikation meist die
-männliche Form verwendet. Wir bitten, dies nicht als Zeichen einer
-geschlechtsspezifischen Wertung zu deuten. Diese Variante deckt auch alle
-weiteren Geschlechter, neben männlich und weiblich, ab.
+<img src="https://raw.githubusercontent.com/gematik/spec-ISiK-Terminplanung/main-stufe-4/Material/images/Gematik_Logo_Flag.svg" alt="gematik logo" width="400"/>
+
+----
+Version: 4.0.2
+
+Datum: 05.12.2024
+
+Status: Active
+
+Realm: Deutschland
+
+----
+
+# Interoperabler Datenaustausch durch Informationssysteme im Krankenhaus (ISiK)
+
+Die gematik wurde vom Gesetzgeber beauftragt, im Benehmen mit der Deutschen Krankenhausgesellschaft (DKG) und den maßgeblichen Bundesverbänden der Industrie im Gesundheitswesen, verbindliche Standards für den Austausch von Gesundheitsdaten mit Informationssystemen im Krankenhaus zu erarbeiten. Dieser FHIR ImplementationGuide (IG) beschreibt die für diesen Zweck entwickelten FHIR Profile und das [REST](https://de.wikipedia.org/wiki/Representational_State_Transfer)-basierte Application Programming Interface (API). Die REST-API wird im Wesentlichen [vom FHIR Standard vorgegeben](https://www.hl7.org/fhir/R4/http.html). Dieser Leitfaden konkretisiert die ISiK-relevanten Funktionen der Standard-REST-API und trifft inhaltliche Festlegungen zu den ISiK-relevanten Ressourcen in Form von Ressourcen-Profilen.
+
+Hersteller bestätigungsrelevanter Systeme sollen durch diesen IG in die Lage versetzt werden, eine konforme Implementierung zu erstellen und das Bestätigungsverfahren der gematik erfolgreich zu absolvieren.
+
+Weitere Informationen siehe [§373 SGB V](https://www.gesetze-im-internet.de/sgb_5/__373.html).
+
+Hinweis: Sowohl für die Implementierung der ISiK-Spezifikation als auch für den Betrieb eines Produktes, das die ISiK-Spezifikation implementiert, ist eine SNOMED-CT-Lizenz notwendig. Diese kann beim [National Release Center für SNOMED CT in Deutschland](https://www.bfarm.de/DE/Kodiersysteme/Terminologien/SNOMED-CT/_node.html) beantragt werden.
+
+**Kontakt**
+
+Bringen Sie allgemeine Fragen und Anmerkungen gerne über unser Anfrageportal ein: [Anfragen ISiK + ISiP](https://service.gematik.de/servicedesk/customer/portal/16)
+
+Falls Sie keinen Zugang zum Anfrageportal haben und dieses nutzen wollen, senden Sie uns bitte eine Nachricht an die Adresse isik [ at ] gematik.de mit dem Betreff "Portalzugang".
+
+**Herausgeber**
+
+gematik GmbH
+
+[Impressum](https://www.gematik.de/impressum/)
+
+**Gender-Hinweis**
+
+Zugunsten des Leseflusses wird in dieser Publikation meist die
+männliche Form verwendet. Wir bitten, dies nicht als Zeichen einer
+geschlechtsspezifischen Wertung zu deuten. Diese Variante deckt auch alle
+weiteren Geschlechter, neben männlich und weiblich, ab.
diff --git a/ImplementationGuide/markdown/ReleaseNotes.md b/ImplementationGuide/markdown/ReleaseNotes.md
@@ -6,21 +6,28 @@ Die erste Ziffer X bezeichnet ein Major-Release und regelt die Gültigkeit von R
 
 Version 4.0.1
 
-Datum: tbd.
+Datum: 02.12.2024
 
 * Implizites ValueSet expandiert https://github.com/gematik/spec-ISiK-Terminplanung/pull/207
 * Dokumentation zur Begründung der Kardinalitäten und Must-Support-Flags ergänzt https://github.com/gematik/spec-ISiK-Terminplanung/pull/209
 * Für ISiKTermin Verschiebung des Slicing auf .specialty.coding. https://github.com/gematik/spec-ISiK-Terminplanung/pull/204
 * Kardinalität für Schedule.actor.display geschwächt https://github.com/gematik/spec-ISiK-Terminplanung/pull/206
 * Anforderungen an die Kodierung von Appointment/Schedule.serviceType geschwächt https://github.com/gematik/spec-ISiK-Terminplanung/pull/227
+* Schwächung der Kardinalität von actor.display im Profil StructureDefinition-ISiKTermin https://github.com/gematik/spec-ISiK-Terminplanung/pull/233
+ * Ergänzung von Anforderungen an Akteure https://github.com/gematik/spec-ISiK-Terminplanung/pull/236
+ * Fix der Canonical URL im Capability-Statement des Terminplanungsserver https://github.com/gematik/spec-ISiK-Terminplanung/pull/238
+ * Hinzufügen der Extension "Appointment Replaces" zum Profil ISiKTermin https://github.com/gematik/spec-ISiK-Terminplanung/pull/242
+ * Update der Dependency de.ihe-d.terminology auf Version 3.0.1 https://github.com/gematik/spec-ISiK-Terminplanung/pull/240
+* Korrektur des Extension Kontext in ISiKKalender https://github.com/gematik/spec-ISiK-Terminplanung/pull/239
+* Aktualisierung der Operation ISiKBookOperation https://github.com/gematik/spec-ISiK-Terminplanung/pull/245
 
 ----
 
 Version 4.0.0
 
-Datum: 09.09.2024
+Datum: 01.10.2024
 
-* Releaseversion, keine inhaltlichen Änderungen zu 4.0.0-rc2
+* Aktive Version ohne weitere Änderungen 
 
 ----
 

diff --git a/ImplementationGuide/markdown/UebergreifendeFestlegungen/Interaktionen.md b/ImplementationGuide/markdown/UebergreifendeFestlegungen/Interaktionen.md
@@ -2,6 +2,15 @@
 
 Für folgende Interaktionen werden im vorliegenden Implementierungsleitfaden Vorgaben für die Umsetzung innerhalb der ISiK-Schnittstelle definiert:
 
+
+| Akteure             | Transaktionen                                                                                                                   | Optionalität |
+|--------------------|-------------------------------------------------------------------------------------------------------------------------------|-------------|
+| **Termin Repository** | - Übermittlung von Patienteninformationen <br> - Verfügbare Behandlungsleistungen abrufen <br> - Verfügbare Terminlisten abrufen <br> - Abfrage von (verfügbaren) Terminblöcken <br> - Termin neu buchen (Buchungsmanagement von verfügbaren Terminen) <br> - Termin absagen (ausgehend vom Client) <br> - Termin verschieben (ausgehend vom Client) <br> - Terminzusatzinformationen aktualisieren (ausgehend vom Client) | Verplichtend           |
+| **Termin Requestor**  | - Übermittlung von Patienteninformationen <br> - Verfügbare Behandlungsleistungen abrufen <br> - Verfügbare Terminlisten abrufen <br> - Abfrage von (verfügbaren) Terminblöcken <br> - Termin neu buchen (Buchungsmanagement von verfügbaren Terminen) <br> - Termin absagen (ausgehend vom Client) <br> - Termin verschieben (ausgehend vom Client) <br> - Terminzusatzinformationen aktualisieren (ausgehend vom Client) | Optional           |
+| **Termin Consumer**   | - Abfrage von (vereinbarten) Terminen                                                                                      | Optional           |
+
+Zudem kann die Situation eintreten, dass ein System die Aufgaben eines Termin Repositories übernimmt, jedoch kein terminführendes System ist (z. B. ein Patientenportal) und die Termine mit einem weiteren Termin Repository synchronisiert (z. B. KIS). In diesem Fall übernimmt das System, welches Termine an das terminführende System sendet, die Rolle eines Termin-Requestors. Diese Option steht einem Termin Repository offen, falls es für bestimmte Use Cases notwendig ist; jedoch ist dies nicht verpflichtend für die Rolle des Termin Repositories.
+
 ---
 
 {{render:Material/images/Interaktionen/1. Übermittelung Patienteninformationen - zum Termin zugehörige Vorabinformationen.png}}

diff --git a/Resources/fsh-generated/fsh-index.json b/Resources/fsh-generated/fsh-index.json
@@ -4,40 +4,40 @@
     "fshName": "ISiKTerminExample",
     "fshType": "Instance",
     "fshFile": "ISiKTermin.fsh",
-    "startLine": 121,
-    "endLine": 138
+    "startLine": 97,
+    "endLine": 114
   },
   {
     "outputFile": "Appointment-ISiKTerminExampleExtendedICU.json",
     "fshName": "ISiKTerminExampleExtendedICU",
     "fshType": "Instance",
     "fshFile": "ISiKTermin.fsh",
-    "startLine": 140,
-    "endLine": 158
+    "startLine": 116,
+    "endLine": 134
   },
   {
     "outputFile": "CapabilityStatement-ISiKCapabilityStatementTerminplanungServer.json",
     "fshName": "ISiKCapabilityStatementTerminplanungServer",
     "fshType": "Instance",
     "fshFile": "ISiKTerminplanungCapabilityStatement.fsh",
-    "startLine": 2,
-    "endLine": 259
+    "startLine": 1,
+    "endLine": 395
   },
   {
     "outputFile": "Communication-ISiKNachrichtExample.json",
     "fshName": "ISiKNachrichtExample",
     "fshType": "Instance",
     "fshFile": "ISiKNachricht.fsh",
-    "startLine": 40,
-    "endLine": 49
+    "startLine": 32,
+    "endLine": 41
   },
   {
     "outputFile": "HealthcareService-ISiKMedizinischeBehandlungseinheitExample.json",
     "fshName": "ISiKMedizinischeBehandlungseinheitExample",
     "fshType": "Instance",
     "fshFile": "ISiKMedizinischeBehandlungseinheit.fsh",
-    "startLine": 31,
-    "endLine": 37
+    "startLine": 22,
+    "endLine": 28
   },
   {
     "outputFile": "OperationDefinition-ISiKAppointmentBookOperation.json",
@@ -52,88 +52,80 @@
     "fshName": "ISiKKalenderExample",
     "fshType": "Instance",
     "fshFile": "ISiKKalender.fsh",
-    "startLine": 64,
-    "endLine": 71
+    "startLine": 45,
+    "endLine": 52
   },
   {
     "outputFile": "Slot-ISiKTerminblockExample.json",
     "fshName": "ISiKTerminblockExample",
     "fshType": "Instance",
     "fshFile": "ISiKTerminblock.fsh",
-    "startLine": 25,
-    "endLine": 31
+    "startLine": 19,
+    "endLine": 25
   },
   {
     "outputFile": "StructureDefinition-ISiKKalender.json",
     "fshName": "ISiKKalender",
     "fshType": "Profile",
     "fshFile": "ISiKKalender.fsh",
     "startLine": 1,
-    "endLine": 53
+    "endLine": 34
   },
   {
     "outputFile": "StructureDefinition-ISiKMedizinischeBehandlungseinheit.json",
     "fshName": "ISiKMedizinischeBehandlungseinheit",
     "fshType": "Profile",
     "fshFile": "ISiKMedizinischeBehandlungseinheit.fsh",
     "startLine": 1,
-    "endLine": 29
+    "endLine": 20
   },
   {
     "outputFile": "StructureDefinition-ISiKNachricht.json",
     "fshName": "ISiKNachricht",
     "fshType": "Profile",
     "fshFile": "ISiKNachricht.fsh",
     "startLine": 1,
-    "endLine": 38
+    "endLine": 30
   },
   {
     "outputFile": "StructureDefinition-ISiKNachrichtExtension.json",
     "fshName": "ISiKNachrichtExtension",
     "fshType": "Extension",
     "fshFile": "ISiKTermin.fsh",
-    "startLine": 104,
-    "endLine": 107
+    "startLine": 80,
+    "endLine": 83
   },
   {
     "outputFile": "StructureDefinition-ISiKTermin.json",
     "fshName": "ISiKTermin",
     "fshType": "Profile",
     "fshFile": "ISiKTermin.fsh",
     "startLine": 1,
-    "endLine": 101
-  },
-  {
-    "outputFile": "StructureDefinition-ISiKTerminKontaktMitGesundheitseinrichtung.json",
-    "fshName": "ISiKTerminKontaktMitGesundheitseinrichtung",
-    "fshType": "Profile",
-    "fshFile": "ISiKTerminKontaktMitGesundheitseinrichtung.fsh",
-    "startLine": 2,
-    "endLine": 7
+    "endLine": 78
   },
   {
     "outputFile": "StructureDefinition-ISiKTerminPriorityExtension.json",
     "fshName": "ISiKTerminPriorityExtension",
     "fshType": "Extension",
     "fshFile": "ISiKTermin.fsh",
-    "startLine": 109,
-    "endLine": 114
+    "startLine": 85,
+    "endLine": 90
   },
   {
     "outputFile": "StructureDefinition-ISiKTerminblock.json",
     "fshName": "ISiKTerminblock",
     "fshType": "Profile",
     "fshFile": "ISiKTerminblock.fsh",
-    "startLine": 2,
-    "endLine": 18
+    "startLine": 1,
+    "endLine": 12
   },
   {
     "outputFile": "StructureDefinition-ScheduleName.json",
     "fshName": "ScheduleName",
     "fshType": "Extension",
     "fshFile": "ISiKKalender.fsh",
-    "startLine": 57,
-    "endLine": 62
+    "startLine": 38,
+    "endLine": 43
   },
   {
     "outputFile": "ValueSet-ISiKTerminCancelationReason.json",