• Content
• Examples
• Detailed Descriptions
• Mappings
• Profiles & Extensions
• R3 Conversions

2.39 Resource QuestionnaireResponse - Content

FHIR Infrastructure Work Group

Maturity Level: 3

Trial Use

Security Category: Patient

Compartments: Device, Encounter, Patient, Practitioner, RelatedPerson

This resource has been identified by it's owning workgroup as a normative candidate for R5. Ballot comment is requested on this.

A structured set of questions and their answers. The questions are ordered and grouped into coherent subsets, corresponding to the structure of the grouping of the questionnaire being responded to.

2.39.3 References

This resource is referenced by Consent, Contract, DeviceUsage and Observation.

This resource implements the Event pattern.

2.39.4 Resource Content

 

See the Profiles & Extensions and the alternate definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions, the spreadsheet version & the dependency analysis a

2.39.4.1 Terminology Bindings

Path	Definition	Type	Reference
QuestionnaireResponse.status		Required	QuestionnaireResponseStatus
QuestionnaireResponse.item.answer.value[x]	Code indicating the response provided for a question.	Example	QuestionnaireAnswerCodes

2.39.4.2 Constraints

id	Level	Location	Description	Expression
qrs-1	Rule	QuestionnaireResponse.item	Item cannot contain both item and answer	(answer.exists() and item.exists()).not()

2.39.5 Notes

• QuestionnaireResponses can be authored by clinicians, patients, or patients' relatives (or even owners in the case of animals). Clinicians may author questionnaire responses, where the answers are provided by others on behalf of the patient. Additionally, information gathered on behalf of a patient may be about the patient's relatives (e.g. in family anamnesis). Therefore, QuestionnaireResponse makes a distinction between the author, the subject and the source of information.
• The QuestionnaireResponse's encounter element can be used to link to the encounter when the questionnaire response was authored. This can be relevant since the encounter gives context to the answers and can be used to relate information in the QuestionnaireResponse to orders and observations that were done during the same Encounter.
• The QuestionnaireResponse's language element can be used to indicate the language in which the patient completed the survey/questionnaire
• The order of questions within groups, groups within groups and groups within questions is relevant and must be retained for display and capture. The hierarchy of the items within the QuestionnaireResponse SHALL mirror the hierarchy of the items in the corresponding Questionnaire (if any).
• For use of QuestionnaireResponse.item.definition, see notes on Questionnaire
• Because of the lack of explicit support for Questionnaires in HL7 v3 , CDA Documents frequently used named sections with Observations to model questionnaires. Such use cases should now utilize the QuestionnaireResponse resource instead.

Refer to additional guidance provided in the Questionnaire resource dealing with the design of questionnaires.

2.39.5.1 Links to Questionnaire

A QuestionnaireResponse may be stand-alone or may point to the definition of the questions in Questionnaire. If the QuestionnaireResponse refers to a Questionnaire:

• The QuestionnaireResponse structure must be consistent with the Questionnaire (i.e. questions must be organized into the same groups, nested questions must still be nested, etc.
• The linkage between the questions and groups in the two resources is established using the linkId element
• When a QuestionnaireResponse references a Questionnaire, all the items in the questionnaire SHOULD be included in the QuestionnaireResponse if they are relevant to the interpretation of the answers, including items of type = display. This might also include items that were not enabled when the Questionnaire was answered, though of course these will not have answers

2.39.5.2 Validating QuestionnaireResponses

Rules imposed by a Questionnaire about expectations for answers are not expected to be met until a Questionnaire is deemed to be 'completed' (or 'amended'). For example, items that are marked as 'required' may be omitted, minimum numbers of answers might not be met, length requirement for answers, co-occurrence constraints, etc. might all be violated when the QuestionnaireResponse is still in the process of being completed. QuestionnaireResponses may be stored in this 'incomplete' state. Such QuestionnaireResponses might also include data for disabled questions, entries and text for non-answered questions, etc. However, once a QuestionnaireResponse is marked as 'completed' (including if it is subsequently changed to 'amended'), all requirements of the associated Questionnaire must be met, all non-answered question items must be removed, all non-enabled items must be removed, etc. (Display items MAY be retained. Certain extensions on the Questionnaire item may mandate that a display item needed for a human reviewer to interpret the QuestionnaireResponse be retained in a completed QuestionnaireResponse.)

2.39.5.3 Nested Items

QuestioinnaireResponse has two different mechanisms to support nesting of items - item.item and item.answer.item. The former is used when nesting items within a 'group' and the latter is always used when nesting items within a question. This is because items nested within a question always nest within each answer to the question. If the question allows multiple answers, each will have its own set of nested items.

2.39.5.4 Security

QuestionnaireResponse resources can have answers with values of type Attachment. These attachments will typically be selected by the user answering the questionnaire and this selection may be done in an uncontrolled environment. Systems should ensure that the attachment is of the desired type and should take precautions before rendering or executing any attached content.

2.39.5.5 Access Control

For most resources, the type of information that can be conveyed in the resource is determined by the resource, and the key attributes that determine the sensitivity level of the information are also known; e.g., drug, observation type, clinical trial randomization status, etc. However, for QuestionnaireResponse, the sensitivity of an instance is dependent on what type of Questionnaire it is associated with. And the data elements that determine that sensitivity could be the answers to any of the questions. This makes automatically enforcing access control rules more challenging. Designers should take these challenges into account and may need to place stricter access controls around QuestionnaireResponse to ensure that access to information is not granted improperly.

2.39.5.6 Profiling QuestionnaireResponses

It is possible to profile QuestionnaireResponse in the same way as any other resource. However, such profiling should not be used to constrain QuestionnaireResponse to only be able to capture the answers associated with a single type of form - that is what the Questionnaire resource is for. Profiling QuestionnaireResponse is appropriate when there's a need to enforce that certain metadata is always present, to indicate limitations on what types of answers can be handled, etc. - independent of what Questionnaire is being completed.

2.39.6 Search Parameters

Search parameters for 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
author	reference	The author of the questionnaire response	QuestionnaireResponse.author (Practitioner, Organization, Device, Patient, PractitionerRole, RelatedPerson)
authored N	date	When the questionnaire response was last changed	QuestionnaireResponse.authored
based-on	reference	Plan/proposal/order fulfilled by this questionnaire response	QuestionnaireResponse.basedOn (CarePlan, ServiceRequest)
encounter	reference	Encounter associated with the questionnaire response	QuestionnaireResponse.encounter (Encounter)
identifier	token	The unique identifier for the questionnaire response	QuestionnaireResponse.identifier
item-subject	reference	Allows searching for QuestionnaireResponses by item value where the item has isSubject=true	QuestionnaireResponse.item.where(extension('http://hl7.org/fhir/StructureDefinition/questionnaireresponse-isSubject').exists()).answer.value.ofType(Reference)
part-of	reference	Procedure or observation this questionnaire response was performed as a part of	QuestionnaireResponse.partOf (Observation, Procedure)
patient	reference	The patient that is the subject of the questionnaire response	QuestionnaireResponse.subject.where(resolve() is Patient) (Any)
questionnaire N	reference	The questionnaire the answers are provided for	QuestionnaireResponse.questionnaire (Questionnaire)
source	reference	The individual providing the information reflected in the questionnaire respose	QuestionnaireResponse.source (Practitioner, Patient, PractitionerRole, RelatedPerson)
status N	token	The status of the questionnaire response	QuestionnaireResponse.status
subject	reference	The subject of the questionnaire response	QuestionnaireResponse.subject (Any)