Find Document References

Die Find-Document-References-Transaktion des MHD Service basiert auf der IHE-Transaktion [ITI-67] der [IHE ITI MHD]-Spezifikation. Sie wird vom ePA-Client-System verwendet, um Dokumente bzw. Dokumentenreferenzen zu finden, die eine Reihe von Suchparametern erfüllen. Als Ergebnis erhält das ePA-Client-System ein vom MHD Service erzeugtes FHIR Bundle mit DocumentReference-Ressourcen, die den Anfrageparametern entsprechen. Zusätzlich wird diese IHE-Transaktion um eine Volltextsuche ergänzt.

Einsatzbereich

Die Transaktion Find Document References [ITI-67] wird verwendet, um DocumentReference-Ressourcen zu finden, die einer bestimmten Menge von Parametern entsprechen. Sie entspricht den Abfragen FindDocuments und FindDocumentsByReferenceId sowie den ePA-spezifischen Abfragen FindDocumentsByTitle und Query FindDocumentsByComment aus der Registry-Stored-Query-Transaktion. Das Ergebnis der Abfrage ist ein FHIR Bundle, das die DocumentReference-Ressourcen enthält, die mit den Abfrageparametern übereinstimmen.

Nachricht

Diese Nachricht wird als HTTP GET- oder HTTP POST-Anfrage an den MHD Service gesendet, um eine Liste von Dokumentmetadaten abzurufen.

Auslösung

Wenn das ePA-Client-System eine XDS metadatenbasierte Suche über Dokumente oder eine metadatengestützte Volltextsuche über indizierte Dokumente durchführen und dazu die korrespondierenden DocumentReference-Ressourcen ermitteln möchte, sendet er eine Find-Document-References-Nachricht.

API

Das ePA-Client-System führt eine HTTP-Suche über die DocumentReference-URL des MHD Service durch. Das Suchziel richtet sich nach [FHIR-HTTP] und bezieht sich auf die DocumentReference-Ressource.

Suchparameter

Die Suchparameter für die FHIR MHD DocumentReference-Ressource sind im CapabilityStatement mit dem Namen EPAMHDDocumentResponder definiert. Sie ermöglichen eine präzise Suche nach relevanten Dokumenten innerhalb eines MHD-kompatiblen Systems. Der MHD-Service erweitert die von der MHD-Spezifikation definierten Suchparameter um author.organization.name, _content, language sowie title.

Volltextsuche

Neben der Angabe von XDS-Metadaten für das Auffinden von Dokumenten soll ein ePA-Client-System in der Benutzerschnittstelle ein oder mehrere Eingabefelder für die Volltextsuche zur Verfügung stellen.

Hinweis: Auf Mobilsystemen (Android und iOS) reicht es aus, für die Rechtschreibkorrektur auf die Bordmittel des jeweiligen Betriebssystems zurückzugreifen. Dies kann auch auf weiteren Betriebssystemen der Fall sein, wenn diese eine sinnvolle Unterstützung bei der Eingabe bieten können. Die Abschaltbarkeit wird deshalb gefordert, um eine erzwungene Rechtschreibkorrektur zu verhindern, die das Eingeben exakter Worte oder Phrasen aktiv verhindert. Wenn die gewählte Rechtschreibkorrektur beispielwiese vorschlagsbasiert arbeitet und Änderungen durch den Benutzer bestätigen lässt, ist die Abschaltbarkeit damit abgegolten. Insgesamt ist es das Ziel, einfache Tippfehler bei der Eingabe schnell erkennen und ggf. korrigieren zu können, aber es gleichzeitig dem Benutzer zu ermöglichen, bequem die Vorschläge der Rechtschreibkorrektur zu ignorieren.

Zur Bildung des Suchstrings kommt eine vereinfachte Grammatik (siehe IG-MHD72948GYM) zum Einsatz (siehe weiter unten). Zudem ist es nicht erlaubt, Suchanfragen zu verschachteln (“Klammerungstiefe” 1).

