Questionnaire - FHIR Resource (stu3)

This Questionnaire Resource uses the FHIR API standard for access and structure.

Validate an Questionnaire FHIR Resource (stu3)

Questionnaire Attributes

AttributeField is listTypeDescription

Description: draft | active | retired | unknown

FHIR Version: stu3

Attribute Type : code

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"status": "draft"

Learn more about the (Questionnaire) status FHIR attribute

Description: When the questionnaire was approved by publisher

FHIR Version: stu3

Attribute Type : date

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"approvalDate":

Learn more about the (Questionnaire) approvalDate FHIR attribute

Description: Concept that represents the overall questionnaire

FHIR Version: stu3

Attribute Type : Coding

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"code":

Learn more about the (Questionnaire) code FHIR attribute

Description: Natural language description of the questionnaire

FHIR Version: stu3

Attribute Type : markdown

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"description":

Learn more about the (Questionnaire) description FHIR attribute

Description: Use and/or publishing restrictions

FHIR Version: stu3

Attribute Type : markdown

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"copyright":

Learn more about the (Questionnaire) copyright FHIR attribute

Description: Name for this questionnaire (human friendly)

FHIR Version: stu3

Attribute Type : string

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"title": "Cancer Quality Forum Questionnaire 2012"

Learn more about the (Questionnaire) title FHIR attribute

Description: Logical URI to reference this questionnaire (globally unique)

FHIR Version: stu3

Attribute Type : uri

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"url": "http://hl7.org/fhir/Questionnaire/3141"

Learn more about the (Questionnaire) url FHIR attribute

Description: Resource that can be subject of QuestionnaireResponse

FHIR Version: stu3

Attribute Type : code

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"subjectType": [
  "Patient"
]

Learn more about the (Questionnaire) subjectType FHIR attribute

Description: Contact details for the publisher

FHIR Version: stu3

Attribute Type : ContactDetail

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"contact":

Learn more about the (Questionnaire) contact FHIR attribute

Description: Intended jurisdiction for questionnaire (if applicable)

FHIR Version: stu3

Attribute Type : CodeableConcept

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"jurisdiction":

Learn more about the (Questionnaire) jurisdiction FHIR attribute

Description: Name of the publisher (organization or individual)

FHIR Version: stu3

Attribute Type : string

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"publisher":

Learn more about the (Questionnaire) publisher FHIR attribute

Description: When the questionnaire was last reviewed

FHIR Version: stu3

Attribute Type : date

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"lastReviewDate":

Learn more about the (Questionnaire) lastReviewDate FHIR attribute

Description: Name for this questionnaire (computer friendly)

FHIR Version: stu3

Attribute Type : string

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"name":

Learn more about the (Questionnaire) name FHIR attribute

Description: C? Questions and sections within the Questionnaire

FHIR Version: stu3

