Release Notes

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.0.0-rc2 (Benehmensherstellung)

Datum: 5.6.2025

added: Neuer verbindlicher Suchparameter identifier für DocumentReference hinzugefügt, auf Basis von Community-Feedback
improved 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
added: 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

improved: 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
changed: 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

added: 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
added: 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
fixed: 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

'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

improved: Übertragung der Dokumentation in die FHIR-Resourcen, Refactoring des ImplementationGuides https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/211
fixed: 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
fixed: Fehlende Kennzeichnung von MS-Elementen im Bundle-Profil https://github.com/gematik/spec-ISiK-Dokumentenaustausch/issues/210
fixed: Binary-URL zeigt noch auf Basis V3 https://github.com/gematik/spec-ISiK-Dokumentenaustausch/issues/206
fixed: Operations hängen im CapabilityStatement am falschen Branch https://github.com/gematik/spec-ISiK-Dokumentenaustausch/issues/206
fixed: Falscher Satz über keine notwendige Verbindlichkeit entfernt und Formulierung verbessert https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/213
improved: Link zum GitHub Archiv des Moduls wurde in der README ergänzt https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/209
improved: Update der validation pipeline Versionen https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/214
fixed: Beispiel für Dokumentensurchergebnisse wurde gefixt https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/217
fixed: OPD-0 Warnung in OperationUpdateMetadata https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/218
fixed: 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
add patternCoding by @f-peverali (entspricht TC 3.0.3) https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/198
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

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

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
Hinweis zum Umgang mit Dokumentenupdates hinzugefügt
- Fix/versionierung von dokumenten #177 by @alexzautke in https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/177
Hinweis zur base64-Kodierung von FHIR-nativen Dokumenten hinzugefügt
- Hinweis zur Kodierung von FHIR Bundles hinzugefügt #178 by @alexzautke in https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/178
Hinweis zur Verwendung des ‘UNK’-Codes im KDL-Mapping hinzugefügt (#179): https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/179
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
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

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
- update cardinality #139 by @f-peverali in https://github.com/gematik/spec-ISiK-Dokumentenaustausch/pull/143

Version: 3.0.0-rc3

Datum: 04.04.2023

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