Structured Data Capture
2.8.0 - CI Build

Structured Data Capture, published by HL7 International - FHIR Infrastructure Work Group. This is not an authorized publication; it is the continuous build for version 2.8.0). This version is based on the current content of https://github.com/HL7/sdc/ and changes regularly. See the Directory of published versions

IG Change History

This provides a list of changes to the SDC specification since its initial release

2021-10-31 v3.0.0 - SDC R3 Official Publication based on FHIR R4 (STU)

  • Updated to reflect FHIR version 4.0.1, including new publishing framework and template (with specific template version)
    • To support this template change, numerous other changes are performed
  • Converted profiles, extensions, and other structure definitions to XML format
  • Added a 'credits' section and provided differentiation with IHE
  • Replaced sdc-questionnaire-extract with three profiles for each extraction mechanism:
    • sdc-questionnaire-extr-obsn (Observation-based)
    • sdc-questionnaire-extr-defn (Definition-based), and
    • sdc-questionnaire-extr-smap (StructureMap-based)
  • Created three profiles for each population mechanism:
    • sdc-questionnaire-pop-obsn (Observation-based)
    • sdc-questionnaire-pop-exp (Expression-based), and
    • sdc-questionnaire-pop-smap (StructureMap-based)
  • Other new profiles created are:
    • sdc-task to define how Task is used to ask for a Questionnaire to be completed
    • sdc-servicerequest to define how ServiceRequest is used to ask for a Questionnaire to be completed
    • sdc-library that defines how a Library is used as a logic computable library within the ONC's Structured Data Capture standard
  • Clarified approaches for population and extraction mechanisms
  • Created various new extensions, some of them are explained as follows:
    • sdc-questionnaire-performerType to indicate the types of resources that can record answers to a Questionnaire
    • Two extensions for the inclusive upper and lower bound on the range of allowed values for a ‘quantity’ type question
    • An extension to indicate if a questionnaire is adaptive
    • Migrated two image extensions from CPG specification to support visual accompaniment to the question and response
    • Added two extensions to support observation-based extraction
  • Updated many profiles, clarified the scope and usage of the profiles, and added new examples to the profiles (based on submitted Change requests)
  • Several updates or enhancements to the documentation text to improve clarity

2019-03-29 v2.7.0 - SDC R3 (STU ballot 1) Ballot Candidate based on FHIR R4 (STU) ballot candidate

  • Updated to reflect final version of R4, including migration of a number of extensions from core to the SDC specification
  • Introduction of several new extensions to support population and extraction
  • Clean-up of the specification and completion of description of the rendering and flow control pages
  • Numerous other changes based on submitted Change requests

2018-08-31 v2.5.0 - SDC Edition 3 (Draft) Ballot Candidate based on FHIR R4 (STU) ballot candidate

  • Updated to reflect changes to the Questionnaire, QuestionnaireResponse and ValueSet resources including alignment of data elements and search criteria. Significant changes include:
    • Renaming of option and options to answerOption and answerValueSet
    • revamping enableWhen to have an operator
    • Additional metadata elements have been added to Questionnaire and a few elements have been renamed
    • The deReference extension has been replaced by Questionnaire.item.definition
    • Sort order of elements has shifted in all resources to better align with other definitional resources
  • Removed the data element profile and the focus on using independently maintained data elements as a mechanism for population, including the use of the deMap extension
  • Changed the realm from 'us' to 'uv' as there are no longer any US-specific constraints
  • Revamped population mechanisms to focus on FHIR-based population leveraging mechanisms found useful in existing production systems
  • Added support for extracting information from a QuestionnaireResponse into FHIR resources including a new operation
  • Added support for adaptive questionnaires, including a new operation and new profiles for Questionnaire and QuestionnaireResponse
  • Split the sdc-questionnaire profile into multiple profiles:
    • sdc-questionnaire which focuses on base capabilities, discoverability and core workflow
    • sdc-questionaire-render which focuses on advanced rendering and formatting control
    • sdc-questionaire-behave which focuses on advanced behavioral controls and calculations
    • sdc-questionaire-populate which focuses on elements supporting questionnaire population
    • sdc-questionaire-extract which focuses on elements supporting data extraction
  • Added new extensions to support form population
  • Reorganized the implementation guide such that each set of behavior is described in a separate section

