This page is part of the Structured Data Capture FHIR IG (v1.6: STU 2 Ballot 1) based on FHIR v1.6.0. . For a full list of available versions, see the Directory of published versions

This is a pre-release of a future version of SDC (expected to be STU 2). The current version is STU 2.
For a full list of available versions, see the Directory of published versions .

4 SDC Form Filler - json

(back to narrative)

Raw json

{
  "resourceType" : "Conformance",
  "id" : "conformance-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>Published: 2014-07-06 (draft)</p>
      <p>Published by: <b>U.S. Office of the National Coordinator (ONC)</b>
      </p>
      <p>This profile defines the expected capabilities of the <i>SDC Form Filler</i> role when conforming to the S&amp;I Framework's <a href="sdc.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="conformance-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>
      <table>
        <tbody>
          <tr>
            <th>FHIR Version:</th>
            <td>$ver$</td>
          </tr>
          <tr>
            <th>Supported formats:</th>
            <td>xml, json</td>
          </tr>
        </tbody>
      </table>
      <h2>REST  behavior</h2>
      <p>The <a href="http://hl7.org/fhir/2016Sep/questionnaire.html">Questionnaire</a>, <a href="http://hl7.org/fhir/2016Sep/valueset.html">ValueSet</a> and <a href="http://hl7.org/fhir/2016Sep/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/2016Sep/binary.html">Binary</a> and <a href="http://hl7.org/fhir/2016Sep/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/2016Sep/questionnaireresponse.html">QuestionnaireResponse</a> resource is used to record the populated form.</p>
      <p>
        <b>Security:</b>
      </p>
      <p>Implementations must meet the general security requirements documented in the <a href="sdc-security.html">SDC implementation guide</a>.</p>
      <h3>Resource summary</h3>
      <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/StructureDefinition/sdc-questionnaire">Profile</a>)</th>
            <td>
              <a href="#Questionnaire-search-type" title="Allows discovery of existing questionnaires to be completed">SHALL</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.">SHOULD</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.">MAY</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.">MAY</a>
            </td>
            <td/>
            <td/>
            <td/>
            <td/>
          </tr>
          <tr>
            <th>ValueSet (<a href="http://hl7.org/fhir/StructureDefinition/sdc-valueset">Profile</a>)</th>
            <td/>
            <td>
              <a href="#ValueSet-read" title="Allows retrieval of a specific value set by id (as referenced in a Questionnaire)">SHALL</a>
            </td>
            <td>
              <a href="#ValueSet-vread" title="Allows retrieval of a specific version of a value set (as referenced in a Questionnaire)">SHOULD</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.">MAY</a>
            </td>
            <td/>
            <td/>
            <td/>
            <td/>
          </tr>
          <tr>
            <th>CodeSystem (<a href="http://hl7.org/fhir/StructureDefinition/sdc-codesystem">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)">SHALL</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)">SHOULD</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.">MAY</a>
            </td>
            <td/>
            <td/>
            <td/>
            <td/>
          </tr>
          <tr>
            <th>QuestionnaireResponse (<a href="http://hl7.org/fhir/StructureDefinition/sdc-element">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.">SHALL</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">SHOULD</a>
            </td>
            <td/>
            <td>
              <a href="#QuestionnaireResponse-create" title="Allows recording a completed or partially-completed form">SHALL</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.)">SHALL</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.">SHALL</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">SHOULD</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)">SHOULD</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.">MAY</a>
            </td>
            <td/>
            <td/>
            <td/>
            <td/>
            <td/>
          </tr>
        </tbody>
      </table>
      <p>
        <b>Operations:</b>
        <a href="http://hl7.org/fhir/OperationDefinition/questionnaire-populate" title="Populate Questionnaire">populate</a> MAY</p>
      <br/>
      <br/>
      <h3>
        <a href="http://hl7.org/fhir/2016Sep/questionnaire.html">Questionnaire</a>
      </h3>
      <h4>Interactions</h4>
      <table class="list">
        <thead>
          <tr>
            <th>Name</th>
            <th>Conformance</th>
            <th>Description</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <th>
              <a name="Questionnaire-search-type"> </a>
              <span>search-type</span>
            </th>
            <td>SHALL</td>
            <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>SHOULD</td>
            <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>MAY</td>
            <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>MAY</td>
            <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>
      <br/>
      <br/>
      <h3>
        <a href="http://hl7.org/fhir/2016Sep/valueset.html">ValueSet</a>
      </h3>
      <h4>Interactions</h4>
      <table class="list">
        <thead>
          <tr>
            <th>Name</th>
            <th>Conformance</th>
            <th>Description</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <th>
              <a name="ValueSet-read"> </a>
              <span>read</span>
            </th>
            <td>SHALL</td>
            <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>SHOULD</td>
            <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>MAY</td>
            <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>
      <br/>
      <br/>
      <h3>
        <a href="http://hl7.org/fhir/2016Sep/codesystem.html">CodeSystem</a>
      </h3>
      <h4>Interactions</h4>
      <table class="list">
        <thead>
          <tr>
            <th>Name</th>
            <th>Conformance</th>
            <th>Description</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <th>
              <a name="CodeSystem-read"> </a>
              <span>read</span>
            </th>
            <td>SHALL</td>
            <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>SHOULD</td>
            <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>MAY</td>
            <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>
      <br/>
      <br/>
      <h3>
        <a href="http://hl7.org/fhir/2016Sep/questionnaireresponse.html">QuestionnaireResponse</a>
      </h3>
      <h4>Interactions</h4>
      <table class="list">
        <thead>
          <tr>
            <th>Name</th>
            <th>Conformance</th>
            <th>Description</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <th>
              <a name="QuestionnaireResponse-search-type"> </a>
              <span>search-type</span>
            </th>
            <td>SHALL</td>
            <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>SHALL</td>
            <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>SHALL</td>
            <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>SHALL</td>
            <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>SHOULD</td>
            <td>
              <p>Allows review of prior versions of an answer set - allows reversion to previously recorded versions</p>
            </td>
          </tr>
        </tbody>
      </table>
      <br/>
      <br/>
      <h3>
        <a href="http://hl7.org/fhir/2016Sep/documentreference.html">DocumentReference</a>
      </h3>
      <h4>Interactions</h4>
      <table class="list">
        <thead>
          <tr>
            <th>Name</th>
            <th>Conformance</th>
            <th>Description</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <th>
              <a name="DocumentReference-search-type"> </a>
              <span>search-type</span>
            </th>
            <td>SHOULD</td>
            <td>
              <p>Allows discovery of existing documents that may be included in a form pre-population request</p>
            </td>
          </tr>
        </tbody>
      </table>
      <br/>
      <br/>
      <h3>
        <a href="http://hl7.org/fhir/2016Sep/binary.html">Binary</a>
      </h3>
      <h4>Interactions</h4>
      <table class="list">
        <thead>
          <tr>
            <th>Name</th>
            <th>Conformance</th>
            <th>Description</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <th>
              <a name="Binary-read"> </a>
              <span>read</span>
            </th>
            <td>SHOULD</td>
            <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>MAY</td>
            <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>"
  },
  "name" : "SDC Form Filler",
  "status" : "draft",
  "date" : "2014-07-06",
  "publisher" : "U.S. Office of the National Coordinator (ONC)",
  "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 [[sdc|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 [[conformance-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",
  "acceptUnknown" : "extensions",
  "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.",
      "security" : {
        "description" : "Implementations must meet the general security requirements documented in the [[sdc-security|SDC implementation guide]]."
      },
      "resource" : [
        {
          "type" : "Questionnaire",
          "profile" : {
            "reference" : "http://hl7.org/fhir/StructureDefinition/sdc-questionnaire"
          },
          "interaction" : [
            {
              "extension" : [
                {
                  "url" : "http://hl7.org/fhir/StructureDefinition/conformance-expectation",
                  "valueCode" : "SHALL"
                }
              },
              "code" : "search-type",
              "documentation" : "Allows discovery of existing questionnaires to be completed"
            },
            {
              "extension" : [
                {
                  "url" : "http://hl7.org/fhir/StructureDefinition/conformance-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/conformance-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/conformance-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" : {
            "reference" : "http://hl7.org/fhir/StructureDefinition/sdc-valueset"
          },
          "interaction" : [
            {
              "extension" : [
                {
                  "url" : "http://hl7.org/fhir/StructureDefinition/conformance-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/conformance-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/conformance-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" : {
            "reference" : "http://hl7.org/fhir/StructureDefinition/sdc-codesystem"
          },
          "interaction" : [
            {
              "extension" : [
                {
                  "url" : "http://hl7.org/fhir/StructureDefinition/conformance-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/conformance-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/conformance-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" : {
            "reference" : "http://hl7.org/fhir/StructureDefinition/sdc-element"
          },
          "interaction" : [
            {
              "extension" : [
                {
                  "url" : "http://hl7.org/fhir/StructureDefinition/conformance-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/conformance-expectation",
                  "valueCode" : "SHALL"
                }
              },
              "code" : "create",
              "documentation" : "Allows recording a completed or partially-completed form"
            },
            {
              "extension" : [
                {
                  "url" : "http://hl7.org/fhir/StructureDefinition/conformance-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/conformance-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/conformance-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/conformance-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/conformance-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/conformance-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/conformance-expectation",
              "valueCode" : "MAY"
            }
          },
          "name" : "populate",
          "definition" : {
            "reference" : "http://hl7.org/fhir/OperationDefinition/questionnaire-populate",
            "display" : "Populate Questionnaire"
          }
        }
      }
    }
  }
}