5.2.10.3 能力声明对比操作（$conforms）

工作组:FHIR Infrastructure 成熟度 Maturity Level: 5Trial Use Compartments: N/A

此操作要求服务器检查它是否实现了客户端在其能力声明中提供的所有资源、交互、搜索参数和操作。 客户端通过引用提供这两个能力声明，并且必须确保所有引用的资源对符合性服务器来说都是可用的。

The official URL for this operation definition is

 http://hl7.org/fhir/OperationDefinition/CapabilityStatement-conforms

Formal Definition (as a OperationDefinition).

URL: [base]/CapabilityStatement/$conforms

This is an idempotent operation

In Parameters:
NameCardinalityTypeBindingProfileDocumentation
left0..1canonical

A canonical reference to the left-hand system's capability statement

right0..1canonical

A canonical reference to the right-hand system's capability statement

mode0..1code

What kind of comparison to perform - server to server, or client to server (use the codes 'server/server' or 'client/server')

Out Parameters:
NameCardinalityTypeBindingProfileDocumentation
issues1..1OperationOutcome

Outcome of the CapabilityStatement test

union0..1CapabilityStatement

The intersection of the functionality described by the CapabilityStatement resources

intersection0..1CapabilityStatement

The union of the functionality described by the CapabilityStatement resources

该操作对两个能力声明所描述的功能进行了全面的比较，包括它们引用的配置、值集、概念映射和结构映射。

此操作的完整执行仍然是一个研究问题，但它的目的是支持系统的比较，以查看它们是否可进行互操作。

如果能力声明对比成功，则返回值为200 OK，返回的操作结果资源会将重合、关联的能力声明随带返回。 操作结果资源可能用错误提示来说明能力声明之间的差异。 如果由于找不到依赖项而无法对能力声明进行比较，则返回值为4xx错误，且返回的操作结果资源的issue元素中至少有一个的 severity 属性值>=error。

5.2.10.3.1 Examples

Request: Request a CapabilityStatement conforms comparison between two server systems

POST [base]/CapabilityStatement/$conforms
[other headers]

<Parameters xmlns="http://hl7.org/fhir">
  <parameter>
    <name value="left"/>
    <valueUri value="http://server1.example.org/fhir/metadata"/>
  </parameter>
  <parameter>
    <name value="right"/>
    <valueUri value="http://server2.example.org/fhir/metadata"/>
  </parameter>
  <parameter>
    <name value="mode"/>
    <valueCode value="server/server"/>
  </parameter>
</Parameters>

Response:

HTTP/1.1 200 OK
[other headers]

<?xml version="1.0" encoding="UTF-8"?>
<OperationOutcome xmlns="http://hl7.org/fhir">
  <id value="conformsnotok"/>
  <text>
    <status value="additional"/>
    <div xmlns="http://www.w3.org/1999/xhtml">
      <p>Request timeout waiting for server http://server1.example.org/fhir/metadata CapabilitiesStatement.</p>
    </div>
  </text>
  <issue> 
    <severity value="error"/>
    <code value="timeout"/>
    <diagnostics value="Request timeout waiting for server http://server1.example.org/fhir/metadata CapabilitiesStatement."/>
 </issue>
</OperationOutcome>

 

For more information about operations, including how they are invoked, see Operations.