Attribute Type : Data Type

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"item": [
  {
    "linkId": "1",
    "code": [
      {
        "code": "COMORBIDITY",
        "system": "http://example.org/system/code/sections"
      }
    ],
    "type": "group",
    "item": [
      {
        "code": [
          {
            "code": "COMORB",
            "system": "http://example.org/system/code/questions"
          }
        ],
        "linkId": "1.1",
        "item": [
          {
            "linkId": "1.1.1",
            "code": [
              {
                "code": "CARDIAL",
                "system": "http://example.org/system/code/sections"
              }
            ],
            "type": "group",
            "enableWhen": [
              {
                "answerCoding": {
                  "code": "Y",
                  "system": "http://hl7.org/fhir/v2/0136"
                },
                "question": "1.1"
              }
            ],
            "item": [
              {
                "code": [
                  {
                    "code": "COMORBCAR",
                    "system": "http://example.org/system/code/questions"
                  }
                ],
                "linkId": "1.1.1.1",
                "item": [
                  {
                    "linkId": "1.1.1.1.1",
                    "prefix": "1.1.1",
                    "code": [
                      {
                        "code": "COMCAR00",
                        "system": "http://example.org/system/code/questions",
                        "display": "Angina Pectoris"
                      },
                      {
                        "code": "194828000",
                        "system": "http://snomed.info/sct",
                        "display": "Angina (disorder)"
                      }
                    ],
                    "type": "choice",
                    "options": {
                      "reference": "http://hl7.org/fhir/ValueSet/yesnodontknow"
                    }
                  },
                  {
                    "linkId": "1.1.1.1.2",
                    "prefix": "1.1.2",
                    "code": [
                      {
                        "code": "22298006",
                        "system": "http://snomed.info/sct",
                        "display": "Myocardial infarction (disorder)"
                      }
                    ],
                    "type": "choice",
                    "options": {
                      "reference": "http://hl7.org/fhir/ValueSet/yesnodontknow"
                    }
                  }
                ],
                "prefix": "1.1",
                "type": "choice",
                "options": {
                  "reference": "http://hl7.org/fhir/ValueSet/yesnodontknow"
                }
              },
              {
                "linkId": "1.1.1.2",
                "prefix": "1.2",
                "code": [
                  {
                    "code": "COMORBVAS",
                    "system": "http://example.org/system/code/questions"
                  }
                ],
                "type": "choice",
                "options": {
                  "reference": "http://hl7.org/fhir/ValueSet/yesnodontknow"
                }
              }
            ]
          }
        ],
        "prefix": "1",
        "type": "choice",
        "options": {
          "reference": "http://hl7.org/fhir/ValueSet/yesnodontknow"
        }
      }
    ]
  },
  {
    "linkId": "2",
    "code": [
      {
        "code": "HISTOPATHOLOGY",
        "system": "http://example.org/system/code/sections"
      }
    ],
    "type": "group",
    "item": [
      {
        "linkId": "2.1",
        "code": [
          {
            "code": "ABDOMINAL",
            "system": "http://example.org/system/code/sections"
          }
        ],
        "type": "group",
        "item": [
          {
            "linkId": "2.1.2",
            "code": [
              {
                "code": "STADPT",
                "system": "http://example.org/system/code/questions",
                "display": "pT category"
              }
            ],
            "type": "choice"
          }
        ]
      }
    ]
  }
]

Learn more about the (Questionnaire) item FHIR attribute

Description: Business version of the questionnaire

FHIR Version: stu3

Attribute Type : string

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"version":

Learn more about the (Questionnaire) version FHIR attribute

Description: Context the content is intended to support

FHIR Version: stu3

Attribute Type : UsageContext

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"useContext":

Learn more about the (Questionnaire) useContext FHIR attribute

Description: Why this questionnaire is defined

FHIR Version: stu3

Attribute Type : markdown

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"purpose":

Learn more about the (Questionnaire) purpose FHIR attribute

Description: Date this was last changed

FHIR Version: stu3

Attribute Type : dateTime

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"date": "2012-01"

Learn more about the (Questionnaire) date FHIR attribute

Description: Additional identifier for the questionnaire

FHIR Version: stu3

Attribute Type : Identifier

Required: N/A

Countability: Array

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"identifier":

Learn more about the (Questionnaire) identifier FHIR attribute

Description: For testing purposes, not real usage

FHIR Version: stu3

Attribute Type : boolean

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"experimental":

Learn more about the (Questionnaire) experimental FHIR attribute

Description: When the questionnaire is expected to be used

FHIR Version: stu3

Attribute Type : Period

Required: N/A

Countability: Singleton

Flags: N/A

Terminology bindings: N/A

Requirements: N/A

Comments: N/A

Example:

"effectivePeriod":

Learn more about the (Questionnaire) effectivePeriod FHIR attribute

Questionnaire Example

