FHIR Release 3 (STU) CI-Build

This page is part of the FHIR Specification (v3.0.2: STU 3). The current version which supercedes this version is 5.0.0 . For a full list Continuous Integration Build of available versions, see FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions icon . Page versions: R5 R4B R4 R3 R2

2.38 2.5 Resource Questionnaire - Content

Responsible Owner: FHIR Infrastructure icon Work Group   Normative Maturity Level : 3   Trial Use Security Category : Business Compartments : Not linked to any No defined compartments

A structured set of questions intended to guide the collection of answers from end-users. Questionnaires provide detailed control over order, presentation, phraseology and grouping to allow coherent, consistent data collection.

2.38.1 2.5.1 Scope and Usage

A Questionnaire is an organized collection of questions intended to solicit information from patients, providers or other individuals involved in the healthcare domain. They may be simple flat lists of questions or can be hierarchically organized in groups and sub-groups, each containing questions. The Questionnaire defines the questions to be asked, how they are ordered and grouped, any intervening instructional text and what the constraints are on the allowed answers. The results of a Questionnaire can be communicated using the QuestionnaireResponse resource.

Questionnaires cover the need to communicate data originating from forms used in medical history examinations, research questionnaires and sometimes full clinical specialty records. In many systems this data is collected using user-defined screens and forms. Questionnaires define specifics about data capture - exactly what questions were asked, in what order, what choices for answers were, etc. Each of these questions is part of the Questionnaire, and as such the Questionnaire is a separately identifiable Resource, whereas the individual questions are not. (Questionnaire questions can be linked to shared data elements using the Questionnaire.item.definition element.)

In addition to its use as a means for capturing data, Questionnaires can also be useful as a mechanism of defining a standardized 'presentation' of data that might already exist. For example, a peri-natal form or diabetes management form. In this use, the benefit is to expose a large volume of data in a predictable way that can be defined outside the user-interface design of the relevant system. The form might allow data to be edited or might be read-only. In some cases, the QuestionnaireResponse might not be intended to be persisted.

Examples of Questionnaires include:

  • Past medical history (PMH)
  • Family diseases
  • Social history
  • Research questionnaires/Clinical research forms (CRFs)
  • Quality and evaluation forms
  • Patient intake form (e.g. clipboard)
  • Insurance claim form Forms to support insurance claims

This resource is limited in scope to support the characteristics of simple questionnaires. However, common extensions have been defined to allow more sophisticated behavior. This includes:

  • Questionnaire core extensions which defines the additional descriptive characteristics for questionnaires and their groups and questions
  • Element extensions which can describe additional constraints on allowed answers for questionnaires such as string length and date and numeric ranges

Additional profiles such as implementation guides, in particular the Structured Data Capture Questionnaire profile IG may provide guidance, extensions and operations that support additional capabilities for defining and allow the definition of more sophisticated questionnaires and forms. their corresponding responses.

2.38.2 2.5.2 Boundaries and Relationships

Questionnaires are intrinsically bound to QuestionnaireResponses in that a Questionnaire defines the questions and rules for answering them that are used in completing the QuestionnaireResponse. The main difference between them is that Questionnaires define 'permitted' answers and are subject and time-independent, while QuestionnaireResponses define a specific user's answers to a Questionnaire at a particular time-point and are focused on a specific subject. As well, the QuestionnaireResponse doesn't convey any of the rules or 'potential' answers the way Questionnaire does. It only conveys the answers selected by the user.

Questionnaires differ from Lists because Lists group existing resources, while Questionnaires group arbitrary questions. In theory, a Questionnaire could be expressed as a List or Composition containing DataElement resources. However, the former would disregard the "wholeness" associated with a questionnaire where questions must generally be maintained as a single structure. The latter would focus on rendering of the data elements rather than organizing the capture of information. Questionnaires are distinct from Observations and DiagnosticReports in that both of these resources are intended to capture only certain types of information (lab, imaging, vitals, etc.) and should not be used to capture the full breadth of healthcare information (allergies, medications, care plans, etc.), while Questionnaires are able to capture any information at all. More importantly, Observation and DiagnosticReport focus on capturing the discrete information in a standardized form so that the information can be used consistently regardless of where or how it is captured. Questionnaire focuses on information capture. The same information can be captured using a wide variety of questionnaires with differently phrased questions organized in different manners. As such, the Questionnaire resource provides a means to standardize the information gathering process (how information is captured), but not the actual how data is interoperably compared, analyzed or computed upon (typically managed using Observation, DiagnosticReport as well as other resources).

Questionnaires are similar to ObservationDefinitions in that both are about defining structures for capturing certain information collected. Observation and DiagnosticReport standardize setting constraints on what information allowed answers are. They can also define hierarchical constructs containing multiple layers of 'arbitrary' nested data elements. However, ObservationDefinitions are instantiated by Observations and are intended to be limited to only those data elements typically captured as Observations, while Questionnaires can describe any element at all and are instantiated by QuestionnaireResponses. Questionnaires also have significantly more power to identify rules around what data can be captured and when, as well as allowed answers. While both support nesting, ObservationDefinition nesting is actually captured, focused on panels and is limited to a single level within the resource, while Questionnaire can define nesting of arbitrary depth for any purpose.

Questionnaires are similar to Compositions in that both organize collections of items and can have a hierarchical structure. They're also intended to help guide 'human' presentation of data. However, Compositions organize resources, while Questionnaires organize specific elements. Also, a Questionnaire represents data 'to be gathered' and is subject-independent, while Compositions represent collections of data that are complete and are about a particular subject. It is possible for StructureDefinitions or GraphDefinitions icon to act as 'templates' for FHIR documents that guide what data is collected for a particular purpose (e.g. a referral), but not how this differs from the gathering process that a Questionnaire provides where there are specific questions that must be asked and answered and rules that guide which questions are enabled in which circumstances.

Questionnaire supports data-collection workflow to a limited extent, in that - once triggered - a Questionnaire can guide a user through a data collection process that ensures appropriate information is gathered. collected based on answers to particular questions. However, Questionnaire doesn't provide support for capturing sets of information at different times or highly interactive data capture. Broader workflow is typically managed using PlanDefinition and Task or using other mechanisms such as CDSHooks.

Questionnaires are similar to the notion of "logical models" "logical models" supported by the StructureDefinition resource. Both support the representation of a collection of data points with labels, data types and hierarchy. It will be common to find the two of them mapped together. The primary difference is that Questionnaire is focused on user-facing data collection. It describes specific questions and includes information such as what number/label should be displayed beside each question, conditions in which questions should be displayed (or not), what instructions should be provided to the user, etc. StructureDefinition, on the other hand, merely defines a data structure with no guidance on display or rules around capture mechanism, only what data should exist in the end. As well, logical models are not intended to capture data directly. Rather, they provide a basis for mapping between data capture structures.

Questionnaires are excellent tools for data capture. They allow tight control over what data is gathered and ensure information is gathered consistently across multiple users. However, data gathered using different questionnaires - or even different versions of the same questionnaire - is often not comparable. It is also not very searchable or easily integrated with discrete data sources. Because of this, the general recommendation in FHIR is to use questionnaires for raw data capture but then to convert the resulting QuestionnaireResponse instances into other FHIR resources - Observations, MedicationStatements, FamilyMemberHistories, etc. This allows the data gathered to then be easily combined with other data into FHIR documents and messages and exposed over FHIR REST interfaces.

2.38.3 2.5.3 Background and Context

Groups and questions that make up a Questionnaire can use the definition element to refer to data elements in external code systems, DataElements systems and StructureDefinitions . In this way, it's possible to leverage standard definitions of questions and their associated data types and answer sets across questionnaires. This also allows extraction of the data from a questionnaire response into other data structures (e.g. populating a ReferralRequest ServiceRequest or CarePlan from information in a completed questionnaire response. It can also support other sorts of post-processing of the data contained in a questionnaire response. However, use of the definition element is not required and Questionnaires may be quite loosely defined. The section Questionnaire versus Resources below discusses the issues of collecting data in such loosely defined Questionnaires versus collecting data as well-defined separate Resources.

This resource is referenced by CarePlan

2.5.4 References to this Resource

2.38.4 2.5.5 Resource Content

Structure

Logical URI to reference Additional Natural language description of Why this When When When the 0..* Context the content is intended to support 0..* Intended jurisdiction for questionnaire (if applicable) Jurisdiction ValueSet ( Extensible ) Σ 0..* Contact details for 0..* Concept that represents Resource Question 0..1 0..1 0..1 Reference Valueset I I
Name Flags Card. Type Description & Constraints      Filter: Filters doco
. . Questionnaire I N DomainResource A structured set of questions
+ Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation
+ Rule: The link ids for groups and questions must be unique within the questionnaire

Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
Interfaces Implemented: MetadataResource
. . . url Σ C 0..1 uri Canonical identifier for this questionnaire questionnaire, represented as an absolute URI (globally unique)
+ Warning: URL should not contain | or # - these characters make processing canonical references problematic
. . . identifier Σ 0..* Identifier Business identifier for the questionnaire

. . . version Σ 0..1 string Business version of the questionnaire
.... versionAlgorithmString 0..1 string
. . . . versionAlgorithmCoding Coding
... name Σ C 0..1 string Name for this questionnaire (computer friendly)
. . . title Σ T 0..1 string Name for this questionnaire (human friendly)
. . . derivedFrom Σ 0..* canonical ( Questionnaire ) Based on Questionnaire

. . . status ?! Σ C 1..1 code draft | active | retired | unknown
Binding: PublicationStatus ( Required )
. . . experimental ?! Σ 0..1 boolean For testing purposes, not only - never for real usage
. . . date subjectType Σ 0..* code 0..1 Resource that can be subject of QuestionnaireResponse
Binding: Resource Types ( Required )

. . . date Σ 0..1 dateTime Date this was last changed
. . . publisher Σ T 0..1 string Name of the publisher publisher/steward (organization or individual)
. . description . contact Σ 0..1 0..* markdown ContactDetail Contact details for the questionnaire publisher

. . . purpose description Σ T 0..1 markdown Natural language description of the questionnaire is defined
. . approvalDate . useContext Σ 0..1 0..* date UsageContext The context that the questionnaire was approved by publisher content is intended to support

. . lastReviewDate . jurisdiction Σ 0..1 0..* date CodeableConcept Jurisdiction of the authority that maintains the questionnaire was last reviewed (if applicable)
Binding: Jurisdiction ValueSet icon ( Extensible )

. . effectivePeriod . purpose Σ T 0..1 Period markdown Why this questionnaire is expected to be used defined
. . useContext . copyright Σ T 0..1 UsageContext markdown Notice about intellectual property ownership, can include restrictions on use
. . jurisdiction . copyrightLabel Σ T 0..1 CodeableConcept string Copyright holder and year(s)
. . contact . approvalDate 0..1 ContactDetail date When the questionnaire was approved by publisher
. . copyright . lastReviewDate 0..1 markdown date When the questionnaire was last reviewed by the publisher
Use and/or publishing restrictions
. . . code effectivePeriod Σ 0..1 Coding Period When the overall questionnaire Questionnaire Question Codes ( Example ) is expected to be used
. . subjectType . code Σ 0..* code Coding Concept that can be subject of QuestionnaireResponse represents the overall questionnaire
ResourceType Binding: Questionnaire Question Codes ( Required Example )

. . . item I C 0..* BackboneElement Questions and sections within the Questionnaire
+ Read-only can't Rule: If one or more answerOption is present, initial cannot be present. Use answerOption.initialSelected instead
+ Rule: The types of any specified for "display" items answerOptions must align with the item type
+ Default values can't be Rule: The types of any specified for groups or display initial values must align with the item type
+ Rule: Group items must have nested items when Questionanire is active
+ Required and repeat aren't permitted for display Warning: Groups should have items
+ Only 'choice' Rule: Display items can cannot have options child items
+ Rule: Display items cannot have a "code" asserted
+ Rule: A question cannot have both option answerOption and options answerValueSet
+ Display Rule: Only coding, decimal, integer, date, dateTime, time, string, quantity, reference, or uri items cannot can have a "code" asserted answerOption
+ Rule: Only coding, decimal, integer, date, dateTime, time, string or quantity items can have answerOption
+ Rule: Required and repeat aren't permitted for display items
+ Rule: Initial values can't be specified for groups or display items
+ Rule: Read-only can't be specified for "display" items
+ Rule: Maximum length can only be declared for simple question types
+ Group items Rule: If there are more than one enableWhen, enableBehavior must be specified
+ Rule: Can only have nested items, display multiple initial values for repeating items
+ Warning: Can only have answerConstraint if answerOption or answerValueSet are present. (This is a warning because extensions may serve the same purpose)
+ Rule: If question is non-repeating, cannot have nested items more than one initialSelected answer option

. . . . linkId C 1..1 string Unique id for item in questionnaire
+ Warning: Link ids should be 255 characters or less
+ Rule: LinkId cannot have leading or trailing spaces or intevening whitespace other than single space characters
. . . . definition 0..1 0..* uri ElementDefinition - details for the item

. . . . code Σ I C 0..* Coding Corresponding concept for this item in a terminology
Binding: Questionnaire Question Codes ( Example )

. . . . prefix 0..1 string E.g. "1(a)", "2.5.3" "1(a)", "2.5.3"
. . . . text Σ T 0..1 string Primary text for the item
. . . . type C 1..1 code group | display | boolean | decimal | integer | date | dateTime +
QuestionnaireItemType Binding: Questionnaire Useable Item Type ( Required )
. . . . enableWhen ?! Σ I C 0..* BackboneElement Only allow data when
+ enableWhen Rule: If the operator is 'exists', the value must contain either a 'answer' or be a 'hasAnswer' element boolean
+ Warning: Referenced questions SHOULD exist in the Questionnaire (unless still in draft, working with modular forms, etc.)

. . . . . question C 1..1 string The linkId of question that determines whether item is enabled enabled/disabled
. . . . hasAnswer . operator I C 1..1 boolean code exists | = | != | > | < | >= | <=
Binding: Questionnaire Item Operator ( Required )
Enable when answered or not
. . . . . answer[x] T I C 1..1 Value for question must have comparison based on operator
Binding: Questionnaire Answer Codes ( Example )
. . . . . . answerBoolean boolean
. . . . . . answerDecimal decimal
. . . . . . answerInteger integer
. . . . . . answerDate date
. . . . . . answerDateTime dateTime
. . . . . . answerTime time
. . . . . . answerString string
. . . . . answerUri . answerCoding uri Coding
. . . . . answerAttachment . answerQuantity SimpleQuantity Attachment
. . . . . . answerReference Reference ( Any )
. . . . . answerCoding . answerUri Coding uri
. . . . . . answerQuantity answerAttachment Quantity Attachment
. . . . enableBehavior answerReference C 0..1 code Reference all | any
Binding: Enable When Behavior ( Any Required )
. . . . required disabledDisplay 0..1 I code hidden | protected
Binding: Questionnaire Item Disabled Display ( Required )
. . . . required C 0..1 boolean Whether the item must be included in data results
. . . . repeats I C 0..1 boolean Whether the item may repeat
. . . . readOnly I C 0..1 boolean Don't allow human editing
. . . . maxLength I C 0..1 integer No more than this these many characters
. . . options . answerConstraint C I 0..1 code optionsOnly | optionsOrType | optionsOrString
Binding: Questionnaire answer constraints value set ( Required )
0..1
. . . . answerValueSet C 0..1 canonical ( ValueSet ) ValueSet containing permitted answers
. . . option . answerOption I C 0..* BackboneElement Permitted answer