2017-03-20 v2.0 - SDC R2 (STU) Official Publication based on FHIR R3 (STU)

  • Updated to reflect changes to the Questionnaire, QuestionnaireResponse and ValueSet resources including alignment of data elements and search criteria. Significant changes include:
    • Questionnaire.item.linkId is now mandatory on all elements (including display items)
    • Additional metadata elements have been added to Questionnaire and a few elements have been renamed
    • The deReference extension has been replaced by Questionnaire.item.definition
    • Sort order of elements has shifted in all resources to better align with other definitional resources
  • Revamped the look & feel of the profiles to make them easier to navigate and place descriptive text "in context" and changed the menu to make it easier to access IG content
  • Renamed the sdc-response profile to sdc-questionnaireresponse and sdc-element to sdc-dataelement to be clearer and avoid confusion
  • Renamed the conformance resources to no longer start with "conformance-" to avoid unnecessary redundancy
  • Clarified and revamped the Form Archiver and Form Receiver to more closely align with the equivalent IHE roles. Specifically, clarified that archiver is write-only. Changed receiver from exposing QuestionnaireResponses as read-write to only consuming responses via a new operation - process-response
  • Introduced a new capability statement called SDC Form Response Manager that builds on SDC Form Manager to provide read/write support for QuestionnaireResponses.
  • Added additional optional populate and terminology operations to the Form Filler and Form Manager
  • Changed DataElement.element to 1..* instead of 1..1 to support the use of Questionnaires with complex data types (e.g. addresses)
  • Changed DataElement.element.definition from 1..1 to 0..1
  • Added a rule that the reference from a Questionnaire to a QuestionnaireResponse must be version-specific
  • Various changes to the documentation text to improve clarity and add implementation guidance
  • Re-organized pages to have table of contents as the root (which resulted in renumbering of sections)

2016-08-11 v1.6 - SDC R2 (STU) Ballot Candidate based on FHIR R3 (STU) ballot candidate

  • Updated to reflect changes to the Questionnaire, QuestionnaireResponse and ValueSet resources including alignment of data elements and search criteria. Significant changes include:
    • Migrated the previous questionnaire-enableWhen, questionnaire-defaultValue (became initialValue), questionnaire-label (became prefix), questionnaire-readOnly, questionnaire-maxLength and questionnaire-category (now 0..*) extensions to be part of the Questionnaire resource's core elements
    • Refactored Questionnaire to allow both groups and questions to be treated as "items" and introduced the notion of "text" items. This allows for a number of Questionnaire designs to be simplified, allows new capabilities and altered which extensions were needed. (questionnaire-questionControl -> questionnaire-itemControl, and questionnaire-instruction, -security, -help, -tooltip, -trailing, -units, -lowRangeLabel and -highRangeLabel all become items of type "text" with a corresponding questionnaire-itemControl code to differentiate them)
    • Added support for additional data types for Questionnaire.item.options
    • Questionnaire now has a mandatory "url" to capture the canonical URL for the Questionnaire
  • Added support for two new "populate" operations - populatehtml and populatelink operations
  • Added a profile for the new CodeSystem resource which has now been split out from ValueSet. The new profile reflects the constraints and extensions that have been moved over from the SDC Valueset profile
  • In the SDC Base Questionnaire profile, Item.required and Item.repeats are no longer 1..1, so they can be omitted if their value is the default - false
  • Added references to a number of new extensions:
    • questionnaire-supportLink - allows linking a questionnaire item to a web page, PDF or other artifact that gives supporting information
    • questionnaire-sourceStructureMap - allows linking a questionnaire to a StructureMap that provides a computable mapping between a data source and QuestionnaireResponses for that Questionnaire
    • questionnaire-usageMode - allows flagging a questionnaire item to indicate whether it should be displayed only when capturing data, when displaying a completed questionnaire or both
    • questionnaire-studyProtocolIdentifier - allows linking a Questionnaire to the study protocol it's associated with
    • questionnaire-allowedProfile - allows questions of type Reference to identify a FHIR profile that must be satisfied by any referenced resource
    • questionnaire-ordinalValue - allows capturing a numeric value associated with a code allowed as the answer to a question
    • questionnaire-optionPrefix - allows capturing the label (e.g. "(a)", "(ii)", etc.) for an option in a list of options for a question
    • questionnaire-unit - allows capturing the computable units associated with a question whose answer is asimple decimal or integer
    • questionnaire-referenceFilter - allows specifying a query to use when looking up allowed answers for a question of type Reference

2015-10-24 v1.0 - SDC R2 (DSTU) Official Publication based on FHIR R2 (DSTU) publication

  • First official release