Ihre Meinung macht den Unterschied
Jetzt Feedback zum gematik Fachportal geben!

Unterstützen Sie uns dabei, das gematik Fachportal weiter zu verbessern.
Was funktioniert gut? Wo sehen Sie Optimierungsbedarf? Nehmen Sie sich einen Moment Zeit und bringen Sie Ihre Perspektive ein.

Hier geht es zur Umfrage

C_12684_Anlage_V1.0.0

Prereleases:

PDF HTML Excel XML
C_12684_Anlage_V1.0.0

C_12684_Anlage

1 Änderung in gemSpec_Aktensystem_ePAfuerAlle

Folgende Ausnahmen sind für Phase 1 für die IBM vorgesehen:

  • A_28834 (Unterstützung von KDL 2024 als deprecated): Auf Unterstützung der KDL 2024 darf verzichtet werden.

  • A_28833 (Migration von Bestandsdaten auf Haupt-Identifier und Version): Auf Unterstützung der Anforderung außerhalb von DocumentEntry.eventCodeList darf verzichtet werden.

  • A_28841 (Persistierung von Haupt-Identifier und Version): Auf Unterstützung der Anforderung außerhalb von DocumentEntry.eventCodeList darf verzichtet werden.

  • A_28842 (Einstellen ohne Versionsangabe): Auf Unterstützung der Anforderung außerhalb von DocumentEntry.eventCodeList darf verzichtet werden.

Es wird in Abschnitt "2 Übergreifende Festlegungen" neu aufgenommen:

Unter A_27443-01 Nutzung Terminologiepaket:

A_28834 - Nutzung ausgewählter Code Systems im Status "Deprecated"

Das ePA-Aktensystem MUSS an den an Stellen, an denen gemäß [gemIG_TI_Terminology] die Verwendung von Codes aus folgenden versionierten Code Systems erlaubt sind, auch Codes der jeweils angegebenen alten Version desselben Code System akzeptieren (inklusive der/des ggf. angegebenen alternativen Namen):

Name Code System Identifier und Version
Status "Active"
(gemäß [gemIG_TI_Terminology] zu unterstützen)		 Code System Identifier und Version
Status "Deprecated"
(zusätzlich zu unterstützen)
KDL http://dvmd.de/fhir/CodeSystem/kdl 
Version 2025		 http://dvmd.de/fhir/CodeSystem/kdl (preferred)
Version 2024

Alternativer Name: 1.2.276.0.76.5.552
Die Umsetzung erfolgt zunächst nur für Codes im Metadatum DocumentEntry.eventCodeList.
[<=]

Der Hinweis "preferred" wird in A_28834 nicht benötigt, kann jedoch bei Bedarf von anderen Anforderungen referenziert werden.

Die hier gelisteten Code Systems werden als "deprecated" markiert. Sie können nach wie vor wie "aktive" Code Systems und deren Codes durch Clients genutzt werden (bspw. beim Einstellen von neuen Dokumenten bzw. DocumentEntries). Mit der Kennzeichnung wird jedoch angedeutet, dass zukünftige Versionen von ePA für Alle die entsprechenden Codes möglicherweise entfernen werden (Status "inactive"). Dann können sie nicht mehr für neue Daten genutzt werden.

Es wird in Abschnitt "3.13.1.8.4 Automatisches Umschreiben von Daten" neu aufgenommen:

A_28833 - XDS Document Service – Migration von Code Systemen auf Haupt-URL

