FHIR Application Feature Framework Implementation Guide
1.0.0 - STU1 Ballot International flag

FHIR Application Feature Framework Implementation Guide, published by HL7 International / FHIR Infrastructure. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/capstmt/ and changes regularly. See the Directory of published versions

: Test if a server conforms to a client's required operations - XML Representation

Page standards status: Trial-use Maturity Level: 5

Raw xml | Download


<OperationDefinition xmlns="http://hl7.org/fhir">
  <id value="CapabilityStatement-conforms"/>
  <meta>
    <lastUpdated value="2021-01-05T10:01:24.148+11:00"/>
  </meta>
  <text>
    <status value="generated"/>
    <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: OperationDefinition CapabilityStatement-conforms</b></p><a name="CapabilityStatement-conforms"> </a><a name="hcCapabilityStatement-conforms"> </a><div style="display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%"><p style="margin-bottom: 0px">Last updated: 2021-01-05 10:01:24+1100</p></div><p>URL: [base]/CapabilityStatement/$conforms</p><h3>Parameters</h3><table class="grid"><tr><td><b>Use</b></td><td><b>Name</b></td><td><b>Scope</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>left</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R5/datatypes.html#canonical">canonical</a></td><td/><td><div><p>A canonical reference to the left-hand system's capability statement</p>
</div></td></tr><tr><td>IN</td><td>right</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R5/datatypes.html#canonical">canonical</a></td><td/><td><div><p>A canonical reference to the right-hand system's capability statement</p>
</div></td></tr><tr><td>IN</td><td>mode</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R5/datatypes.html#code">code</a></td><td/><td><div><p>What kind of comparison to perform - server to server, or client to server (use the codes 'server/server' or 'client/server')</p>
</div></td></tr><tr><td>OUT</td><td>issues</td><td/><td>1..1</td><td><a href="http://hl7.org/fhir/R5/operationoutcome.html">OperationOutcome</a></td><td/><td><div><p>Outcome of the CapabilityStatement test</p>
</div></td></tr><tr><td>OUT</td><td>union</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R5/capabilitystatement.html">CapabilityStatement</a></td><td/><td><div><p>The intersection of the functionality described by the CapabilityStatement resources</p>
</div></td></tr><tr><td>OUT</td><td>intersection</td><td/><td>0..1</td><td><a href="http://hl7.org/fhir/R5/capabilitystatement.html">CapabilityStatement</a></td><td/><td><div><p>The union of the functionality described by the CapabilityStatement resources</p>
</div></td></tr></table><div><p>The operation performs a full comparison of the functionality described by the two capability statements, including the profiles and value sets they reference, and also including concept maps and structure maps.</p>
<p>The full execution of this operation is still a matter of research, but it is intended to support comparison of systems to see if they will interoperate</p>
<p>If the capability statements can be successfully compared, then the return value is a 200 OK with an OperationOutcome along with intersection and union capability statements. The operation outcome can contain errors relating to differences between the capability statements. If the capability statements cannot be compared, because dependencies cannot be located, the return value is a 4xx error, with an OperationOutcome with at least one issue with severity &gt;= error</p>
</div></div>
  </text>
  <extension
             url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">
    <valueInteger value="5"/>
  </extension>
  <extension
             url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
    <valueCode value="trial-use"/>
  </extension>
  <extension url="http://hl7.org/fhir/build/StructureDefinition/example">
    <extension url="list">
      <valueString value="1"/>
    </extension>
    <extension url="response">
      <valueBoolean value="false"/>
    </extension>
    <extension url="content">
      <valueString value="$conforms-request.txt"/>
    </extension>
  </extension>
  <extension url="http://hl7.org/fhir/build/StructureDefinition/example">
    <extension url="list">
      <valueString value="1"/>
    </extension>
    <extension url="response">
      <valueBoolean value="true"/>
    </extension>
    <extension url="content">
      <valueString value="$conforms-response.txt"/>
    </extension>
  </extension>
  <extension url="http://hl7.org/fhir/build/StructureDefinition/footer">
    <valueMarkdown
                   value="The operation performs a full comparison of the functionality described by the two capability statements, including the profiles and value sets they reference, and also including concept maps and structure maps.     