. . . . . value[x] T C 1..1 Answer value
Binding: Questionnaire Answer Codes ( Example )
. . . . . . valueDecimal decimal
. . . . . . valueInteger integer
. . . . . . valueDate date
. . . . . . valueDateTime dateTime
...... valueTime time
. . . . . . valueString string
. . . . . . valueUri uri
. . . . . . valueCoding Coding
. . . . . initial[x] . valueQuantity SimpleQuantity
. . . . . . valueReference Reference ( Any )
. . . . . initialSelected C 0..1 boolean Default value Whether option is selected by default
.... initial C 0..* BackboneElement Initial value(s) when item is first rendered

. . . . . value[x] T C 1..1 Actual value for initializing the question
Binding: Questionnaire Answer Codes ( Example )
. . . . . . initialBoolean valueBoolean boolean
. . . . . . initialDecimal valueDecimal decimal
. . . . . . initialInteger valueInteger integer
. . . . . initialDate . valueDate date
. . . . . . initialDateTime valueDateTime dateTime
. . . . . . initialTime valueTime time
. . . . . . initialString valueString string
. . . . . . initialUri valueUri uri
. . . . . . initialAttachment valueAttachment Attachment
. . . . . . initialCoding valueCoding Coding
. . . . . . initialQuantity valueQuantity Quantity SimpleQuantity
. . . . . initialReference . valueReference Reference ( Any )
. . . . item 0..* see item Nested questionnaire items


doco Documentation for this format icon

See the Extensions for this resource

UML Diagram ( Legend )

