ISiK Dokumentenaustausch Implementierungsleitfaden
Version 6.0.0-rc - ci-build

Release Notes

Seiteninhalt:

Im Rahmen der ISiK-Veröffentlichungen wird das Semantic Versioning verwendet.

Die erste Ziffer X bezeichnet ein Major-Release und regelt die Gültigkeit von Releases. Die dritte Ziffer Y (Release x.0.y) bezeichnet eine technische Korrektur und versioniert kleinere Änderungen (Packages) während eines Jahres, z. B. 1.0.1.

Offene Punkte und bekannte Probleme siehe GitHub Issues

Version 5.1.1

Datum: 17.12.2025

  • documentation fehlende shorts und comments nachgepflegt https://github.com/gematik/spec-ISiK-Basismodul/pull/921

Version 5.1.0

Datum: 23.10.2025

  • improve id-Elemente sind in allen Profilen dokumentiert und als bedingtes Pflicht-/MS-Feld gekennzeichnet. https://github.com/gematik/spec-ISiK-Basismodul/pull/799
  • documentation Rendering der im Modul verwendeten ValueSets https://github.com/gematik/spec-ISiK-Basismodul/pull/802

Version 5.0.0

Datum: 26.06.2025

  • fix Anpassung der Displaywerte in den DocumenReference-Examples von „mimeType Sufficient“ zu „Format aus MIME Type ableitbar“ https://github.com/gematik/spec-ISiK-Basismodul/pull/765
  • documentation Hinweise auf erläuternde Inhalten auf den MHD Seiten integriert https://github.com/gematik/spec-ISiK-Basismodul/pull/770

Mit Inkrafttreten der Stufe 5 werden auch sämtliche nachfolgend aufgeführten Änderungen verbindlich.

Version 5.0.0-rc2 (Benehmensherstellung)

Datum: 5.6.2025

  • improve Neuer verbindlicher Suchparameter identifier für DocumentReference hinzugefügt, auf Basis von Community-Feedback
  • improve Anforderung gelockert zur Herstellung des Patienten-Kontextes und Ausschluss von logischen Referenzen im ISiK-kontext entfernt https://github.com/gematik/spec-ISiK-Basismodul/pull/718
  • improve Must-Support auf Bundle.entry, da darunterliegende Elemente ebenfalls als Must-Support gekennzeichnet sind https://github.com/gematik/spec-ISiK-Basismodul/pull/725
  • improve Einschränkenden Kardinalität auf DocumentReference.custodian wurde aufgehoben, da Custodian in MHD mit der neuesten Version ebenfalls zulässig ist https://github.com/gematik/spec-ISiK-Basismodul/pull/725
  • improve Optimierung der Verständlichkeit des Abschnittes “2:3.68.4.1.2 Message Semantics” https://github.com/gematik/spec-ISiK-Basismodul/pull/739
  • improve Update Anforderungen zu Herstellung von Patient- und Encounterkontext https://github.com/gematik/spec-ISiK-Basismodul/pull/756/files

Version 5.0.0-rc1

Datum: 13.05.2025

  • improve Dependency auf IHE-MHD-Package entfernt, da dieses nicht für die Validierung erforderlich ist und mehrere umfangreiche indirekte Dependencies enthält, die für dieses Modul nicht benötigt werden
  • improve Für die menschenlesbare Bezeichnung des Dokuments ist das Element content.attachment.title zu verwenden. Die bisherige Nutzung von DocumentReference.description entfällt zugunsten einer besseren Angleichung an MHD und die ePA-Spezifikation. Implementierungen sollten daher den Titel des Dokuments ausschließlich in content.attachment.title angeben. https://github.com/gematik/spec-ISiK-Basismodul/pull/686
    • content .attachment.title` wurde auf 1..1 MS gesetzt, um die Verwendung zu erzwingen.
    • DocumentReference .description` wurde auf 0..1 MS gesetzt, und kann weiterhin verwendet werden, um inhaltliche Hinweise zum Dokument, eine knappe Zusammenfassung oder ergänzende Kommentare bereitzustellen.

Version 5.0.0-rc (Kommentierung)

Mit der Stufe 5 werden alle Technical Corrections der Stufe 4 bindend.

Datum: 09.04.2025

  • improve Löschen von vorläufigen Dokumenten durch update des docStatus auf entered-in-error mittels $updateMetadata hinzugefügt https://github.com/gematik/spec-ISiK-Basismodul/pull/582
  • improve Ergänzung einer weiteren experimentellen Methode der Herstellung von Patientenkontext mittels Logical Reference https://github.com/gematik/spec-ISiK-Basismodul/pull/582
    • Im Zuge dessen Lockerung der Kardinalität von DocumentReference.subject.reference auf 0..1, um diese Methode zu ermöglichen
  • fix Entfernung des fixed values “urn:ietf:rfc:3986” auf DocumentReference.masterIdentifier.system, um auch Identifier der Form root+extension zu ermöglichen, siehe https://profiles.ihe.net/ITI/TF/Volume2/ch-Z.html#z.9-fhir-data-types https://chat.fhir.org/#narrow/channel/287581-german.2Fisik/topic/.5BDOK.5D.20masterIdentifier.20als.20OID.3F

Version: 4.0.2

Datum: 19.3.2025

  • improve ‘revert’ ‘improve’ Patient-/Encounter-Interaktionen hinzugefügt - https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/233/commits/105c1cffdf91ccb5e51dc7adf5e8a238019fd7d4

Version: 4.0.1