The full execution of this operation is still a matter of research, but it is intended to support comparison of systems to see if they will interoperate    

If the capability statements can be successfully compared, then the return value is a 200 OK with an OperationOutcome along with intersection and union capability statements. The operation outcome can contain errors relating to differences between the capability statements. If the capability statements cannot be compared, because dependencies cannot be located, the return value is a 4xx error, with an OperationOutcome with at least one issue with severity &gt;= error"/>
  </extension>
  <extension
             url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">
    <valueCode value="fhir"/>
  </extension>
  <url
       value="http://hl7.org/fhir/build/OperationDefinition/CapabilityStatement-conforms"/>
  <identifier>
    <system value="urn:ietf:rfc:3986"/>
    <value value="urn:oid:2.16.840.1.113883.4.642.32.5"/>
  </identifier>
  <version value="1.0.0"/>
  <name value="Conforms"/>
  <title value="Test if a server conforms to a client's required operations"/>
  <status value="draft"/>
  <kind value="operation"/>
  <date value="2021-01-05T10:01:24+11:00"/>
  <publisher value="HL7 International / FHIR Infrastructure"/>
  <contact>
    <name value="HL7 International / FHIR Infrastructure"/>
    <telecom>
      <system value="url"/>
      <value value="http://www.hl7.org/Special/committees/fiwg"/>
    </telecom>
  </contact>
  <description
               value="This operation asks the server to check that it implements all the resources, interactions, search parameters, and operations that the client provides in its capability statement. The client provides both capability statements by reference, and must ensure that all the referenced resources are available to the conformance server"/>
  <jurisdiction>
    <coding>
      <system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/>
      <code value="001"/>
      <display value="World"/>
    </coding>
  </jurisdiction>
  <affectsState value="false"/>
  <code value="conforms"/>
  <comment
           value="The operation performs a full comparison of the functionality described by the two capability statements, including the profiles and value sets they reference, and also including concept maps and structure maps.     

The full execution of this operation is still a matter of research, but it is intended to support comparison of systems to see if they will interoperate    

If the capability statements can be successfully compared, then the return value is a 200 OK with an OperationOutcome along with intersection and union capability statements. The operation outcome can contain errors relating to differences between the capability statements. If the capability statements cannot be compared, because dependencies cannot be located, the return value is a 4xx error, with an OperationOutcome with at least one issue with severity &gt;= error"/>
  <resource value="CapabilityStatement"/>
  <system value="false"/>
  <type value="true"/>
  <instance value="false"/>
  <parameter>
    <name value="left"/>
    <use value="in"/>
    <min value="0"/>
    <max value="1"/>
    <documentation
                   value="A canonical reference to the left-hand system's capability statement"/>
    <type value="canonical"/>
  </parameter>
  <parameter>
    <name value="right"/>
    <use value="in"/>
    <min value="0"/>
    <max value="1"/>
    <documentation
                   value="A canonical reference to the right-hand system's capability statement"/>
    <type value="canonical"/>
  </parameter>
  <parameter>
    <name value="mode"/>
    <use value="in"/>
    <min value="0"/>
    <max value="1"/>
    <documentation
                   value="What kind of comparison to perform - server to server, or client to server (use the codes 'server/server' or 'client/server')"/>
    <type value="code"/>
  </parameter>
  <parameter>
    <name value="issues"/>
    <use value="out"/>
    <min value="1"/>
    <max value="1"/>
    <documentation value="Outcome of the CapabilityStatement test"/>
    <type value="OperationOutcome"/>
  </parameter>
  <parameter>
    <name value="union"/>
    <use value="out"/>
    <min value="0"/>
    <max value="1"/>
    <documentation
                   value="The intersection of the functionality described by the CapabilityStatement resources"/>
    <type value="CapabilityStatement"/>
  </parameter>
  <parameter>
    <name value="intersection"/>
    <use value="out"/>
    <min value="0"/>
    <max value="1"/>
    <documentation
                   value="The union of the functionality described by the CapabilityStatement resources"/>
    <type value="CapabilityStatement"/>
  </parameter>
</OperationDefinition>