This page is part of the Structured Data Capture FHIR IG (v2.7.0: STU 3 Ballot 2) based on FHIR R4. The current version which supercedes this version is 3.0.0. For a full list of available versions, see the Directory of published versions
The official URL for this profile is:
http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-search
This profile expands adds additional constraints and extensions to the base SDC questionnaire profile that define basic expectations for searching respositories for questionnaires of interest. I.e. It identifies which elements of Questionnaire searchable metadata should be supported as well as identifying others of potential relevance. Further information on how this use-case is implemented as well as guidance on on the elements and extensions included in the profile can be found on the Finding a Questionnaire page.
Description of Profiles, Differentials, Snapshots and how the different presentations work.
This structure is derived from Questionnaire
This structure is derived from Questionnaire
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Questionnaire | 0..* | |||
identifier | S | 0..* | Identifier | |
title | S | 1..1 | string | |
experimental | S | 0..1 | boolean | |
date | S | 1..1 | dateTime | |
publisher | S | 0..1 | string | |
description | S | 0..1 | markdown | |
useContext | S | 0..* | SDCUsageContext | |
jurisdiction | 0..1 | CodeableConcept | ||
purpose | S | 0..1 | markdown | |
copyright | S | 0..1 | markdown | |
approvalDate | 0..1 | date | ||
lastReviewDate | 0..1 | date | ||
effectivePeriod | 0..1 | Period | ||
code | S | 0..1 | Coding | |
item | 0..* | BackboneElement | ||
definition | 0..1 | uri | ||
code | 0..* | Coding | ||
Documentation for this format |
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Questionnaire | I | 0..* | A structured set of questions | |
id | Σ | 0..1 | id | Logical id of this artifact |
meta | Σ | 0..1 | Meta | Metadata about the resource |
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created |
language | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred) Max Binding: AllLanguages | |
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |
contained | 0..* | Resource | Contained, inline Resources | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
url | Σ | 0..1 | uri | Canonical identifier for this questionnaire, represented as a URI (globally unique) |
identifier | SΣ | 0..* | Identifier | Additional identifier for the questionnaire |
version | Σ | 0..1 | string | Business version of the questionnaire |
name | ΣI | 0..1 | string | Name for this questionnaire (computer friendly) |
title | SΣ | 1..1 | string | Name for this questionnaire (human friendly) |
derivedFrom | 0..* | canonical(Questionnaire) | Instantiates protocol or definition | |
status | ?!Σ | 1..1 | code | draft | active | retired | unknown Binding: PublicationStatus (required) |
experimental | SΣ | 0..1 | boolean | For testing purposes, not real usage |
subjectType | Σ | 0..* | code | Resource that can be subject of QuestionnaireResponse Binding: ResourceType (required) |
date | SΣ | 1..1 | dateTime | Date last changed |
publisher | SΣ | 0..1 | string | Name of the publisher (organization or individual) |
contact | Σ | 0..* | ContactDetail | Contact details for the publisher |
description | S | 0..1 | markdown | Natural language description of the questionnaire |
useContext | SΣ | 0..* | SDCUsageContext | The context that the content is intended to support |
jurisdiction | Σ | 0..1 | CodeableConcept | Intended jurisdiction for questionnaire (if applicable) Binding: Jurisdiction ValueSet (extensible) |
purpose | S | 0..1 | markdown | Why this questionnaire is defined |
copyright | S | 0..1 | markdown | Use and/or publishing restrictions |
approvalDate | 0..1 | date | When the questionnaire was approved by publisher | |
lastReviewDate | 0..1 | date | When the questionnaire was last reviewed | |
effectivePeriod | Σ | 0..1 | Period | When the questionnaire is expected to be used |
code | SΣ | 0..1 | Coding | Concept that represents the overall questionnaire Binding: QuestionnaireQuestionCodes (example) |
item | I | 0..* | BackboneElement | Questions and sections within the Questionnaire |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
linkId | 1..1 | string | Unique id for item in questionnaire | |
definition | 0..1 | uri | ElementDefinition - details for the item | |
code | I | 0..* | Coding | Corresponding concept for this item in a terminology Binding: QuestionnaireQuestionCodes (example) |
prefix | 0..1 | string | E.g. "1(a)", "2.5.3" | |
text | 0..1 | string | Primary text for the item | |
type | 1..1 | code | group | display | boolean | decimal | integer | date | dateTime + Binding: QuestionnaireItemType (required) | |
enableWhen | ?!I | 0..* | BackboneElement | Only allow data when que-7: If the operator is 'exists', the value must be a boolean |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
question | 1..1 | string | Question that determines whether item is enabled | |
operator | 1..1 | code | exists | = | != | > | < | >= | <= Binding: QuestionnaireItemOperator (required) | |
answer[x] | I | 1..1 | boolean, decimal, integer, date, dateTime, time, string, Coding, Quantity, Reference(Resource) | Value for question comparison based on operator Binding: QuestionnaireAnswerCodes (example) |
enableBehavior | I | 0..1 | code | all | any Binding: EnableWhenBehavior (required) |
required | I | 0..1 | boolean | Whether the item must be included in data results |
repeats | I | 0..1 | boolean | Whether the item may repeat |
readOnly | I | 0..1 | boolean | Don't allow human editing |
maxLength | I | 0..1 | integer | No more than this many characters |
answerValueSet | I | 0..1 | canonical(ValueSet) | Valueset containing permitted answers |
answerOption | I | 0..* | BackboneElement | Permitted answer |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
value[x] | 1..1 | integer, date, time, string, Coding, Reference(Resource) | Answer value Binding: QuestionnaireAnswerCodes (example) | |
initialSelected | 0..1 | boolean | Whether option is selected by default | |
initial | I | 0..* | BackboneElement | Initial value(s) when item is first rendered |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
value[x] | 1..1 | boolean, decimal, integer, date, dateTime, time, string, uri, Attachment, Coding, Quantity, Reference(Resource) | Actual value for initializing the question Binding: QuestionnaireAnswerCodes (example) | |
item | I | 0..* | Unknown reference to #Questionnaire.item Nested questionnaire items | |
Documentation for this format |
This structure is derived from Questionnaire
Differential View
This structure is derived from Questionnaire
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Questionnaire | 0..* | |||
identifier | S | 0..* | Identifier | |
title | S | 1..1 | string | |
experimental | S | 0..1 | boolean | |
date | S | 1..1 | dateTime | |
publisher | S | 0..1 | string | |
description | S | 0..1 | markdown | |
useContext | S | 0..* | SDCUsageContext | |
jurisdiction | 0..1 | CodeableConcept | ||
purpose | S | 0..1 | markdown | |
copyright | S | 0..1 | markdown | |
approvalDate | 0..1 | date | ||
lastReviewDate | 0..1 | date | ||
effectivePeriod | 0..1 | Period | ||
code | S | 0..1 | Coding | |
item | 0..* | BackboneElement | ||
definition | 0..1 | uri | ||
code | 0..* | Coding | ||
Documentation for this format |
Snapshot View
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Questionnaire | I | 0..* | A structured set of questions | |
id | Σ | 0..1 | id | Logical id of this artifact |
meta | Σ | 0..1 | Meta | Metadata about the resource |
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created |
language | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred) Max Binding: AllLanguages | |
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |
contained | 0..* | Resource | Contained, inline Resources | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored |
url | Σ | 0..1 | uri | Canonical identifier for this questionnaire, represented as a URI (globally unique) |
identifier | SΣ | 0..* | Identifier | Additional identifier for the questionnaire |
version | Σ | 0..1 | string | Business version of the questionnaire |
name | ΣI | 0..1 | string | Name for this questionnaire (computer friendly) |
title | SΣ | 1..1 | string | Name for this questionnaire (human friendly) |
derivedFrom | 0..* | canonical(Questionnaire) | Instantiates protocol or definition | |
status | ?!Σ | 1..1 | code | draft | active | retired | unknown Binding: PublicationStatus (required) |
experimental | SΣ | 0..1 | boolean | For testing purposes, not real usage |
subjectType | Σ | 0..* | code | Resource that can be subject of QuestionnaireResponse Binding: ResourceType (required) |
date | SΣ | 1..1 | dateTime | Date last changed |
publisher | SΣ | 0..1 | string | Name of the publisher (organization or individual) |
contact | Σ | 0..* | ContactDetail | Contact details for the publisher |
description | S | 0..1 | markdown | Natural language description of the questionnaire |
useContext | SΣ | 0..* | SDCUsageContext | The context that the content is intended to support |
jurisdiction | Σ | 0..1 | CodeableConcept | Intended jurisdiction for questionnaire (if applicable) Binding: Jurisdiction ValueSet (extensible) |
purpose | S | 0..1 | markdown | Why this questionnaire is defined |
copyright | S | 0..1 | markdown | Use and/or publishing restrictions |
approvalDate | 0..1 | date | When the questionnaire was approved by publisher | |
lastReviewDate | 0..1 | date | When the questionnaire was last reviewed | |
effectivePeriod | Σ | 0..1 | Period | When the questionnaire is expected to be used |
code | SΣ | 0..1 | Coding | Concept that represents the overall questionnaire Binding: QuestionnaireQuestionCodes (example) |
item | I | 0..* | BackboneElement | Questions and sections within the Questionnaire |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
linkId | 1..1 | string | Unique id for item in questionnaire | |
definition | 0..1 | uri | ElementDefinition - details for the item | |
code | I | 0..* | Coding | Corresponding concept for this item in a terminology Binding: QuestionnaireQuestionCodes (example) |
prefix | 0..1 | string | E.g. "1(a)", "2.5.3" | |
text | 0..1 | string | Primary text for the item | |
type | 1..1 | code | group | display | boolean | decimal | integer | date | dateTime + Binding: QuestionnaireItemType (required) | |
enableWhen | ?!I | 0..* | BackboneElement | Only allow data when que-7: If the operator is 'exists', the value must be a boolean |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
question | 1..1 | string | Question that determines whether item is enabled | |
operator | 1..1 | code | exists | = | != | > | < | >= | <= Binding: QuestionnaireItemOperator (required) | |
answer[x] | I | 1..1 | boolean, decimal, integer, date, dateTime, time, string, Coding, Quantity, Reference(Resource) | Value for question comparison based on operator Binding: QuestionnaireAnswerCodes (example) |
enableBehavior | I | 0..1 | code | all | any Binding: EnableWhenBehavior (required) |
required | I | 0..1 | boolean | Whether the item must be included in data results |
repeats | I | 0..1 | boolean | Whether the item may repeat |
readOnly | I | 0..1 | boolean | Don't allow human editing |
maxLength | I | 0..1 | integer | No more than this many characters |
answerValueSet | I | 0..1 | canonical(ValueSet) | Valueset containing permitted answers |
answerOption | I | 0..* | BackboneElement | Permitted answer |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
value[x] | 1..1 | integer, date, time, string, Coding, Reference(Resource) | Answer value Binding: QuestionnaireAnswerCodes (example) | |
initialSelected | 0..1 | boolean | Whether option is selected by default | |
initial | I | 0..* | BackboneElement | Initial value(s) when item is first rendered |
id | 0..1 | string | Unique id for inter-element referencing | |
extension | 0..* | Extension | Additional content defined by implementations | |
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized |
value[x] | 1..1 | boolean, decimal, integer, date, dateTime, time, string, uri, Attachment, Coding, Quantity, Reference(Resource) | Actual value for initializing the question Binding: QuestionnaireAnswerCodes (example) | |
item | I | 0..* | Unknown reference to #Questionnaire.item Nested questionnaire items | |
Documentation for this format |
Other representations of profile: Schematron
Path | Conformance | ValueSet |
Questionnaire.code | example | QuestionnaireQuestionCodes |
Id | Path | Details | Requirements |
dom-2 | Questionnaire | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() | |
dom-4 | Questionnaire | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty() | |
dom-3 | Questionnaire | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty() | |
dom-6 | Questionnaire | A resource should have narrative for robust management : text.div.exists() | |
dom-5 | Questionnaire | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() | |
que-2 | Questionnaire | The link ids for groups and questions must be unique within the questionnaire : descendants().linkId.isDistinct() | |
que-0 | Questionnaire | Name should be usable as an identifier for the module by machine processing applications such as code generation : name.matches('[A-Z]([A-Za-z0-9_]){0,254}') | |
ele-1 | Questionnaire.item | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
que-9 | Questionnaire.item | Read-only can't be specified for "display" items : type!='display' or readOnly.empty() | |
que-8 | Questionnaire.item | Initial values can't be specified for groups or display items : (type!='group' and type!='display') or initial.empty() | |
que-6 | Questionnaire.item | Required and repeat aren't permitted for display items : type!='display' or (required.empty() and repeats.empty()) | |
que-5 | Questionnaire.item | Only 'choice' and 'open-choice' items can have answerValueSet : (type ='choice' or type = 'open-choice' or type = 'decimal' or type = 'integer' or type = 'date' or type = 'dateTime' or type = 'time' or type = 'string' or type = 'quantity') or (answerValueSet.empty() and answerOption.empty()) | |
que-4 | Questionnaire.item | A question cannot have both answerOption and answerValueSet : answerOption.empty() or answerValueSet.empty() | |
que-3 | Questionnaire.item | Display items cannot have a "code" asserted : type!='display' or code.empty() | |
que-10 | Questionnaire.item | Maximum length can only be declared for simple question types : (type in ('boolean' | 'decimal' | 'integer' | 'string' | 'text' | 'url' | 'open-choice')) or maxLength.empty() | |
que-1 | Questionnaire.item | Group items must have nested items, display items cannot have nested items : (type='group' implies item.empty().not()) and (type.trace('type')='display' implies item.trace('item').empty()) | |
que-13 | Questionnaire.item | Can only have multiple initial values for repeating items : repeats=true or initial.count() <= 1 | |
que-11 | Questionnaire.item | If one or more answerOption is present, initial[x] must be missing : answerOption.empty() or initial.empty() | |
que-12 | Questionnaire.item | If there are more than one enableWhen, enableBehavior must be specified : enableWhen.count() > 2 implies enableBehavior.exists() | |
ele-1 | Questionnaire.item.enableWhen | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
que-7 | Questionnaire.item.enableWhen | If the operator is 'exists', the value must be a boolean : operator = 'exists' implies (answer is Boolean) | |
ele-1 | Questionnaire.item.answerOption | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ele-1 | Questionnaire.item.initial | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) |