Beispiel: Observation-basierte Prepopulation und Extraction

Metadaten

NameExamplePrePopObservation
URLhttps://gematik.de/fhir/isik/Questionnaire/ExamplePrePopObservation
Beschreibung

Beispiel-Questionnaire mit automatischer Vorbelegung von Observations

Die Suche nach passenden Observations geschieht innerhlab des Patienten-Kontextes anhand des in item-codehinterlegten Codes. Die Extension SDC-ObservationLinkPeriod legt fest, wie alt Observations maximal sein dürfen, um für die Vorbelegung herangezogen zu werden (hier: max. 1 Jahr)
Die Extension SDC-ObservationExtract legt fest, ob aus den Angaben des Questionnaires eine neue Observation extrahiert werden soll (hier: true)

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

sdc-questionnaire-launchContext

Subextensions
URLWert
namepatient
typePatient
descriptionPatientenkontext

Item-Definitionen

IDTextTypeCodeOptionsExtractionLinkPeriod
3Pflegegradgroup
3.1Bitte geben Sie den Pflegegrad an:choicehttp://loinc.org, 80391-6

#pflegegrad-de

True
WertEinheit
1a

Quellcode

<Questionnaire xmlns="http://hl7.org/fhir">
<id value="ExamplePrePopObservation" />
<profile value="https://gematik.de/fhir/isik/StructureDefinition/ISiKFormularDefinition" />
</meta>
<ValueSet>
<id value="pflegegrad-de" />
<profile value="http://hl7.org/fhir/StructureDefinition/shareablevalueset" />
</meta>
<url value="http://fhir.de/ValueSet/pflegegrad-de" />
<version value="1.5.4" />
<name value="PflegegradDE" />
<title value="PflegegradDE ValueSet" />
<status value="active" />
<experimental value="false" />
<date value="2025-06-16" />
<publisher value="HL7 Deutschland e.V. (Technisches Komitee FHIR)" />
<system value="url" />
<value value="http://hl7.de/technische-komitees/fhir/" />
</telecom>
</contact>
<description value="Codes zur genaueren Differenzierung des Pflegegrads." />
<system value="http://fhir.de/CodeSystem/bfarm/ops" />
<property value="parent" />
<op value="=" />
<value value="9-984" />
</filter>
</include>
</compose>
<identifier value="440c50b5-7272-4184-9ddd-95a75d8207f8" />
<timestamp value="2019-07-06" />
<total value="6" />
<system value="http://fhir.de/CodeSystem/bfarm/ops" />
<code value="9-984.6" />
<display value="Pflegebedürftigkeit: Pflegebedürftig nach Pflegegrad 1" />
</contains>
<system value="http://fhir.de/CodeSystem/bfarm/ops" />
<code value="9-984.7" />
<display value="Pflegebedürftigkeit: Pflegebedürftig nach Pflegegrad 2" />
</contains>
<system value="http://fhir.de/CodeSystem/bfarm/ops" />
<code value="9-984.8" />
<display value="Pflegebedürftigkeit: Pflegebedürftig nach Pflegegrad 3" />
</contains>
<system value="http://fhir.de/CodeSystem/bfarm/ops" />
<code value="9-984.9" />
<display value="Pflegebedürftigkeit: Pflegebedürftig nach Pflegegrad 4" />
</contains>
<system value="http://fhir.de/CodeSystem/bfarm/ops" />
<code value="9-984.a" />
<display value="Pflegebedürftigkeit: Pflegebedürftig nach Pflegegrad 5" />
</contains>
<system value="http://fhir.de/CodeSystem/bfarm/ops" />
<code value="9-984.b" />
<display value="Pflegebedürftigkeit: Erfolgter Antrag auf Einstufung in einen Pflegegrad" />
</contains>
</expansion>
</ValueSet>
</contained>
<extension url="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-launchContext">
<extension url="name">
<system value="http://hl7.org/fhir/uv/sdc/CodeSystem/launchContext" />
<code value="patient" />
</valueCoding>
</extension>
<extension url="type">
<valueCode value="Patient" />
</extension>
<extension url="description">
<valueString value="Patientenkontext" />
</extension>
</extension>
<url value="https://gematik.de/fhir/isik/Questionnaire/ExamplePrePopObservation" />
<version value="0.1.0" />
<name value="ExamplePrePopObservation" />
<title value="Vorbelegung von Observations" />
<status value="draft" />
<experimental value="false" />
<subjectType value="Patient" />
<publisher value="Gematik GmbH" />
<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)" />
<linkId value="3" />
<text value="Pflegegrad" />
<type value="group" />
<required value="true" />
<extension url="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observationLinkPeriod">
<value value="1" />
<system value="http://unitsofmeasure.org" />
<code value="a" />
</valueDuration>
</extension>
<extension url="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observationExtract">
<valueBoolean value="true" />
</extension>
<linkId value="3.1" />
<system value="http://loinc.org" />
<code value="80391-6" />
</code>
<text value="Bitte geben Sie den Pflegegrad an:" />
<type value="choice" />
<answerValueSet value="#pflegegrad-de" />
</item>
</item>
</Questionnaire>
{
"resourceType": "Questionnaire",
"id": "ExamplePrePopObservation",
"meta": {
"profile": [
"https://gematik.de/fhir/isik/StructureDefinition/ISiKFormularDefinition"
]
},
{
"resourceType": "ValueSet",
"id": "pflegegrad-de",
"meta": {
"profile": [
"http://hl7.org/fhir/StructureDefinition/shareablevalueset"
]
},
"url": "http://fhir.de/ValueSet/pflegegrad-de",
"version": "1.5.4",
"name": "PflegegradDE",
"title": "PflegegradDE ValueSet",
"status": "active",
"experimental": false,
"date": "2025-06-16",
"publisher": "HL7 Deutschland e.V. (Technisches Komitee FHIR)",
"contact": [
{
"telecom": [
{
"system": "url",
"value": "http://hl7.de/technische-komitees/fhir/"
}
]
}
],
"description": "Codes zur genaueren Differenzierung des Pflegegrads.",
"compose": {
"include": [
{
"system": "http://fhir.de/CodeSystem/bfarm/ops",
"filter": [
{
"property": "parent",
"op": "=",
"value": "9-984"
}
]
}
]
},
"identifier": "440c50b5-7272-4184-9ddd-95a75d8207f8",
"timestamp": "2019-07-06",
"total": 6,
{
"system": "http://fhir.de/CodeSystem/bfarm/ops",
"code": "9-984.6",
"display": "Pflegebedürftigkeit: Pflegebedürftig nach Pflegegrad 1"
},
{
"system": "http://fhir.de/CodeSystem/bfarm/ops",
"code": "9-984.7",
"display": "Pflegebedürftigkeit: Pflegebedürftig nach Pflegegrad 2"
},
{
"system": "http://fhir.de/CodeSystem/bfarm/ops",
"code": "9-984.8",
"display": "Pflegebedürftigkeit: Pflegebedürftig nach Pflegegrad 3"
},
{
"system": "http://fhir.de/CodeSystem/bfarm/ops",
"code": "9-984.9",
"display": "Pflegebedürftigkeit: Pflegebedürftig nach Pflegegrad 4"
},
{
"system": "http://fhir.de/CodeSystem/bfarm/ops",
"code": "9-984.a",
"display": "Pflegebedürftigkeit: Pflegebedürftig nach Pflegegrad 5"
},
{
"system": "http://fhir.de/CodeSystem/bfarm/ops",
"code": "9-984.b",
"display": "Pflegebedürftigkeit: Erfolgter Antrag auf Einstufung in einen Pflegegrad"
}
]
}
}
],
{
{
"url": "name",
"system": "http://hl7.org/fhir/uv/sdc/CodeSystem/launchContext",
"code": "patient"
}
},
{
"url": "type",
"valueCode": "Patient"
},
{
"url": "description",
"valueString": "Patientenkontext"
}
],
"url": "http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-launchContext"
}
],
"url": "https://gematik.de/fhir/isik/Questionnaire/ExamplePrePopObservation",
"version": "0.1.0",
"name": "ExamplePrePopObservation",
"title": "Vorbelegung von Observations",
"status": "draft",
"experimental": false,
"Patient"
],
"publisher": "Gematik GmbH",
"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)",
"item": [
{
"linkId": "3",
"text": "Pflegegrad",
"type": "group",
"required": true,
"item": [
{
{
"url": "http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observationLinkPeriod",
"value": 1,
"system": "http://unitsofmeasure.org",
"code": "a"
}
},
{
"url": "http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-observationExtract",
"valueBoolean": true
}
],
"linkId": "3.1",
"code": [
{
"system": "http://loinc.org",
"code": "80391-6"
}
],
"text": "Bitte geben Sie den Pflegegrad an:",
"type": "choice",
"answerValueSet": "#pflegegrad-de"
}
]
}
]
}