Implementation Guide
ePA MHD Service
Version 1.1.0 - release

## Extension: EPA Match Snippet Extension

Official URL: https://gematik.de/fhir/epa-mhd/StructureDefinition/epa-match-snippet | Version: 1.1.0
Active as of 2025-12-15 | Computable Name: EPAMatchSnippetExtension
Copyright/Legal: gematik GmbH / Dieses Artefakt ist lizenziert unter Apache License, Version 2.0.

Diese Erweiterung enthält einen Textausschnitt, der den Kontext eines Suchtreffers beschreibt. Sie hebt relevante Inhalte hervor, die den eingegebenen Suchbegriffen entsprechen und bietet so eine präzise Vorschau auf das Suchergebnis.

Context of Use

This extension may be used on the following element(s):

- Element ID Bundle.entry.search

Usage info

Usages:

- Use this Extension: EPA Document Search Result Bundle
- Examples for this Extension: Bundle/example-fulltext-search-match

You can also check for usages in the FHIR IG Statistics

### Formal Views of Extension Content

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

- Text Summary
- Differential Table
- Snapshot Table
- All

This structure is derived from Extension

Summary

Complex Extension: Diese Erweiterung enthält einen Textausschnitt, der den Kontext eines Suchtreffers beschreibt. Sie hebt relevante Inhalte hervor, die den eingegebenen Suchbegriffen entsprechen und bietet so eine präzise Vorschau auf das Suchergebnis.

- snippet: string: An Extension
- pageNumber: string: An Extension

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | EPA Match Snippet Extension
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Closed by value:url
extension:snippet |  | 0..1 | Extension | Extension
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "snippet"
value[x] |  | 1..1 | string | Menschenlesbarer Textausschnitt, der den Kontext des Suchtreffers beschreibt
extension:pageNumber |  | 0..1 | Extension | Extension
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "pageNumber"
value[x] |  | 1..1 | string | Bei Dokumenten mit Seitennummerierung (z.B. PDF) lässt sich hier die genaue Trefferseite der Volltextsuche angeben.
url |  | 1..1 | uri | "https://gematik.de/fhir/epa-mhd/StructureDefinition/epa-match-snippet"
value[x] |  | 0..0 |  | Value of extension
Documentation for this format

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | EPA Match Snippet Extension
id |  | 0..1 | string | Unique id for inter-element referencing
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Closed by value:url
extension:snippet |  | 0..1 | Extension | Extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "snippet"
value[x] |  | 1..1 | string | Menschenlesbarer Textausschnitt, der den Kontext des Suchtreffers beschreibt
extension:pageNumber |  | 0..1 | Extension | Extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "pageNumber"
value[x] |  | 1..1 | string | Bei Dokumenten mit Seitennummerierung (z.B. PDF) lässt sich hier die genaue Trefferseite der Volltextsuche angeben.
url |  | 1..1 | uri | "https://gematik.de/fhir/epa-mhd/StructureDefinition/epa-match-snippet"
Documentation for this format

This structure is derived from Extension

Summary

Complex Extension: Diese Erweiterung enthält einen Textausschnitt, der den Kontext eines Suchtreffers beschreibt. Sie hebt relevante Inhalte hervor, die den eingegebenen Suchbegriffen entsprechen und bietet so eine präzise Vorschau auf das Suchergebnis.

- snippet: string: An Extension
- pageNumber: string: An Extension

Differential View

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | EPA Match Snippet Extension
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Closed by value:url
extension:snippet |  | 0..1 | Extension | Extension
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "snippet"
value[x] |  | 1..1 | string | Menschenlesbarer Textausschnitt, der den Kontext des Suchtreffers beschreibt
extension:pageNumber |  | 0..1 | Extension | Extension
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "pageNumber"
value[x] |  | 1..1 | string | Bei Dokumenten mit Seitennummerierung (z.B. PDF) lässt sich hier die genaue Trefferseite der Volltextsuche angeben.
url |  | 1..1 | uri | "https://gematik.de/fhir/epa-mhd/StructureDefinition/epa-match-snippet"
value[x] |  | 0..0 |  | Value of extension
Documentation for this format

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | EPA Match Snippet Extension
id |  | 0..1 | string | Unique id for inter-element referencing
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Closed by value:url
extension:snippet |  | 0..1 | Extension | Extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "snippet"
value[x] |  | 1..1 | string | Menschenlesbarer Textausschnitt, der den Kontext des Suchtreffers beschreibt
extension:pageNumber |  | 0..1 | Extension | Extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "pageNumber"
value[x] |  | 1..1 | string | Bei Dokumenten mit Seitennummerierung (z.B. PDF) lässt sich hier die genaue Trefferseite der Volltextsuche angeben.
url |  | 1..1 | uri | "https://gematik.de/fhir/epa-mhd/StructureDefinition/epa-match-snippet"
Documentation for this format

Other representations of profile: CSV, Excel, Schematron

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`