Datum: 24.01.2025

  • documentation Übertragung der Dokumentation in die FHIR-Resourcen, Refactoring des ImplementationGuides https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/211
  • fix Update der der dependency de.ihe-d.terminology von 3.0.0 -> 3.0.1 https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/212 - Begründung de.ihe-d.terminology#3.0.0 war defekt: ValueSets in XML abgelegt. Inhaltlich keine Änderung
  • fix Fehlende Kennzeichnung von MS-Elementen im Bundle-Profil https://github.com/gematik/spec-ISiK-Dokumentenaustausch/issues/210
  • fix Binary-URL zeigt noch auf Basis V3 https://github.com/gematik/spec-ISiK-Dokumentenaustausch/issues/206
  • fix Operations hängen im CapabilityStatement am falschen Branch https://github.com/gematik/spec-ISiK-Dokumentenaustausch/issues/206
  • fix Falscher Satz über keine notwendige Verbindlichkeit entfernt und Formulierung verbessert https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/213
  • improve Link zum GitHub Archiv des Moduls wurde in der README ergänzt https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/209
  • improve Update der validation pipeline Versionen https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/214
  • fix Beispiel für Dokumentensurchergebnisse wurde gefixt https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/217
  • fix OPD-0 Warnung in OperationUpdateMetadata https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/218
  • fix Hinzufügen der Wildcard dependency für die Basismodul dependency https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/221

Version: 4.0.0

Datum: 09.09.2024

  • fix IHEXDStypeCode Canonical-URL (entspricht TC 3.0.3) https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/198
  • improve patternCoding by @f-peverali (entspricht TC 3.0.3) https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/198
  • fix Fix der XDS Slices für .type und .category (entspricht TC 3.0.3) https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/198

Version: 4.0.0-rc

Datum: 03.04.2024

  • improve Dependency hinzugefügt zu IHE-Package zwecks Auflösung von ValueSets https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/181
  • Erweiterung um Use Case Diagramm, Resourcen Diagramm und Informationsmodell
  • Erweiterung um Use Case Zusammenhänge von verketteten Suchparametern

Version: 3.0.3

Diese Technical Correction entfällt für Stufe 4, da die Änderungen direkt in Stufe 4 (4.0.0-rc2) eingebracht sind.

Version: 3.0.2

Datum: 27.03.2024

  • documentation Hinweis hinzugefügt wie aus einer UUID eine OID generiert werden kann #172 by @alexzautke in https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/172
  • documentation Hinweis zum Umgang mit Dokumentenupdates hinzugefügt
    • fix Fix /versionierung von dokumenten #177 by @alexzautke in https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/177
  • documentation Hinweis zur base64-Kodierung von FHIR-nativen Dokumenten hinzugefügt
    • improve Hinweis zur Kodierung von FHIR Bundles hinzugefügt #178 by @alexzautke in https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/178
  • improve Hinweis zur Verwendung des ‘UNK’-Codes im KDL-Mapping hinzugefügt (#179): https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/179
  • improve Klarstellung , dass keine Vorgaben für “Managing Return Content” bestehen by @alexzautke in https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/183
  • Beispiel Encounter geändert zu Abteilungskontakt (kohärent mit Basis): https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/184/files
  • improve Update Basis dependency to 3.0.4

Full Changelog: https://github.com/gematik/spec-ISiK-Dokumentenaustausch/compare/v3.0.1…v.3.0.2

Version: 3.0.1

Datum: 05.01.2024

  • improve Update Dependency zu Basismodul (Technical Correction 3.0.1)
  • Nutzung der ISiKBinary präzisiert und im CapabilityStatement entsprechend korrigiert: add CpS statement and reference regarding ISIK binary PTDATA-605 by @f-peverali in https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/157
  • Anforderungen zur Nutzung der Ressourcen aus ISIK Basismodul präzisiert: Feature/ptdata 773 anforderungen anpassen basis ressourcen by @f-peverali in https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/163
  • rm all interaction on Encounter + Patient in CpS by @f-peverali in https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/165

Version: 3.0.0

Datum: 01.07.2023

  • Mit dem Release der Stufe 3.0.0 werden die unten gelisteten Änderungen normativ festgesetzt.

Version: 3.0.0-rc4

Datum: 31.05.2023

  • Dokumentenmetadaten (DocumentReference): Kardinalität korrigiert zur Harmonisierung mit MHD
    • improve cardinality #139 by @f-peverali in https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/143

Version: 3.0.0-rc3

Datum: 04.04.2023

  • improve Update der Dependency auf Basismodul 3.0.0-rc2

Version: 3.0.0-rc2

Datum: 31.01.2023

  • Status -Korrektur: “draft”
  • Dependency update auf ISiK Basis-Version 2.0.4

  • weitere Änderungen an Implementierungsleitfaden (informativ)

Version: 3.0.0-rc1

Datum: 04.01.2023

  • Interaktion Dokumentenbereitstellung: Ersetzen der Operation $submit-document mit IHE ITI-105
  • Interaktion Metadaten erzeugen: Ersetzen der Operation $generate-metadata mit IHE ITI-106
  • Profil ISiKDokumentenMetadaten:
    • Kardinalität von DocumentReference.content.attachment.data und .url gelockert, um ITI-105 bedienen zu können
    • Kommentare zu Inkompatibilitäten angepasst auf die Änderungen in IHE MHD Version 4.2.0
  • Akteure und Interaktionen: Anpassung der Dokumentation and die IHE Nomenklaturen
  • Update MHD Dependency -> 4.2.0
  • Update KDL Dependency -> 2022.1.2

  • Beispieldaten an Änderungen in den Interaktionen angepasst

Version: 2.0.1

Datum: 31.10.2022

  • Update Basismodul Dependency -> 2.0.2

Version: 2.0.0

Datum: 30.06.2022

  • Initialer Release