Questionnaire ( DomainResource ) + MetadataResource An absolute URI that is used to identify this questionnaire when it is referenced in a specification, model, design or an instance. instance; also called its canonical identifier. This SHALL be a URL, SHOULD be globally unique, unique and SHOULD be an a literal address at which an authoritative instance of this questionnaire is (or will be) published. The This URL SHOULD include can be the major version target of a canonical reference. It SHALL remain the questionnaire. For more information see [Technical and Business Versions](resource.html#versions) same when the questionnaire is stored on different servers url : uri [0..1] A formal identifier that is used to identify this questionnaire when it is represented in other formats, or referenced in a specification, model, design or an instance identifier : Identifier [0..*] The identifier that is used to identify this version of the questionnaire when it is referenced in a specification, model, design or instance. This is an arbitrary value managed by the questionnaire author and is not expected to be globally unique. For example, it might be a timestamp (e.g. yyyymmdd) if a managed version is not available. There is also no expectation that versions can be placed in a lexicographical sequence version : string [0..1] Indicates the mechanism used to compare versions to determine which is more current versionAlgorithm[x] : DataType [0..1] « string | Coding ; null (Strength=Extensible) VersionAlgorithm + » A natural language name identifying the questionnaire. This name should be usable as an identifier for the module by machine processing applications such as code generation name : string [0..1] « This element has or is affected by some invariants C » A short, descriptive, user-friendly title for the questionnaire title : string [0..1] The status URL of a Questionnaire that this questionnaire. Enables tracking the life-cycle Questionnaire is based on derivedFrom : canonical [0..*] « Questionnaire » The current state of the content this questionnaire (this element modifies the meaning of other elements) status : code [1..1] « The lifecycle status of a Value Set or Concept Map. null (Strength=Required) PublicationStatus ! » « This element has or is affected by some invariants C » A boolean Boolean value to indicate that this questionnaire is authored for testing purposes (or education/evaluation/marketing), education/evaluation/marketing) and is not intended to no version of this resource will ever be used intended for genuine usage (this element modifies the meaning of other elements) experimental : boolean [0..1] The types of subjects that can be the subject of responses created for the questionnaire subjectType : code [0..*] « null (Strength=Required) ResourceType ! » The date (and optionally time) when the questionnaire was published. last significantly changed. The date must change if and when the business version changes and it must change if the status code changes. In addition, it should change when the substantive content of the questionnaire changes date : dateTime [0..1] The name of the individual or organization that published or individual responsible for the release and ongoing maintenance of the questionnaire publisher : string [0..1] Contact details to assist a user in finding and communicating with the publisher contact : ContactDetail [0..*] A free text natural language description of the questionnaire from a consumer's perspective description : markdown [0..1] Explaination The content was developed with a focus and intent of supporting the contexts that are listed. These contexts may be general categories (gender, age, ...) or may be references to specific programs (insurance plans, studies, ...) and may be used to assist with indexing and searching for appropriate questionnaires useContext : UsageContext [0..*] A legal or geographic region in which the authority that maintains the resource is operating. In general, the jurisdiction is also found in the useContext. The useContext may reference additional jurisdictions because the defining jurisdiction does not necessarily limit the jurisdictions of use jurisdiction : CodeableConcept [0..*] « null (Strength=Extensible) JurisdictionValueSet + » Explanation of why this questionnaire is needed and why it has been designed as it has purpose : markdown [0..1] A copyright statement relating to the questionnaire and/or its contents. Copyright statements are notices of intellectual property ownership and can include restrictions on the use and publishing of the questionnaire copyright : markdown [0..1] A short string (<50 characters), suitable for inclusion in a page footer that identifies the copyright holder, effective period, and optionally whether rights are restricted. (e.g. 'All rights reserved', 'Some rights reserved') copyrightLabel : string [0..1] The date on which the resource content was approved by the publisher. Approval happens once when the content is officially approved for usage approvalDate : date [0..1] The date on which the resource content was last reviewed. Review happens periodically after approval, approval but doesn't does not change the original approval date lastReviewDate : date [0..1] The period during which the questionnaire content was or is planned to be in active use effectivePeriod : Period [0..1] The content was developed with a focus and intent of supporting the contexts that are listed. These terms may be used to assist with indexing and searching for appropriate questionnaire instances useContext : UsageContext [0..*] A legal or geographic region in which the questionnaire is intended to be used jurisdiction : CodeableConcept [0..*] Countries and regions within which this artifact is targeted for use (Strength=Extensible) Jurisdiction ValueSet + Contact details to assist a user in finding and communicating with the publisher contact : ContactDetail [0..*] A copyright statement relating to the questionnaire and/or its contents. Copyright statements are generally legal restrictions on the use and publishing of the questionnaire copyright : markdown [0..1] An identifier for this question or group collection of questions in a particular terminology such as LOINC code : Coding [0..*] « Codes for questionnaires, groups and individual questions null (Strength=Example) Questionnaire Question QuestionnaireQuestionCodes ?? » The types of subjects that can be the subject of responses created for the questionnaire subjectType : code [0..*] One of the resource types defined as part of FHIR. (Strength=Required) ResourceType ! Item An identifier that is unique within the Questionnaire allowing linkage to the equivalent item in a QuestionnaireResponse resource linkId : string [1..1] « This element has or is affected by some invariants C » A reference This element is a URI that refers to an [[[ElementDefinition]]] [ElementDefinition](elementdefinition.html) or to an [ObservationDefinition](observationdefinition.html) that provides the details for the item. If a definition is provided, then the following element values can be inferred from the definition: * code (ElementDefinition.code) * type (ElementDefinition.type) * required (ElementDefinition.min) * repeats (ElementDefinition.max) * maxLength (ElementDefinition.maxLength) * options (ElementDefinition.binding) Any information provided about this item, including information that might otherwise be included in these elements on a the instance of the Questionnaire Item overrides resource. A detailed description of the information from construction of the definition URI is shown in [Comments](questionnaire.html#definition), below definition : uri [0..1] [0..*] A terminology code that corresponds to this group or question (e.g. a code from LOINC, which defines many questions and answers) code : Coding [0..*] « Codes for questionnaires, groups and individual questions null (Strength=Example) Questionnaire Question QuestionnaireQuestionCodes ?? » « This element has or is affected by some invariants C » A short label for a particular group, question or set of display text within the questionnaire used for reference by the individual completing the questionnaire prefix : string [0..1] The name of a section, the text of a question or text content for a display item text : string [0..1] The type of questionnaire item this is - whether text for display, a grouping of other items or a particular type of data to be captured (string, integer, coded choice, Coding, etc.) type : code [1..1] « null (Strength=Required) QuestionnaireItemTypeUsable ! » « This element has or is affected by some invariants C » Distinguishes groups from questions and display text Controls how multiple enableWhen values are interpreted - whether all or any must be true enableBehavior : code [0..1] « null (Strength=Required) EnableWhenBehavior ! » « This element has or is affected by some invariants C » Indicates if and indicates data type for questions how items that are disabled (because enableWhen evaluates to 'false') should be displayed disabledDisplay : code [0..1] « null (Strength=Required) QuestionnaireItemType QuestionnaireItemDisabledDisp... ! » An indication, if true, that the item must be present in a "completed" "completed" QuestionnaireResponse. If false, the item may be skipped when answering the questionnaire required : boolean [0..1] « This element has or is affected by some invariants C » An indication, if true, that the a QuestionnaireResponse for this item may occur multiple times in the response, collecting include multiple answers answers for questions associated with a single instance of this item (for question-type items) or multiple sets repetitions of answers for groups the item (for group-type items) repeats : boolean [0..1] « This element has or is affected by some invariants C » An indication, when true, that the value cannot be changed by a human respondent to the Questionnaire readOnly : boolean [0..1] « This element has or is affected by some invariants C » The maximum number of characters that are permitted in the answer to be considered a "valid" "valid" QuestionnaireResponse maxLength : integer [0..1] « This element has or is affected by some invariants C » For items that have a defined set of allowed answers (via answerOption or answerValueSet), indicates whether values *other* than those specified can be selected answerConstraint : code [0..1] « null (Strength=Required) QuestionnaireAnswerConstraint ! » « This element has or is affected by some invariants C » A reference to a value set containing a list of codes values representing permitted answers for a "choice" or "open-choice" question options answerValueSet : Reference canonical [0..1] « ValueSet » « The value that should be defaulted when initially rendering the questionnaire for user input This element has or is affected by some invariants initial[x] : Type [0..1] boolean | decimal | integer | date | dateTime C | » time | string | uri | Attachment | Coding | Quantity | Reference ( Any ); Allowed values to answer questions. (Strength=Example) Questionnaire Answer ?? EnableWhen The linkId for the question whose answer (or lack of answer) governs whether this item is enabled question : string [1..1] « This element has or is affected by some invariants C » An indication that this item should be enabled only if Specifies the criteria by which the specified question is answered (hasAnswer=true) or not answered (hasAnswer=false) enabled hasAnswer operator : boolean code [0..1] [1..1] « null (Strength=Required) QuestionnaireItemOperator ! » « This element has or is affected by some invariants C » An answer A value that the referenced question must match is tested using the specified operator in order for the item to be enabled enabled. If there are multiple answers, a match on any of the answers suffices. If different behavior is desired (all must match, at least 2 must match, etc.), consider using the enableWhenExpression extension answer[x] : Type DataType [0..1] [1..1] « boolean | decimal | integer | date | dateTime | time | string | uri time | Attachment string | Coding | Quantity | ( SimpleQuantity )| Reference ( Any ); )| uri | Allowed values to answer questions. Attachment ; null (Strength=Example) QuestionnaireAnswerCodes ?? » « Questionnaire Answer This element has or is affected by some invariants C ?? » Option AnswerOption A potential answer that's allowed as the answer to this question value[x] : Type DataType [1..1] « decimal | integer | date | dateTime | time | string | uri | Coding ; | Quantity ( SimpleQuantity )| Reference ( Any ); Allowed values to answer questions. null (Strength=Example) Questionnaire Answer QuestionnaireAnswerCodes ?? » « This element has or is affected by some invariants C » Indicates whether the answer value is selected when the list of possible answers is initially shown initialSelected : boolean [0..1] « This element has or is affected by some invariants C » Initial The actual value to for an initial answer value[x] : DataType [1..1] « boolean | decimal | integer | date | dateTime | time | string | uri | Attachment | Coding | Quantity ( SimpleQuantity )| Reference ( Any ); null (Strength=Example) QuestionnaireAnswerCodes ?? » « This element has or is affected by some invariants C » A constraint indicating that this item should only be enabled (displayed/allow answers to be captured) when the specified condition is true (this element modifies the meaning of other elements) enableWhen [0..*] One of the permitted answers for a "choice" or "open-choice" the question option answerOption [0..*] One or more values that should be pre-populated in the answer when initially rendering the questionnaire for user input initial [0..*] Text, questions and other groups to be nested beneath a question or group item [0..*] A particular question, question grouping or display text that is part of the questionnaire item [0..*]

XML Template 

<

<Questionnaire xmlns="http://hl7.org/fhir"> doco

 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <
 <</identifier>
 <
 <
 <
 <
 <
 <
 <
 <
 <
 <
 <
 <</effectivePeriod>
 <</useContext>
 <</jurisdiction>

 <url value="[uri]"/><!-- 0..1 Canonical identifier for this questionnaire, represented as an absolute URI (globally unique) -->
 <identifier><!-- 0..* Identifier Business identifier for questionnaire --></identifier>
 <version value="[string]"/><!-- 0..1 Business version of the questionnaire -->
 <versionAlgorithm[x]><!-- 0..1 string|Coding How to compare versions --></versionAlgorithm[x]>
 <name value="[string]"/><!-- I 0..1 Name for this questionnaire (computer friendly) -->
 <title value="[string]"/><!-- 0..1 Name for this questionnaire (human friendly) -->
 <derivedFrom><!-- 0..* canonical(Questionnaire) Based on Questionnaire --></derivedFrom>
 <status value="[code]"/><!-- I 1..1 draft | active | retired | unknown -->
 <experimental value="[boolean]"/><!-- 0..1 For testing only - never for real usage -->
 <subjectType value="[code]"/><!-- 0..* Resource that can be subject of QuestionnaireResponse -->
 <date value="[dateTime]"/><!-- 0..1 Date last changed -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher/steward (organization or individual) -->

 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>
 <
 <</code>
 <
 <
  <
  <<a href="questionnaire-definitions.html#Questionnaire.item.definition" title="A reference to an [[[ElementDefinition]]] that provides the details for the item. If a definition is provided, then the following element values can be inferred from the definition: 

* code (ElementDefinition.code)
* type (ElementDefinition.type)
* required (ElementDefinition.min)
* repeats (ElementDefinition.max)
* maxLength (ElementDefinition.maxLength)
* options (ElementDefinition.binding)

Any information provided in these elements on a Questionnaire Item overrides the information from the definition." class="dict">
  <</code>
  <
  <
  <
  <
   <
   <
   <|
     </answer[x]>

 <description value="[markdown]"/><!-- 0..1 Natural language description of the questionnaire -->
 <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext>
 <jurisdiction><!-- 0..* CodeableConcept Jurisdiction of the authority that maintains the questionnaire (if applicable) icon --></jurisdiction>
 <purpose value="[markdown]"/><!-- 0..1 Why this questionnaire is defined -->
 <copyright value="[markdown]"/><!-- 0..1 Notice about intellectual property ownership, can include restrictions on use -->
 <copyrightLabel value="[string]"/><!-- 0..1 Copyright holder and year(s) -->
 <approvalDate value="[date]"/><!-- 0..1 When the questionnaire was approved by publisher -->
 <lastReviewDate value="[date]"/><!-- 0..1 When the questionnaire was last reviewed by the publisher -->
 <effectivePeriod><!-- 0..1 Period When the questionnaire is expected to be used --></effectivePeriod>
 <code><!-- 0..* Coding Concept that represents the overall questionnaire --></code>
 <item>  <!-- 0..* Questions and sections within the Questionnaire -->
  <linkId value="[string]"/><!-- I 1..1 Unique id for item in questionnaire -->
  <definition value="[uri]"/><!-- 0..* ElementDefinition - details for the item -->
  <code><!-- I 0..* Coding Corresponding concept for this item in a terminology --></code>
  <prefix value="[string]"/><!-- 0..1 E.g. "1(a)", "2.5.3" -->
  <text value="[string]"/><!-- 0..1 Primary text for the item -->
  <type value="[code]"/><!-- I 1..1 group | display | boolean | decimal | integer | date | dateTime + -->
  <enableWhen>  <!-- I 0..* Only allow data when -->
   <question value="[string]"/><!-- I 1..1 The linkId of question that determines whether item is enabled/disabled -->
   <operator value="[code]"/><!-- I 1..1 exists | = | != | > | < | >= | <= -->
   <answer[x]><!-- I 1..1 boolean|decimal|integer|date|dateTime|time|string|Coding|
     Quantity(SimpleQuantity)|Reference(Any)|uri|Attachment Value for question comparison based on operator --></answer[x]>
  </enableWhen>
  <
  <
  <
  <
  <</options>
  <
   <</value[x]>
  </option>
  <|
    </initial[x]>
  <</item>

  <enableBehavior value="[code]"/><!-- I 0..1 all | any -->
  <disabledDisplay value="[code]"/><!-- 0..1 hidden | protected -->
  <required value="[boolean]"/><!-- I 0..1 Whether the item must be included in data results -->
  <repeats value="[boolean]"/><!-- I 0..1 Whether the item may repeat -->
  <readOnly value="[boolean]"/><!-- I 0..1 Don't allow human editing -->
  <maxLength value="[integer]"/><!-- I 0..1 No more than these many characters -->
  <answerConstraint value="[code]"/><!-- I 0..1 optionsOnly | optionsOrType | optionsOrString -->
  <answerValueSet><!-- I 0..1 canonical(ValueSet) ValueSet containing permitted answers --></answerValueSet>
  <answerOption>  <!-- I 0..* Permitted answer -->
   <value[x]><!-- I 1..1 decimal|integer|date|dateTime|time|string|uri|Coding|
     Quantity(SimpleQuantity)|Reference(Any) Answer value --></value[x]>

   <initialSelected value="[boolean]"/><!-- I 0..1 Whether option is selected by default -->
  </answerOption>
  <initial>  <!-- I 0..* Initial value(s) when item is first rendered -->
   <value[x]><!-- I 1..1 boolean|decimal|integer|date|dateTime|time|string|uri|
     Attachment|Coding|Quantity(SimpleQuantity)|Reference(Any) Actual value for initializing the question --></value[x]>

  </initial>
  <item><!-- 0..* Content as for Questionnaire.item Nested questionnaire items --></item>

 </item>
</Questionnaire>

JSON Template 

{doco
  "resourceType" : "",

  "resourceType" : "Questionnaire",

  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
    "
    "<a href="questionnaire-definitions.html#Questionnaire.item.definition" title="A reference to an [[[ElementDefinition]]] that provides the details for the item. If a definition is provided, then the following element values can be inferred from the definition: 

* code (ElementDefinition.code)
* type (ElementDefinition.type)
* required (ElementDefinition.min)
* repeats (ElementDefinition.max)
* maxLength (ElementDefinition.maxLength)
* options (ElementDefinition.binding)

Any information provided in these elements on a Questionnaire Item overrides the information from the definition." class="dict">definition
    "
    "
    "
    "
    "
      "
      "
      
      ">
      ">
      ">
      ">"
      ">"
      ">"
      ">"
      ">"
      " }
      " }
      " }
      " }

  "url" : "<uri>", // Canonical identifier for this questionnaire, represented as an absolute URI (globally unique)
  "identifier" : [{ Identifier }], // Business identifier for questionnaire
  "version" : "<string>", // Business version of the questionnaire
  // versionAlgorithm[x]: How to compare versions. One of these 2:

  "versionAlgorithmString" : "<string>",
  "versionAlgorithmCoding" : { Coding },
  "name" : "<string>", // I Name for this questionnaire (computer friendly)
  "title" : "<string>", // Name for this questionnaire (human friendly)
  "derivedFrom" : ["<canonical(Questionnaire)>"], // Based on Questionnaire
  "status" : "<code>", // I R!  draft | active | retired | unknown
  "experimental" : <boolean>, // For testing only - never for real usage
  "subjectType" : ["<code>"], // Resource that can be subject of QuestionnaireResponse
  "date" : "<dateTime>", // Date last changed
  "publisher" : "<string>", // Name of the publisher/steward (organization or individual)
  "contact" : [{ ContactDetail }], // Contact details for the publisher
  "description" : "<markdown>", // Natural language description of the questionnaire
  "useContext" : [{ UsageContext }], // The context that the content is intended to support
  "jurisdiction" : [{ CodeableConcept }], // Jurisdiction of the authority that maintains the questionnaire (if applicable) icon
  "purpose" : "<markdown>", // Why this questionnaire is defined
  "copyright" : "<markdown>", // Notice about intellectual property ownership, can include restrictions on use
  "copyrightLabel" : "<string>", // Copyright holder and year(s)
  "approvalDate" : "<date>", // When the questionnaire was approved by publisher
  "lastReviewDate" : "<date>", // When the questionnaire was last reviewed by the publisher
  "effectivePeriod" : { Period }, // When the questionnaire is expected to be used
  "code" : [{ Coding }], // Concept that represents the overall questionnaire
  "item" : [{ // Questions and sections within the Questionnaire
    "linkId" : "<string>", // I R!  Unique id for item in questionnaire
    "definition" : ["<uri>"], // ElementDefinition - details for the item
    "code" : [{ Coding }], // I Corresponding concept for this item in a terminology
    "prefix" : "<string>", // E.g. "1(a)", "2.5.3"
    "text" : "<string>", // Primary text for the item
    "type" : "<code>", // I R!  group | display | boolean | decimal | integer | date | dateTime +
    "enableWhen" : [{ // I Only allow data when
      "question" : "<string>", // I R!  The linkId of question that determines whether item is enabled/disabled
      "operator" : "<code>", // I R!  exists | = | != | > | < | >= | <=
      // answer[x]: Value for question comparison based on operator. One of these 12:

      "answerBoolean" : <boolean>,
      "answerDecimal" : <decimal>,
      "answerInteger" : <integer>,
      "answerDate" : "<date>",
      "answerDateTime" : "<dateTime>",
      "answerTime" : "<time>",
      "answerString" : "<string>",
      "answerCoding" : { Coding },
      "answerQuantity" : { Quantity(SimpleQuantity) },
      "answerReference" : { Reference(Any) },
      "answerUri" : "<uri>",
      "answerAttachment" : { Attachment }

    }],
    "
    "
    "
    "
    "
    "
      
      ">
      ">"
      ">"
      ">"
      " }

    "enableBehavior" : "<code>", // I all | any
    "disabledDisplay" : "<code>", // hidden | protected
    "required" : <boolean>, // I Whether the item must be included in data results
    "repeats" : <boolean>, // I Whether the item may repeat
    "readOnly" : <boolean>, // I Don't allow human editing
    "maxLength" : <integer>, // I No more than these many characters
    "answerConstraint" : "<code>", // I optionsOnly | optionsOrType | optionsOrString
    "answerValueSet" : "<canonical(ValueSet)>", // I ValueSet containing permitted answers
    "answerOption" : [{ // I Permitted answer
      // value[x]: Answer value. One of these 10:

      "valueDecimal" : <decimal>,
      "valueInteger" : <integer>,
      "valueDate" : "<date>",
      "valueDateTime" : "<dateTime>",
      "valueTime" : "<time>",
      "valueString" : "<string>",
      "valueUri" : "<uri>",
      "valueCoding" : { Coding },
      "valueQuantity" : { Quantity(SimpleQuantity) },
      "valueReference" : { Reference(Any) },
      "initialSelected" : <boolean> // I Whether option is selected by default

    }],
    
    ">,
    ">,
    ">,
    ">",
    ">",
    ">",
    ">",
    ">",
    " },
    " },
    " },
    " },
    "

    "initial" : [{ // I Initial value(s) when item is first rendered
      // value[x]: Actual value for initializing the question. One of these 12:

      "valueBoolean" : <boolean>,
      "valueDecimal" : <decimal>,
      "valueInteger" : <integer>,
      "valueDate" : "<date>",
      "valueDateTime" : "<dateTime>",
      "valueTime" : "<time>",
      "valueString" : "<string>",
      "valueUri" : "<uri>",
      "valueAttachment" : { Attachment },
      "valueCoding" : { Coding },
      "valueQuantity" : { Quantity(SimpleQuantity) },
      "valueReference" : { Reference(Any) }
    }],
    "item" : [{ Content as for Questionnaire.item }] // Nested questionnaire items

  }]
}

Turtle Template 

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:Questionnaire;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from 
  # from 
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
    fhir:
    fhir:<a href="questionnaire-definitions.html#Questionnaire.item.definition" title="A reference to an [[[ElementDefinition]]] that provides the details for the item. If a definition is provided, then the following element values can be inferred from the definition: 

* code (ElementDefinition.code)
* type (ElementDefinition.type)
* required (ElementDefinition.min)
* repeats (ElementDefinition.max)
* maxLength (ElementDefinition.maxLength)
* options (ElementDefinition.binding)

Any information provided in these elements on a Questionnaire Item overrides the information from the definition." class="dict">Questionnaire.item.definition
    fhir:
    fhir:
    fhir:
    fhir:
    fhir:
      fhir:
      fhir:
      # . One of these 12
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
        fhir:) ]
    ], ...;
    fhir:
    fhir:
    fhir:
    fhir:
    fhir:
    fhir:
      # . One of these 5
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
    ], ...;
    # . One of these 12
      fhir: ]
      fhir: ]
      fhir: ]
      fhir: ]
      fhir: ]
      fhir: ]
      fhir: ]
      fhir: ]
      fhir: ]
      fhir: ]
      fhir: ]
      fhir:) ]
    fhir:
  ], ...;

  # from Resource: fhir:id, fhir:meta, fhir:implicitRules, and fhir:language
  # from DomainResource: fhir:text, fhir:contained, fhir:extension, and fhir:modifierExtension
  fhir:url [ uri ] ; # 0..1 Canonical identifier for this questionnaire, represented as an absolute URI (globally unique)
  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* Business identifier for questionnaire
  fhir:version [ string ] ; # 0..1 Business version of the questionnaire
  # versionAlgorithm[x] : 0..1 How to compare versions. One of these 2
    fhir:versionAlgorithm [  a fhir:String ; string ]
    fhir:versionAlgorithm [  a fhir:Coding ; Coding ]
  fhir:name [ string ] ; # 0..1 I Name for this questionnaire (computer friendly)
  fhir:title [ string ] ; # 0..1 Name for this questionnaire (human friendly)
  fhir:derivedFrom  ( [ canonical(Questionnaire) ] ... ) ; # 0..* Based on Questionnaire
  fhir:status [ code ] ; # 1..1 I draft | active | retired | unknown
  fhir:experimental [ boolean ] ; # 0..1 For testing only - never for real usage
  fhir:subjectType  ( [ code ] ... ) ; # 0..* Resource that can be subject of QuestionnaireResponse
  fhir:date [ dateTime ] ; # 0..1 Date last changed
  fhir:publisher [ string ] ; # 0..1 Name of the publisher/steward (organization or individual)
  fhir:contact  ( [ ContactDetail ] ... ) ; # 0..* Contact details for the publisher
  fhir:description [ markdown ] ; # 0..1 Natural language description of the questionnaire
  fhir:useContext  ( [ UsageContext ] ... ) ; # 0..* The context that the content is intended to support
  fhir:jurisdiction  ( [ CodeableConcept ] ... ) ; # 0..* Jurisdiction of the authority that maintains the questionnaire (if applicable)
  fhir:purpose [ markdown ] ; # 0..1 Why this questionnaire is defined
  fhir:copyright [ markdown ] ; # 0..1 Notice about intellectual property ownership, can include restrictions on use
  fhir:copyrightLabel [ string ] ; # 0..1 Copyright holder and year(s)
  fhir:approvalDate [ date ] ; # 0..1 When the questionnaire was approved by publisher
  fhir:lastReviewDate [ date ] ; # 0..1 When the questionnaire was last reviewed by the publisher
  fhir:effectivePeriod [ Period ] ; # 0..1 When the questionnaire is expected to be used
  fhir:code  ( [ Coding ] ... ) ; # 0..* Concept that represents the overall questionnaire
  fhir:item ( [ # 0..* Questions and sections within the Questionnaire
    fhir:linkId [ string ] ; # 1..1 I Unique id for item in questionnaire
    fhir:definition  ( [ uri ] ... ) ; # 0..* ElementDefinition - details for the item
    fhir:code  ( [ Coding ] ... ) ; # 0..* I Corresponding concept for this item in a terminology
    fhir:prefix [ string ] ; # 0..1 E.g. "1(a)", "2.5.3"
    fhir:text [ string ] ; # 0..1 Primary text for the item
    fhir:type [ code ] ; # 1..1 I group | display | boolean | decimal | integer | date | dateTime +
    fhir:enableWhen ( [ # 0..* I Only allow data when
      fhir:question [ string ] ; # 1..1 I The linkId of question that determines whether item is enabled/disabled
      fhir:operator [ code ] ; # 1..1 I exists | = | != | > | < | >= | <=
      # answer[x] : 1..1 I Value for question comparison based on operator. One of these 12
        fhir:answer [  a fhir:Boolean ; boolean ]
        fhir:answer [  a fhir:Decimal ; decimal ]
        fhir:answer [  a fhir:Integer ; integer ]
        fhir:answer [  a fhir:Date ; date ]
        fhir:answer [  a fhir:DateTime ; dateTime ]
        fhir:answer [  a fhir:Time ; time ]
        fhir:answer [  a fhir:String ; string ]
        fhir:answer [  a fhir:Coding ; Coding ]
        fhir:answer [  a fhir:SimpleQuantity ; Quantity(SimpleQuantity) ]
        fhir:answer [  a fhir:Reference ; Reference(Any) ]
        fhir:answer [  a fhir:Uri ; uri ]
        fhir:answer [  a fhir:Attachment ; Attachment ]
    ] ... ) ;
    fhir:enableBehavior [ code ] ; # 0..1 I all | any
    fhir:disabledDisplay [ code ] ; # 0..1 hidden | protected
    fhir:required [ boolean ] ; # 0..1 I Whether the item must be included in data results
    fhir:repeats [ boolean ] ; # 0..1 I Whether the item may repeat
    fhir:readOnly [ boolean ] ; # 0..1 I Don't allow human editing
    fhir:maxLength [ integer ] ; # 0..1 I No more than these many characters
    fhir:answerConstraint [ code ] ; # 0..1 I optionsOnly | optionsOrType | optionsOrString
    fhir:answerValueSet [ canonical(ValueSet) ] ; # 0..1 I ValueSet containing permitted answers
    fhir:answerOption ( [ # 0..* I Permitted answer
      # value[x] : 1..1 I Answer value. One of these 10
        fhir:value [  a fhir:Decimal ; decimal ]
        fhir:value [  a fhir:Integer ; integer ]
        fhir:value [  a fhir:Date ; date ]
        fhir:value [  a fhir:DateTime ; dateTime ]
        fhir:value [  a fhir:Time ; time ]
        fhir:value [  a fhir:String ; string ]
        fhir:value [  a fhir:Uri ; uri ]
        fhir:value [  a fhir:Coding ; Coding ]
        fhir:value [  a fhir:SimpleQuantity ; Quantity(SimpleQuantity) ]
        fhir:value [  a fhir:Reference ; Reference(Any) ]
      fhir:initialSelected [ boolean ] ; # 0..1 I Whether option is selected by default
    ] ... ) ;
    fhir:initial ( [ # 0..* I Initial value(s) when item is first rendered
      # value[x] : 1..1 I Actual value for initializing the question. One of these 12
        fhir:value [  a fhir:Boolean ; boolean ]
        fhir:value [  a fhir:Decimal ; decimal ]
        fhir:value [  a fhir:Integer ; integer ]
        fhir:value [  a fhir:Date ; date ]
        fhir:value [  a fhir:DateTime ; dateTime ]
        fhir:value [  a fhir:Time ; time ]
        fhir:value [  a fhir:String ; string ]
        fhir:value [  a fhir:Uri ; uri ]
        fhir:value [  a fhir:Attachment ; Attachment ]
        fhir:value [  a fhir:Coding ; Coding ]
        fhir:value [  a fhir:SimpleQuantity ; Quantity(SimpleQuantity) ]
        fhir:value [  a fhir:Reference ; Reference(Any) ]
    ] ... ) ;
    fhir:item  ( [ See Questionnaire.item ] ... ) ; # 0..* Nested questionnaire items
  ] ... ) ;

]

Changes since DSTU2 from both R4 and R4B

Questionnaire.url Questionnaire.telecom deleted Questionnaire.group.title deleted Questionnaire.group.concept deleted
Questionnaire Added Element
Questionnaire.name Questionnaire.versionAlgorithm[x]
  • Added Element
Questionnaire.title Questionnaire.subjectType
  • Added Element Remove codes CatalogEntry , ChargeItem , ChargeItemDefinition , ClinicalImpression , DeviceUseStatement , DocumentManifest , DomainResource , EffectEvidenceSynthesis , GraphDefinition , ImmunizationEvaluation , ImmunizationRecommendation , Media , MedicinalProduct , MedicinalProductAuthorization , MedicinalProductContraindication , MedicinalProductIndication , MedicinalProductIngredient , MedicinalProductInteraction , MedicinalProductManufactured , MedicinalProductPackaged , MedicinalProductPharmaceutical , MedicinalProductUndesirableEffect , MolecularSequence , RequestGroup , ResearchDefinition , ResearchElementDefinition , Resource , RiskEvidenceSynthesis , SubstanceNucleicAcid , SubstancePolymer , SubstanceProtein , SubstanceReferenceInformation , SubstanceSourceMaterial , SubstanceSpecification , SupplyDelivery , SupplyRequest , TestReport , TestScript , VerificationResult
  • Add codes ActorDefinition , AdministrableProductDefinition , ArtifactAssessment , ClinicalAssessment , ClinicalUseDefinition , ConditionDefinition , DeviceAlert , DeviceAssociation , FormularyItem , GenomicStudy , ImagingSelection , Ingredient , InsuranceProduct , ManufacturedItemDefinition , MedicinalProductDefinition , MolecularDefinition , NutritionIntake , NutritionProduct , PackagedProductDefinition , Permission , RegulatedAuthorization , RequestOrchestration , Requirements , SubscriptionStatus , SubscriptionTopic , SubstanceDefinition
Questionnaire.status Questionnaire.jurisdiction
  • Change value set from http://hl7.org/fhir/ValueSet/questionnaire-status http://hl7.org/fhir/ValueSet/jurisdiction to http://hl7.org/fhir/ValueSet/publication-status Questionnaire.experimental Added Element Questionnaire.description Added Element Questionnaire.purpose Added Element Questionnaire.approvalDate Added Element Questionnaire.lastReviewDate Added Element Questionnaire.effectivePeriod Added Element Questionnaire.useContext Added Element Questionnaire.jurisdiction Added Element Questionnaire.contact Added Element Questionnaire.copyright Added Element Jurisdiction ValueSet icon
Questionnaire.code Questionnaire.copyrightLabel
  • Added Element
Questionnaire.item Questionnaire.item.definition
    Renamed from group to item Min Cardinality changed from 1 to 0
  • Max Cardinality changed from 1 to *
Questionnaire.item.linkId Questionnaire.item.type
  • Min Cardinality changed Change value set from 0 http://hl7.org/fhir/ValueSet/item-type|4.0.0 to 1 Questionnaire.item.definition Added Element Questionnaire.item.code Added Element Questionnaire.item.prefix Added Element Questionnaire.item.type Added Element Questionnaire.item.enableWhen Added Element Questionnaire Useable Item Type
    • Questionnaire.item.enableWhen.question
  • Added Element Remove codes choice , open-choice
    • Questionnaire.item.enableWhen.hasAnswer
  • Added Element Add code coding
Questionnaire.item.enableWhen.answer[x]
  • Added Element Questionnaire.item.readOnly Added Element Questionnaire.item.maxLength Added Element Questionnaire.item.options Added Element Questionnaire.item.option Added Element Questionnaire.item.option.value[x] Added Element Add Types Quantity(http://hl7.org/fhir/StructureDefinition/SimpleQuantity), uri, Attachment
Questionnaire.item.initial[x] Questionnaire.item.disabledDisplay
  • Added Element
Questionnaire.item.item Questionnaire.item.answerConstraint
  • Added Element
Questionnaire.group.group Questionnaire.item.answerOption.value[x]
  • deleted Add Types decimal, dateTime, uri, Quantity(http://hl7.org/fhir/StructureDefinition/SimpleQuantity)
Questionnaire.group.question Questionnaire.item.initial.value[x]
  • deleted Add Type Quantity(http://hl7.org/fhir/StructureDefinition/SimpleQuantity)

See the Full Difference for further information

This analysis is available for R4 as XML or JSON . See R2 <--> R3 Conversion Maps (status = 6 tests that all execute ok. 4 fail round-trip testing and 5 r3 resources are invalid (109 errors). ). for R4B as XML or JSON .

Structure

Logical URI to reference Additional Natural language description of Why this When When When the 0..* Context the content is intended to support 0..* Intended jurisdiction for questionnaire (if applicable) Jurisdiction ValueSet ( Extensible ) Σ 0..* Contact details for 0..* Concept that represents Resource Question 0..1 0..1 0..1 Reference Valueset I I
Name Flags Card. Type Description & Constraints      Filter: Filters doco
. . Questionnaire I N DomainResource A structured set of questions
+ Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation
+ Rule: The link ids for groups and questions must be unique within the questionnaire

Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
Interfaces Implemented: MetadataResource
. . . url Σ C 0..1 uri Canonical identifier for this questionnaire questionnaire, represented as an absolute URI (globally unique)
+ Warning: URL should not contain | or # - these characters make processing canonical references problematic
. . . identifier Σ 0..* Identifier Business identifier for the questionnaire

. . . version Σ 0..1 string Business version of the questionnaire
.... versionAlgorithmString 0..1 string
. . . . versionAlgorithmCoding Coding
... name Σ C 0..1 string Name for this questionnaire (computer friendly)
. . . title Σ T 0..1 string Name for this questionnaire (human friendly)
. . . derivedFrom Σ 0..* canonical ( Questionnaire ) Based on Questionnaire

. . . status ?! Σ C 1..1 code draft | active | retired | unknown
Binding: PublicationStatus ( Required )
. . . experimental ?! Σ 0..1 boolean For testing purposes, not only - never for real usage
. . . date subjectType Σ 0..* code Resource that can be subject of QuestionnaireResponse
Binding: Resource Types ( Required )

0..1
. . . date Σ 0..1 dateTime Date this was last changed
. . . publisher Σ T 0..1 string Name of the publisher publisher/steward (organization or individual)
. . description . contact Σ 0..1 0..* markdown ContactDetail Contact details for the questionnaire publisher

. . . purpose description Σ T 0..1 markdown Natural language description of the questionnaire is defined
. . approvalDate . useContext Σ 0..1 0..* date UsageContext The context that the questionnaire was approved by publisher content is intended to support

. . lastReviewDate . jurisdiction Σ 0..1 0..* date CodeableConcept Jurisdiction of the authority that maintains the questionnaire was last reviewed (if applicable)
Binding: Jurisdiction ValueSet icon ( Extensible )

. . effectivePeriod . purpose Σ T 0..1 Period markdown Why this questionnaire is expected to be used defined
. . useContext . copyright Σ T 0..1 UsageContext markdown Notice about intellectual property ownership, can include restrictions on use
. . jurisdiction . copyrightLabel Σ T 0..1 CodeableConcept string Copyright holder and year(s)
. . contact . approvalDate 0..1 ContactDetail date When the questionnaire was approved by publisher
. . copyright . lastReviewDate 0..1 markdown date When the questionnaire was last reviewed by the publisher
Use and/or publishing restrictions
. . . code effectivePeriod Σ 0..1 Coding Period When the overall questionnaire Questionnaire Question Codes ( Example ) is expected to be used
. . subjectType . code Σ 0..* code Coding Concept that can be subject of QuestionnaireResponse represents the overall questionnaire
ResourceType Binding: Questionnaire Question Codes ( Required Example )

. . . item I C 0..* BackboneElement Questions and sections within the Questionnaire
+ Read-only can't Rule: If one or more answerOption is present, initial cannot be present. Use answerOption.initialSelected instead
+ Rule: The types of any specified for "display" items answerOptions must align with the item type
+ Default values can't be Rule: The types of any specified for groups or display initial values must align with the item type
+ Rule: Group items must have nested items when Questionanire is active
+ Required and repeat aren't permitted for display Warning: Groups should have items
+ Only 'choice' Rule: Display items can cannot have options child items
+ Rule: Display items cannot have a "code" asserted
+ Rule: A question cannot have both option answerOption and options answerValueSet
+ Display Rule: Only coding, decimal, integer, date, dateTime, time, string, quantity, reference, or uri items cannot can have a "code" asserted answerOption
+ Rule: Only coding, decimal, integer, date, dateTime, time, string or quantity items can have answerOption
+ Rule: Required and repeat aren't permitted for display items
+ Rule: Initial values can't be specified for groups or display items
+ Rule: Read-only can't be specified for "display" items
+ Rule: Maximum length can only be declared for simple question types
+ Group items Rule: If there are more than one enableWhen, enableBehavior must be specified
+ Rule: Can only have nested items, display multiple initial values for repeating items
+ Warning: Can only have answerConstraint if answerOption or answerValueSet are present. (This is a warning because extensions may serve the same purpose)
+ Rule: If question is non-repeating, cannot have nested items more than one initialSelected answer option

. . . . linkId C 1..1 string Unique id for item in questionnaire
+ Warning: Link ids should be 255 characters or less
+ Rule: LinkId cannot have leading or trailing spaces or intevening whitespace other than single space characters
. . . . definition 0..1 0..* uri ElementDefinition - details for the item

. . . . code Σ I C 0..* Coding Corresponding concept for this item in a terminology
Binding: Questionnaire Question Codes ( Example )

. . . . prefix 0..1 string E.g. "1(a)", "2.5.3" "1(a)", "2.5.3"
. . . . text Σ T 0..1 string Primary text for the item
. . . . type C 1..1 code group | display | boolean | decimal | integer | date | dateTime +
QuestionnaireItemType Binding: Questionnaire Useable Item Type ( Required )
. . . . enableWhen ?! Σ I C 0..* BackboneElement Only allow data when
+ enableWhen Rule: If the operator is 'exists', the value must contain either a 'answer' or be a 'hasAnswer' element boolean
+ Warning: Referenced questions SHOULD exist in the Questionnaire (unless still in draft, working with modular forms, etc.)

. . . . . question C 1..1 string The linkId of question that determines whether item is enabled enabled/disabled
. . . . hasAnswer . operator I C 1..1 boolean code exists | = | != | > | < | >= | <=
Binding: Questionnaire Item Operator ( Required )
Enable when answered or not
. . . . . answer[x] T I C 1..1 Value for question must have comparison based on operator
Binding: Questionnaire Answer Codes ( Example )
. . . . . . answerBoolean boolean
. . . . . . answerDecimal decimal
. . . . . . answerInteger integer
. . . . . . answerDate date
. . . . . . answerDateTime dateTime
. . . . . . answerTime time
. . . . . . answerString string
. . . . . answerUri . answerCoding uri Coding
. . . . . answerAttachment . answerQuantity SimpleQuantity Attachment
. . . . . . answerReference Reference ( Any )
. . . . . answerCoding . answerUri Coding uri
. . . . . . answerQuantity answerAttachment Quantity Attachment
. . . . enableBehavior answerReference C 0..1 code Reference all | any
Binding: Enable When Behavior ( Any Required )
. . . . required disabledDisplay 0..1 I code hidden | protected
Binding: Questionnaire Item Disabled Display ( Required )
. . . . required C 0..1 boolean Whether the item must be included in data results
. . . . repeats I C 0..1 boolean Whether the item may repeat
. . . . readOnly I C 0..1 boolean Don't allow human editing
. . . . maxLength I C 0..1 integer No more than this these many characters
. . . options . answerConstraint C I 0..1 code optionsOnly | optionsOrType | optionsOrString
Binding: Questionnaire answer constraints value set ( Required )
0..1
. . . . answerValueSet C 0..1 canonical ( ValueSet ) ValueSet containing permitted answers
. . . option . answerOption I C 0..* BackboneElement Permitted answer

. . . . . value[x] T C 1..1 Answer value
Binding: Questionnaire Answer Codes ( Example )
. . . . . . valueDecimal decimal
. . . . . . valueInteger integer
. . . . . . valueDate date
. . . . . . valueDateTime dateTime
...... valueTime time
. . . . . . valueString string
. . . . . . valueUri uri
. . . . . . valueCoding Coding
. . . . . initial[x] . valueQuantity SimpleQuantity
. . . . . . valueReference Reference ( Any )
. . . . . initialSelected C 0..1 boolean Default value Whether option is selected by default
.... initial C 0..* BackboneElement Initial value(s) when item is first rendered

. . . . . value[x] T C 1..1 Actual value for initializing the question
Binding: Questionnaire Answer Codes ( Example )
. . . . . . initialBoolean valueBoolean boolean
. . . . . . initialDecimal valueDecimal decimal
. . . . . . initialInteger valueInteger integer
. . . . . initialDate . valueDate date
. . . . . . initialDateTime valueDateTime dateTime
. . . . . . initialTime valueTime time
. . . . . . initialString valueString string
. . . . . . initialUri valueUri uri
. . . . . . initialAttachment valueAttachment Attachment
. . . . . . initialCoding valueCoding Coding
. . . . . . initialQuantity valueQuantity Quantity SimpleQuantity
. . . . . initialReference . valueReference Reference ( Any )
. . . . item 0..* see item Nested questionnaire items


doco Documentation for this format icon

See the Extensions for this resource

UML Diagram ( Legend )

Questionnaire ( DomainResource ) + MetadataResource An absolute URI that is used to identify this questionnaire when it is referenced in a specification, model, design or an instance. instance; also called its canonical identifier. This SHALL be a URL, SHOULD be globally unique, unique and SHOULD be an a literal address at which an authoritative instance of this questionnaire is (or will be) published. The This URL SHOULD include can be the major version target of a canonical reference. It SHALL remain the questionnaire. For more information see [Technical and Business Versions](resource.html#versions) same when the questionnaire is stored on different servers url : uri [0..1] A formal identifier that is used to identify this questionnaire when it is represented in other formats, or referenced in a specification, model, design or an instance identifier : Identifier [0..*] The identifier that is used to identify this version of the questionnaire when it is referenced in a specification, model, design or instance. This is an arbitrary value managed by the questionnaire author and is not expected to be globally unique. For example, it might be a timestamp (e.g. yyyymmdd) if a managed version is not available. There is also no expectation that versions can be placed in a lexicographical sequence version : string [0..1] Indicates the mechanism used to compare versions to determine which is more current versionAlgorithm[x] : DataType [0..1] « string | Coding ; null (Strength=Extensible) VersionAlgorithm + » A natural language name identifying the questionnaire. This name should be usable as an identifier for the module by machine processing applications such as code generation name : string [0..1] « This element has or is affected by some invariants C » A short, descriptive, user-friendly title for the questionnaire title : string [0..1] The status URL of a Questionnaire that this questionnaire. Enables tracking the life-cycle Questionnaire is based on derivedFrom : canonical [0..*] « Questionnaire » The current state of the content this questionnaire (this element modifies the meaning of other elements) status : code [1..1] « The lifecycle status of a Value Set or Concept Map. null (Strength=Required) PublicationStatus ! » « This element has or is affected by some invariants C » A boolean Boolean value to indicate that this questionnaire is authored for testing purposes (or education/evaluation/marketing), education/evaluation/marketing) and is not intended to no version of this resource will ever be used intended for genuine usage (this element modifies the meaning of other elements) experimental : boolean [0..1] The types of subjects that can be the subject of responses created for the questionnaire subjectType : code [0..*] « null (Strength=Required) ResourceType ! » The date (and optionally time) when the questionnaire was published. last significantly changed. The date must change if and when the business version changes and it must change if the status code changes. In addition, it should change when the substantive content of the questionnaire changes date : dateTime [0..1] The name of the individual or organization that published or individual responsible for the release and ongoing maintenance of the questionnaire publisher : string [0..1] Contact details to assist a user in finding and communicating with the publisher contact : ContactDetail [0..*] A free text natural language description of the questionnaire from a consumer's perspective description : markdown [0..1] Explaination The content was developed with a focus and intent of supporting the contexts that are listed. These contexts may be general categories (gender, age, ...) or may be references to specific programs (insurance plans, studies, ...) and may be used to assist with indexing and searching for appropriate questionnaires useContext : UsageContext [0..*] A legal or geographic region in which the authority that maintains the resource is operating. In general, the jurisdiction is also found in the useContext. The useContext may reference additional jurisdictions because the defining jurisdiction does not necessarily limit the jurisdictions of use jurisdiction : CodeableConcept [0..*] « null (Strength=Extensible) JurisdictionValueSet + » Explanation of why this questionnaire is needed and why it has been designed as it has purpose : markdown [0..1] A copyright statement relating to the questionnaire and/or its contents. Copyright statements are notices of intellectual property ownership and can include restrictions on the use and publishing of the questionnaire copyright : markdown [0..1] A short string (<50 characters), suitable for inclusion in a page footer that identifies the copyright holder, effective period, and optionally whether rights are restricted. (e.g. 'All rights reserved', 'Some rights reserved') copyrightLabel : string [0..1] The date on which the resource content was approved by the publisher. Approval happens once when the content is officially approved for usage approvalDate : date [0..1] The date on which the resource content was last reviewed. Review happens periodically after approval, approval but doesn't does not change the original approval date lastReviewDate : date [0..1] The period during which the questionnaire content was or is planned to be in active use effectivePeriod : Period [0..1] The content was developed with a focus and intent of supporting the contexts that are listed. These terms may be used to assist with indexing and searching for appropriate questionnaire instances useContext : UsageContext [0..*] A legal or geographic region in which the questionnaire is intended to be used jurisdiction : CodeableConcept [0..*] Countries and regions within which this artifact is targeted for use (Strength=Extensible) Jurisdiction ValueSet + Contact details to assist a user in finding and communicating with the publisher contact : ContactDetail [0..*] A copyright statement relating to the questionnaire and/or its contents. Copyright statements are generally legal restrictions on the use and publishing of the questionnaire copyright : markdown [0..1] An identifier for this question or group collection of questions in a particular terminology such as LOINC code : Coding [0..*] « Codes for questionnaires, groups and individual questions null (Strength=Example) Questionnaire Question QuestionnaireQuestionCodes ?? » The types of subjects that can be the subject of responses created for the questionnaire subjectType : code [0..*] One of the resource types defined as part of FHIR. (Strength=Required) ResourceType ! Item An identifier that is unique within the Questionnaire allowing linkage to the equivalent item in a QuestionnaireResponse resource linkId : string [1..1] « This element has or is affected by some invariants C » A reference This element is a URI that refers to an [[[ElementDefinition]]] [ElementDefinition](elementdefinition.html) or to an [ObservationDefinition](observationdefinition.html) that provides the details for the item. If a definition is provided, then the following element values can be inferred from the definition: * code (ElementDefinition.code) * type (ElementDefinition.type) * required (ElementDefinition.min) * repeats (ElementDefinition.max) * maxLength (ElementDefinition.maxLength) * options (ElementDefinition.binding) Any information provided about this item, including information that might otherwise be included in these elements on a the instance of the Questionnaire Item overrides resource. A detailed description of the information from construction of the definition URI is shown in [Comments](questionnaire.html#definition), below definition : uri [0..1] [0..*] A terminology code that corresponds to this group or question (e.g. a code from LOINC, which defines many questions and answers) code : Coding [0..*] « Codes for questionnaires, groups and individual questions null (Strength=Example) Questionnaire Question QuestionnaireQuestionCodes ?? » « This element has or is affected by some invariants C » A short label for a particular group, question or set of display text within the questionnaire used for reference by the individual completing the questionnaire prefix : string [0..1] The name of a section, the text of a question or text content for a display item text : string [0..1] The type of questionnaire item this is - whether text for display, a grouping of other items or a particular type of data to be captured (string, integer, coded choice, Coding, etc.) type : code [1..1] « null (Strength=Required) QuestionnaireItemTypeUsable ! » « This element has or is affected by some invariants C » Distinguishes groups from questions and display text Controls how multiple enableWhen values are interpreted - whether all or any must be true enableBehavior : code [0..1] « null (Strength=Required) EnableWhenBehavior ! » « This element has or is affected by some invariants C » Indicates if and indicates data type for questions how items that are disabled (because enableWhen evaluates to 'false') should be displayed disabledDisplay : code [0..1] « null (Strength=Required) QuestionnaireItemType QuestionnaireItemDisabledDisp... ! » An indication, if true, that the item must be present in a "completed" "completed" QuestionnaireResponse. If false, the item may be skipped when answering the questionnaire required : boolean [0..1] « This element has or is affected by some invariants C » An indication, if true, that the a QuestionnaireResponse for this item may occur multiple times in the response, collecting include multiple answers answers for questions associated with a single instance of this item (for question-type items) or multiple sets repetitions of answers for groups the item (for group-type items) repeats : boolean [0..1] « This element has or is affected by some invariants C » An indication, when true, that the value cannot be changed by a human respondent to the Questionnaire readOnly : boolean [0..1] « This element has or is affected by some invariants C » The maximum number of characters that are permitted in the answer to be considered a "valid" "valid" QuestionnaireResponse maxLength : integer [0..1] « This element has or is affected by some invariants C » For items that have a defined set of allowed answers (via answerOption or answerValueSet), indicates whether values *other* than those specified can be selected answerConstraint : code [0..1] « null (Strength=Required) QuestionnaireAnswerConstraint ! » « This element has or is affected by some invariants C » A reference to a value set containing a list of codes values representing permitted answers for a "choice" or "open-choice" question options answerValueSet : Reference canonical [0..1] « ValueSet » « The value that should be defaulted when initially rendering the questionnaire for user input This element has or is affected by some invariants initial[x] : Type [0..1] boolean | decimal | integer | date | dateTime C | » time | string | uri | Attachment | Coding | Quantity | Reference ( Any ); Allowed values to answer questions. (Strength=Example) Questionnaire Answer ?? EnableWhen The linkId for the question whose answer (or lack of answer) governs whether this item is enabled question : string [1..1] « This element has or is affected by some invariants C » An indication that this item should be enabled only if Specifies the criteria by which the specified question is answered (hasAnswer=true) or not answered (hasAnswer=false) enabled hasAnswer operator : boolean code [0..1] [1..1] « null (Strength=Required) QuestionnaireItemOperator ! » « This element has or is affected by some invariants C » An answer A value that the referenced question must match is tested using the specified operator in order for the item to be enabled enabled. If there are multiple answers, a match on any of the answers suffices. If different behavior is desired (all must match, at least 2 must match, etc.), consider using the enableWhenExpression extension answer[x] : Type DataType [0..1] [1..1] « boolean | decimal | integer | date | dateTime | time | string | uri time | Attachment string | Coding | Quantity | ( SimpleQuantity )| Reference ( Any ); )| uri | Allowed values to answer questions. Attachment ; null (Strength=Example) QuestionnaireAnswerCodes ?? » « Questionnaire Answer This element has or is affected by some invariants C ?? » Option AnswerOption A potential answer that's allowed as the answer to this question value[x] : Type DataType [1..1] « decimal | integer | date | dateTime | time | string | uri | Coding ; | Quantity ( SimpleQuantity )| Reference ( Any ); Allowed values to answer questions. null (Strength=Example) Questionnaire Answer QuestionnaireAnswerCodes ?? » « This element has or is affected by some invariants C » Indicates whether the answer value is selected when the list of possible answers is initially shown initialSelected : boolean [0..1] « This element has or is affected by some invariants C » Initial The actual value to for an initial answer value[x] : DataType [1..1] « boolean | decimal | integer | date | dateTime | time | string | uri | Attachment | Coding | Quantity ( SimpleQuantity )| Reference ( Any ); null (Strength=Example) QuestionnaireAnswerCodes ?? » « This element has or is affected by some invariants C » A constraint indicating that this item should only be enabled (displayed/allow answers to be captured) when the specified condition is true (this element modifies the meaning of other elements) enableWhen [0..*] One of the permitted answers for a "choice" or "open-choice" the question option answerOption [0..*] One or more values that should be pre-populated in the answer when initially rendering the questionnaire for user input initial [0..*] Text, questions and other groups to be nested beneath a question or group item [0..*] A particular question, question grouping or display text that is part of the questionnaire item [0..*]

XML Template 

<

<Questionnaire xmlns="http://hl7.org/fhir"> doco

 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <
 <</identifier>
 <
 <
 <
 <
 <
 <
 <
 <
 <
 <
 <
 <</effectivePeriod>
 <</useContext>
 <</jurisdiction>

 <url value="[uri]"/><!-- 0..1 Canonical identifier for this questionnaire, represented as an absolute URI (globally unique) -->
 <identifier><!-- 0..* Identifier Business identifier for questionnaire --></identifier>
 <version value="[string]"/><!-- 0..1 Business version of the questionnaire -->
 <versionAlgorithm[x]><!-- 0..1 string|Coding How to compare versions --></versionAlgorithm[x]>
 <name value="[string]"/><!-- I 0..1 Name for this questionnaire (computer friendly) -->
 <title value="[string]"/><!-- 0..1 Name for this questionnaire (human friendly) -->
 <derivedFrom><!-- 0..* canonical(Questionnaire) Based on Questionnaire --></derivedFrom>
 <status value="[code]"/><!-- I 1..1 draft | active | retired | unknown -->
 <experimental value="[boolean]"/><!-- 0..1 For testing only - never for real usage -->
 <subjectType value="[code]"/><!-- 0..* Resource that can be subject of QuestionnaireResponse -->
 <date value="[dateTime]"/><!-- 0..1 Date last changed -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher/steward (organization or individual) -->

 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>
 <
 <</code>
 <
 <
  <
  <<a href="questionnaire-definitions.html#Questionnaire.item.definition" title="A reference to an [[[ElementDefinition]]] that provides the details for the item. If a definition is provided, then the following element values can be inferred from the definition: 

* code (ElementDefinition.code)
* type (ElementDefinition.type)
* required (ElementDefinition.min)
* repeats (ElementDefinition.max)
* maxLength (ElementDefinition.maxLength)
* options (ElementDefinition.binding)

Any information provided in these elements on a Questionnaire Item overrides the information from the definition." class="dict">
  <</code>
  <
  <
  <
  <
   <
   <
   <|
     </answer[x]>

 <description value="[markdown]"/><!-- 0..1 Natural language description of the questionnaire -->
 <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext>
 <jurisdiction><!-- 0..* CodeableConcept Jurisdiction of the authority that maintains the questionnaire (if applicable) icon --></jurisdiction>
 <purpose value="[markdown]"/><!-- 0..1 Why this questionnaire is defined -->
 <copyright value="[markdown]"/><!-- 0..1 Notice about intellectual property ownership, can include restrictions on use -->
 <copyrightLabel value="[string]"/><!-- 0..1 Copyright holder and year(s) -->
 <approvalDate value="[date]"/><!-- 0..1 When the questionnaire was approved by publisher -->
 <lastReviewDate value="[date]"/><!-- 0..1 When the questionnaire was last reviewed by the publisher -->
 <effectivePeriod><!-- 0..1 Period When the questionnaire is expected to be used --></effectivePeriod>
 <code><!-- 0..* Coding Concept that represents the overall questionnaire --></code>
 <item>  <!-- 0..* Questions and sections within the Questionnaire -->
  <linkId value="[string]"/><!-- I 1..1 Unique id for item in questionnaire -->
  <definition value="[uri]"/><!-- 0..* ElementDefinition - details for the item -->
  <code><!-- I 0..* Coding Corresponding concept for this item in a terminology --></code>
  <prefix value="[string]"/><!-- 0..1 E.g. "1(a)", "2.5.3" -->
  <text value="[string]"/><!-- 0..1 Primary text for the item -->
  <type value="[code]"/><!-- I 1..1 group | display | boolean | decimal | integer | date | dateTime + -->
  <enableWhen>  <!-- I 0..* Only allow data when -->
   <question value="[string]"/><!-- I 1..1 The linkId of question that determines whether item is enabled/disabled -->
   <operator value="[code]"/><!-- I 1..1 exists | = | != | > | < | >= | <= -->
   <answer[x]><!-- I 1..1 boolean|decimal|integer|date|dateTime|time|string|Coding|
     Quantity(SimpleQuantity)|Reference(Any)|uri|Attachment Value for question comparison based on operator --></answer[x]>
  </enableWhen>
  <
  <
  <
  <
  <</options>
  <
   <</value[x]>
  </option>
  <|
    </initial[x]>
  <</item>

  <enableBehavior value="[code]"/><!-- I 0..1 all | any -->
  <disabledDisplay value="[code]"/><!-- 0..1 hidden | protected -->
  <required value="[boolean]"/><!-- I 0..1 Whether the item must be included in data results -->
  <repeats value="[boolean]"/><!-- I 0..1 Whether the item may repeat -->
  <readOnly value="[boolean]"/><!-- I 0..1 Don't allow human editing -->
  <maxLength value="[integer]"/><!-- I 0..1 No more than these many characters -->
  <answerConstraint value="[code]"/><!-- I 0..1 optionsOnly | optionsOrType | optionsOrString -->
  <answerValueSet><!-- I 0..1 canonical(ValueSet) ValueSet containing permitted answers --></answerValueSet>
  <answerOption>  <!-- I 0..* Permitted answer -->
   <value[x]><!-- I 1..1 decimal|integer|date|dateTime|time|string|uri|Coding|
     Quantity(SimpleQuantity)|Reference(Any) Answer value --></value[x]>

   <initialSelected value="[boolean]"/><!-- I 0..1 Whether option is selected by default -->
  </answerOption>
  <initial>  <!-- I 0..* Initial value(s) when item is first rendered -->
   <value[x]><!-- I 1..1 boolean|decimal|integer|date|dateTime|time|string|uri|
     Attachment|Coding|Quantity(SimpleQuantity)|Reference(Any) Actual value for initializing the question --></value[x]>

  </initial>
  <item><!-- 0..* Content as for Questionnaire.item Nested questionnaire items --></item>

 </item>
</Questionnaire>

JSON Template 

{doco
  "resourceType" : "",

  "resourceType" : "Questionnaire",

  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
    "
    "<a href="questionnaire-definitions.html#Questionnaire.item.definition" title="A reference to an [[[ElementDefinition]]] that provides the details for the item. If a definition is provided, then the following element values can be inferred from the definition: 

* code (ElementDefinition.code)
* type (ElementDefinition.type)
* required (ElementDefinition.min)
* repeats (ElementDefinition.max)
* maxLength (ElementDefinition.maxLength)
* options (ElementDefinition.binding)

Any information provided in these elements on a Questionnaire Item overrides the information from the definition." class="dict">definition
    "
    "
    "
    "
    "
      "
      "
      
      ">
      ">
      ">
      ">"
      ">"
      ">"
      ">"
      ">"
      " }
      " }
      " }
      " }

  "url" : "<uri>", // Canonical identifier for this questionnaire, represented as an absolute URI (globally unique)
  "identifier" : [{ Identifier }], // Business identifier for questionnaire
  "version" : "<string>", // Business version of the questionnaire
  // versionAlgorithm[x]: How to compare versions. One of these 2:

  "versionAlgorithmString" : "<string>",
  "versionAlgorithmCoding" : { Coding },
  "name" : "<string>", // I Name for this questionnaire (computer friendly)
  "title" : "<string>", // Name for this questionnaire (human friendly)
  "derivedFrom" : ["<canonical(Questionnaire)>"], // Based on Questionnaire
  "status" : "<code>", // I R!  draft | active | retired | unknown
  "experimental" : <boolean>, // For testing only - never for real usage
  "subjectType" : ["<code>"], // Resource that can be subject of QuestionnaireResponse
  "date" : "<dateTime>", // Date last changed
  "publisher" : "<string>", // Name of the publisher/steward (organization or individual)
  "contact" : [{ ContactDetail }], // Contact details for the publisher
  "description" : "<markdown>", // Natural language description of the questionnaire
  "useContext" : [{ UsageContext }], // The context that the content is intended to support
  "jurisdiction" : [{ CodeableConcept }], // Jurisdiction of the authority that maintains the questionnaire (if applicable) icon
  "purpose" : "<markdown>", // Why this questionnaire is defined
  "copyright" : "<markdown>", // Notice about intellectual property ownership, can include restrictions on use
  "copyrightLabel" : "<string>", // Copyright holder and year(s)
  "approvalDate" : "<date>", // When the questionnaire was approved by publisher
  "lastReviewDate" : "<date>", // When the questionnaire was last reviewed by the publisher
  "effectivePeriod" : { Period }, // When the questionnaire is expected to be used
  "code" : [{ Coding }], // Concept that represents the overall questionnaire
  "item" : [{ // Questions and sections within the Questionnaire
    "linkId" : "<string>", // I R!  Unique id for item in questionnaire
    "definition" : ["<uri>"], // ElementDefinition - details for the item
    "code" : [{ Coding }], // I Corresponding concept for this item in a terminology
    "prefix" : "<string>", // E.g. "1(a)", "2.5.3"
    "text" : "<string>", // Primary text for the item
    "type" : "<code>", // I R!  group | display | boolean | decimal | integer | date | dateTime +
    "enableWhen" : [{ // I Only allow data when
      "question" : "<string>", // I R!  The linkId of question that determines whether item is enabled/disabled
      "operator" : "<code>", // I R!  exists | = | != | > | < | >= | <=
      // answer[x]: Value for question comparison based on operator. One of these 12:

      "answerBoolean" : <boolean>,
      "answerDecimal" : <decimal>,
      "answerInteger" : <integer>,
      "answerDate" : "<date>",
      "answerDateTime" : "<dateTime>",
      "answerTime" : "<time>",
      "answerString" : "<string>",
      "answerCoding" : { Coding },
      "answerQuantity" : { Quantity(SimpleQuantity) },
      "answerReference" : { Reference(Any) },
      "answerUri" : "<uri>",
      "answerAttachment" : { Attachment }

    }],
    "
    "
    "
    "
    "
    "
      
      ">
      ">"
      ">"
      ">"
      " }

    "enableBehavior" : "<code>", // I all | any
    "disabledDisplay" : "<code>", // hidden | protected
    "required" : <boolean>, // I Whether the item must be included in data results
    "repeats" : <boolean>, // I Whether the item may repeat
    "readOnly" : <boolean>, // I Don't allow human editing
    "maxLength" : <integer>, // I No more than these many characters
    "answerConstraint" : "<code>", // I optionsOnly | optionsOrType | optionsOrString
    "answerValueSet" : "<canonical(ValueSet)>", // I ValueSet containing permitted answers
    "answerOption" : [{ // I Permitted answer
      // value[x]: Answer value. One of these 10:

      "valueDecimal" : <decimal>,
      "valueInteger" : <integer>,
      "valueDate" : "<date>",
      "valueDateTime" : "<dateTime>",
      "valueTime" : "<time>",
      "valueString" : "<string>",
      "valueUri" : "<uri>",
      "valueCoding" : { Coding },
      "valueQuantity" : { Quantity(SimpleQuantity) },
      "valueReference" : { Reference(Any) },
      "initialSelected" : <boolean> // I Whether option is selected by default

    }],
    
    ">,
    ">,
    ">,
    ">",
    ">",
    ">",
    ">",
    ">",
    " },
    " },
    " },
    " },
    "

    "initial" : [{ // I Initial value(s) when item is first rendered
      // value[x]: Actual value for initializing the question. One of these 12:

      "valueBoolean" : <boolean>,
      "valueDecimal" : <decimal>,
      "valueInteger" : <integer>,
      "valueDate" : "<date>",
      "valueDateTime" : "<dateTime>",
      "valueTime" : "<time>",
      "valueString" : "<string>",
      "valueUri" : "<uri>",
      "valueAttachment" : { Attachment },
      "valueCoding" : { Coding },
      "valueQuantity" : { Quantity(SimpleQuantity) },
      "valueReference" : { Reference(Any) }
    }],
    "item" : [{ Content as for Questionnaire.item }] // Nested questionnaire items

  }]
}

Turtle Template 

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:Questionnaire;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from 
  # from 
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
    fhir:
    fhir:<a href="questionnaire-definitions.html#Questionnaire.item.definition" title="A reference to an [[[ElementDefinition]]] that provides the details for the item. If a definition is provided, then the following element values can be inferred from the definition: 

* code (ElementDefinition.code)
* type (ElementDefinition.type)
* required (ElementDefinition.min)
* repeats (ElementDefinition.max)
* maxLength (ElementDefinition.maxLength)
* options (ElementDefinition.binding)

Any information provided in these elements on a Questionnaire Item overrides the information from the definition." class="dict">Questionnaire.item.definition
    fhir:
    fhir:
    fhir:
    fhir:
    fhir:
      fhir:
      fhir:
      # . One of these 12
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
        fhir:) ]
    ], ...;
    fhir:
    fhir:
    fhir:
    fhir:
    fhir:
    fhir:
      # . One of these 5
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
        fhir: ]
    ], ...;
    # . One of these 12
      fhir: ]
      fhir: ]
      fhir: ]
      fhir: ]
      fhir: ]
      fhir: ]
      fhir: ]
      fhir: ]
      fhir: ]
      fhir: ]
      fhir: ]
      fhir:) ]
    fhir:
  ], ...;

  # from Resource: fhir:id, fhir:meta, fhir:implicitRules, and fhir:language
  # from DomainResource: fhir:text, fhir:contained, fhir:extension, and fhir:modifierExtension
  fhir:url [ uri ] ; # 0..1 Canonical identifier for this questionnaire, represented as an absolute URI (globally unique)
  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* Business identifier for questionnaire
  fhir:version [ string ] ; # 0..1 Business version of the questionnaire
  # versionAlgorithm[x] : 0..1 How to compare versions. One of these 2
    fhir:versionAlgorithm [  a fhir:String ; string ]
    fhir:versionAlgorithm [  a fhir:Coding ; Coding ]
  fhir:name [ string ] ; # 0..1 I Name for this questionnaire (computer friendly)
  fhir:title [ string ] ; # 0..1 Name for this questionnaire (human friendly)
  fhir:derivedFrom  ( [ canonical(Questionnaire) ] ... ) ; # 0..* Based on Questionnaire
  fhir:status [ code ] ; # 1..1 I draft | active | retired | unknown
  fhir:experimental [ boolean ] ; # 0..1 For testing only - never for real usage
  fhir:subjectType  ( [ code ] ... ) ; # 0..* Resource that can be subject of QuestionnaireResponse
  fhir:date [ dateTime ] ; # 0..1 Date last changed
  fhir:publisher [ string ] ; # 0..1 Name of the publisher/steward (organization or individual)
  fhir:contact  ( [ ContactDetail ] ... ) ; # 0..* Contact details for the publisher
  fhir:description [ markdown ] ; # 0..1 Natural language description of the questionnaire
  fhir:useContext  ( [ UsageContext ] ... ) ; # 0..* The context that the content is intended to support
  fhir:jurisdiction  ( [ CodeableConcept ] ... ) ; # 0..* Jurisdiction of the authority that maintains the questionnaire (if applicable)
  fhir:purpose [ markdown ] ; # 0..1 Why this questionnaire is defined
  fhir:copyright [ markdown ] ; # 0..1 Notice about intellectual property ownership, can include restrictions on use
  fhir:copyrightLabel [ string ] ; # 0..1 Copyright holder and year(s)
  fhir:approvalDate [ date ] ; # 0..1 When the questionnaire was approved by publisher
  fhir:lastReviewDate [ date ] ; # 0..1 When the questionnaire was last reviewed by the publisher
  fhir:effectivePeriod [ Period ] ; # 0..1 When the questionnaire is expected to be used
  fhir:code  ( [ Coding ] ... ) ; # 0..* Concept that represents the overall questionnaire
  fhir:item ( [ # 0..* Questions and sections within the Questionnaire
    fhir:linkId [ string ] ; # 1..1 I Unique id for item in questionnaire
    fhir:definition  ( [ uri ] ... ) ; # 0..* ElementDefinition - details for the item
    fhir:code  ( [ Coding ] ... ) ; # 0..* I Corresponding concept for this item in a terminology
    fhir:prefix [ string ] ; # 0..1 E.g. "1(a)", "2.5.3"
    fhir:text [ string ] ; # 0..1 Primary text for the item
    fhir:type [ code ] ; # 1..1 I group | display | boolean | decimal | integer | date | dateTime +
    fhir:enableWhen ( [ # 0..* I Only allow data when
      fhir:question [ string ] ; # 1..1 I The linkId of question that determines whether item is enabled/disabled
      fhir:operator [ code ] ; # 1..1 I exists | = | != | > | < | >= | <=
      # answer[x] : 1..1 I Value for question comparison based on operator. One of these 12
        fhir:answer [  a fhir:Boolean ; boolean ]
        fhir:answer [  a fhir:Decimal ; decimal ]
        fhir:answer [  a fhir:Integer ; integer ]
        fhir:answer [  a fhir:Date ; date ]
        fhir:answer [  a fhir:DateTime ; dateTime ]
        fhir:answer [  a fhir:Time ; time ]
        fhir:answer [  a fhir:String ; string ]
        fhir:answer [  a fhir:Coding ; Coding ]
        fhir:answer [  a fhir:SimpleQuantity ; Quantity(SimpleQuantity) ]
        fhir:answer [  a fhir:Reference ; Reference(Any) ]
        fhir:answer [  a fhir:Uri ; uri ]
        fhir:answer [  a fhir:Attachment ; Attachment ]
    ] ... ) ;
    fhir:enableBehavior [ code ] ; # 0..1 I all | any
    fhir:disabledDisplay [ code ] ; # 0..1 hidden | protected
    fhir:required [ boolean ] ; # 0..1 I Whether the item must be included in data results
    fhir:repeats [ boolean ] ; # 0..1 I Whether the item may repeat
    fhir:readOnly [ boolean ] ; # 0..1 I Don't allow human editing
    fhir:maxLength [ integer ] ; # 0..1 I No more than these many characters
    fhir:answerConstraint [ code ] ; # 0..1 I optionsOnly | optionsOrType | optionsOrString
    fhir:answerValueSet [ canonical(ValueSet) ] ; # 0..1 I ValueSet containing permitted answers
    fhir:answerOption ( [ # 0..* I Permitted answer
      # value[x] : 1..1 I Answer value. One of these 10
        fhir:value [  a fhir:Decimal ; decimal ]
        fhir:value [  a fhir:Integer ; integer ]
        fhir:value [  a fhir:Date ; date ]
        fhir:value [  a fhir:DateTime ; dateTime ]
        fhir:value [  a fhir:Time ; time ]
        fhir:value [  a fhir:String ; string ]
        fhir:value [  a fhir:Uri ; uri ]
        fhir:value [  a fhir:Coding ; Coding ]
        fhir:value [  a fhir:SimpleQuantity ; Quantity(SimpleQuantity) ]
        fhir:value [  a fhir:Reference ; Reference(Any) ]
      fhir:initialSelected [ boolean ] ; # 0..1 I Whether option is selected by default
    ] ... ) ;
    fhir:initial ( [ # 0..* I Initial value(s) when item is first rendered
      # value[x] : 1..1 I Actual value for initializing the question. One of these 12
        fhir:value [  a fhir:Boolean ; boolean ]
        fhir:value [  a fhir:Decimal ; decimal ]
        fhir:value [  a fhir:Integer ; integer ]
        fhir:value [  a fhir:Date ; date ]
        fhir:value [  a fhir:DateTime ; dateTime ]
        fhir:value [  a fhir:Time ; time ]
        fhir:value [  a fhir:String ; string ]
        fhir:value [  a fhir:Uri ; uri ]
        fhir:value [  a fhir:Attachment ; Attachment ]
        fhir:value [  a fhir:Coding ; Coding ]
        fhir:value [  a fhir:SimpleQuantity ; Quantity(SimpleQuantity) ]
        fhir:value [  a fhir:Reference ; Reference(Any) ]
    ] ... ) ;
    fhir:item  ( [ See Questionnaire.item ] ... ) ; # 0..* Nested questionnaire items
  ] ... ) ;

]