Der XDS Document Service MUSS die Metadaten von bestehenden DocumentEntries, SubmissionSets, Folders und Associations wie folgt anpassen, sofern das entsprechende Metadatum Codes enthält:

  • Der XDS Document Service MUSS für jeden Code prüfen, ob für das gegebene Code System gemäß [gemIG_TI_Terminology] unter den "Naming Systems" alternative Namen definiert sind und das bestehende Code System durch denjenigen Namen ("Identifier") des Code System ersetzen, der in den "Naming Systems" als "preferred" gekennzeichnet ist und die Version gemäß [gemIG_TI_Terminology] hinzufügen.
  • Der XDS Document Service MUSS den folgenden Code System-Wert "1.2.276.0.76.5.518" (ICD-10GM Version 2022) ersetzen durch den Wert "http://fhir.de/CodeSystem/bfarm/icd-10-gm" und die Version "2022" ergänzen.
  • Der XDS Document Service MUSS den folgenden Code System-Wert "1.2.276.0.76.5.552" (KDL 2024) durch den Wert "http://dvmd.de/fhir/CodeSystem/kdl" ersetzen und die Version "2024" ergänzen.
  • Der XDS Document Service MUSS den folgenden Code System-Wert "http://dvmd.de/fhir/CodeSystem/kdl", sofern er ohne Version angegeben wird (KDL), um die Version "2024" ergänzen.
[<=]

In der Regel bedeutet dies, dass Code Systeme, die bisher als OID oder unter Angabe einer Alternativ-URL abgespeichert wurden, stattdessen mit Haupt-Identifier + Version des Code Systems gespeichert werden, um einen konsistenten Datenbestand zu erreichen.

Wenn der "preferred" Identifier in den Bestandsdaten bereits vergeben ist, ist keine Änderungen am Code System vorzunehmen.

Für XDS wird die Versionsangabe eines Code-System-Werts (bei URL-basierte Werte) über ein  "|"-Symbol angehängt, siehe A_27759*.

Die Version ist nur in Fällen hinzuzufügen, in denen das entsprechende Code System gemäß [gemIG_TI_Terminology] eine Version führt.

Es wird in Abschnitt "3.13.1.4.3 Vorgaben zu IHE ITI-Transaktionen bei mehreren Schnittstellen" neu aufgenommen:

Unter A_28662 - XDS Document Service – Kein Coding Scheme mit Präfix "urn:oid":

A_28841 - XDS Document Service – Persistierung neuer Metadaten mit "preferred" Identifier und ggf. Version

Der XDS Document Service MUSS beim Persistieren von DocumentEntries, SubmissionSets, Associations und Folders etwaige Codes in den Metadaten derart abspeichern, dass das entsprechende Code System immer mit dem Haupt-Identifier  ("preferred" Name in [gemIG_TI_Terminology]) persistiert wird, auch wenn der Einstellende einen alternativen Identifier verwendet hat.
Wenn das Code System gemäß [gemIG_TI_Terminology] eine Version führt, muss diese ebenfalls persistiert werden.
[<=]

Ziel ist es eine möglichst konsistente und gleichförmige Datenbasis im Aktensystem zu pflegen.

A_28842 - XDS Document Service – Einstellen von Code Systeme ohne Versionsangabe

Der XDS Document Service MUSS beim Einstellen von DocumentEntry-Metadaten, die Codes enthalten, jeden Code, der mit einem Code System mit URL-basiertem Identifier aber ohne Versionsangabe geschickt wird, wie folgt behandeln:

  1. Die aktuellste Version des Code System gemäß [gemIG_TI_Terminology], bzw. wenn dort nicht existent ggf. die aktuellste "deprecated"-Version gemäß A_28834*, wird ergänzt.
  2. Prüfung, ob der Code in der derart konstruierten Version des Code System existiert.
Wenn der Code in der so konstruierten Version des Code Systems existiert, MUSS der XDS Document Service das Einstellen wie gewohnt fortsetzen, als wenn der Client den Code unter Angabe der neuesten Code System-Version gesendet hätte.

Andernfalls MUSS der XDS Document Service die Anfrage ggf. mit demselben Fehler ablehnen, der auch beim Einstellen mit einem anderen nicht existierenden Codes zurückgegeben würde. 

[<=]