{
  "status": "draft",
  "title": "Cancer Quality Forum Questionnaire 2012",
  "resourceType": "Questionnaire",
  "text": {
    "status": "generated",
    "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">\n      <pre>\n            1.Comorbidity?\n              1.1 Cardial Comorbidity\n                1.1.1 Angina?\n                1.1.2 MI?\n              1.2 Vascular Comorbidity?\n              ...\n            Histopathology\n              Abdominal\n                pT category?\n              ...\n          </pre>\n    </div>"
  },
  "subjectType": [
    "Patient"
  ],
  "url": "http://hl7.org/fhir/Questionnaire/3141",
  "item": [
    {
      "linkId": "1",
      "code": [
        {
          "code": "COMORBIDITY",
          "system": "http://example.org/system/code/sections"
        }
      ],
      "type": "group",
      "item": [
        {
          "code": [
            {
              "code": "COMORB",
              "system": "http://example.org/system/code/questions"
            }
          ],
          "linkId": "1.1",
          "item": [
            {
              "linkId": "1.1.1",
              "code": [
                {
                  "code": "CARDIAL",
                  "system": "http://example.org/system/code/sections"
                }
              ],
              "type": "group",
              "enableWhen": [
                {
                  "answerCoding": {
                    "code": "Y",
                    "system": "http://hl7.org/fhir/v2/0136"
                  },
                  "question": "1.1"
                }
              ],
              "item": [
                {
                  "code": [
                    {
                      "code": "COMORBCAR",
                      "system": "http://example.org/system/code/questions"
                    }
                  ],
                  "linkId": "1.1.1.1",
                  "item": [
                    {
                      "linkId": "1.1.1.1.1",
                      "prefix": "1.1.1",
                      "code": [
                        {
                          "code": "COMCAR00",
                          "system": "http://example.org/system/code/questions",
                          "display": "Angina Pectoris"
                        },
                        {
                          "code": "194828000",
                          "system": "http://snomed.info/sct",
                          "display": "Angina (disorder)"
                        }
                      ],
                      "type": "choice",
                      "options": {
                        "reference": "http://hl7.org/fhir/ValueSet/yesnodontknow"
                      }
                    },
                    {
                      "linkId": "1.1.1.1.2",
                      "prefix": "1.1.2",
                      "code": [
                        {
                          "code": "22298006",
                          "system": "http://snomed.info/sct",
                          "display": "Myocardial infarction (disorder)"
                        }
                      ],
                      "type": "choice",
                      "options": {
                        "reference": "http://hl7.org/fhir/ValueSet/yesnodontknow"
                      }
                    }
                  ],
                  "prefix": "1.1",
                  "type": "choice",
                  "options": {
                    "reference": "http://hl7.org/fhir/ValueSet/yesnodontknow"
                  }
                },
                {
                  "linkId": "1.1.1.2",
                  "prefix": "1.2",
                  "code": [
                    {
                      "code": "COMORBVAS",
                      "system": "http://example.org/system/code/questions"
                    }
                  ],
                  "type": "choice",
                  "options": {
                    "reference": "http://hl7.org/fhir/ValueSet/yesnodontknow"
                  }
                }
              ]
            }
          ],
          "prefix": "1",
          "type": "choice",
          "options": {
            "reference": "http://hl7.org/fhir/ValueSet/yesnodontknow"
          }
        }
      ]
    },
    {
      "linkId": "2",
      "code": [
        {
          "code": "HISTOPATHOLOGY",
          "system": "http://example.org/system/code/sections"
        }
      ],
      "type": "group",
      "item": [
        {
          "linkId": "2.1",
          "code": [
            {
              "code": "ABDOMINAL",
              "system": "http://example.org/system/code/sections"
            }
          ],
          "type": "group",
          "item": [
            {
              "linkId": "2.1.2",
              "code": [
                {
                  "code": "STADPT",
                  "system": "http://example.org/system/code/questions",
                  "display": "pT category"
                }
              ],
              "type": "choice"
            }
          ]
        }
      ]
    }
  ],
  "date": "2012-01",
  "id": "3141"
}