Changes since DSTU2 from both R4 and R4B

Questionnaire.url Questionnaire.telecom deleted Questionnaire.group.title deleted Questionnaire.group.concept deleted
Questionnaire Added Element
Questionnaire.name Questionnaire.versionAlgorithm[x]
  • Added Element
Questionnaire.title Questionnaire.subjectType
  • Added Element Remove codes CatalogEntry , ChargeItem , ChargeItemDefinition , ClinicalImpression , DeviceUseStatement , DocumentManifest , DomainResource , EffectEvidenceSynthesis , GraphDefinition , ImmunizationEvaluation , ImmunizationRecommendation , Media , MedicinalProduct , MedicinalProductAuthorization , MedicinalProductContraindication , MedicinalProductIndication , MedicinalProductIngredient , MedicinalProductInteraction , MedicinalProductManufactured , MedicinalProductPackaged , MedicinalProductPharmaceutical , MedicinalProductUndesirableEffect , MolecularSequence , RequestGroup , ResearchDefinition , ResearchElementDefinition , Resource , RiskEvidenceSynthesis , SubstanceNucleicAcid , SubstancePolymer , SubstanceProtein , SubstanceReferenceInformation , SubstanceSourceMaterial , SubstanceSpecification , SupplyDelivery , SupplyRequest , TestReport , TestScript , VerificationResult
  • Add codes ActorDefinition , AdministrableProductDefinition , ArtifactAssessment , ClinicalAssessment , ClinicalUseDefinition , ConditionDefinition , DeviceAlert , DeviceAssociation , FormularyItem , GenomicStudy , ImagingSelection , Ingredient , InsuranceProduct , ManufacturedItemDefinition , MedicinalProductDefinition , MolecularDefinition , NutritionIntake , NutritionProduct , PackagedProductDefinition , Permission , RegulatedAuthorization , RequestOrchestration , Requirements , SubscriptionStatus , SubscriptionTopic , SubstanceDefinition
Questionnaire.status Questionnaire.jurisdiction
  • Change value set from http://hl7.org/fhir/ValueSet/questionnaire-status http://hl7.org/fhir/ValueSet/jurisdiction to http://hl7.org/fhir/ValueSet/publication-status Questionnaire.experimental Added Element Questionnaire.description Added Element Questionnaire.purpose Added Element Questionnaire.approvalDate Added Element Questionnaire.lastReviewDate Added Element Questionnaire.effectivePeriod Added Element Questionnaire.useContext Added Element Questionnaire.jurisdiction Added Element Questionnaire.contact Added Element Questionnaire.copyright Added Element Jurisdiction ValueSet icon
Questionnaire.code Questionnaire.copyrightLabel
  • Added Element
Questionnaire.item Questionnaire.item.definition
    Renamed from group to item Min Cardinality changed from 1 to 0
  • Max Cardinality changed from 1 to *