Die Anforderung ist keine harte (“MUSS”-)Verpflichtung, da es Clients geben kann, für die eine Kombination beider Sucharten nicht sinnvoll in das Gesamtkonzept zu integrieren ist. Andere Clients setzen möglicherweise nur sehr ausgewählte Anwendungsfälle um, bei denen diese Kombination nicht sinnvoll oder notwendig ist.

Beispiele für gültige Suchanfragen

• Einzelne Begriffe:
  • Diabetes: Sucht im Dokument nach Worten, die die Buchstabenfolge "Diabetes" enthalten (case-insensitive, mögliche Treffer z. B. 'Diabetes', 'Diabetesuntersuchung', 'Altersdiabetessymptom', 'TYP-1-DIABETES').
  • Bluthochdruck: Sucht im Dokument nach Worten, die die Buchstabenfolge "Bluthochdruck" enthalten (case-insensitive, s.o.).
• Phrasen mit Anführungszeichen:
  • "Diabetes": Sucht im Dokument das Wort Diabetes (case-insensitive), einige mögliche Trefferwörter: 'Diabetes', 'diabetes', 'DIAbetES'.
  • "Chronische Schmerzen": Sucht im Dokument nach der genauen Buchstabenfolge (Phrase) "Chronische Schmerzen", inklusive des Leerzeichens (case-insensitive, d.h. auch andere Groß/Kleinschreibung möglich).
  • "Herz-Kreislauf-Erkrankungen": Sucht im Dokument nach der genauen Buchstabenfolge (Phrase) "Herz-Kreislauf-Erkrankungen" (case-insensitive).
• Verwendung von booleschen Operatoren:
  • Diabetes AND Bluthochdruck: Sucht im Dokument nach Worten, die die Buchstabenfolge "Diabetes" und "Bluthochdruck" enthalten (case-insensitive) und liefert nur dann einen Treffer, wenn beide gefunden werden.
  • Asthma OR "Chronische Schmerzen": Sucht im Dokument nach Worten, die die Buchstabenfolge "Asthma" (case-insensitive) oder die Phrase "Chronische Schmerzen" (case-insensitive) enthalten und liefert dann einen Treffer, eins von beiden gefunden wird.
  • NOT Krebs: Sucht im Dokument nach der Wortfolge "Krebs" (case-insensitive), und liefert einen Treffer, wenn das Wort nicht gefunden wird.
• Verwendung von Klammern zur Anpassung der Auswertereihenfolge:
  • (Diabetes OR Bluthochdruck) AND AsthmaÄhnlich wie oben, zwingt nur den MHD Service, die "OR"-Verknüpfung vor dem "AND" auszuwerten.
  • ("Chronische Schmerzen" OR Asthma) AND NOT KrebsWeiteres Beispiel für Klammerung.
• Suchanfrage ohne Klammern mit relevanter Bindungsstärke:
  • NOT Diabetes AND Asthma OR Bluthochdruck
  • Erklärung:
    • NOT Diabetes AND Asthma OR Bluthochdruck
    • Erklärung:
      • Der NOT-Operator hat die höchste Bindungsstärke und wird zuerst ausgewertet, sodass überprüft wird, ob das Dokument den Begriff "Diabetes" nicht enthält.
      • Der AND-Operator hat die nächste höchste Bindungsstärke. Die Suchanfrage prüft, ob "Asthma" im Dokument enthalten ist und "Diabetes" nicht enthalten ist.
      • Der OR-Operator wird zuletzt ausgewertet. Ein Dokument gilt als Treffer, wenn entweder "Asthma" enthalten ist und "Diabetes" nicht enthalten ist, oder wenn "Bluthochdruck" im Dokument enthalten ist.
      • Eine äquivalente Suchanfrage wäre:(NOT Diabetes AND Asthma) OR Bluthochdruck

Beispiele für ungültige Suchanfragen:

• Ungültige Verwendung von Operatoren:
  • Diabetes AND OR Bluthochdruck
    Grund: Die Kombination von AND und OR ohne Suchbegriff dazwischen ist nicht erlaubt.
• Fehlende Anführungszeichen für Phrasen:
  • Chronische Schmerzen AND Asthma
    Grund: Eine Phrase wie "Chronische Schmerzen" muss in Anführungszeichen gesetzt werden, um als zusammenhängender Begriff erkannt zu werden. Alternativ könnte zwischen "Chronische" und "Schmerzen" ein AND oder OR gesetzt werden. Die vorliegende Suche hingegen würde einen Fehler zurückgeben.