Diese Regelung erlaubt es, inbesondere KDL 2024-Codes bis auf weiteres in ePA 3.1.3 unter Angabe der Code System URL aber ohne Angabe der dazugehörigen Version einzustellen wie es in ePA 3.0.5 möglich war. Dies soll (insbesondere nicht auf 3.1.3 migrierten) Clients den Übergang von 3.0.5 nach 3.1.3 erleichtern.

A_28841* gilt auch hier nach wie vor, das heißt ggf. wird der Code mit Haupt-URL + Version persistiert.

Code Systeme, die über eine OID eingestellt werden, sind implizit (über die OID) versioniert und sind deshalb nicht für A_28842* relevant.

Es wird in Abschnitt "3.13.1.4.3.2 Registry Stored Query [ITI-18]" neu aufgenommen:

Anmerkung: Aufgrund von https://gemspec.gematik.de/docs/gemSpec/gemSpec_Aktensystem_ePAfueralle/latest/#A_28668  ist schon eine unscharfe Suche mit URL aber ohne Version möglich (gefunden werden Treffer für diesen Code in allen Versionen des Code System) . Diesbezüglich ist keine Ergänzung notwendig.

Unter "A_28668 - Unscharfe Suche über Metadatenattribute mit Code System Version":

A_28844 - XDS Document Service – Suche nach Code System mit Haupt-Identifier und Version

Der XDS Document Service MUSS bei Belegung eines Suchparameters mit einem Code in einer Registry Stored Query [ITI-18] die Suche wie folgt durchführen: 
Bei Code Systemen MUSS der XDS Document Service zur Ermittlung von Treffern in der Datenbasis auch Ergebnisse finden, bei denen der entsprechende Code mit einem äquivalenten Identifier für das jeweilige Code System gespeichert ist. Dies betrift Coding Systems gemäß  [gemIG_TI_Terminology] oder die als "deprecated" gelisteten Code Systems gemäß A_28834, sofern an der jeweiligen Stelle mehr als ein Identifier für das angefragte Code System festgelegt ist.
Wenn der XDS Document Service später für diese Suche einen DocumentEntry zurückgeliefert, MUSS statt des vom Client gelieferten Code-System-Werts stattdessen der Haupt-Identifier inklusive Versionsangabe zurückgeliefert werden.
[<=]

Damit werden bei der Suche die verschiedenen Identifier eines Code Systems als äquivalent behandelt; das heißt, der Client darf einen beliebigen Namen für ein Code System verwenden und der XDS Document Service muss auch dann einen Treffer generieren, wenn der entsprechende Code mit einem anderen Identifier für dasselbe Code System in der Datenbasis gespeichert wird.

Unabhängig von der Anfrage gibt der XDS Document Service also dem Client das Code System immer mit Haupt-Identifier zurück.

Es wird in Abschnitt "3.13.1.4.3.5 Restricted Update Document Set [ITI-92]" neu aufgenommen:

Direkt noch vor "A_15061-09 - XDS Document Service – Ablauflogik für Restricted Update Document Set":

A_28845 - XDS Document Service – Verwendung von Haupt-Identifier in Code System für RMU

Der XDS Document Service MUSS sicherstellen, dass bei der Umsetzung der Operation RestrictedUpdateDocumentSet ein vom Client gesendetes Code System

  • gemäß [gemIG_TI_Terminology]
  • oder "deprecated" gelisteten Code Systems gemäß A_28834
beim Abgleich mit der Datenbasis auch dann eine Gleichheit feststellt, wenn das abzugleichende Code System in der Datenbasis mit einem abweichenden, äquivalenten Identifier für dasselbe Code System gespeichert ist. [<=]

Damit wird sichergestellt, dass die Prüfung auf geänderte Codes nicht daran scheitert, dass der Client einen Code System Identifier wählt, der vom im Aktensystem gespeicherten Identifier abweicht.

In der folgenden Anforderung wird der informative Teil unter dem Beispiel gestrichen: