This page is part of the FHIR Specification (v0.0.82: DSTU 1). The current version which supercedes this version is 5.0.0 . For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

4.7 Resource Questionnaire - Content

A structured set of questions and their answers. The Questionnaire may contain questions, answers or both. The questions are ordered and grouped into coherent subsets, corresponding to the structure of the grouping of the underlying questions.

4.7.1 Scope and Usage

The Questionnaire may be a single list of questions, or can be hierarchically organized in groups and sub-groups, each containing questions. Questions may contain and single answer, which can take the form of simple text, numbers, dates or a set of coded choices.

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

Examples of Questionnaires include:

Support for validation is outside the scope of this Resource, although basic structural features can be defined using the Questionnaire core extensions .

4.7.2 Boundaries and Relationships

Questionnaires differ from Lists because Lists regroup or summarize existing information, while Questionnaires contain original, clinician collected data. Questionnaires are similar to Documents. However, the purpose of a Questionnaire is the capture of raw data as opposed to the composition and assertion of information intended for long term persistence and use in a Document.

4.7.3 Background and Context

Groups and questions that make up a Questionnaire can be explicitly named to refer to externally defined numbering or identification of questions and sections on formally defined questionnaires. This allows extraction of the data on a form and post-processing of the data contained in a Questionnaire. Such naming is not required however 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.

4.7.4 Resource Content

Questionnaire ( Resource ) The lifecycle status of the questionnaire as a whole (this element modifies the meaning of other elements) status : code 1..1 << Lifecycle status of the questionnaire QuestionnaireStatus >> The date and/or time that this version of the questionnaire was authored authored : dateTime 1..1 The subject of the questionnaires: this is the patient that the answers apply to, but this person is not necessarily the source of information subject : Resource ( Patient | RelatedPerson ) 0..1 Person who received the answers to the questions in the Questionnaire and recorded them in the system author : Resource ( Practitioner | Patient | RelatedPerson ) 0..1 The person who answered the questions about the subject. Only used when this is not the subject him/herself source : Resource ( Patient | Practitioner | RelatedPerson ) 0..1 Structured name for a predefined list of questions this questionnaire is responding to name : CodeableConcept 0..1 << Structured names for forms QuestionnaireName >> This records identifiers associated with this question/answer set that are defined by business processed and/ or used to refer to it when a direct URL reference to the resource itself is not appropriate (e.g. in CDA documents, or in written / printed documentation) identifier : Identifier 0..* Encounter during which this questionnaire answers were collected. When there were multiple encounters, this is the one considered most relevant to the context of the answers encounter : Resource ( Encounter ) 0..1 Group Structured name for a section of a predefined list of questions this questionnaire is responding to name : CodeableConcept 0..1 << Structured names for (sub)sections of forms QuestionnaireGroupName >> Text that is displayed above the contents of the group header : string 0..1 Additional text for the group, used for display purposes text : string 0..1 More specific subject this section's answers are about, details the subject given in Questionnaire subject : Resource ( Any ) 0..1 Question Structured name for the question that identifies this question within the Questionnaire or Group name : CodeableConcept 0..1 << Structured names for questions on the form QuestionName >> Text of the question as it is shown to the user text : string 0..1 Single-valued answer to the question answer[x] : decimal | integer | boolean | date | string | dateTime | instant 0..1 Selections made by the user from the list of options choice : Coding 0..* Reference to a valueset containing the possible options options : Resource ( ValueSet ) 0..1 Structured answer in the form of a FHIR Resource or datatype data[x] : * 0..1 The remark contains information about the answer given. This is additional information about the answer the author wishes to convey, but should not be used to contain information that is part of the answer itself remarks : string 0..1 A sub-group within a group. The ordering of groups within this group is relevant group 0..* Nested group, containing nested question for this question. The order of groups within the question is relevant group 0..* Set of questions within this group. The order of questions within the group is relevant question 0..* A group of questions to a possibly similarly grouped set of questions in the questionnaire group 0..1
<Questionnaire xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: extension, modifierExtension, language, text, and contained -->
 <status value="[code]"/><!-- 1..1 draft | published | retired | in progress | completed | amended § -->
 <authored value="[dateTime]"/><!-- 1..1 Date this version was authored § -->
 <subject><!-- 0..1 Resource(Patient|RelatedPerson) The subject of the questions § --></subject>
 <author><!-- 0..1 Resource(Practitioner|Patient|RelatedPerson) 
     Person who received and recorded the answers § --></author>
 <source><!-- 0..1 Resource(Patient|Practitioner|RelatedPerson) 
     The person who answered the questions § --></source>
 <name><!-- 0..1 CodeableConcept Name/code for a predefined list of questions § --></name>
 <identifier><!-- 0..* Identifier External Ids for this questionnaire § --></identifier>
 <encounter><!-- 0..1 Resource(Encounter) 
     Primary encounter during which the answers were collected § --></encounter>
 <group>  <!-- 0..1 Grouped questions -->
  <name><!-- 0..1 CodeableConcept Code or name of the section on a questionnaire --></name>
  <header value="[string]"/><!-- 0..1 Text that is displayed above the contents of the group -->
  <text value="[string]"/><!-- 0..1 Additional text for the group -->
  <subject><!-- 0..1 Resource(Any) The subject this group's answers are about --></subject>
  <group><!-- ?? 0..* Content as for Questionnaire.group Nested questionnaire group --></group>
  <question>  <!-- ?? 0..* Questions in this group -->
   <name><!-- ?? 0..1 CodeableConcept Code or name of the question --></name>
   <text value="[string]"/><!-- ?? 0..1 Text of the question as it is shown to the user -->
   <answer[x]><!-- ?? 0..1 decimal|integer|boolean|date|string|dateTime|instant 
       Single-valued answer to the question --></answer[x]>
   <choice><!-- ?? 0..* Coding Selected options --></choice>
   <options><!-- 0..1 Resource(ValueSet) Valueset containing the possible options --></options>
   <data[x]><!-- ?? 0..1 * Structured answer --></data[x]>
   <remarks value="[string]"/><!-- 0..1 Remarks about the answer given -->
   <group><!-- 0..* Content as for Questionnaire.group Nested questionnaire group --></group>
  </question>
 </group>
