R6 Ballot (2nd Draft)

Publish-box (todo)

Example OperationDefinition/CapabilityStatement-conforms (JSON)

FHIR Infrastructure Work GroupMaturity Level: N/AStandards Status: Informative

Raw JSON (canonical form + also see JSON Format Specification)

Operation Definition

{
  "resourceType" : "OperationDefinition",
  "id" : "CapabilityStatement-conforms",
  "text" : {
    "status" : "generated",
    "div" : "<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><a name=\"CapabilityStatement-conforms-en-AU\"> </a><p>URL: [base]/CapabilityStatement/$conforms</p><p>Parameters</p><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=\"datatypes.html#canonical\">canonical</a></td><td/><td><div><p>A canonical reference to the left-hand system's capability statement</p>\n</div></td></tr><tr><td>IN</td><td>right</td><td/><td>0..1</td><td><a href=\"datatypes.html#canonical\">canonical</a></td><td/><td><div><p>A canonical reference to the right-hand system's capability statement</p>\n</div></td></tr><tr><td>IN</td><td>mode</td><td/><td>0..1</td><td><a href=\"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>\n</div></td></tr><tr><td>OUT</td><td>issues</td><td/><td>1..1</td><td><a href=\"operationoutcome.html\">OperationOutcome</a></td><td/><td><div><p>Outcome of the CapabilityStatement test</p>\n</div></td></tr><tr><td>OUT</td><td>union</td><td/><td>0..1</td><td><a href=\"capabilitystatement.html\">CapabilityStatement</a></td><td/><td><div><p>The intersection of the functionality described by the CapabilityStatement resources</p>\n</div></td></tr><tr><td>OUT</td><td>intersection</td><td/><td>0..1</td><td><a href=\"capabilitystatement.html\">CapabilityStatement</a></td><td/><td><div><p>The union of the functionality described by the CapabilityStatement resources</p>\n</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>\n<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>\n<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>\n</div></div>"
  },
  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger" : 5
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
    "valueCode" : "trial-use"
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
    "valueCode" : "fhir"
  }],
  "url" : "http://hl7.org/fhir/OperationDefinition/CapabilityStatement-conforms",
  "version" : "6.0.0-ballot2",
  "name" : "Conforms",
  "title" : "Test if a server implements a client's required operations",
  "status" : "draft",
  "kind" : "operation",
  "experimental" : false,
  "date" : "2024-08-12T16:52:12+08:00",
  "publisher" : "HL7 International / FHIR Infrastructure",
  "contact" : [{
    "telecom" : [{
      "system" : "url",
      "value" : "http://hl7.org/fhir"
    },
    {
      "system" : "email",
      "value" : "fhir@lists.hl7.org"
    }]
  },
  {
    "telecom" : [{
      "system" : "url",
      "value" : "http://www.hl7.org/Special/committees/fiwg"
    }]
  }],
  "description" : "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" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
      "code" : "001",
      "display" : "World"
    }]
  }],
  "affectsState" : false,
  "code" : "conforms",
  "comment" : "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.     \n\nThe 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    \n\nIf 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 >= error",
  "resource" : ["CapabilityStatement"],
  "system" : false,
  "type" : true,
  "instance" : false,
  "parameter" : [{
    "name" : "left",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "A canonical reference to the left-hand system's capability statement",
    "type" : "canonical"
  },
  {
    "name" : "right",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "A canonical reference to the right-hand system's capability statement",
    "type" : "canonical"
  },
  {
    "name" : "mode",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "What kind of comparison to perform - server to server, or client to server (use the codes 'server/server' or 'client/server')",
    "type" : "code"
  },
  {
    "name" : "issues",
    "use" : "out",
    "min" : 1,
    "max" : "1",
    "documentation" : "Outcome of the CapabilityStatement test",
    "type" : "OperationOutcome"
  },
  {
    "name" : "union",
    "use" : "out",
    "min" : 0,
    "max" : "1",
    "documentation" : "The intersection of the functionality described by the CapabilityStatement resources",
    "type" : "CapabilityStatement"
  },
  {
    "name" : "intersection",
    "use" : "out",
    "min" : 0,
    "max" : "1",
    "documentation" : "The union of the functionality described by the CapabilityStatement resources",
    "type" : "CapabilityStatement"
  }]
}

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.