Questionnaire.item.linkId Questionnaire.item.type
  • Min Cardinality changed Change value set from 0 http://hl7.org/fhir/ValueSet/item-type|4.0.0 to 1 Questionnaire.item.definition Added Element Questionnaire.item.code Added Element Questionnaire.item.prefix Added Element Questionnaire.item.type Added Element Questionnaire.item.enableWhen Added Element Questionnaire Useable Item Type
    • Questionnaire.item.enableWhen.question
  • Added Element Remove codes choice , open-choice
    • Questionnaire.item.enableWhen.hasAnswer
  • Added Element Add code coding
Questionnaire.item.enableWhen.answer[x]
  • Added Element Questionnaire.item.readOnly Added Element Questionnaire.item.maxLength Added Element Questionnaire.item.options Added Element Questionnaire.item.option Added Element Questionnaire.item.option.value[x] Added Element Add Types Quantity(http://hl7.org/fhir/StructureDefinition/SimpleQuantity), uri, Attachment
Questionnaire.item.initial[x] Questionnaire.item.disabledDisplay
  • Added Element
Questionnaire.item.item Questionnaire.item.answerConstraint
  • Added Element
Questionnaire.group.group Questionnaire.item.answerOption.value[x]
  • deleted Add Types decimal, dateTime, uri, Quantity(http://hl7.org/fhir/StructureDefinition/SimpleQuantity)
Questionnaire.group.question Questionnaire.item.initial.value[x]
  • deleted Add Type Quantity(http://hl7.org/fhir/StructureDefinition/SimpleQuantity)

See the Full Difference for further information

This analysis is available for R4 as XML or JSON . See R2 <--> R3 Conversion Maps (status = 6 tests that all execute ok. 4 fail round-trip testing and 5 r3 resources are invalid (109 errors). ). for R4B as XML or JSON .

 

Alternate Additional definitions: Master Definition ( XML , + JSON ), , XML Schema / Schematron (for ) + JSON Schema , ShEx (for Turtle ) , the spreadsheet version & the dependency analysis

2.38.4.1 2.5.5.1 Terminology Bindings

Questionnaire.subjectType Questionnaire.item.type Questionnaire.item.enableWhen.answer[x] Questionnaire.item.initial[x]
Path Definition ValueSet Type Reference Documentation
Questionnaire.versionAlgorithm[x] VersionAlgorithm Extensible

Indicates the mechanism used to compare versions to determine which is more current.

Questionnaire.status PublicationStatus Required

The lifecycle status of a Value Set or Concept Map. an artifact.

Questionnaire.subjectType ResourceType Required PublicationStatus

Concrete FHIR Resource Types

Questionnaire.jurisdiction Countries and regions within which this artifact is targeted for use JurisdictionValueSet icon Extensible Jurisdiction ValueSet

This value set defines a base set of codes for country, country subdivision and region for indicating where a resource is intended to be used.

Note: The codes for countries and country subdivisions are taken from ISO 3166 icon while the codes for "supra-national" regions are from UN Standard country or area codes for statistical use (M49) icon.
Questionnaire.code Questionnaire.item.code Codes for questionnaires, groups and individual questions QuestionnaireQuestionCodes (a valid code from LOINC icon ) Example Questionnaire Question Codes

Example list of codes for questions and groups of questions. (Not necessarily complete or appropriate.)

Questionnaire.item.code QuestionnaireQuestionCodes (a valid code from LOINC icon ) Example One

Example list of the resource types defined as part codes for questions and groups of FHIR. questions. (Not necessarily complete or appropriate.)

Questionnaire.item.type QuestionnaireItemTypeUsable Required

Item types allowed to appear on Questionnaire.type (excludes the abstract 'questionnaire' code.

Questionnaire.item.enableWhen.operator Resource Types QuestionnaireItemOperator Required

The criteria by which a question is enabled.

Questionnaire.item.enableWhen.answer[x] Distinguishes groups QuestionnaireAnswerCodes (a valid code from questions and display text and indicates data type SNOMED CT icon ) Example

Example list of codes for questions answers to questions. (Not complete or necessarily appropriate.)

Questionnaire.item.enableBehavior EnableWhenBehavior Required

Controls how multiple enableWhen values are interpreted - whether all or any must be true.

Questionnaire.item.disabledDisplay QuestionnaireItemType QuestionnaireItemDisabledDisplay Required

Codes that guide the display of disabled questionnaire items

Questionnaire.item.answerConstraint Allowed values to QuestionnaireAnswerConstraint (a valid code from Questionnaire answer questions. constraint codes ) Example Required Questionnaire Answer

Codes that describe the types of constraints possible on a question item that has a list of permitted answers

Questionnaire.item.option.value[x] Questionnaire.item.answerOption.value[x] QuestionnaireAnswerCodes (a valid code from SNOMED CT icon ) Example Allowed values

Example list of codes for answers to answer questions. (Not complete or necessarily appropriate.)

Questionnaire.item.initial.value[x] QuestionnaireAnswerCodes (a valid code from SNOMED CT icon ) Example Questionnaire Answer Codes

Example list of codes for answers to questions. (Not complete or necessarily appropriate.)

2.38.4.2 2.5.5.2 Constraints

UniqueKey Level Location Description Expression
que-1 : On Questionnaire.item: img  cnl-0 Warning (base) Name should be usable as an identifier for the module by machine processing applications such as code generation name.exists() implies name.matches('^[A-Z]([A-Za-z0-9_]){1,254}$')
img  cnl-1 Warning Questionnaire.url URL should not contain | or # - these characters make processing canonical references problematic exists() implies matches('^[^|# ]+$')
img  que-18a Rule Questionnaire.item The types of any specified answerOptions must align with the item type answerOption.value.exists() implies defineVariable('type', type).trace('type', %type).answerOption.value.type().name.distinct().select(iif($this='simplequantity', 'quantity', $this.lower())).where(%type!=$this and (%type='text' and $this='string').not() and (%type='url' and $this='uri').not()).trace('Unmatched answerOption type(s)').empty()
img  que-18b Rule Questionnaire.item The types of any specified initial values must align with the item type initial.value.exists() implies defineVariable('type', type).trace('type', %type).initial.value.type().name.distinct().select(iif($this='simplequantity', 'quantity', $this.lower())).where(%type!=$this and (%type='text' and $this='string').not() and (%type='url' and $this='uri').not()).trace('Unmatched initial value type(s)').empty()
img  que-1a Rule Questionnaire.item Group items must have nested items, display items cannot have nested items ( expression when Questionanire is active on Questionnaire.item: (type='group' implies item.empty().not()) and (type.trace('type')='display' %resource.status='active') implies item.trace('item').empty()) item.empty().not() )
que-10 : On Questionnaire.item: Maximum length can only be declared for simple question types ( expression img  que-1b Warning on Questionnaire.item: Questionnaire.item Groups should have items (type in ('boolean' | 'decimal' | 'integer' | 'string' | 'text' | 'url')) or maxLength.empty() type='group' implies item.empty().not() )
que-2 : img  que-1c Rule Questionnaire.item Display items cannot have child items type='display' implies item.empty()
img  que-2 Rule (base) The link ids for groups and questions must be unique within the questionnaire ( expression : descendants().linkId.isDistinct() repeat(item).linkId.isDistinct() )
que-3 : On Questionnaire.item: img  que-3 Rule Questionnaire.item Display items cannot have a "code" "code" asserted ( expression on Questionnaire.item: type!='display' or code.empty() )
que-4 : On Questionnaire.item: img  que-4 Rule Questionnaire.item A question cannot have both option answerOption and options ( expression answerValueSet on Questionnaire.item: option.empty() answerOption.empty() or options.empty() answerValueSet.empty() )
que-5 : On Questionnaire.item: img  que-5 Rule Questionnaire.item Only 'choice' coding, decimal, integer, date, dateTime, time, string, quantity, reference, or uri items can have options ( expression answerOption on Questionnaire.item: (type ='choice' (('coding' | 'decimal' | 'integer' | 'date' | 'dateTime' | 'time' | 'string' | 'quantity' | 'reference' | 'uri') contains type) or type = 'open-choice') answerOption.empty()
img  que-5b Rule Questionnaire.item Only coding, decimal, integer, date, dateTime, time, string or (options.empty() and option.empty()) quantity items can have answerOption (('coding' | 'string' | 'uri') contains type) or answerValueSet.empty() )
que-6 : On Questionnaire.item: img  que-6 Rule Questionnaire.item Required and repeat aren't permitted for display items ( expression on Questionnaire.item: type!='display' or (required.empty() and repeats.empty()) )
que-7 : On Questionnaire.item.enableWhen: enableWhen img  que-7 Rule Questionnaire.item.enableWhen If the operator is 'exists', the value must contain either a 'answer' or be a 'hasAnswer' element ( expression boolean on Questionnaire.item.enableWhen: hasAnswer.exists() xor answer.exists() operator = 'exists' implies (answer is boolean) )
que-8 : On Questionnaire.item: Default img  que-8 Rule Questionnaire.item Initial values can't be specified for groups or display items ( expression on Questionnaire.item: (type!='group' and type!='display') or initial.empty() )
que-9 : On Questionnaire.item: img  que-9 Rule Questionnaire.item Read-only can't be specified for "display" "display" items ( expression on Questionnaire.item: type!='display' or readOnly.empty() )
img  que-10 Rule Questionnaire.item Maximum length can only be declared for simple question types (type in ('string' | 'decimal' | 'integer' | 'text' | 'date' | 'dateTime' | 'time' | 'url')) or answerConstraint='optionOrString' or maxLength.empty()
img  que-11 Rule Questionnaire.item If one or more answerOption is present, initial cannot be present. Use answerOption.initialSelected instead answerOption.empty() or initial.empty()
img  que-12 Rule Questionnaire.item If there are more than one enableWhen, enableBehavior must be specified enableWhen.count() > 1 implies enableBehavior.exists()
img  que-13 Rule Questionnaire.item Can only have multiple initial values for repeating items repeats=true or initial.count() <= 1
img  que-14 Warning Questionnaire.item Can only have answerConstraint if answerOption or answerValueSet are present. (This is a warning because extensions may serve the same purpose) answerConstraint.exists() implies answerOption.exists() or answerValueSet.exists()
img  que-15 Warning Questionnaire.item.linkId Link ids should be 255 characters or less $this.length() <= 255
img  que-16 Rule Questionnaire.item.linkId LinkId cannot have leading or trailing spaces or intevening whitespace other than single space characters $this.matches('[^\\s]+( [^\\s]+)*')
img  que-17 Rule Questionnaire.item If question is non-repeating, cannot have more than one initialSelected answer option repeats.not() implies answerOption.where(initialSelected=true).count() <= 1
img  que-18 Warning Questionnaire.item.enableWhen Referenced questions SHOULD exist in the Questionnaire (unless still in draft, working with modular forms, etc.) question.exists() implies (%resource.repeat(item).linkId contains question)

2.38.5 2.5.6 Notes:

  • Questionnaires may be used to represent predefined forms or panels, referenced using items of type "group" "group"
  • Questions may be nested. The Questionnaire resource supports nested items beneath both items of type "group" "group" (which doesn't capture an answer of its own) as well as beneath questions
  • Groups and Questions may have linkIds allowing groups and question answers captured in a QuestionnaireResponse to be associated with their corresponding group or question.
  • Questionnaire allows for flexible naming and structuring of its contents to reflect the flexible and varying nature of forms and questionnaires. It explicitly does not try to standardize or streamline exchange of its contents outside its context of use, although exchanging partners may further constrain its structure and flexibility using profiles to define standardized, reusable forms.
  • Because of the lack of explicit support for Questionnaires in HL7 v3 icon , CDA icon Documents frequently used named sections with Observations to model Questionnaires. Such use cases should now use the Questionnaire Resource instead.
  • The order of questions within groups, groups within groups and groups within questions is relevant and must be retained for display and capture.
  • Display items allow the inclusion of instructions, background information and similar content within a questionnaire.
  • In cases where it is necessary or appropriate to capture the reason why a response is missing (that is, why a particular question was not answered), there should be an explicit child item defined for the relevant question(s) in the Questionnaire; e.g. add a child question of "Reason not specified:" with an enableWhen operator "not exists" to the parent question.

2.5.6.1 Structured Data Capture

The base questionnaire resource is aimed at the capabilities of "most" healthcare systems that deal with forms and questionnaires. While the resource structure supports a reasonable degree of complexity, it doesn't provide the degree of control over rendering, question flow and data management needed by some portions of the healthcare space. Many of these more sophisticated requirements are addressed by a supplemental implementation guide called Structured Data Capture (SDC) icon. This implementation guide covers the following capabilities, plus several others:

  • Rendering grids of questions, multi-column drop-downs, multi-language questionnaires, and other 'advanced' formatting capabilities
  • Advanced dynamic questionnaires including calculated scores, enabling of questions and groups based on complex logic, drop-downs driven by answers to other questions
  • Support for populating questionnaires from existing clinical data based on the current patient, encounter, etc., including the ability to render the form as HTML or to redirect to a website to complete unanswered items
  • Support for extracting information from a completed QuestionnaireResponse to generate other FHIR resources such as Observations, MedicationStatements, etc.
  • Support for completing 'adaptive' questionnaires (see below)

2.5.6.2 Adaptive Questionnaires

Some questionnaires might not provide a full listing of questions, instead relying on a service to interactively send partially completed forms to a server which generates the next set of questions. As such, some questionnaires might be 'active' but have either no questions or an insufficient set of questions for their purpose. Further guidance on the use of such forms, can be found in the SDC implementation guide.

2.38.5.1 2.5.6.3 Using Questionnaires versus using Resources

There is considerable overlap between the information covered by Questionnaires and other Resources (especially FamilyMemberHistory , MedicationStatement , Observation , Procedure , etc.). Questionnaire's flexible structure can easily be misused to capture any data, even data that should be captured as separate Resources. The choice between using Questionnaires or separate Resources may be dictated by the procedure of collection and recording; e.g. if the data is captured as a physician-agreed (electronic) form, it might be impossible or undesirable to distill separate resources from it and capturing the data in a Questionnaire would be most appropriate.

However, data captured only in Questionnaires can be difficult to query after-the-fact. Queries against other Resources will not return data captured only in Questionnaires , and querying against Questionnaires directly may might not find all desired data, depending on how the questions may have been phrased or encoded over time or by different clinicians. Moreover, interoperability of such Questionnaires is limited, as interpretation of its contents is only known to the circle of parties that were involved in its definition: encoding data from such Questionnaires using more specific resources increases the availability of the information they contain.

It is entirely possible for data to exist in both QuestionnaireResponse and in other resources. For example, data may be captured in QuestionnaireResponse as part of an intake questionnaire. That data may then be propagated into the Patient resource (demographics), FamilyMemberHistory , AllergyIntolerance , MedicationStatement and and/or Observation resources to allow the data to be queried and analyzed. The original QuestionnaireResponse instance can be retained for traceability purposes. If desired, a Provenance resource can be used to identify the Questionnaire as the data source for the other resources. For example, if a questionnaire question asks "what "what is your weight", weight", an Observation with the appropriate Observation.code and the specified answer as the Observation.valueQuantity can be created.

2.38.5.2 2.5.6.4 Profiling Questionnaires

Profiling can be used to define the constraints of a set of Questionnaires - for example that a particular system only supports Questionnaires where answers have certain data types, only recognizes certain extensions, mandates the presence of certain metadata, etc. However, profiling should NOT be used to define the content of a specific Questionnaire instance. To define a Questionnaire instance, simply create an instance of Questionnaire as you would any other resource.

2.5.6.5 Structure of the Questionnaire

A Questionnaire is built out of two components, Questionnaire and item:

  • The main component is Questionnaire, which holds information about the Questionnaire, like the identifier, publisher, date authored, title, etc. The Questionnaire contains zero or more items which define the content of the questionnaire (zero items allows for the possibility of narrative-only questionnaires, though these provide little computable information).
  • Items have one of three sub-types, distinguished by the type element:
    • display items convey text to be rendered on the form that won't capture data and which won't contain nested items. This might include copyright or authorship information, instructions or other background information.
    • group items organize content of the questionnaire into sections, sub-sections, etc. Groups don't have answers associated with them directly, but generally contain child 'question' items which do.
    • question items ask a specific question to which an answer may be given. There isn't a single type for question items. Instead, the type conveys the data type of the answer for the question. If an item isn't a 'display' or a 'group', then it's it is a question which allows a particular type of answer to be gathered. Questions may also have nested content - groups and/or other questions. This way, one can model "panels" "panels" of questions which would only be relevant (and thus would only be displayed) depending on the answers of a parent question; e.g. a question "Did "Did the patient receive treatment in the past six months?" months?" would contain a nested group of questions asking for further details about the treatment. See an example from the Australian New South Wales blue book icon

Specific controls on dynamic display of groups, questions, etc. based on the answers to other questions is outside the scope of the base resource and are handled using extensions.

Group text is intended to provide a "label" for a collection of nested items. The text will often be rendered in a "heading" style. As such, it should be kept relatively short. Detailed instructions should be conveyed by a nested "display" item. It's not necessary to create groups in order to relate an instruction to a collection of questions - you can simply intermix display items and questions or groups, with the expectation that users will see the display text before encountering the following questions.

2.38.5.3 2.5.6.6 Group properties

Some properties defined at the 'group' level will impact the behavior of everything within the group. For example, if a 'group' item is marked as readOnly=true, then all items within that group are automatically treated as readOnly - even if they explicitly declare readOnly=false. The same holds for enableWhen. If a group is 'disabled' based on its enableWhen settings, then all child items are automatically disabled - regardless of whether they have enableWhen declared or how those enableWhen conditions might resolve. Some extensions (e.g. the SDC 'hidden' extension) behave in the same manner. Systems MAY choose to raise errors or warnings if questionnaires have conflicting settings. E.g. if a group is marked as readOnly=true and a descendant item explicitly declares readOnly=false. This wouldn't be because the behavior is unclear, but more to draw the author's attention to the fact that their desired behavior for the child will not be realized due to the setting of the ancestor group.

Behavior of parent 'question' items (i.e. questions with child groups or questions) can also influence descendant elements, but not as strongly. If a question is readOnly, that doesn't mean that child items are also readOnly. However, if a question is disabled, all descendant items are also disabled. Similarly, a 'hidden' question, would hide child elements as well.

2.5.6.7 LinkIds

LinkIds are globally unique in a Questionnaire and are how items in a QuestionnaireResponse are tied to their corresponding Questionnaire item. The QuestionnaireResponse page includes a diagram showing how response items are linked to their corresponding Questionnaire items. Questions and their responses are tied together by their linkIds. LinkIds are unique across all items in a Questionnaire, but can sometimes appear multiple times within a QuestionnaireResponse . The diagram on the right shows a Questionnaire with a hierarchy of group and question items, some marked as 'repeats'=true, and others false and with similar variation in 'required'=true and false. It also shows a hypothetical QuestionnaireResponse that is valid against that questionnaire with appropriate nesting of items and answers and linkIds showing the alignment between the Questionnaire and QuestionnaireResponse items.

2.5.6.8 Identifiers within Questionnaire

There are three different "identifying" "identifying" elements within Questionnaire: identifier , id and linkId . Each serves very distinct purposes:

  • The identifier element is used to reference the overall questionnaire in business terms. It is the number printed across the top of the form or listed beside the form when making a choice between alternate forms.
  • The id attribute supported on each element is used for references within a resource, for example linking narrative to discrete elements. Ids are not generally displayed to end users
  • The linkId element on questions and groups establishes a link between elements in a QuestionnaireResponse and their definition inside a Questionnaire. This is the only way to link between the groups and questions in a Questionnaire and QuestionnaireResponse. These are also not displayed to end users

2.38.5.4 2.5.6.9 Question Definitions

Questionnaires can be crafted using any questions the author can conceive and can be phrased in whatever manner is appropriate or convenient. However, standardization of questions and the constraints enforced on the accompanying answers increases the ability to compare data gathered across questionnaires. Items can be directly linked to an ElementDefinition using Questionnaire.item.definition which provides details for the item. The SDC guide has defined an assembly icon process to support retrieving and injecting information from definitions into a Questionnaire. In most cases, systems rendering forms can't be expected to do this automatically as part of form display without a separate workflow step. If a definition is provided, then the following element values can be derived from the definition:

  • concept code (from ElementDefinition.code)
  • type text (from ElementDefinition.type) ElementDefinition.label)
  • required (from (inferred from ElementDefinition.min)
  • repeats (from (inferred from ElementDefinition.max)
  • maxLength (from ElementDefinition.maxLength)
  • options answerValueSet (from ElementDefinition.binding) ElementDefinition.binding.valueSet)
  • initial.value[x] or fixed[x] (from ElementDefinition.defaultValue[x] - depending on whether readOnly is set)

QuestionnaireResponse.item.type corresponds to ElementDefinition.type, however item.type is mandatory in Questionnaire, so it can't be 'populated' because it must exist for the item to exist at all. However, the values specified for item.type and ElementDefinition.type do need to correspond. Complex types such as Address or anything based on BackboneElement would correspond to 'group', while simple types would normally map directly.

In addition, extensions and elements that have corresponding extensions should also propagate. Specifically:

  • Any extensions that have a context of both ElementDefinition and Questionnaire.item (e.g. maxSize ) should propagate
  • Any extensions defined for Questionnaire.item that directly correspond to elements on ElementDefinition should also propagate. E.g.:
    • ElementDefinition.minValue[x] -> minValue
    • ElementDefinition.maxValue[x] -> maxValue
    • There are Questionnaire extensions defined in the SDC IG icon that correspond to min, max, type.targetProfile and constraint

Any information provided in these elements overrides the information from the definition. definition, and some are always required to be populated so that invariants can be enforced, etc. The url refers to a an ElementDefinition in either a StructureDefinition or a DataElement , and always starts with the canonical URL for the target resource. When referring to a StructureDefinition, a fragment identifier is used to specify the element definition by its id (Element.id). E.g. http://hl7.org/fhir/StructureDefinition/Observation#Observation.value[x]. In the absence of a fragment identifier, the first/root element definition in the target is the matching element definition. Examples:

Note that LOINC codes
Value of definition Explanation
http://hl7.org/fhir/StructureDefinition/Observation#Observation.effectiveDateTime A reference to the standard Observation element effectiveDateTime
http://example.org/definitions/xxx A reference to the logical model implicitly define DataElement resources. "xxx" that represents a data element
http://example.org/StructureDefinition/Oedema#Observation.category:XXX A reference to slice XXX on the Observation category element on an Oedema Scale profile
http://example.org/StructureDefinition/Oedema|2.0#Observation.category:XXX A reference to slice XXX on the Observation category element on an Oedema Scale profile, specifying version 2.0

The definitions may also be used to automatically pre-populate answers, or extract data from a corresponding pre-existing QuestionnaireResponse resource.

Note that LOINC codes implicitly icon define logical models whose elements can be considered question definitions.

NOTE: Even if a standard question definition is provided , information such as the question text, data type and value set SHOULD still be declared for the question. Systems processing the questionnaire may might not have access to or support the ability to look up the question definitions from external sources. If the information is not included in-line within the questionnaire, other systems may might not be able to render or use the Questionnaire. The questionnaire-definitionBased extension can be used to flag that a questionnaire requires the ability to resolve and use item.definition information to fully understand the Questionnaire. Systems that validate, render or otherwise process the questionnaire SHOULD check for this extension.

If an external definition is included along with question information such as question text, data type or value set, it is expected that the content for the question and the referenced definition would be in alignment. However, FHIR does not dictate what degree of alignment is required; e.g. Does the question text need to match exactly? Is it legitimate for a question to constrain the allowed value set of possible answers? These rules will need to be established within implementation environments.

2.38.5.5 2.5.6.10 Question types

The codes for the data type for each question are slightly different than the data types allowed in the QuestionnaireResponse resource. Where the names are the same (ignoring case), the "answer" "answer" must use the specified type. Where the names are different, the mappings are as follows:

open-choice Coding (if choosing from one of the listed choices) or string (if a different value is provided)
Questionnaire AnswerFormat code QuestionnaireResponse data type
text string
url uri
choice coding Coding

2.38.5.6 2.5.6.11 Permitted values for questions

Many questionnaires place constraints on the allowed list of values for a given question. FHIR supports this notion through the item.options item.answerValueSet or the item.option item.answerOption element.

The "option" "answerOption" mechanism is simplest - all options possible answers are listed in-line with the question using the item.option item.answerOption element. Maintenance of the set of permitted question answers involves maintenance of the questionnaire itself.

The "options" "answerValueSet" mechanism is more sophisticated. Rather than listing the options possible answers directly, the item.options item.answerValueSet element points refers to a ValueSet resource. This approach adds complexity for questionnaires having a simple list of strings as choices for a question, but provides several benefits, including:

  • Questionnaires that reference codes from externally defined code systems have a means of doing so
  • Answer sets can be shared across questions (and there are many questionnaires where this capability is useful)
  • The full capability of value sets can be brought into play, including the ability to use ConceptMap to link and translate from questionnaire-specific codes to other codes, the use of multiple display names (e.g. different languages), the ability to use coded ordinals, and the ability to allow choices from larger value sets (e.g. "all "all SNOMED CT procedure codes") codes")

In many cases, the set of code choices will be specific to a given questionnaire and should be maintained as part of the questionnaire. In this case, the referenced ValueSet can be included as a contained resource. All contained ValueSets are listed together and then are referenced by the individual questions as necessary. Alternatively, the item.options item.answerValueSet element can reference the value set in a version-specific manner. This ensures that the Questionnaire will not adopt a new version of the referenced value set without revising the Questionnaire to point to that new version - putting the author of the Questionnaire in control of any changes.

2.38.5.7 2.5.6.12 Useful Value Sets

Many questions have a common set of possible codes for their answer. These value sets may be useful to help, and when referenced by full URL, do not need to be provided as part of the questionnaire:

2.38.5.8 2.5.6.13 Handling Boolean Answers

In a questionnaire response, a question of type 'boolean' can have 3 possible states - unanswered, answered true, and answered false. Users will generally need to be able to toggle through all three states. If a default value is specified and the element is mandatory, a simple control with only true and false options (e.g. traditional check-box) will suffice. However, if a three-state selection is required, the typical controls used in HTML and other rendering technologies for booleans might not be appropriate. E.g. a checkbox that can only convey 'true' or 'false' will not be able to differentiate 'unanswered' and thus is generally not appropriate. If a tri-state control is available, that would work well. Alternatively, a set of radio buttons allow choices of true, false or "no answer" could also work.

As well, when enableWhen expressions are used that reference boolean elements, designers should consider whether "non-answered" is a possible value for boolean questions and design their enableWhen logic accordingly.

2.5.6.14 Questions with multiple answer types

In some questionnaires, it may be possible to respond to a question with multiple types of answers. For example, capturing a coded answer plus free text, capturing a coded value plus a numeric priority, etc. In FHIR, this is handled through nested questions. Each question has a single data type. However, each question can have nested child questions. These nested child questions can have text (e.g. "Please specify") "Please specify") or can have no text at all if the appropriate guidance is provided by the parent question or group.

2.38.5.9 2.5.6.15 Questionnaires with Math

Many questionnaires involve computations on questionnaire answers, e.g. tabulating scores. To help with associating numeric values to coded answers, there are two extensions defined - one for defining the itemweight extension can be used to define the numeric weighting of a code defined in a value set - valueset-ordinalValue and or in the other for defining a code that can appear within a Coding itself - iso21090-CO-value . questionnaire itself.

In addition, there are extensions for defining the dynamic value of an element usings using expressions. For more information, see the Using Expressions and Documentation Template topics in the Clinical Reasoning module.

2.5.6.16 Questionnaire workflow

Once a Questionnaire is defined, there's often a need to 'assign' a Questionnaire to a particular individual to request them to complete it. This is not done using the Questionnaire resource directly. Instead, the Questionnaire is referenced as an 'input' or argument using one of FHIR's workflow patterns . The most common mechanism is by defining a stand-alone Task that references the Questionnaire and seeks completion. The SDC implementation guide defines profiles and guidance for using this mechanism.

2.5.6.17 More advanced questionnaires

The capabilities of the Questionnaire resource are fairly simple and try to adhere to what most systems that deal with questionnaires would be capable of. However, there are lots of systems that require more sophisticated capabilities, such as:

  • Greater control over rendering, including tables, read-only values, hidden answers, multi-column drop-downs
  • Greater control over question flow, including formula-based rules for conditional display of elements
  • Ability to pre-populate forms with data found in the client system
  • Ability to define how to convert a completed QuestionnaireResponse for a Questionnaire into a collection of Observations and/or other resources

Extensions have been defined for all of these purposes and many more. (Questionnaire has the most 'core' extensions of any resource to-date.) A list of these extensions can be found here . However, some of the extensions are complex and work together in particular ways. To support more advanced questionnaire implementation, the Structured Data Capture (SDC) icon implementation guide has been created to provide non-country-specific guidance on the use of most of these extensions and sets expectations for systems wishing to support more complex forms.

2.38.6 2.5.7 Search Parameters

Search parameters for this resource. See also the full list of search parameters for this resource , and check the Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

Name Type Description Expression In Common
combo-code code token A code that corresponds to one of its items in the questionnaire Questionnaire.code | Questionnaire.repeat(item).code
context token Questionnaire.item.code A use context assigned to the questionnaire (Questionnaire.useContext.value.ofType(CodeableConcept)) 25 Resources
context-quantity quantity A quantity- or range-valued use context assigned to the questionnaire (Questionnaire.useContext.value.ofType(Quantity)) | (Questionnaire.useContext.value.ofType(Range)) 25 Resources
context-type token A type of use context assigned to the questionnaire Questionnaire.useContext.code 25 Resources
context-type-quantity composite A use context type and quantity- or range-based value assigned to the questionnaire On Questionnaire.useContext:
  context-type: code
  context-quantity: value.ofType(Quantity) | value.ofType(Range) 		25 Resources
context-type-value composite A use context type and value assigned to the questionnaire On Questionnaire.useContext:
  context-type: code
  context: value.ofType(CodeableConcept) 		25 Resources
date date The questionnaire publication date Questionnaire.date 26 Resources
definition uri ElementDefinition - details for the item Questionnaire.repeat(item).definition
description string The description of the questionnaire Questionnaire.description 24 Resources
effective date The time during which the questionnaire is intended to be in use Questionnaire.effectivePeriod 10 Resources
experimental token Whether the Questionnaire is experimental Questionnaire.experimental
identifier token External identifier for the questionnaire Questionnaire.identifier 30 Resources
item-code token A code that corresponds to one of the items in the questionnaire Questionnaire.repeat(item).code
jurisdiction token Intended jurisdiction for Jurisdiction of the authority that maintains the the questionnaire Questionnaire.jurisdiction 22 Resources
name string Computationally friendly name of the questionnaire Questionnaire.name 24 Resources
publisher string Name of the publisher of the questionnaire Questionnaire.publisher 26 Resources
questionnaire-code token A code that matches one of the Questionnaire.code codings Questionnaire.code
status token The current status of the questionnaire Questionnaire.status 30 Resources
subject-type token Resource that can be subject of QuestionnaireResponse Questionnaire.subjectType
title string The human-friendly name of the questionnaire Questionnaire.title 24 Resources
url uri The uri that identifies the questionnaire Questionnaire.url 30 Resources
version token The business version of the questionnaire Questionnaire.version 27 Resources