SADIE Developer and Tester Guide

Questionnaire

The Questionnaire resource stores the questionnaire/form definition this includes:

• Questions to be asked
• How they are ordered and grouped
• Any intervening instructional text
• Initial/default values for answers
• Constraints on answers:
  • Required
  • Maximum Length (String)
  • Maximum Value (Number, Date)
  • Minimum Length (String)
  • Minimum Value (Number, Date)
  • Belongs to a defined list
  • Specific format

FlexForm Questionnaire Profile

Dynamic Logic

Dynamic logic is added by using the enableWhenExpression extension.

{
    "url": "http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire-enableWhenExpression",
    "valueExpression": {
      "description": "Example rule name",
      "language": "text/fhirpath",
      "expression": ""
    }
}

Dynamic Logic Expression Examples

1. Combining “and” and “or” operators for complex expression

"expression": "(item.where(linkId='1tab').item.where(linkId='1card').item.where(linkId='1').item.where(linkId='1.1').answer.valueInteger > 5 and item.where(linkId='1tab').item.where(linkId='1card').item.where(linkId='1').item.where(linkId='1.2').answer.valueBoolean = true and (item.where(linkId='1tab').item.where(linkId='1card').item.where(linkId='1').item.where(linkId='1.3').answer.empty() or item.where(linkId='1tab').item.where(linkId='1card').item.where(linkId='1').item.where(linkId='1.3').answer.valueString != 'test') and item.where(linkId='1tab').item.where(linkId='1card').item.where(linkId='2').answer.valueInteger = 10) or item.where(linkId='1tab').item.where(linkId='1card').item.where(linkId='3').answer.valueBoolean = true"

2. Comparison using Two Dynamic Date Values and Date Arithmetic

"expression": "item.where(linkId='1tab').item.where(linkId='1card').item.where(linkId='8').answer.valueDate <= item.where(linkId='1tab').item.where(linkId='1card').item.where(linkId='6').answer.valueDate.toDateTime() - 1 month"

3. Comparison using Current Date and Date Arithmetic

"expression": "item.where(linkId='1tab').item.where(linkId='1card').item.where(linkId='8').answer.valueDate <= now() - 2 weeks"

4. Comparison using Date Literal

"expression": "item.where(linkId='1tab').item.where(linkId='1card').item.where(linkId='6').answer.valueDate <= @2020-12-25"

5. There must be Two Answers for a "repeats: true" Question Within an Integer Range

"expression": "item.where(linkId='1tab').item.where(linkId='1card').item.where(linkId='7').item.where(linkId='7.1').answer.where(valueInteger >= 1 and valueInteger <= 10).count() >= 2"

6. Case-insensitive String Comparison

"expression": "item.where(linkId='1tab').item.where(linkId='1card').item.where(linkId='5').answer.valueString ~ 'continue'"

Questionnaire Example