Questionnaire Structure


  
{
  "resourceType" : "Questionnaire",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "url" : "<uri>", // Logical URI to reference this questionnaire (globally unique)
  "identifier" : [{ Identifier }], // Additional identifier for the questionnaire
  "version" : "<string>", // Business version of the questionnaire
  "name" : "<string>", // Name for this questionnaire (computer friendly)
  "title" : "<string>", // Name for this questionnaire (human friendly)
  "status" : "<code>", // R!  draft | active | retired | unknown
  "experimental" : <boolean>, // For testing purposes, not real usage
  "date" : "<dateTime>", // Date this was last changed
  "publisher" : "<string>", // Name of the publisher (organization or individual)
  "description" : "<markdown>", // Natural language description of the questionnaire
  "purpose" : "<markdown>", // Why this questionnaire is defined
  "approvalDate" : "<date>", // When the questionnaire was approved by publisher
  "lastReviewDate" : "<date>", // When the questionnaire was last reviewed
  "effectivePeriod" : { Period }, // When the questionnaire is expected to be used
  "useContext" : [{ UsageContext }], // Context the content is intended to support
  "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for questionnaire (if applicable)
  "contact" : [{ ContactDetail }], // Contact details for the publisher
  "copyright" : "<markdown>", // Use and/or publishing restrictions
  "code" : [{ Coding }], // Concept that represents the overall questionnaire
  "subjectType" : ["<code>"], // Resource that can be subject of QuestionnaireResponse
  "item" : [{ // C? Questions and sections within the Questionnaire
    "linkId" : "<string>", // R!  Unique id for item in questionnaire
    "definition" : "<uri>", // ElementDefinition - details for the item
    "code" : [{ Coding }], // C? 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>", // R!  group | display | boolean | decimal | integer | date | dateTime +
    "enableWhen" : [{ // Only allow data when
      "question" : "<string>", // R!  Question that determines whether item is enabled
      "hasAnswer" : <boolean>, // C? Enable when answered or not
      // answer[x]: Value question must have. One of these 12:
      "answerBoolean" : <boolean>
      "answerDecimal" : <decimal>
      "answerInteger" : <integer>
      "answerDate" : "<date>"
      "answerDateTime" : "<dateTime>"
      "answerTime" : "<time>"
      "answerString" : "<string>"
      "answerUri" : "<uri>"
      "answerAttachment" : { Attachment }
      "answerCoding" : { Coding }
      "answerQuantity" : { Quantity }
      "answerReference" : { Reference(Any) }
    }],
    "required" : <boolean>, // C? Whether the item must be included in data results
    "repeats" : <boolean>, // C? Whether the item may repeat
    "readOnly" : <boolean>, // C? Don't allow human editing
    "maxLength" : <integer>, // C? No more than this many characters
    "options" : { Reference(ValueSet) }, // C? Valueset containing permitted answers
    "option" : [{ // C? Permitted answer
      // value[x]: Answer value. One of these 5:
      "valueInteger" : <integer>
      "valueDate" : "<date>"
      "valueTime" : "<time>"
      "valueString" : "<string>"
      "valueCoding" : { Coding }
    }],
    // initial[x]: Default value when item is first rendered. One of these 12:
    "initialBoolean" : <boolean>,
    "initialDecimal" : <decimal>,
    "initialInteger" : <integer>,
    "initialDate" : "<date>",
    "initialDateTime" : "<dateTime>",
    "initialTime" : "<time>",
    "initialString" : "<string>",
    "initialUri" : "<uri>",
    "initialAttachment" : { Attachment },
    "initialCoding" : { Coding },
    "initialQuantity" : { Quantity },
    "initialReference" : { Reference(Any) },
    "item" : [{ Content as for Questionnaire.item }] // C? Nested questionnaire items
  }]
}

Questionnaire Search Parameters

The following search parameters can be used to query Questionnaire resources. Just submit them like so:

https://api.1up.health/fhir/stu3/Questionnaire?query-param=queryvalue

Search Parameter	Field Type	Resource Fields Searched
`code`	`text`	`item.code`
`date`	`date`	`date`
`description`	`text`	`description`
`effective`	`date`	`effectivePeriod`
`identifier`	`text`	`identifier`
`jurisdiction`	`text`	`jurisdiction`
`name`	`text`	`name`
`publisher`	`text`	`publisher`
`status`	`text`	`status`
`title`	`text`	`title`
`url`	`uri`	`url`
`version`	`text`	`version`