This page is part of the FHIR Specification (v3.5.0: R4 Ballot #2). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3
Vocabulary Work Group | Maturity Level: N/A | Ballot Status: Informative | Compartments: Not linked to any defined compartments |
Raw XML (canonical form + also see XML Format Specification)
Operation Definition
<?xml version="1.0" encoding="UTF-8"?> <OperationDefinition xmlns="http://hl7.org/fhir"> <id value="CodeSystem-subsumes"/> <text> <status value="generated"/> <div xmlns="http://www.w3.org/1999/xhtml"> <h2> Subsumption Testing</h2> <p> OPERATION: Subsumption Testing</p> <p> The official URL for this operation definition is: </p> <pre> http://hl7.org/fhir/OperationDefinition/CodeSystem-subsumes</pre> <div> <p> Test the subsumption relationship between code/Coding A and code/Coding B given the semantics of subsumption in the underlying code system (see hierarchyMeaning)</p> </div> <p> URL: [base]/CodeSystem/$subsumes</p> <p> URL: [base]/CodeSystem/[id]/$subsumes</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> codeA</td> <td> 0..1</td> <td> <a href="datatypes.html#code">code</a> </td> <td/> <td> <div> <p> The "A" code that is to be tested. If a code is provided, a system must be provided</p> </div> </td> </tr> <tr> <td> IN</td> <td> codeB</td> <td> 0..1</td> <td> <a href="datatypes.html#code">code</a> </td> <td/> <td> <div> <p> The "B" code that is to be tested. If a code is provided, a system must be provided</p> </div> </td> </tr> <tr> <td> IN</td> <td> system</td> <td> 0..1</td> <td> <a href="datatypes.html#uri">uri</a> </td> <td/> <td> <div> <p> The code system in which subsumption testing is to be performed. This must be provided unless the operation is invoked on a code system instance</p> </div> </td> </tr> <tr> <td> IN</td> <td> version</td> <td> 0..1</td> <td> <a href="datatypes.html#string">string</a> </td> <td/> <td> <div> <p> The version of the code system, if one was provided in the source data</p> </div> </td> </tr> <tr> <td> IN</td> <td> codingA</td> <td> 0..1</td> <td> <a href="datatypes.html#Coding">Coding</a> </td> <td/> <td> <div> <p> The "A" Coding that is to be tested. The code system does not have to match the specified subsumption code system, but the relationships between the code systems must be well established</p> </div> </td> </tr> <tr> <td> IN</td> <td> codingB</td> <td> 0..1</td> <td> <a href="datatypes.html#Coding">Coding</a> </td> <td/> <td> <div> <p> The "B" Coding that is to be tested. The code system does not have to match the specified subsumption code system, but the relationships between the code systems must be well established</p> </div> </td> </tr> <tr> <td> OUT</td> <td> outcome</td> <td> 1..1</td> <td> <a href="datatypes.html#code">code</a> </td> <td> <a href="valueset-concept-subsumption-outcome.html">http://hl7.org/fhir/ValueSet/concept-subsumption-outcome</a> (Required) </td> <td> <div> <p> The subsumption relationship between code/Coding "A" and code/Coding "B". There are 4 possible codes to be returned (equivalent, subsumes, subsumed-by, and not-subsumed) as defined in the concept-subsumption-outcome value set. If the server is unable to determine the relationship between the codes/Codings, then it returns an error response with an OperationOutcome.</p> </div> </td> </tr> </table> <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"> <valueString value="Normative"/> </extension> <url value="http://hl7.org/fhir/OperationDefinition/CodeSystem-subsumes"/> <name value="Subsumption Testing"/> <status value="draft"/> <kind value="operation"/> <date value="2018-08-19T21:48:56+10:00"/> <publisher value="HL7 (FHIR Project)"/> <contact> <telecom> <system value="url"/> <value value="http://hl7.org/fhir"/> </telecom> <telecom> <system value="email"/> <value value="fhir@lists.hl7.org"/> </telecom> </contact> <description value="Test the subsumption relationship between code/Coding A and code/Coding B given the semantics of subsumption in the underlying code system (see hierarchyMeaning)"/> <code value="subsumes"/> <resource value="CodeSystem"/> <system value="false"/> <type value="true"/> <instance value="true"/> <parameter> <name value="codeA"/> <use value="in"/> <min value="0"/> <max value="1"/> <documentation value="The "A" code that is to be tested. If a code is provided, a system must be provided"/> <type value="code"/> </parameter> <parameter> <name value="codeB"/> <use value="in"/> <min value="0"/> <max value="1"/> <documentation value="The "B" code that is to be tested. If a code is provided, a system must be provided"/> <type value="code"/> </parameter> <parameter> <name value="system"/> <use value="in"/> <min value="0"/> <max value="1"/> <documentation value="The code system in which subsumption testing is to be performed. This must be provided unless the operation is invoked on a code system instance"/> <type value="uri"/> </parameter> <parameter> <name value="version"/> <use value="in"/> <min value="0"/> <max value="1"/> <documentation value="The version of the code system, if one was provided in the source data"/> <type value="string"/> </parameter> <parameter> <name value="codingA"/> <use value="in"/> <min value="0"/> <max value="1"/> <documentation value="The "A" Coding that is to be tested. The code system does not have to match the specified subsumption code system, but the relationships between the code systems must be well established"/> <type value="Coding"/> </parameter> <parameter> <name value="codingB"/> <use value="in"/> <min value="0"/> <max value="1"/> <documentation value="The "B" Coding that is to be tested. The code system does not have to match the specified subsumption code system, but the relationships between the code systems must be well established"/> <type value="Coding"/> </parameter> <parameter> <name value="outcome"/> <use value="out"/> <min value="1"/> <max value="1"/> <documentation value="The subsumption relationship between code/Coding "A" and code/Coding "B". There are 4 possible codes to be returned (equivalent, subsumes, subsumed-by, and not-subsumed) as defined in the concept-subsumption-outcome value set. If the server is unable to determine the relationship between the codes/Codings, then it returns an error response with an OperationOutcome."/> <type value="code"/> <binding> <strength value="required"/> <valueSet value="http://hl7.org/fhir/ValueSet/concept-subsumption-outcome"/> </binding> </parameter> </OperationDefinition>
Usage note: every effort has been made to ensure that the examples are correct and useful, but they are not a normative part of the specification.