Structured Data Capture
4.0.0-ballot - STU 4 ballot International flag

This page is part of the Structured Data Capture FHIR IG (v4.0.0-ballot: STU 4 Ballot 1) based on FHIR (HL7® FHIR® Standard) R4. The current version which supersedes this version is 3.0.0. For a full list of available versions, see the Directory of published versions

CapabilityStatement: SDC Form Manager

Official URL: http://hl7.org/fhir/uv/sdc/CapabilityStatement/sdc-form-manager Version: 4.0.0-ballot
Standards status: Trial-use Maturity Level: 4 Computable Name: SDCFormManager
Other Identifiers: OID:2.16.840.1.113883.4.642.40.17.13.4

This profile defines the expected capabilities of the ''SDC Form Manager'' role when conforming to the S&I Framework's [[index.html Structured Data Capture FHIR implementation guide]]. This role is responsible for maintaining a repository of form definitions and also of performing pre-population of form data.

Raw OpenAPI-Swagger Definition file | Download

Generated Narrative: CapabilityStatement sdc-form-manager

SDC Form Manager

  • Implementation Guide Version: 4.0.0-ballot
  • FHIR Version: 1.0.0
  • Supported Formats: xml, json
  • Supported Patch Formats:
  • Published on: 2014-07-06
  • Published by: HL7 International / FHIR Infrastructure

Note to Implementers: FHIR Capabilities

Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

FHIR RESTful Capabilities

Mode: server

The primary focus of the repository is the definition of [[Questionnaire]]s. However, [[ValueSet]]s and [[CodeSystem]]s must also be supported to allow definition of coded data elements. Some data elements will choose to maintain value sets as 'contained' resources, meaning the value set exists only in the context of the data element and cannot be referenced or maintained without also updating the data element. However, systems should support value set re-use across data elements. (Version-specific referencing can be used to avoid value sets from changing independent of the referencing [[Questionnaire]].)

Security

Implementations must meet the general security requirements documented in the [[security.html|SDC implementation guide]].

Summary of System-wide Interactions

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

  • The relevant profiles (if any)
  • The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
  • The required, recommended, and some optional search parameters (if any).
  • The linked resources enabled for _include
  • The other resources enabled for _revinclude
  • The operations on the resource (if any)
Resource TypeProfileRV-RSUCDH-ISearches_include_revincludeOperations
Questionnairehttp://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaireyyyyyyycode, context, date, identifier, publisher, status, title, version, definitionQuestionnaire.group.question.options
CodeSystemhttp://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-codesystemyyyyyyycode, date, description, name, status, system, url, assembledFrom, assemble-expectation
ValueSethttp://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-valuesetyyyyyyydate, description, name, reference, statusValueSet.compose.import

Resource Conformance: SHALL Questionnaire

Base System Profile
SDC Base Questionnaire
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support
    search-type

    Allows a user to search for existing forms

    read

    Allows retrieval of a specific known form

    vread

    Allows retrieval of a specific version of a form

    history-instance

    Allows review of changes to a form over time

    create

    Allows defining a new form. Repositories requiring curation of submitted forms may require all new data elements to have a status of 'draft'.

    update

    Allows an existing form to be updated. Servers may choose to prohibit certain types of edits, instead requiring the creation of a new questionnaire (and potentially the retiring of the existing questionnaire). Servers may also limit who can change particular forms.

  • MAY support
    delete

    Allows removal of an existing form. Servers may choose to not support deletions and instead require that the form's status be changed to 'retired'. Other systems support deletions but limit them to forms meeting certain requirements. E.g. only forms with a status of draft or only forms that have been retired for at least two years, etc.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLcodetoken
SHALLcontexttoken
SHALLdatedate
SHALLidentifiertoken
SHALLpublisherstring
SHALLstatustoken
SHALLtitlestring
SHALLversiontoken
SHALLdefinitiontoken
 

Resource Conformance: SHALL CodeSystem

Base System Profile
SDC Code System
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support
    search-type

    Allows discovery of existing code systems for use in authoring questionnaires

    read

    Allows retrieval of a specific code system referenced within a questionnaire

    vread

    Allows retrieval of a historical version of a code system as referenced within a questionnaire

    history-instance

    Allows review of changes to a code system over time

    create

    Allows definition of a new code system used by one or more questionnaires

    update

    Allows existing code systems referenced by one or more questionnaires to be maintained

  • MAY support
    delete

    Not all servers will support deletion of code systems. Status change to 'retired' will be more typical, though deletion of draft code systems may keep repositories cleaner.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLcodetoken
SHALLdatedate
SHALLdescriptionstring
SHALLnamestring
SHALLstatustoken
SHALLsystemuri
SHALLurluri
SHOULDassembledFromtoken
SHOULDassemble-expectationtoken
 

Resource Conformance: SHALL ValueSet

Base System Profile
SDC Value Set
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support
    search-type

    Allows discovery of existing value sets for use in authoring questionnaires

    read

    Allows retrieval of a specific value set referenced within a questionnaire

    vread

    Allows retrieval of a historical version of a value set as referenced within a questionnaire

    history-instance

    Allows review of changes to a value set over time

    create

    Allows definition of a new value set used by one or more questionnaires

    update

    Allows existing value sets referenced by one or more questionnaires to be maintained

  • MAY support
    delete

    Not all servers will support deletion of value sets. Status change to 'retired' will be more typical, though deletion of draft value sets may keep repositories cleaner.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLdatedate
SHALLdescriptionstring
SHALLnamestring
SHALLreferenceuri
SHALLstatustoken
 

Operations

Use