Beispiele
- Beispiele
- Beispiel: Bedingte Items
- Beispiel: Observation-basierte Prepopulation und Extraction
- Beispiel: Stammdaten Prepopulation
- Beispiel: Observation-basierte Extraction bei quantitativen Angaben
- Beispiel: Vorbelegung demografischer Patientendaten
- Beispiel: Validierung von Dezimalzahlen
- Beispiel: Validierung von Pattern
- Beispiel: Modifier Extension MDR-relevant
Beispiel: Bedingte Items
Metadaten
| Name | ExampleConditionalItem |
|---|---|
| URL | https://gematik.de/fhir/isik/Questionnaire/ExampleConditionalItem |
| Beschreibung | Beispiel-Questionnaire mit bedingten Fragestellungen/ItemsDie zweite Frage "Was ist denn los?" soll nur gestellt werden, wenn die erste Frage "Wie geht's" mit "muss." beantwortet wurde. |
Gerendertes Formular
Globale Extensions
| ID | Text | Type | Options | EnableWhen | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2 | Fragen mit EnableWhen-Bedingung | group | |||||||||||
| 2.1 | Wie geht's? | choice |
| ||||||||||
| 2.2 | Was ist denn los? | choice |
|
|
Quellcode
</meta>
<description value="### Beispiel-Questionnaire mit bedingten Fragestellungen/Items \nDie zweite Frage "Was ist denn los?" soll nur gestellt werden, \nwenn die erste Frage "Wie geht's" mit "muss." beantwortet wurde." />
</answerOption>
</answerOption>
</answerOption>
</item>
</answerCoding>
</enableWhen>
</answerOption>
</answerOption>
</item>
</item>
</Questionnaire>
{
},
"Patient"
],
"description": "### Beispiel-Questionnaire mit bedingten Fragestellungen/Items \nDie zweite Frage "Was ist denn los?" soll nur gestellt werden, \nwenn die erste Frage "Wie geht's" mit "muss." beantwortet wurde.",
{
{
{
},
{
},
{
}
]
},
{
],
]
}
]
}
]
}
Beispiel: Observation-basierte Prepopulation und Extraction
Metadaten
| Name | ExamplePrePopObservation |
|---|---|
| URL | https://gematik.de/fhir/isik/Questionnaire/ExamplePrePopObservation |
| Beschreibung | Beispiel-Questionnaire mit automatischer Vorbelegung von ObservationsDie Suche nach passenden Observations geschieht innerhlab des Patienten-Kontextes anhand des in |
Gerendertes Formular
Zur korrekten Darstellung dieses Beispiels wird eine externe Anfrage in Richtung des offiziellen HL7 Deutschland e.V. FHIR-Server (https://fhir.hl7.de/fhir) gestellt. Falls dort keine passende Observation mehr liegen sollte, scheitert die Prepopulation. Wenden Sie sich in diesem Fall bitte an das ISiK Team.
Globale Extensions
| Name | |||||||||
|---|---|---|---|---|---|---|---|---|---|
| Subextensions |
|
Item-Definitionen
| ID | Text | Type | Code | Options | Extraction | LinkPeriod | ||||
|---|---|---|---|---|---|---|---|---|---|---|
| 3 | Pflegegrad | group | ||||||||
| 3.1 | Bitte geben Sie den Pflegegrad an: | choice | http://loinc.org, 80391-6 | True |
|
Quellcode
</meta>
<ValueSet>
</meta>
</telecom>
</contact>
</filter>
</include>
</compose>
</contains>
</contains>
</contains>
</contains>
</contains>
</contains>
</expansion>
</ValueSet>
</contained>
</valueCoding>
</extension>
</extension>
</extension>
</extension>
<description value="### Beispiel-Questionnaire mit automatischer Vorbelegung von Observations \nDie Suche nach passenden Observations geschieht innerhlab des Patienten-Kontextes anhand des in `item-code`hinterlegten Codes.\nDie Extension [SDC-ObservationLinkPeriod](https://build.fhir.org/ig/HL7/sdc/StructureDefinition-sdc-questionnaire-observationLinkPeriod.html) legt fest, wie alt Observations maximal sein dürfen, um für die Vorbelegung herangezogen zu werden (hier: max. 1 Jahr) \nDie Extension [SDC-ObservationExtract](https://build.fhir.org/ig/HL7/sdc/StructureDefinition-sdc-questionnaire-observationExtract.html) legt fest, ob aus den Angaben des Questionnaires eine neue Observation extrahiert werden soll (hier: true)" />
<extension url="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observationLinkPeriod">
</valueDuration>
</extension>
<extension url="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observationExtract">
</extension>
</code>
</item>
</item>
</Questionnaire>
{
},
{
},
],
{
]
}
]
},
{
},
{
},
{
},
{
},
{
},
{
}
]
}
}
],
{
{
}
},
{
},
{
}
],
}
],
"Patient"
],
"description": "### Beispiel-Questionnaire mit automatischer Vorbelegung von Observations \nDie Suche nach passenden Observations geschieht innerhlab des Patienten-Kontextes anhand des in `item-code`hinterlegten Codes.\nDie Extension [SDC-ObservationLinkPeriod](https://build.fhir.org/ig/HL7/sdc/StructureDefinition-sdc-questionnaire-observationLinkPeriod.html) legt fest, wie alt Observations maximal sein dürfen, um für die Vorbelegung herangezogen zu werden (hier: max. 1 Jahr) \nDie Extension [SDC-ObservationExtract](https://build.fhir.org/ig/HL7/sdc/StructureDefinition-sdc-questionnaire-observationExtract.html) legt fest, ob aus den Angaben des Questionnaires eine neue Observation extrahiert werden soll (hier: true)",
{
{
{
}
},
{
}
],
],
}
]
}
]
}
Beispiel: Stammdaten Prepopulation
Metadaten
| Name | ExamplePrePopDemo |
|---|---|
| URL | https://gematik.de/fhir/isik/Questionnaire/ExamplePrePopDemo |
| Beschreibung | Beispiel-Questionnaire mit automatischer Vorbelegung von demografischen PatientendatenDer Patientenkontext wird mittels der SDC-LaunchContexts-Extension hergestellt. |
Gerendertes Formular
Globale Extensions
| Name | |||||||||
|---|---|---|---|---|---|---|---|---|---|
| Subextensions |
|
Item-Definitionen
| ID | Text | Type | InitialExpression | ||||||
|---|---|---|---|---|---|---|---|---|---|
| 1 | Demografische Patientendaten | group | |||||||
| 1.1 | Vorname: | string |
| ||||||
| 1.2 | Nachname: | string |
| ||||||
| 1.4 | Versichertennummer: | string |
|
Quellcode
</meta>
</valueCoding>
</extension>
</extension>
</extension>
</extension>
<description value="### Beispiel-Questionnaire mit automatischer Vorbelegung von demografischen Patientendaten \nDer Patientenkontext wird mittels der [SDC-LaunchContexts](https://build.fhir.org/ig/HL7/sdc/StructureDefinition-sdc-questionnaire-launchContext.html)-Extension hergestellt. \nDie Vorbelegung erfolgt über die [SDC-InitialExpression](https://build.fhir.org/ig/HL7/sdc/StructureDefinition-sdc-questionnaire-initialExpression.html)-Extension" />
<extension url="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-initialExpression">
<description value="Selektion des ersten Vornamens des Patienten. Präferiert aus dem offiziellem Namen, alternativ erster gefundener Name" />
<expression value="(%patient.name.where(use = 'official').given[0] | %patient.name[0].given[0]).first()" />
</valueExpression>
</extension>
</item>
<extension url="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-initialExpression">
<description value="Selektion des Nachnamens des Patienten. Präferiert aus dem offiziellem Namen, alternativ erster gefundener Name" />
<expression value="(%patient.name.where(use = 'official').family | %patient.name[0].family).first()" />
</valueExpression>
</extension>
</item>
<extension url="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-initialExpression">
</valueExpression>
</extension>
</item>
</item>
</Questionnaire>
{
},
{
{
}
},
{
},
{
}
],
}
],
"Patient"
],
"description": "### Beispiel-Questionnaire mit automatischer Vorbelegung von demografischen Patientendaten \nDer Patientenkontext wird mittels der [SDC-LaunchContexts](https://build.fhir.org/ig/HL7/sdc/StructureDefinition-sdc-questionnaire-launchContext.html)-Extension hergestellt. \nDie Vorbelegung erfolgt über die [SDC-InitialExpression](https://build.fhir.org/ig/HL7/sdc/StructureDefinition-sdc-questionnaire-initialExpression.html)-Extension",
{
{
{
"description": "Selektion des ersten Vornamens des Patienten. Präferiert aus dem offiziellem Namen, alternativ erster gefundener Name",
"expression": "(%patient.name.where(use = 'official').given[0] | %patient.name[0].given[0]).first()"
}
}
],
},
{
{
"description": "Selektion des Nachnamens des Patienten. Präferiert aus dem offiziellem Namen, alternativ erster gefundener Name",
}
}
],
},
{
{
}
}
],
}
]
}
]
}
Beispiel: Observation-basierte Extraction bei quantitativen Angaben
Metadaten
| Name | ExampleExtractWithUnit |
|---|---|
| URL | https://gematik.de/fhir/isik/Questionnaire/ExampleExtractWithUnit |
| Beschreibung | Beispiel-Questionnaire mit Observation Based Extraction von Dezimalwerten mit Maßeinheiten
|
Gerendertes Formular
Beim Klicken auf "Zeige QR + Observations" werden Sie auf eine externe Seite weitergeleitet, auf der die durch Sie in der Demo eingegebenen Werte als QuestionnaireResonse und extragierte Observations dargestellt werden.
Globale Extensions
| ID | Text | Type | Subextensions | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 4 | Körpermaße | group | |||||||||
| 4.1 | Körpergewicht in kg | decimal |
| ||||||||
| 4.2 | Körpergröße in cm | decimal |
|
Extrahierte Ressourcen
{
},
{
}
]
},
},
},
{
{
},
{
}
]
}
]
}
{
},
{
]
}
],
},
},
},
]
}
{
},
{
]
}
],
},
},
},
]
}
Quellcode
</meta>
<description value="### Beispiel-Questionnaire mit Observation Based Extraction von Dezimalwerten mit Maßeinheiten \n * Vorgabe der anzugebenden Maßeinheit mittels [questionnaire-unit](https://hl7.org/fhir/R4/extension-questionnaire-unit.html)-Extension\n * Annotation zur Extraktion mittels [observationExtract](http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observationExtract)\n * Annotation zum Setzen der category bei Extraktion mittels [observationExtractCategory](http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observationExtract-category)" />
</extension>
<extension url="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observationExtract">
</extension>
<extension url="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observation-extract-category">
</coding>
</valueCodeableConcept>
</extension>
</code>
</item>
</extension>
<extension url="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observationExtract">
</extension>
<extension url="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observation-extract-category">
</coding>
</valueCodeableConcept>
</extension>
</code>
</item>
</item>
</Questionnaire>
{
},
"Patient"
],
"description": "### Beispiel-Questionnaire mit Observation Based Extraction von Dezimalwerten mit Maßeinheiten \n * Vorgabe der anzugebenden Maßeinheit mittels [questionnaire-unit](https://hl7.org/fhir/R4/extension-questionnaire-unit.html)-Extension\n * Annotation zur Extraktion mittels [observationExtract](http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observationExtract)\n * Annotation zum Setzen der category bei Extraktion mittels [observationExtractCategory](http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observationExtract-category)",
{
{
{
}
},
{
},
{
"url": "http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observation-extract-category",
]
}
}
],
],
},
{
{
}
},
{
},
{
"url": "http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observation-extract-category",
]
}
}
],
],
}
]
}
]
}
Beispiel: Vorbelegung demografischer Patientendaten
Metadaten
| Name | ExamplePrePopDemo |
|---|---|
| URL | https://gematik.de/fhir/isik/Questionnaire/ExamplePrePopDemo |
| Beschreibung | Beispiel-Questionnaire mit automatischer Vorbelegung von demografischen PatientendatenDer Patientenkontext wird mittels der SDC-LaunchContexts-Extension hergestellt. |
Gerendertes Formular
Globale Extensions
| Name | |||||||||
|---|---|---|---|---|---|---|---|---|---|
| Subextensions |
|
Item-Definitionen
| ID | Text | Type | Vorbelegung | ||||
|---|---|---|---|---|---|---|---|
| 1 | Demografische Patientendaten | group | |||||
| 1.1 | Vorname: | string |
| ||||
| 1.2 | Nachname: | string |
| ||||
| 1.4 | Versichertennummer: | string |
|
Quellcode
</meta>
</valueCoding>
</extension>
</extension>
</extension>
</extension>
<description value="### Beispiel-Questionnaire mit automatischer Vorbelegung von demografischen Patientendaten \nDer Patientenkontext wird mittels der [SDC-LaunchContexts](https://build.fhir.org/ig/HL7/sdc/StructureDefinition-sdc-questionnaire-launchContext.html)-Extension hergestellt. \nDie Vorbelegung erfolgt über die [SDC-InitialExpression](https://build.fhir.org/ig/HL7/sdc/StructureDefinition-sdc-questionnaire-initialExpression.html)-Extension" />
<extension url="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-initialExpression">
<description value="Selektion des ersten Vornamens des Patienten. Präferiert aus dem offiziellem Namen, alternativ erster gefundener Name" />
<expression value="(%patient.name.where(use = 'official').given[0] | %patient.name[0].given[0]).first()" />
</valueExpression>
</extension>
</item>
<extension url="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-initialExpression">
<description value="Selektion des Nachnamens des Patienten. Präferiert aus dem offiziellem Namen, alternativ erster gefundener Name" />
<expression value="(%patient.name.where(use = 'official').family | %patient.name[0].family).first()" />
</valueExpression>
</extension>
</item>
<extension url="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-initialExpression">
</valueExpression>
</extension>
</item>
</item>
</Questionnaire>
{
},
{
{
}
},
{
},
{
}
],
}
],
"Patient"
],
"description": "### Beispiel-Questionnaire mit automatischer Vorbelegung von demografischen Patientendaten \nDer Patientenkontext wird mittels der [SDC-LaunchContexts](https://build.fhir.org/ig/HL7/sdc/StructureDefinition-sdc-questionnaire-launchContext.html)-Extension hergestellt. \nDie Vorbelegung erfolgt über die [SDC-InitialExpression](https://build.fhir.org/ig/HL7/sdc/StructureDefinition-sdc-questionnaire-initialExpression.html)-Extension",
{
{
{
"description": "Selektion des ersten Vornamens des Patienten. Präferiert aus dem offiziellem Namen, alternativ erster gefundener Name",
"expression": "(%patient.name.where(use = 'official').given[0] | %patient.name[0].given[0]).first()"
}
}
],
},
{
{
"description": "Selektion des Nachnamens des Patienten. Präferiert aus dem offiziellem Namen, alternativ erster gefundener Name",
}
}
],
},
{
{
}
}
],
}
]
}
]
}
Questionnaire
Metadaten
| Name | ExampleEntryValidationDecimal |
|---|---|
| URL | https://gematik.de/fhir/isik/Questionnaire/ExampleEntryValidationDecimal |
| Beschreibung | Beispiel-Questionnaire Validierung von Dezimalwerten
|
Gerendertes Formular
Globale Extensions
Item-Definitionen
| ID | Text | Type | Validierung | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 4 | Körpermaße | group | |||||||||||||
| 4.1 | Körpergewicht in kg (muss zwischen 20 und 300kg liegen) | decimal |
| ||||||||||||
| 4.2 | Körpergröße in m (muss zwischen 1m und 2.50m liegen) | decimal |
|
Quellcode
</meta>
<description value="### Beispiel-Questionnaire Validierung von Dezimalwerten \n* Vorgabe des Eingabeformates mittels [entryFormat](https://hl7.org/fhir/R4/extension-entryformat.html)-Extension\n* Limitierung der Dezimalstellen mittels [maxDecimalPlaces](https://hl7.org/fhir/R4/extension-maxdecimalplaces.html)-Extension\n* Limitierung des Wertebereiches mittels [minValue](https://hl7.org/fhir/R4/extension-minvalue.html) \n und [maxValue](https://hl7.org/fhir/R4/extension-maxvalue.html)-Extension\n* Vorgabe der anzugebenden Maßeinheit mittels [questionnaire-unit](https://hl7.org/fhir/R4/extension-questionnaire-unit.html)-Extension" />
</extension>
</extension>
</extension>
</extension>
</item>
</extension>
</extension>
</extension>
</extension>
</extension>
</item>
</item>
</Questionnaire>
{
},
"Patient"
],
"description": "### Beispiel-Questionnaire Validierung von Dezimalwerten \n* Vorgabe des Eingabeformates mittels [entryFormat](https://hl7.org/fhir/R4/extension-entryformat.html)-Extension\n* Limitierung der Dezimalstellen mittels [maxDecimalPlaces](https://hl7.org/fhir/R4/extension-maxdecimalplaces.html)-Extension\n* Limitierung des Wertebereiches mittels [minValue](https://hl7.org/fhir/R4/extension-minvalue.html) \n und [maxValue](https://hl7.org/fhir/R4/extension-maxvalue.html)-Extension\n* Vorgabe der anzugebenden Maßeinheit mittels [questionnaire-unit](https://hl7.org/fhir/R4/extension-questionnaire-unit.html)-Extension",
{
{
{
}
},
{
},
{
},
{
}
],
},
{
{
}
},
{
},
{
},
{
},
{
}
],
}
]
}
]
}
QuestionnaireResponse
Beispiel: vollständig und valide ausgefülltes Formular
| Titel | Validierung von Dezimalen |
|---|---|
| Datum | 2025-01-01 |
| Patient | Patient/PatientinMinimal |
| Autor | Patient/PatientinMinimal |
| ID | Frage | Antwort |
|---|---|---|
| 4 | Körpermaße | |
| 4.1 | Körpergewicht in kg (muss zwischen 20 und 300kg liegen) | 66 |
| 4.2 | Körpergröße in m (muss zwischen 1m und 2.50m liegen) | 1.66 |
Quellcode
</meta>
</extension>
</questionnaire>
</subject>
</author>
</answer>
</item>
</answer>
</item>
</item>
</QuestionnaireResponse>
{
},
{
}
]
},
},
},
{
{
]
},
{
]
}
]
}
]
}
Beispiel: Validierung von Pattern
Metadaten
| Name | ExampleInputPatternValidation |
|---|---|
| URL | https://gematik.de/fhir/isik/Questionnaire/ExampleInputPatternValidation |
| Beschreibung | Beispiel-Questionnaire mit Validierung von Benutzereingaben mittels einer FHIRPath-ExpressionDie Validierung erfolgt über die targetConstraint-Extension |
Gerendertes Formular
Das Feature wird von LHC-Forms zum aktuellen Zeitpunkt noch nicht unterstützt. Aus dem Grund wird im gerenderten Formular die Validierung noch nicht korrekt ausgeführt.
Globale Extensions
| ID | Text | Type | Subextensions | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1.4 | Versichertennummer: | string |
|
Quellcode
</meta>
<description value="### Beispiel-Questionnaire mit Validierung von Benutzereingaben mittels einer FHIRPath-Expression \nDie Validierung erfolgt über die [targetConstraint](https://hl7.org/fhir/extensions/StructureDefinition-targetConstraint.html)-Extension" />
</extension>
</extension>
</valueExpression>
</extension>
<valueString value="Eine Versichertennummer muss mit einem Großbuchstaben beginnen, gefolgt von 9 Zahlen!" />
</extension>
</extension>
</item>
</Questionnaire>
{
},
"Patient"
],
"description": "### Beispiel-Questionnaire mit Validierung von Benutzereingaben mittels einer FHIRPath-Expression \nDie Validierung erfolgt über die [targetConstraint](https://hl7.org/fhir/extensions/StructureDefinition-targetConstraint.html)-Extension",
{
{
{
},
{
},
{
}
},
{
"valueString": "Eine Versichertennummer muss mit einem Großbuchstaben beginnen, gefolgt von 9 Zahlen!"
}
],
}
],
}
]
}
Beispiel: Modifier Extension MDR-relevant
Metadaten
| Name | ExampleMdrRelevant |
|---|---|
| URL | https://gematik.de/fhir/isik/Questionnaire/ExampleMdrRelevant |
| Beschreibung | Beispiel-Questionnaire, welches eine MDR-Relevanz ausweist
|
Gerendertes Formular
Globale Extensions
| Name | Value |
|---|---|
| rel |
Quellcode
</meta>
<modifierExtension url="https://gematik.de/fhir/isik/StructureDefinition/ISiKMDRRelevanzFormularExtension">
</valueCoding>
</modifierExtension>
<description value="### Beispiel-Questionnaire, welches eine MDR-Relevanz ausweist\n* Angabe der MDR-Relevanz mittels [ISiKMDRRelevanzFormular](https://simplifier.net/isik-stufe-5/isikmdrrelevanzformularextension)-Extension\nDisclaimer: Dies ist ein simples fantasie Beispiel und hat keine medizinische Aussagekraft. Das erwartete Verhalten von Systemen, die mit diesem Questionnaire testen wäre, dass das Formular mit einer Fehlermeldung *nicht* rendert!" />
</item>
</enableWhen>
</item>
</enableWhen>
</item>
</item>
</Questionnaire>
{
},
{
}
}
],
"Patient"
],
"description": "### Beispiel-Questionnaire, welches eine MDR-Relevanz ausweist\n* Angabe der MDR-Relevanz mittels [ISiKMDRRelevanzFormular](https://simplifier.net/isik-stufe-5/isikmdrrelevanzformularextension)-Extension\nDisclaimer: Dies ist ein simples fantasie Beispiel und hat keine medizinische Aussagekraft. Das erwartete Verhalten von Systemen, die mit diesem Questionnaire testen wäre, dass das Formular mit einer Fehlermeldung *nicht* rendert!",
{
{
},
{
]
},
{
]
}
]
}
]
}