This page is part of the Structured Data Capture FHIR IG (v2.5.0: STU 3 Ballot 1) based on FHIR v3.5.0. The current version which supercedes this version is 3.0.0. For a full list of available versions, see the Directory of published versions
{ "resourceType" : "CapabilityStatement", "id" : "sdc-form-filler", "text" : { "status" : "generated", "div" : "<div xmlns="http://www.w3.org/1999/xhtml"> <h2>SDC Form Filler</h2> <p>(Requirements Definition)</p> <p>http://hl7.org/fhir/uv/sdc/CapabilityStatement/sdc-form-filler Published: 2014-07-06 (draft)</p> <p>Published by: <b>HL7 International - FHIR Infrastructure</b> </p> <p>This profile defines the expected capabilities of the <i>SDC Form Filler</i> role when conforming to the S&I Framework's <a href="index.html">Structured Data Capture FHIR implementation guide</a>. 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.</p> <p>Note that Form Fillers may also take on the role of <a href="sdc-form-archiver.html">Form Archiver</a> if they have a requirement to retain the completed version of a form (and potentially the source data that was used to complete it).</p> <h2>General</h2> <div class="table-wrapper"> <table> <tbody> <tr> <th>FHIR Version:</th> <td>$ver$</td> </tr> <tr> <th>Supported formats:</th> <td>xml, json</td> </tr> </tbody> </table> </div> <h2>REST behavior</h2> <p>The <a href="http://hl7.org/fhir/2018Sep/questionnaire.html">Questionnaire</a>, <a href="http://hl7.org/fhir/2018Sep/valueset.html">ValueSet</a> and <a href="http://hl7.org/fhir/2018Sep/codesystem.html">CodeSystem</a> resources are retrieved to allow the system to guide the user through the entry process. The <a href="http://hl7.org/fhir/2018Sep/binary.html">Binary</a> and <a href="http://hl7.org/fhir/2018Sep/documentreference.html">DocumentReference</a> 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 <i>Form Filler</i> itself.) Finally, the <a href="http://hl7.org/fhir/2018Sep/questionnaireresponse.html">QuestionnaireResponse</a> resource is used to record the populated form.</p> <p>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 <i>Form Response Manager</i> </p> <p> <b>Security:</b> </p> <p>Implementations must meet the general security requirements documented in the <a href="security.html">SDC implementation guide</a>.</p> <h3>Resource summary</h3> <div class="table-wrapper"> <table class="grid"> <thead> <tr> <th>Resource</th> <th>Search</th> <th>Read</th> <th>Read Version</th> <th>Instance History</th> <th>Resource History</th> <th>Create</th> <th>Update</th> <th>Delete</th> </tr> </thead> <tbody> <tr> <th>Questionnaire (<a href="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire.html">Profile</a>)</th> <td> <a href="#Questionnaire-search-type" title="Allows discovery of existing questionnaires to be completed">Yes</a> </td> <td> <a href="#Questionnaire-read" title="Allows retrieval of a specific questionnaire by id. Allows systems to maintain a 'favorites' list of forms and retrieve them by id.">Yes</a> </td> <td> <a href="#Questionnaire-vread" title="Allows retrieval of a historical version of a questionnaire. Most systems will make use of the current version only.">Yes</a> </td> <td> <a href="#Questionnaire-history-instance" title="Allows review of changes made to a questionnaire over time. Of interest to some systems, but probably not most.">Yes</a> </td> <td/> <td/> <td/> <td/> </tr> <tr> <th>ValueSet (<a href="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-valueset.html">Profile</a>)</th> <td/> <td> <a href="#ValueSet-read" title="Allows retrieval of a specific value set by id (as referenced in a Questionnaire)">Yes</a> </td> <td> <a href="#ValueSet-vread" title="Allows retrieval of a specific version of a value set (as referenced in a Questionnaire)">Yes</a> </td> <td> <a href="#ValueSet-history-instance" title="Allows review of changes to a value set over time. Of interest to some systems, but probably not most.">Yes</a> </td> <td/> <td/> <td/> <td/> </tr> <tr> <th>CodeSystem (<a href="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-codesystem.html">Profile</a>)</th> <td/> <td> <a href="#CodeSystem-read" title="Allows retrieval of a specific code system by id (as referenced by a ValueSet used in a Questionnaire)">Yes</a> </td> <td> <a href="#CodeSystem-vread" title="Allows retrieval of a specific version of a code system (as referenced by a ValueSet used in a Questionnaire)">Yes</a> </td> <td> <a href="#CodeSystem-history-instance" title="Allows review of changes to a code system over time. Of interest to some systems, but probably not most.">Yes</a> </td> <td/> <td/> <td/> <td/> </tr> <tr> <th>QuestionnaireResponse (<a href="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaireresponse.html">Profile</a>)</th> <td> <a href="#QuestionnaireResponse-search-type" title="Allows a user to search for existing completed or partially-completed forms. Generally used to find partially-completed forms for update.">Yes</a> </td> <td/> <td/> <td> <a href="#QuestionnaireResponse-history-instance" title="Allows review of prior versions of an answer set - allows reversion to previously recorded versions">Yes</a> </td> <td/> <td> <a href="#QuestionnaireResponse-create" title="Allows recording a completed or partially-completed form">Yes</a> </td> <td> <a href="#QuestionnaireResponse-update" title="Allows updating an existing completed or partially-completed form. (Systems may place rules on who can update forms and under what circumstances.)">Yes</a> </td> <td> <a href="#QuestionnaireResponse-delete" title="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.">Yes</a> </td> </tr> <tr> <th>DocumentReference</th> <td> <a href="#DocumentReference-search-type" title="Allows discovery of existing documents that may be included in a form pre-population request">Yes</a> </td> <td/> <td/> <td/> <td/> <td/> <td/> <td/> </tr> <tr> <th>Binary</th> <td/> <td> <a href="#Binary-read" title="Allows retrieval of a specific binary (as pointed to by a DocumentReference)">Yes</a> </td> <td> <a href="#Binary-vread" title="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.">Yes</a> </td> <td/> <td/> <td/> <td/> <td/> </tr> </tbody> </table> </div> <p> <b>Operations:</b> </p> <ul> <li> <a href="http://hl7.org/fhir/operationdefinition/valueset-expand">expand</a> </li> <li> <a href="http://hl7.org/fhir/operationdefinition/valueset-validate-code">expand</a> </li> <li> <a href="http://hl7.org/fhir/operationdefinition/questionnaire-populate">populate</a> </li> <li> <a href="http://hl7.org/fhir/operationdefinition/questionnaire-populatehtml">populatehtml</a> </li> <li> <a href="http://hl7.org/fhir/operationdefinition/questionnaire-populatelink">populatelink</a> </li> </ul> <br/> <br/> <h3> <a href="http://hl7.org/fhir/2018Sep/questionnaire.html">Questionnaire</a> </h3> <p>Profile: <a href="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire.html">http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaire</a> </p> <h4>Interactions</h4> <div class="table-wrapper"> <table class="list"> <thead> <tr> <th>Name</th> <th>Description</th> </tr> </thead> <tbody> <tr> <th> <a name="Questionnaire-search-type"> </a> <span>search-type</span> </th> <td> <p>Allows discovery of existing questionnaires to be completed</p> </td> </tr> <tr> <th> <a name="Questionnaire-read"> </a> <span>read</span> </th> <td> <p>Allows retrieval of a specific questionnaire by id. Allows systems to maintain a 'favorites' list of forms and retrieve them by id.</p> </td> </tr> <tr> <th> <a name="Questionnaire-history-instance"> </a> <span>history-instance</span> </th> <td> <p>Allows review of changes made to a questionnaire over time. Of interest to some systems, but probably not most.</p> </td> </tr> <tr> <th> <a name="Questionnaire-vread"> </a> <span>vread</span> </th> <td> <p>Allows retrieval of a historical version of a questionnaire. Most systems will make use of the current version only.</p> </td> </tr> </tbody> </table> </div> <br/> <br/> <h3> <a href="http://hl7.org/fhir/2018Sep/valueset.html">ValueSet</a> </h3> <p>Profile: <a href="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-valueset.html">http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-valueset</a> </p> <h4>Interactions</h4> <div class="table-wrapper"> <table class="list"> <thead> <tr> <th>Name</th> <th>Description</th> </tr> </thead> <tbody> <tr> <th> <a name="ValueSet-read"> </a> <span>read</span> </th> <td> <p>Allows retrieval of a specific value set by id (as referenced in a Questionnaire)</p> </td> </tr> <tr> <th> <a name="ValueSet-vread"> </a> <span>vread</span> </th> <td> <p>Allows retrieval of a specific version of a value set (as referenced in a Questionnaire)</p> </td> </tr> <tr> <th> <a name="ValueSet-history-instance"> </a> <span>history-instance</span> </th> <td> <p>Allows review of changes to a value set over time. Of interest to some systems, but probably not most.</p> </td> </tr> </tbody> </table> </div> <br/> <br/> <h3> <a href="http://hl7.org/fhir/2018Sep/codesystem.html">CodeSystem</a> </h3> <p>Profile: <a href="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-codesystem.html">http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-codesystem</a> </p> <h4>Interactions</h4> <div class="table-wrapper"> <table class="list"> <thead> <tr> <th>Name</th> <th>Description</th> </tr> </thead> <tbody> <tr> <th> <a name="CodeSystem-read"> </a> <span>read</span> </th> <td> <p>Allows retrieval of a specific code system by id (as referenced by a ValueSet used in a Questionnaire)</p> </td> </tr> <tr> <th> <a name="CodeSystem-vread"> </a> <span>vread</span> </th> <td> <p>Allows retrieval of a specific version of a code system (as referenced by a ValueSet used in a Questionnaire)</p> </td> </tr> <tr> <th> <a name="CodeSystem-history-instance"> </a> <span>history-instance</span> </th> <td> <p>Allows review of changes to a code system over time. Of interest to some systems, but probably not most.</p> </td> </tr> </tbody> </table> </div> <br/> <br/> <h3> <a href="http://hl7.org/fhir/2018Sep/questionnaireresponse.html">QuestionnaireResponse</a> </h3> <p>Profile: <a href="http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaireresponse.html">http://hl7.org/fhir/uv/sdc/StructureDefinition/sdc-questionnaireresponse</a> </p> <h4>Interactions</h4> <div class="table-wrapper"> <table class="list"> <thead> <tr> <th>Name</th> <th>Description</th> </tr> </thead> <tbody> <tr> <th> <a name="QuestionnaireResponse-search-type"> </a> <span>search-type</span> </th> <td> <p>Allows a user to search for existing completed or partially-completed forms. Generally used to find partially-completed forms for update.</p> </td> </tr> <tr> <th> <a name="QuestionnaireResponse-create"> </a> <span>create</span> </th> <td> <p>Allows recording a completed or partially-completed form</p> </td> </tr> <tr> <th> <a name="QuestionnaireResponse-update"> </a> <span>update</span> </th> <td> <p>Allows updating an existing completed or partially-completed form. (Systems may place rules on who can update forms and under what circumstances.)</p> </td> </tr> <tr> <th> <a name="QuestionnaireResponse-delete"> </a> <span>delete</span> </th> <td> <p>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.</p> </td> </tr> <tr> <th> <a name="QuestionnaireResponse-history-instance"> </a> <span>history-instance</span> </th> <td> <p>Allows review of prior versions of an answer set - allows reversion to previously recorded versions</p> </td> </tr> </tbody> </table> </div> <br/> <br/> <h3> <a href="http://hl7.org/fhir/2018Sep/documentreference.html">DocumentReference</a> </h3> <h4>Interactions</h4> <div class="table-wrapper"> <table class="list"> <thead> <tr> <th>Name</th> <th>Description</th> </tr> </thead> <tbody> <tr> <th> <a name="DocumentReference-search-type"> </a> <span>search-type</span> </th> <td> <p>Allows discovery of existing documents that may be included in a form pre-population request</p> </td> </tr> </tbody> </table> </div> <br/> <br/> <h3> <a href="http://hl7.org/fhir/2018Sep/binary.html">Binary</a> </h3> <h4>Interactions</h4> <div class="table-wrapper"> <table class="list"> <thead> <tr> <th>Name</th> <th>Description</th> </tr> </thead> <tbody> <tr> <th> <a name="Binary-read"> </a> <span>read</span> </th> <td> <p>Allows retrieval of a specific binary (as pointed to by a DocumentReference)</p> </td> </tr> <tr> <th> <a name="Binary-vread"> </a> <span>vread</span> </th> <td> <p>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.</p> </td> </tr> </tbody> </table> </div> </div>" }, "url" : "http://hl7.org/fhir/uv/sdc/CapabilityStatement/sdc-form-filler", "version" : "2.5.0", "name" : "SDC Form Filler", "status" : "draft", "date" : "2014-07-06", "publisher" : "HL7 International - FHIR Infrastructure", "contact" : [ { "telecom" : [ { "system" : "other", "value" : "http://wiki.siframework.org/Structured+Data+Capture+Initiative" } ] } ], "description" : "This profile defines the expected capabilities of the ''SDC Form Filler'' role when conforming to the S&I Framework's [[index|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 [[sdc-form-archiver|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", "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|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." } ] }, { "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" : "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" } ] }, { "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" : "expand", "definition" : "http://hl7.org/fhir/OperationDefinition/ValueSet-validate-code" }, { "extension" : [ { "url" : "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode" : "MAY" } ], "name" : "populate", "definition" : "http://hl7.org/fhir/OperationDefinition/Questionnaire-populate" }, { "extension" : [ { "url" : "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode" : "MAY" } ], "name" : "populatehtml", "definition" : "http://hl7.org/fhir/OperationDefinition/Questionnaire-populatehtml" }, { "extension" : [ { "url" : "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode" : "MAY" } ], "name" : "populatelink", "definition" : "http://hl7.org/fhir/OperationDefinition/Questionnaire-populatelink" } ] } ] }