Implementation Guide
ePA MHD Service
Version 1.1.0 - release

## Home

Official URL: https://gematik.de/fhir/epa-mhd/ImplementationGuide/de.gematik.epa.mhd | Version: 1.1.0
Active as of 2025-12-15 | Computable Name: gemIG_ePA_MHD
Copyright/Legal: gematik GmbH / Dieser Implementation Guide ist lizenziert unter Apache License, Version 2.0.

Die ePA für alle unterstützt die Suche auf Dokumenten im XDS Document Service über eine [IHE ITI MHD] kompatible Schnittstelle des MHD Service. Dieser Dienst erweitert die vorhandene IHE XDS-Suchfunktionalität um eine Volltextsuche, die mit einer metadatenbasierten Suche kombinierbar ist. Die Trefferliste einer Volltextsuche enthält u.a.

- die Dokumentmetadaten (gemäß Suchkriterien),
- die im Dokument gefundenen Suchbegriffe in Form von Ausschnitten bzw. Snippets sowie
- einen Score, der ein ungefähres Maß für die Güte des Suchergebnisses angibt.

Neben der Kombination aus dokumentenbasierter Metadaten- und Volltextsuche erlaubt der MHD Service auch das Herunterladen eines Dokuments aus dem XDS Document Service.

### Systemüberblick

Der MHD Service ist als FHIR Data Service eine Ausprägung eines Medical Service sowie Teil des ePA-Aktensystems. Er wird in einer vertrauenswürdigen Ausführungsumgebung (VAU) betrieben (vgl. nachstehende Abbildung).

Anforderungen an ePA-Client-Systeme zu Lokalisierung und Aufbau einer Verbindung zum ePA-Aktensystem und damit die clientseitige Nutzung des MHD Service sind im Implementierungsleitfaden [gemILF_PS_ePA] sowie [gemSpec_Krypt] einzusehen.

Abbildung: Systemüberblick der Fachanwendung ePA mit MHD Service ([FMC-Blockdiagramm])

### Einordnung von IHE MHD-Akteuren in die Fachanwendung ePA

In der nachstehenden Abbildung wird gezeigt, welche IHE Akteure insgesamt in der Fachanwendung ePA wie gruppiert und welche zugehörigen Transaktionen angewendet werden. Akteure unterschiedlicher Integrationsprofile sind im XDS Document Service bzw. MHD Service über zusammengefasste Außenschnittstellen nutzbar, d.h. sie agieren nach außen hin nicht als eigenständige Dienste, sondern sind über feste Pfade adressiert. MHD-Akteure sind ferner farblich hervorgehoben. Kursiv dargestellte Akteure und Transaktionen sind als produkttyp- bzw. komponentenintern anzusehen und setzen lediglich die jeweilige Semantik des IHE-Akteurs um.

Abbildung: Überblick über IHE Akteure und assoziierte Transaktionen

### Funktionalitäten

Der MHD Service unterstützt die folgenden Funktionalitäten:

- Die Metadatensuche ermöglicht das Auffinden von Dokumentmetadaten auf Basis der IHE-Transaktion Find Document References [ITI-67] - sie kann mit einer volltextbasierten Suche kombiniert werden.
- Nach einer metadatengestützten (Voll-)Textsuche können Dokumente auf Basis der IHE-Transaktion Retrieve Document [ITI-68] heruntergeladen werden. Der Download ist auch ohne vorhergehende Suche möglich.

#### Rahmenbedingungen für die Volltextsuche

Die Funktionalität der Volltextsuche umfasst die folgenden Rahmenbedingungen:

- Indizierung der Dokumente im XDS Document Service:
  - Indizierung bzw. Indizieren bezeichnet hier die Verfügbarmachung des in den Dokumenten enthaltenen Textes für die Suche.
    - Die technische Umsetzung der Indizierung, d.h. wie festgehalten wird, welche Begriffe in welchen Dokumenten zu finden sind, ist nicht vorgegeben.
  - Die Dokumente werden beim Einstellen in den XDS Document Service indiziert, d.h. sie stehen für die Metadaten- und Volltextsuche nach kurzer Zeit zur Verfügung.
  - Ausschließlich PDF/A-, XML-, JSON- und reine Textdokumente werden indiziert und damit durchsuchbar gemacht.
    - Das schließt die Erkennung von Text in Bildern ein (Optical Character Recognition, OCR) und betrifft auch Bilder, die nicht die komplette Seite einnehmen.
    - Das schließt auch die Suche in Dokumenten ein, in denen alle oder einzelne Seiten um 90 oder 180 Grad gedreht sind.
  - Dokumente werden durch die Indizierung nicht verändert (seiteneffektfrei).
  - Die Dokumentmetadaten werden bereits durch den XDS Document Service für die Suche aufbereitet; die entsprechend vorhandenen Mechanismen aus diesem Dienst werden nachgenutzt.
- Zugriff auf den MHD-Service
  - Der Zugriff auf den MHD-Service durch Clients erfolgt nur lesend (Dokumente werden nach wie vor über den XDS Document Service eingestellt, der dann die Indizierung anstößt)
  - Lesender Zugriff wird auf diejenigen Dokumente (und deren indizierte “Stichwörter”) gewährt, auf die Clients auch via XDS Document Service lesend zugreifen können (Recht “R” in der Legal Policy des Aktensystems)
- Unterstützung von Nutzer:innen beim Verfassen einer Suchanfrage:
  - Eine clientseitige Prüfung von Rechtschreib- und Tippfehlern bei der Suchanfrage unterstützt die Nutzer:innen.​
  - Das Speichern von gängigen Suchanfragen im ePA-Client-System ist möglich.​
