Core extensions for Questionnaire

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: R4 R3 R2

Background and Context

Questionnaire structure and validation

There are two extensions to help with defining the structure of a Questionnaire, especially useful when sending an "empty form" Questionnaire, e.g. a Questionnaire where only the questions are provided. such Questionnaires contain the text and descriptions of sections and questions within the sections, and these two extensions provide extra information to a client displaying such an empty Questionnaire and make it possible to do basic validation of the input. It is expected that more extensive validation for Questionnaires is added by creating new extensions.

mayRepeat - This extension may be used on a Questionnaire.group to signal that this group can occur more than once in the instance. Such repeating groups contain Questions that may repeat, often shown in a tabular form where each question is a column heading and each repeat a row in a table.
answerFormat - This extension may be used on Questionnaire.question and indicates the kind of answer expected. The format is either a basic input form (corresponding to the FHIR types like string and integer) or an indication that the answer is a coded choice coming from a list of options. In the latter case, the answer may be single- or multiple-choice and supplying free text ("Other, please specify...") may also be indicated. This format helps the client to display the correct kind of input method for such a question.

Other

omitReason - A code to explicitly indicate why a question on a form was not answered (comparable to some of the ISO 21090 concepts in nullFlavor), i.e. "patient did not want to answer", "no matching choice available" etcetera.

This profile was published on Thu, Jul 4, 2013 00:00+1000 as a draft by HL7 , and profiles the Questionnaire Resource

Content

Terminology Bindings

Example

Path	Definition	Type	Reference
[questionnaire-extensions].extensions.answerFormat	The expected format of an answer	Fixed	http://hl7.org/fhir/answer-format

Example Instance "Example for Profile Core extensions for Questionnaire"

<Questionnaire xmlns="http://hl7.org/fhir">
  <text>
    <status value="generated"/>
    <div xmlns="http://www.w3.org/1999/xhtml">
      <pre>
            Comorbidity? YES
              Cardial Comorbidity? YES
                Angina? YES
                MI? NO
              Vascular Comorbidity?
                (no answers)
              ...
            Histopathology
              Abdominal
                pT category: 1
              ...
          </pre>
    </div>
  </text>
  <contained>
    <Patient id="patsub">
      <identifier>
        <system value="http://cancer.questionnaire.org/systems/id/patientnr"/>
        <value value="A34442332"/>
      </identifier>
      <identifier>
        <label value="Dutch BSN"/>
        <system value="urn:oid:2.16.840.1.113883.2.4.6.3"/>
        <value value="188912345"/>
      </identifier>
      <gender>
        <coding>
          <system value="http://hl7.org/fhir/v3/AdministrativeGender"/>
          <code value="M"/>
        </coding>
      </gender>
      <birthDate value="1972-11-30"/>

    </Patient>
  </contained>
  <contained>
    <Practitioner id="questauth">
      <identifier>
        <label value="AUMC, Den Helder"/>
        <system value="http://cancer.questionnaire.org/systems/id/org"/>
        <value value="AUMC"/>
      </identifier>
    </Practitioner>
  </contained>
  <contained>
    <Observation id="obs.pt-category">
      <name>
        <coding>
          <system value="http://snomed.info/sct"/>
          <code value="53786006"/>
          <display value="pT category"/>
        </coding>
      </name>
      <valueCodeableConcept>
        <coding>
          <system value="http://snomed.info/sct"/>
          <code value="443357004"/>
          <display value="pT1a category"/>
        </coding>
      </valueCodeableConcept>
      <status value="final"/>
      <reliability value="unknown"/>
    </Observation>
  </contained>
  <status value="completed"/>
  <authored value="2013-02-19T14:15:00"/>
  <subject>
    <reference value="#patsub"/>
  </subject>
  <author>
    <reference value="#questauth"/>
  </author>
  <name>
    <text value="Cancer Quality Forum Questionnaire 2012"/>
  </name>
  <group>
    <group>
      <!--   COMORBIDITY   -->
      <!--   First main section of the form, questions about comorbidity   -->
      <name>
        <coding>
          <system value="http://cancer.questionnaire.org/system/code/sections"/>
          <code value="COMORBIDITY"/>
        </coding>
      </name>
      <!--   section contains one question: whether there is comorbidity   -->
      <question>
        <name>
          <coding>
            <system value="http://cancer.questionnaire.org/system/code/questions"/>
            <code value="COMORB"/>
          </coding>
        </name>
        <choice>
          <system value="http://cancer.questionnaire.org/system/code/yesno"/>
          <code value="1"/>
          <display value="Yes"/>
        </choice>
        <group>
          <!--   COMORBIDITY/CARDIAL   -->
          <!--   Subsection about specific comorbidity: cardial   -->
          <name>
            <coding>
              <system value="http://cancer.questionnaire.org/system/code/sections"/>
              <code value="CARDIAL"/>
            </coding>
          </name>
          <question>
            <name>
              <coding>
                <system value="http://cancer.questionnaire.org/system/code/questions"/>
                <code value="COMORBCAR"/>
              </coding>
            </name>
            <choice>
              <system value="http://cancer.questionnaire.org/system/code/yesno"/>
              <code value="1"/>
            </choice>
          </question>
          <question>
            <!--   This answer carries both the questionnaire-specific name and an equivalent SNOMED CT
             code   -->
            <name>
              <coding>
                <system value="http://cancer.questionnaire.org/system/code/questions"/>
                <code value="COMCAR00"/>
                <display value="Angina Pectoris"/>
              </coding>
              <coding>
                <system value="http://snomed.info/sct"/>
                <code value="194828000"/>
                <display value="Angina (disorder)"/>
              </coding>
            </name>
            <choice>
              <system value="http://cancer.questionnaire.org/system/code/yesno"/>
              <code value="1"/>
            </choice>
          </question>
          <question>
            <name>
              <coding>
                <system value="http://snomed.info/sct"/>
                <code value="22298006"/>
                <display value="Myocardial infarction (disorder)"/>
              </coding>
            </name>
            <choice>
              <system value="http://cancer.questionnaire.org/system/code/yesno"/>
              <code value="0"/>
            </choice>
          </question>
        </group>
        <group>
          <!--   COMORBIDITY/VASCULAR   -->
          <name>
            <coding>
              <system value="http://cancer.questionnaire.org/system/code/sections"/>
              <code value="VASCULAR"/>
            </coding>
          </name>
        </group>
      </question>
    </group>
    <group>
      <!--   HISTOPATHOLOGY   -->
      <name>
        <coding>
          <system value="http://cancer.questionnaire.org/system/code/sections"/>
          <code value="HISTOPATHOLOGY"/>
        </coding>
      </name>
      <group>
        <name>
          <coding>
            <system value="http://cancer.questionnaire.org/system/code/sections"/>
            <code value="ABDOMINAL"/>
          </coding>
        </name>
        <question>
          <name>
            <coding>
              <system value="http://cancer.questionnaire.org/system/code/questions"/>
              <code value="STADPT"/>
              <display value="pT category"/>
            </coding>
          </name>
          <dataResource>
            <reference value="#obs.pt-category"/>
          </dataResource>
        </question>
      </group>
    </group>
  </group>
</Questionnaire>

Core extensions for Questionnaire

Scope and Usage

Background and Context

Questionnaire structure and validation

Other

Content

Terminology Bindings

Example