Structured Data Capture
3.0.0 - STU 3 International flag

This page is part of the Structured Data Capture FHIR IG (v3.0.0: STU 3) based on FHIR R4. This is the current published version. For a full list of available versions, see the Directory of published versions

: Questionnaire process response - XML Representation

Page standards status: Trial-use Maturity Level: 3

Raw xml | Download



<OperationDefinition xmlns="http://hl7.org/fhir">
  <id value="Questionnaire-process-response"/>
  <text>
    <status value="extensions"/>
    <div xmlns="http://www.w3.org/1999/xhtml"><h2>SDCQuestionnaireProcessResponse</h2><p>OPERATION: SDCQuestionnaireProcessResponse</p><p>The official URL for this operation definition is: </p><pre>http://hl7.org/fhir/uv/sdc/OperationDefinition/Questionnaire-process-response</pre><div><p>This operation allows a system to 'receive' a QuestionnaireResponse for a particular Questionnaire.  It is intended to be used by systems that expect to receive completed questionnaires but which do not necessarily want to host a RESTful endpoint where those responses are subsequently queryable.  The receiver may choose to perform validation of the received response or against local business rules.  There no response beyond an HTTP 200 OK if the response is consumed successfully, though an OperationOutcome can optionally be returned identifying warnings.  If there are validation or other issues, the operation will fail with details in an OperationOutcome.  The specific action that occurs on receipt of a form will depend on both the type of form and the submitter.  It could trigger admission to a clinical trial, the beginning of an product investigation, the consideration of a patient's eligibility for coverage, etc.  Alternatively, the data may simply be consumed and aggregated with other information for analysis or other use.</p>
</div><p>URL: [base]/Questionnaire/$process-response</p><p>URL: [base]/Questionnaire/[id]/$process-response</p><p>Input parameters Profile: <a href="StructureDefinition-parameters-questionnaire-process-response-in.html">Questionnaire process response operation input parameters</a></p><p>Parameters</p><table class="grid"><tr><td><b>Use</b></td><td><b>Name</b></td><td><b>Cardinality</b></td><td><b>Type</b></td><td><b>Binding</b></td><td><b>Documentation</b></td></tr><tr><td>IN</td><td>response</td><td>1..1</td><td><a href="http://hl7.org/fhir/R4/questionnaireresponse.html">QuestionnaireResponse</a></td><td/><td><div><p>The questionnaire response to be accepted/processed</p>
</div></td></tr><tr><td>OUT</td><td>warnings</td><td>0..1</td><td><a href="http://hl7.org/fhir/R4/operationoutcome.html">OperationOutcome</a></td><td/><td><div><p>If the response is successfully procssed, an OperationOutcome may still be returned indicating warnings.  For example, identifying questions that were incomplete, answers that were defaulted, etc.  It may also convey 'information' messages about the processing of the questionnaire response.</p>
</div></td></tr></table><div><p>Some receivers may accept responses that are still 'in progress', but others may reject instances with a status other than 'final' or possibly 'amended'.  If the operation is invoked on a particular Questionnaire, the submitted QuestionnaireResponse must be a response to the specified Questionnaire.  Otherwise, the QuestionnaireResponse will be validated against whatever Questionnaire the QuestionnaireResponse references.  It is an error for a QuestionnaireResponse that does not declare a questionnaire to be invoked directly on the Questionnaire endpoint.</p>
</div></div>
  </text>
  <extension
             url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">
    <valueInteger value="3">
      <extension
                 url="http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom">
        <valueCanonical
                        value="http://hl7.org/fhir/uv/sdc/ImplementationGuide/hl7.fhir.uv.sdc"/>
      </extension>
    </valueInteger>
  </extension>
  <extension
             url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
    <valueCode value="trial-use">
      <extension
                 url="http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom">
        <valueCanonical
                        value="http://hl7.org/fhir/uv/sdc/ImplementationGuide/hl7.fhir.uv.sdc"/>
      </extension>
    </valueCode>
  </extension>
  <url
       value="http://hl7.org/fhir/uv/sdc/OperationDefinition/Questionnaire-process-response"/>
  <version value="3.0.0"/>
  <name value="SDCQuestionnaireProcessResponse"/>
  <title value="Questionnaire Process Response"/>
  <status value="draft"/>
  <kind value="operation"/>
  <date value="2017-03-19"/>
  <publisher value="HL7 International - FHIR Infrastructure Work Group"/>
  <contact>
    <telecom>
      <system value="url"/>
      <value value="http://hl7.org/Special/committees/fiwg"/>
    </telecom>
  </contact>
  <description
               value="This operation allows a system to &#39;receive&#39; a QuestionnaireResponse for a particular Questionnaire.  It is intended to be used by systems that expect to receive completed questionnaires but which do not necessarily want to host a RESTful endpoint where those responses are subsequently queryable.  The receiver may choose to perform validation of the received response or against local business rules.  There no response beyond an HTTP 200 OK if the response is consumed successfully, though an OperationOutcome can optionally be returned identifying warnings.  If there are validation or other issues, the operation will fail with details in an OperationOutcome.  The specific action that occurs on receipt of a form will depend on both the type of form and the submitter.  It could trigger admission to a clinical trial, the beginning of an product investigation, the consideration of a patient&#39;s eligibility for coverage, etc.  Alternatively, the data may simply be consumed and aggregated with other information for analysis or other use."/>
  <jurisdiction>
    <coding>
      <system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/>
      <code value="001"/>
    </coding>
  </jurisdiction>
  <code value="process-response"/>
  <comment
           value="Some receivers may accept responses that are still &#39;in progress&#39;, but others may reject instances with a status other than &#39;final&#39; or possibly &#39;amended&#39;.  If the operation is invoked on a particular Questionnaire, the submitted QuestionnaireResponse must be a response to the specified Questionnaire.  Otherwise, the QuestionnaireResponse will be validated against whatever Questionnaire the QuestionnaireResponse references.  It is an error for a QuestionnaireResponse that does not declare a questionnaire to be invoked directly on the Questionnaire endpoint."/>
  <resource value="Questionnaire"/>
  <system value="false"/>
  <type value="true"/>
  <instance value="true"/>
  <inputProfile
                value="http://hl7.org/fhir/uv/sdc/StructureDefinition/parameters-questionnaire-process-response-in"/>
  <parameter>
    <name value="response"/>
    <use value="in"/>
    <min value="1"/>
    <max value="1"/>
    <documentation value="The questionnaire response to be accepted/processed"/>
    <type value="QuestionnaireResponse"/>
  </parameter>
  <parameter>
    <name value="warnings"/>
    <use value="out"/>
    <min value="0"/>
    <max value="1"/>
    <documentation
                   value="If the response is successfully procssed, an OperationOutcome may still be returned indicating warnings.  For example, identifying questions that were incomplete, answers that were defaulted, etc.  It may also convey &#39;information&#39; messages about the processing of the questionnaire response."/>
    <type value="OperationOutcome"/>
  </parameter>
</OperationDefinition>