Package | hl7.fhir.uv.sdc |
Type | CapabilityStatement |
Id | sdc-form-filler |
FHIR Version | R4 |
Source | http://hl7.org/fhir/uv/sdc/https://build.fhir.org/ig/HL7/sdc/CapabilityStatement-sdc-form-filler.html |
URL | http://hl7.org/fhir/uv/sdc/CapabilityStatement/sdc-form-filler |
Version | 4.0.0-ballot |
Status | active |
Date | 2014-07-06 |
Name | SDCFormFiller |
Title | SDC Form Filler |
Realm | uv |
Authority | hl7 |
Description | This profile defines the expected capabilities of the ''SDC Form Filler'' role when conforming to the S&I Framework's [[index.html|Structured Data Capture FHIR implementation guide]]. This role is responsible for retrieving pre-defined forms, requesting pre-population of forms and/or auto-populating forms, guiding the user through verifying populated data and submitting completed or partially-completed forms.<br/>Note that Form Fillers may also take on the role of [[CapabilityStatement-sdc-form-archiver.html|Form Archiver]] if they have a requirement to retain the completed version of a form (and potentially the source data that was used to complete it). |
Kind | requirements |
CapabilityStatement | |
SHCAppCapabilityStatement | SHC App |
OperationDefinition | |
Questionnaire-assemble | Assemble Modular Questionnaire Operation |
Questionnaire-populate | Populate Questionnaire |
Questionnaire-assemble | Assemble Modular Questionnaire Operation |
Questionnaire-populate | Populate Questionnaire |
StructureDefinition | |
sdc-codesystem | SDC Code System |
sdc-questionnaire | SDC Base Questionnaire |
sdc-questionnaireresponse | SDC Standard Questionnaire Response |
sdc-valueset | SDC Value Set |
sdc-codesystem | SDCCodeSystem |
sdc-questionnaire | SDCBaseQuestionnaire |
sdc-questionnaireresponse | SDC Questionnaire Response |
sdc-valueset | SDC ValueSet |
Note: links and images are rebased to the (stated) source
Generated Narrative: CapabilityStatement sdc-form-filler
xml
, json
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.
client
The [[Questionnaire]], [[ValueSet]] and [[CodeSystem]] resources are retrieved to allow the system to guide the user through the entry process. The [[Binary]] and [[DocumentReference]] resources allow the system to find existing clinical documents that can be within the pre-population process. (Support for retrieval operations on these resources is optional as the relevant CDA or FHIR structures may also be directly generated by the ''Form Filler'' itself.) Finally, the [[QuestionnaireResponse]] resource is used to record the populated form.<br/>Note: Form Fillers that support the 'populate' operation will need to be capable of consuming and rendering a partially completed QuestionnaireResponse in the same manner as if they had retrieved such a QuestionnaireResponse from a ''Form Response Manager''
Implementations must meet the general security requirements documented in the [[security.html|SDC implementation guide]].
The summary table lists the resources that are part of this configuration, and for each resource it lists:
_include
_revinclude
Resource Type | Profile | R | V-R | S | U | C | D | H-I | Searches | _include | _revinclude | Operations |
---|---|---|---|---|---|---|---|---|---|---|---|---|
Questionnaire | http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire | y | y | y | y | $populate , $assemble | ||||||
ValueSet | http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-valueset | y | y | y | ||||||||
CodeSystem | http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-codesystem | y | y | y | ||||||||
QuestionnaireResponse | http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaireresponse | y | y | y | y | y | y | $extract | ||||
DocumentReference | y | |||||||||||
Binary | y | y |
search-type
Allows discovery of existing questionnaires to be completed
read
Allows retrieval of a specific questionnaire by id. Allows systems to maintain a 'favorites' list of forms and retrieve them by id.
history-instance
Allows review of changes made to a questionnaire over time. Of interest to some systems, but probably not most.
vread
Allows retrieval of a historical version of a questionnaire. Most systems will make use of the current version only.
read
Allows retrieval of a specific value set by id (as referenced in a Questionnaire)
vread
Allows retrieval of a specific version of a value set (as referenced in a Questionnaire)
history-instance
Allows review of changes to a value set over time. Of interest to some systems, but probably not most.
read
Allows retrieval of a specific code system by id (as referenced by a ValueSet used in a Questionnaire)
vread
Allows retrieval of a specific version of a code system (as referenced by a ValueSet used in a Questionnaire)
history-instance
Allows review of changes to a code system over time. Of interest to some systems, but probably not most.
search-type
Allows a user to search for existing completed or partially-completed forms. Generally used to find partially-completed forms for update.
read
Allows retrieval of a specific QuestionnaireResponse by id.
create
Allows recording a completed or partially-completed form
update
Allows updating an existing completed or partially-completed form. (Systems may place rules on who can update forms and under what circumstances.)
delete
Allows removal of a completed form from a repository. Note that the removal may be logical rather than physical. Some systems may have rules for who can remove a completed form and under what circumstances.
history-instance
Allows review of prior versions of an answer set - allows reversion to previously recorded versions
Conformance | Operation | Documentation |
---|---|---|
MAY | $extract |
search-type
Allows discovery of existing documents that may be included in a form pre-population request
read
Allows retrieval of a specific binary (as pointed to by a DocumentReference)
vread
Allows retrieval of a historical version of a binary. In general, the most recent version would be appropriate, but some may prefer to use the specific version referenced by a DocumentReference.
{ "resourceType": "CapabilityStatement", "id": "sdc-form-filler", "text": { "status": "extensions", "div": "<!-- snip (see above) -->" }, "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg", "valueCode": "fhir" }, { "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm", "valueInteger": 4, "_valueInteger": { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom", "valueCanonical": "http://hl7.org/fhir/uv/sdc/ImplementationGuide/hl7.fhir.uv.sdc" } ] } }, { "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status", "valueCode": "trial-use", "_valueCode": { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom", "valueCanonical": "http://hl7.org/fhir/uv/sdc/ImplementationGuide/hl7.fhir.uv.sdc" } ] } } ], "url": "http://hl7.org/fhir/uv/sdc/CapabilityStatement/sdc-form-filler", "version": "4.0.0-ballot", "name": "SDCFormFiller", "title": "SDC Form Filler", "status": "active", "date": "2014-07-06", "publisher": "HL7 International / FHIR Infrastructure", "contact": [ { "name": "HL7 International / FHIR Infrastructure", "telecom": [ { "system": "url", "value": "http://www.hl7.org/Special/committees/fiwg" } ] }, { "telecom": [ { "system": "url", "value": "http://www.hl7.org/Special/committees/fiwg" } ] } ], "description": "This profile defines the expected capabilities of the ''SDC Form Filler'' role when conforming to the S&I Framework's [[index.html|Structured Data Capture FHIR implementation guide]]. This role is responsible for retrieving pre-defined forms, requesting pre-population of forms and/or auto-populating forms, guiding the user through verifying populated data and submitting completed or partially-completed forms.<br/>Note that Form Fillers may also take on the role of [[CapabilityStatement-sdc-form-archiver.html|Form Archiver]] if they have a requirement to retain the completed version of a form (and potentially the source data that was used to complete it).", "jurisdiction": [ { "coding": [ { "system": "http://unstats.un.org/unsd/methods/m49/m49.htm", "code": "001", "display": "World" } ] } ], "kind": "requirements", "fhirVersion": "1.0.0", "format": [ "xml", "json" ], "rest": [ { "mode": "client", "documentation": "The [[Questionnaire]], [[ValueSet]] and [[CodeSystem]] resources are retrieved to allow the system to guide the user through the entry process. The [[Binary]] and [[DocumentReference]] resources allow the system to find existing clinical documents that can be within the pre-population process. (Support for retrieval operations on these resources is optional as the relevant CDA or FHIR structures may also be directly generated by the ''Form Filler'' itself.) Finally, the [[QuestionnaireResponse]] resource is used to record the populated form.<br/>Note: Form Fillers that support the 'populate' operation will need to be capable of consuming and rendering a partially completed QuestionnaireResponse in the same manner as if they had retrieved such a QuestionnaireResponse from a ''Form Response Manager''", "security": { "description": "Implementations must meet the general security requirements documented in the [[security.html|SDC implementation guide]]." }, "resource": [ { "type": "Questionnaire", "profile": "http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire", "interaction": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHALL" } ], "code": "search-type", "documentation": "Allows discovery of existing questionnaires to be completed" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "code": "read", "documentation": "Allows retrieval of a specific questionnaire by id. Allows systems to maintain a 'favorites' list of forms and retrieve them by id." }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "MAY" } ], "code": "history-instance", "documentation": "Allows review of changes made to a questionnaire over time. Of interest to some systems, but probably not most." }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "MAY" } ], "code": "vread", "documentation": "Allows retrieval of a historical version of a questionnaire. Most systems will make use of the current version only." } ], "operation": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "MAY" } ], "name": "populate", "definition": "http://hl7.org/fhir/uv/sdc/OperationDefinition/Questionnaire-populate" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "MAY" } ], "name": "assemble", "definition": "http://hl7.org/fhir/uv/sdc/OperationDefinition/Questionnaire-assemble" } ] }, { "type": "ValueSet", "profile": "http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-valueset", "interaction": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHALL" } ], "code": "read", "documentation": "Allows retrieval of a specific value set by id (as referenced in a Questionnaire)" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "code": "vread", "documentation": "Allows retrieval of a specific version of a value set (as referenced in a Questionnaire)" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "MAY" } ], "code": "history-instance", "documentation": "Allows review of changes to a value set over time. Of interest to some systems, but probably not most." } ] }, { "type": "CodeSystem", "profile": "http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-codesystem", "interaction": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHALL" } ], "code": "read", "documentation": "Allows retrieval of a specific code system by id (as referenced by a ValueSet used in a Questionnaire)" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "code": "vread", "documentation": "Allows retrieval of a specific version of a code system (as referenced by a ValueSet used in a Questionnaire)" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "MAY" } ], "code": "history-instance", "documentation": "Allows review of changes to a code system over time. Of interest to some systems, but probably not most." } ] }, { "type": "QuestionnaireResponse", "profile": "http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaireresponse", "interaction": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHALL" } ], "code": "search-type", "documentation": "Allows a user to search for existing completed or partially-completed forms. Generally used to find partially-completed forms for update." }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHALL" } ], "code": "read", "documentation": "Allows retrieval of a specific QuestionnaireResponse by id." }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHALL" } ], "code": "create", "documentation": "Allows recording a completed or partially-completed form" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHALL" } ], "code": "update", "documentation": "Allows updating an existing completed or partially-completed form. (Systems may place rules on who can update forms and under what circumstances.)" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHALL" } ], "code": "delete", "documentation": "Allows removal of a completed form from a repository. Note that the removal may be logical rather than physical. Some systems may have rules for who can remove a completed form and under what circumstances." }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "code": "history-instance", "documentation": "Allows review of prior versions of an answer set - allows reversion to previously recorded versions" } ], "operation": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "MAY" } ], "name": "extract", "definition": "hhttp://hl7.org/fhir/uv/sdc/OperationDefinition/QuestionnaireResponse-extract" } ] }, { "type": "DocumentReference", "interaction": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "code": "search-type", "documentation": "Allows discovery of existing documents that may be included in a form pre-population request" } ] }, { "type": "Binary", "interaction": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "code": "read", "documentation": "Allows retrieval of a specific binary (as pointed to by a DocumentReference)" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "MAY" } ], "code": "vread", "documentation": "Allows retrieval of a historical version of a binary. In general, the most recent version would be appropriate, but some may prefer to use the specific version referenced by a DocumentReference." } ] } ], "operation": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "name": "expand", "definition": "http://hl7.org/fhir/OperationDefinition/ValueSet-expand" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "name": "validate code", "definition": "http://hl7.org/fhir/OperationDefinition/ValueSet-validate-code" } ] } ] }