</Questionnaire>

Alternate definitions: Schema / Schematron , Resource Profile

4.7.4.1 Terminology Bindings

Path Definition Type Reference
Questionnaire.status Lifecycle status of the questionnaire Fixed http://hl7.org/fhir/questionnaire-status
Questionnaire.name Structured names for forms Example http://hl7.org/fhir/vs/questionnaire-name
Questionnaire.group.name Structured names for (sub)sections of forms Example http://hl7.org/fhir/vs/questionnaire-group-name
Questionnaire.group.question.name Structured names for questions on the form Example http://hl7.org/fhir/vs/questionnaire-question-name

4.7.4.2 Constraints

4.7.5 Notes:

4.7.5.1 Using Questionnaires versus using Resources

There is considerable overlap between the information covered by Questionnaires and other Resources (especially FamilyHistory, 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 the Questionnaire SHALL be stored and communicated as a whole.

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 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 other, more specific, Resources increases the ability and consistency with which it can be understood and queried.

To facilitate better standardization of the information on a form, Questionnaire has the capacity (Using a Question's data element) to allow systems to communicate (part of) the answers in the form of structured FHIR data. This provides an upgrade path to the questionnaire designer and communicating systems, where capable systems may use FHIR data to answer (sets of) questions, whereas other systems can simply continue to supply the direct answers as input by the user.

4.7.5.2 Providing Questions and/or Answers

The Questionnaire has been specifically designed to be able to contain both a form's questions and answers. The Group and Question construct has elements to carry textual data of the form like headings, explanatory text, actual question text and the text of (multiple)choice options. As such, the Questionnaire can be used to:

This third case can be useful to make Questionnaire serve as a kind of form "template", where FHIR clients receive the empty form, display it to the user, get answers from the users and then return the combined questions and answers to the server. The questionnaire core extensions provide additional means for control over repeating sections and expected answer format.

4.7.5.3 Structure of the Questionnaire

A Questionnaire is built out of three components:

4.7.6 Search Parameters

Search parameters for this resource. The standard parameters also apply. See Searching for more information about searching in REST, messaging, and services.

Name Type Description Paths
_id token The logical resource id associated with the resource (must be supported by all servers)
_language token The language of the resource
author reference The author of the questionnaire Questionnaire.author
( Patient , Practitioner , RelatedPerson )
authored date When the questionnaire was authored Questionnaire.authored
encounter reference Encounter during which questionnaire was authored Questionnaire.encounter
( Encounter )
identifier token An identifier for the questionnaire Questionnaire.identifier
name token Name of the questionnaire Questionnaire.name
status token The status of the questionnaire Questionnaire.status
subject reference The subject of the questionnaire Questionnaire.subject
( Patient , RelatedPerson )

comments powered by Disqus