• Unzulässige Verschachtelung von Klammern:
  • (Diabetes OR (Bluthochdruck AND Asthma))
    Grund: Verschachtelte Klammerung ist nicht erlaubt. Die Grammatik erlaubt nur eine Ebene der Klammerung.
• Unvollständige logische Ausdrücke:
  • NOT AND Diabetes
    Grund: NOT muss einem spezifischen Suchbegriff oder einer Phrase vorangestellt sein, nicht einem Operator.
• Falsche Platzierung von Klammern:
  • Diabetes OR )Bluthochdruck AND Asthma(
    Grund: Die Klammern sind falsch platziert. Klammern müssen korrekt geöffnet und geschlossen werden.

Verarbeitung

Der MHD Service verarbeitet die Anfrage, um die DocumentReference-Einträge zu ermitteln, die den angegebenen Suchparametern entsprechen. Darüber hinaus gibt er einen zur Verarbeitung passenden HTTP Status Code sowie ein FHIR Bundle der passenden DocumentReference-Ressourcen zurück.

Diese Anforderung stellt insbesondere sicher, dass MHD-Anfragen korrekt auf die entsprechenden XDS-Metadaten abgebildet werden.

In der Operation Find Document References können neben den Standardpaginierungsparametern wie _count und _offset weitere Parameter enthalten sein, die die Paginierung erleichtern. Ein Beispiel hierfür ist der Parameter stateid, der den aktuellen Zustand der Ergebnisliste repräsentiert. Dies ermöglicht es dem MHD Service, die Navigation durch die Ergebnisse effizient zu verwalten, indem der Kontext oder Zustand der Suche erhalten bleibt.

{
  "resourceType": "Bundle",
  "entry": [
    {
      "search": {
        "mode": "match",
        "score": 0.9
      }
      ...
    }
  ],
  "type": "searchset",
  "total": 1
}

Die Auswertung mit größeren Editierdistanzen (>=2) kann unterstützt werden. Sie kann auch variabel eingesetzt werden (z. B. je nach Wortlänge der Suchbegriffe). Dieselbe Suchanfrage sollte aber bei unverändertem Dokumentenindex immer verlässlich dieselben Treffer liefern.

Snippet- und Trefferanzahl-Erweiterungen

Die Match Snippet Extension und die Match Total Hits Extension sind Erweiterungen, die im Rahmen der Volltextsuche verwendet werden, um die Ergebnisse der Suche detaillierter darzustellen. Die Match Snippet Extension dient dazu, relevante Textausschnitte (Snippets) aus einem Dokument zu extrahieren, die den gesuchten Begriff enthalten. Diese Snippets werden im value der Erweiterung bereitgestellt und markieren den gefundenen Begriff durch das Tag <match> </match>. Zusätzlich wird die Seitenzahl des Dokuments angegeben, auf der der Treffer gefunden wurde. Die Match Total Hits Extension bietet eine Gesamtübersicht der Treffer im Dokument. Es gibt an, wie viele Treffer insgesamt im gesamten Dokument gefunden wurden, basierend auf der Volltextsuche.

Beispiel Snippets und Trefferanzeige

{
  "url": "https://gematik.de/fhir/epa-mhd/StructureDefinition/epa-match-snippet",
  "extension": [
    {
      "url": "snippet",
      "valueString": "Das ist ein <match>Test</match>."
    },
    {
      "url": "pageNumber",
      "valueString": "1"
    }
  ]
}

Beispiel Gesamtzahl der Treffer pro Dokument

{
  "url": "https://gematik.de/fhir/epa-mhd/StructureDefinition/epa-match-total-hits",
  "valueInteger": 2
}

Sicherheitsanforderungen

Generelle Sicherheitsanforderungen werden hier festgehalten.

Protokollierung

Die Protokollierung erfolgt über den Audit Event Service. Weitere Anforderungen sind [gemSpec_Aktensystem_ePAfueralle#Protokollierung] zu entnehmen.