- Struktur der Suchanfrage:
  - Ein ePA-Client-System muss als Suchkriterien Dokumentmetadaten und Suchbegriffe angeben können.
  - Die wesentlichen Dokumentmetadaten müssen unterstützt werden, um die Menge der potentiellen Trefferdokumente eingrenzen zu können.
  - Bei der Volltextsuche sind die folgenden Funktionen und Einschränkungen vorgesehen:
    - Eine Suche kann nach einem oder mehreren Begriffen suchen.
    - Diese Begriffe können mit logischen Suchoperatoren (d.h. UND, ODER, NICHT) verknüpft werden.
    - Eine Verschachtelung von Suchoperatoren wird nicht unterstützt.
    - Das Suchen exakter Phrasen (d.h. das Suchen nach genau den angegebenen Worten in genau dieser Reihenfolge) wird unterstützt.
- Umsetzen der Suche im MHD Service
  - Syntaktisch ähnliche Begriffe (bspw. durch Tippfehler entstanden) werden aktensystemseitig in einem vorgegebenem Rahmen korrigiert.
- Ergebnispräsentation:
  - Jedes Suchergebnis zeigt alle aus der Suche im Dokument gefundenen Begriffe an.
  - Zu jedem gefundenen Begriff wird angezeigt, wie oft er in dem jeweiligen Dokument vorkommt.
  - Je Suchergebnis wird ein Ausschnitt bzw. Snippet angezeigt, das den Textkontext (d.h. den Begriff und den umgebenden Text) der Suchbegriffe im Dokument wiedergibt.
- Nicht-funktionale Anforderungen:
  - Der MHD Service garantiert eine Antwortzeit von wenigen Sekunden.
- Der MHD Service stellt die folgenden Funktionalitäten nicht bereit:
  - Einstellen der Dokumente - Das Einstellen und Registrieren von Dokumenten erfolgt über den XDS Document Service.
  - Suche nach Synonymen und semantisch ähnlichen Begriffen
  - Suche in anderen Dokumententypen als PDF/A, XML, JSON oder reinen Textdokumenten
  - Suche in Dokumenten, die nicht im XDS Document Service gespeichert sind

### Abhängigkeiten

IG | Package | FHIR | Comment
--- | --- | --- | ---
Implementation Guide ePA MHD Service | de.gematik.epa.mhd#1.1.0 | R4 |
HL7 Terminology (THO) | hl7.terminology.r4#7.0.1 | R4 | Automatically added as a dependency - all IGs depend on HL7 Terminology
FHIR Extensions Pack | hl7.fhir.uv.extensions.r4#5.2.0 | R4 |
de.basisprofil.r4 | de.basisprofil.r4#1.5.4 | R4 |
Mobile access to Health Documents (MHD) | ihe.iti.mhd#4.2.3 | R4 |
HL7 Terminology (THO) | hl7.terminology.r4#6.5.0 | R4 |
Basic Audit Log Patterns (BALP) | ihe.iti.balp#1.1.4 | R4 |
TI Terminology | de.gematik.terminology#1.0.8 | R4 |
dvmd.kdl.r4 | dvmd.kdl.r4#2025.0.1 | R4 |
Implementation Guide Telematikinfrastruktur (TI) Common | de.gematik.ti#1.2.0 | R4 |
Implementation Guide ePA Basisfunktionalitäten | de.gematik.epa#1.3.0 | R4 |
FHIR Tooling Extensions IG | hl7.fhir.uv.tools.r4#0.8.0 | R4 | for example references

Package hl7.fhir.uv.extensions.r4#5.2.0 This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Mon, Feb 10, 2025 21:45+1100+11:00)

Package de.basisprofil.r4#1.5.4 Projekt Basisprofilierung R4 (HL7 Deutschland e.V.)

Package ihe.iti.balp#1.1.4 The Basic Audit Log Patterns (BALP) Implementation Guide is a Content Profile that defines some basic and reusable AuditEvent patterns. This includes basic audit log profiles for FHIR RESTful operations to be used when there is not a more specific audit event defined. A focus is enabling Privacy centric AuditEvent logs that hold well formed indication of the Patient when they are the subject of the activity being recorded in the log. Where a more specific audit event can be defined it should be derived off of these basic patterns. (built Fri, Oct 31, 2025 12:53-0500-05:00)

Package ihe.iti.mhd#4.2.3 ImplementationGuide for IHE IT Infrastructure Technical Framework Supplement Mobile access to Health Documents (MHD) (built Fri, Oct 31, 2025 14:32-0500-05:00)

Package dvmd.kdl.r4#2025.0.1 Publikation der Terminologie-Ressourcen für die Nutzung der Klinische Dokumentenklassen-Liste (KDL) des DVMD Version 2025

Package hl7.fhir.uv.tools.r4#0.8.0 This IG defines the extensions that the tools use internally. Some of these extensions are content that are being evaluated for elevation into the main spec, and others are tooling concerns (built Tue, Aug 5, 2025 20:09+1000+10:00)

### Sprachliche Konventionen

- Zur besseren Lesbarkeit wird in diesem Implementation Guide das generische Maskulinum verwendet. Die hier verwendeten Personenbezeichnungen beziehen sich stets auf alle Geschlechter.

- Der Begriff “Arzt” wird in diesem Implementation Guide sowohl für Human- als auch für Zahnmediziner verwendet.

### Kontakt

Allgemeine Fragen und Kommentare zum Implementation Guide können Sie über das [Anfragenportal] der gematik einreichen. Falls kein Zugang besteht, senden Sie bitte eine E-Mail an “patientteam [ at ] gematik [ dot ] de” mit dem Betreff “Anfragenportal Zugang”.