{
"description": null,
"_filename": "StructureDefinition-ISiKFormularDefinition.json",
"package_name": "de.gematik.isik",
"date": "2025-10-23",
"derivation": "constraint",
"publisher": "gematik GmbH",
"fhirVersion": "4.0.1",
"name": "ISiKFormularDefinition",
"abstract": false,
"type": "Questionnaire",
"experimental": "false",
"resourceType": "StructureDefinition",
"title": null,
"package_version": "5.1.0",
"status": "active",
"id": "d7ed3015-ba58-4f08-9727-7dd71f1ec033",
"kind": "resource",
"url": "https://gematik.de/fhir/isik/StructureDefinition/ISiKFormularDefinition",
"version": "5.1.0",
"differential": {
"element": [ {
"id": "Questionnaire.id",
"path": "Questionnaire.id",
"short": "serverseitige, interne ID des Datensatzes",
"comment": "**bedingtes Pflichtfeld/bedingtes MS:** Alle von einem Server bereitgestellten Ressourcen MÜSSEN über eine `id` verfügen.\n Von Clients erzeugte Ressourcen, die im Kontext einer CREATE-Interaktion übermittelt werden, MÜSSEN NICHT über eine `id`verfügen. ",
"mustSupport": true
}, {
"id": "Questionnaire.meta.versionId",
"path": "Questionnaire.meta.versionId",
"short": "Eindeutiger Name der serverseitigen Version des Datensatzes",
"comment": "Alle von einem Server bereitgestellten Ressourcen SOLLEN über eine `versionID` verfügen.\n Von Clients erzeugte Ressourcen, die im Kontext einer CREATE-Interaktion übermittelt werden, MÜSSEN NICHT über eine `versionID`verfügen. "
}, {
"id": "Questionnaire.meta.lastUpdated",
"path": "Questionnaire.meta.lastUpdated",
"short": "Zeitpunkt der letzten Änderung",
"comment": "Alle von einem Server bereitgestellten Ressourcen SOLLEN über ein `lastUpdate` verfügen.\n Von Clients erzeugte Ressourcen, die im Kontext einer CREATE-Interaktion übermittelt werden, MÜSSEN NICHT über ein `lastUpdate`verfügen. "
}, {
"path": "Questionnaire.modifierExtension",
"min": 0,
"short": "MPG-Relevanz der Formulardaten",
"type": [ {
"code": "Extension",
"profile": [ "https://gematik.de/fhir/isik/StructureDefinition/ISiKMDRRelevanzFormularExtension" ]
} ],
"mustSupport": true,
"sliceName": "MDR-Relevant",
"max": "1",
"id": "Questionnaire.modifierExtension:MDR-Relevant",
"comment": "**Begründung MS:**\n In dieser Extension wird angegeben, dass die Formulardaten MDR-relevant sind. Für die Erhebung und/oder Darstellung müssen ggf. bestimmte Voraussetzungen erfüllt sein. Ist die Extension nicht vorhanden, liegt keine MDR-relevanmt vor."
}, {
"id": "Questionnaire.url",
"min": 1,
"path": "Questionnaire.url",
"short": "CanoncialURL des Formulars",
"comment": "Weltweit eindeutiger Name des Formulars.\n **Begründung Pflichtfeld:**\n Wird für eindeutige Bezugnahme von FormularDaten auf FormularDefinition benötigt.",
"mustSupport": true
}, {
"id": "Questionnaire.version",
"min": 1,
"path": "Questionnaire.version",
"short": "Version",
"comment": "Versionsnummer des Formulars. Sollte gem. semVer-Regeln inkrementiert werden, je nach Schweregrad der Änderungen.\n **Begründung MS:** \n Wird benötigt, um FormularDefinitionen in unterschiedlichen Versionen zu differenzieren. ",
"mustSupport": true
}, {
"id": "Questionnaire.title",
"min": 1,
"path": "Questionnaire.title",
"short": "Titel/Überschrift",
"comment": "Dem Anwender angezeigter Titel des Formulars. \n **Begründung MS:** \n Wird für die Darstellung und Auffindbarkeit der FormularDefinition benötigt.",
"mustSupport": true
}, {
"id": "Questionnaire.status",
"path": "Questionnaire.status",
"short": "active | retired",
"comment": "Die im ISiK-Kontext bereitgestellten Formulare sollten final ausspezifiziert sein und daher den Status 'active' haben. \n Formulare, die zurückgezogen oder durch neuere Versionen ersetzt wurden, können mit 'retired' gekennzeichnet werden.",
"mustSupport": true
}, {
"id": "Questionnaire.subjectType",
"max": "1",
"min": 1,
"path": "Questionnaire.subjectType",
"short": "Subject, über das in diesem Formular berichtet wird.",
"comment": "**Begründung Pflichtfeld:** \n Zur Vereinfachung des Workflows werden zunächst nur Formulare mit Patientenbezug zugelassen. \n Dabei ist stets davon auszugehen, dass der Patient, für den dieses Formular ausgefüllt wird, \n identisch ist, mit dem Patient, der im Launch-Kontext übergeben wird. \n Diese Anforderung kann in künftigen Ausbaustufen gelockert werden.",
"mustSupport": true,
"patternCode": "Patient"
}, {
"id": "Questionnaire.description",
"min": 1,
"path": "Questionnaire.description",
"short": "Formularbeschreibung",
"comment": "**Begründung Pflichtfeld:** \n Ausführliche Beschreibung des Formulars zur Verbesserung der Auffindbarkeit und Interpretation der Nutzung",
"mustSupport": true
}, {
"id": "Questionnaire.item",
"path": "Questionnaire.item",
"short": "Formularfeld",
"comment": "Formularfeld oder Einstiegspunkt für eine Gruppe von Formularfeldern",
"mustSupport": true
}, {
"id": "Questionnaire.item.linkId",
"path": "Questionnaire.item.linkId",
"short": "innerhalb dieses Formulars eindeutige ID dieses Feldes",
"comment": "**Begründung Pflichtfeld:** \n Erforderlich für die Verlinkung der Antworten in der QuestionnaireRespons mit der Definition des Formularfeldes.",
"mustSupport": true
}, {
"id": "Questionnaire.item.code",
"path": "Questionnaire.item.code",
"short": "Code für dieses Formularfeld",
"comment": "**Begründung MS:** \n Zur eindeutigen Identifikation des Formularfeldes. Ohne Code ist Observation-based-extraction nicht möglich.\n Wenn kein Code zur Verfügung steht, besteht weiterhin die Möglichkeit ein Item ohne Code zu definieren.",
"mustSupport": true
}, {
"id": "Questionnaire.item.prefix",
"path": "Questionnaire.item.prefix",
"short": "Feld für bspw. Nummerierung von Elementen",
"comment": "**Begründung MS:**\n Falls bspw. eine Gruppierung oder Nummerierung nicht über die Verschachtelung von Items erfolgt, kann über das Prefix eine solche erfolgen. Aus dem Grund MUSS es in der Darstellung beim Rendern mit verarbeitet werden.",
"mustSupport": true
}, {
"id": "Questionnaire.item.text",
"path": "Questionnaire.item.text",
"short": "Fragestellung, Anzeigetext oder Gruppenname",
"comment": "**Begründung MS:** \n Je nach 'type' des items: Fragestellung, Anzeigetext oder Gruppenname",
"mustSupport": true
}, {
"id": "Questionnaire.item.type",
"path": "Questionnaire.item.type",
"comment": "Time is handled using \"string\". File is handled using Attachment. (Content can be sent as a contained binary).",
"mustSupport": true
}, {
"id": "Questionnaire.item.enableWhen",
"path": "Questionnaire.item.enableWhen",
"comment": "**Begründung MS:** Bedingungen, die erfüllt sein müssen, damit das Item dargestellt wird. Dieses Feld ist ein modifier-Element, weshalb MS obligatorisch ist, es muss interpretiert werden.",
"mustSupport": true
}, {
"id": "Questionnaire.item.enableWhen.question",
"path": "Questionnaire.item.enableWhen.question",
"comment": "LinkId der Frage, bei der die Bedingung zu erfüllen ist.",
"mustSupport": true
}, {
"id": "Questionnaire.item.enableWhen.operator",
"path": "Questionnaire.item.enableWhen.operator",
"comment": "Operator, mittels dem die Value der .question mit dem in answer[x] angegeben Element vergleichen wird.",
"mustSupport": true
}, {
"id": "Questionnaire.item.enableWhen.answer[x]",
"path": "Questionnaire.item.enableWhen.answer[x]",
"comment": "Rechter Wert des Bedingungsvergleich",
"mustSupport": true
}, {
"id": "Questionnaire.item.required",
"path": "Questionnaire.item.required",
"short": "Pflichtfeld?",
"comment": "**Begründung MS:** \n FormularRenderer sollen sicherstellen können, dass Formulare vom Anwender vollständig ausgefüllt werden.",
"mustSupport": true
}, {
"id": "Questionnaire.item.repeats",
"path": "Questionnaire.item.repeats",
"short": "Mehrfachangaben erlaubt?",
"comment": "**Begründung MS:** FormularRenderer sollen in der Lage sein zwischen Einfach- und Mehrfachangaben unterscheiden zu können.",
"mustSupport": true
}, {
"id": "Questionnaire.item.readOnly",
"path": "Questionnaire.item.readOnly",
"short": "Keine Eingabe erlaubt?",
"comment": "Antwort wird automatisch vorbelegt/berechnet und darf nicht vom Anwender editiert/überschrieben werden.\n **Begründung MS:** Automatisch vorbelegte Items sollen gegen Veränderung durch den Benutzer geschützt werden können (z.B. für Patientenstammdaten).",
"mustSupport": true
}, {
"id": "Questionnaire.item.maxLength",
"path": "Questionnaire.item.maxLength",
"short": "Längenbegrenzung",
"comment": "Maximale Anzahl zulässiger Zeichen für die Beantwortung der Frage.",
"mustSupport": true
}, {
"id": "Questionnaire.item.answerValueSet",
"path": "Questionnaire.item.answerValueSet",
"short": "Festlegung der Antwortmöglichkeiten durch Verweis auf ValueSet",
"comment": "**Begründung MS:** Wo geeignete ValueSets vorhanden sind, die die Antwortmöglichkeiten hinreichend repräsentieren, sollte auf diese verwiesen werden.",
"mustSupport": true
}, {
"id": "Questionnaire.item.answerOption",
"path": "Questionnaire.item.answerOption",
"short": "Festlegung der Antwortmöglichkeiten durch Aufzählung",
"comment": "**Begründung MS:** Wo *keine* geeignete ValueSets vorhanden sind, die die Antwortmöglichkeiten hinreichen repräsentieren, \n können Antworten alternativ in der FormularDefinition explizit aufgezählt werden..",
"mustSupport": true
}, {
"id": "Questionnaire.item.item",
"path": "Questionnaire.item.item",
"short": "Untergeordnetes Item",
"comment": "**Begründung MS:** \n Items können beliebig verschachtelt und zu Gruppen zusammengefasst werden, um komplexere und umfangreichere Formulare zu strukturieren.",
"mustSupport": true
} ]
},
"baseDefinition": "http://hl7.org/fhir/StructureDefinition/Questionnaire"
}