DSTU2

This page is part of the FHIR Specification (v1.0.2: DSTU 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

6.16 Resource Conformance - Content

FHIR Infrastructure Work GroupMaturity Level: 2Compartments: Not linked to any defined compartments

A conformance statement is a set of capabilities of a FHIR Server that may be used as a statement of actual server functionality or a statement of required or desired server implementation.

6.16.1 Scope and Usage

The conformance statement is a key part of the overall conformance framework in FHIR. It is used as a statement of the features of actual software, or of a set of rules for an application to conform to. This statement connects to all the detailed statements of functionality, such as StructureDefinitions and ValueSets. This composite statement of application functionality is used as either the source or target of a conformance assessment. For further information about Conformance testing, see Conformance Rules and Profiling FHIR.

Specifically, conformance statements are used in one of three ways:

6.16.1.1 Describe an actual implementation

In this scenario, the conformance statement describes the capabilities of a deployed and configured solution available at a particular access point or set of access points. The statement describes exactly how to interface with that deployed solution and thus provides for a degree of self-configuration of software solutions.

This is the type of profile that FHIR restful solutions are expected to make available on invocation of the conformance operation. It is also the type of statement that forms a basis for the testing, certification or commissioning of specific software installations.

6.16.1.2 Describe software solution capabilities

In this scenario, the conformance statement describes generic capabilities of a software application or component solution. The solution might be available for purchase or other acquisition and might be deployed and configured at any number of independent sites. Because it is not dependent on any particular implementation, the profile cannot provide specific details such as endpoint addresses. It may also need to document various configurations in which the application can be set up or describe the degree of customizability associated with the solution.

This type of statement may be used as a marketing tool by software and system developers to formally describe their capabilities. It can also be used as the basis for conformance testing of software solutions independent of a particular installation.

6.16.1.3 Describe a desired solution

In this scenario, the conformance statement describes the capabilities of a desired system. It might be used as part of an architectural design process to document needed system capabilities, or might be used as part of an RFP process to formally document the requirements of a requested solution and to document the criteria by which proposals will be evaluated.

These three types of profiles can be used together. A requirements statement can be compared against the solution statements proffered by respondents to an RFP. A solution statement for a software package forms the starting point for the implementation statement associated with a particular installation of that software package.

6.16.2 Background and Context

Conformance Statements provide for a degree of automatic configuration and adaptation. However, capturing absolutely every variation that could impact the interoperability of two systems, let alone keeping that detailed information up-to-date as systems evolve through maintenance and upgrades is rarely practical. Therefore, conformance statements should be seen as an interim step. They provide a degree of automation. However, they also provide a great deal of human-readable content that can minimize the need for direct communication between the operators of the systems being configured to interoperate.

This resource is referenced by testscript

6.16.3 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Conformance IDomainResourceA conformance statement
Conformance statements of kind 'requirements' do not have software or implementation elements
A Conformance statement SHALL have at least one of REST, messaging or document
Conformance statements of kind 'software' do not have implementation elements
A Conformance statement SHALL have at least one of description, software, or implementation
Messaging end-point is required (and is only permitted) when statement is for an implementation
The set of documents must be unique by the combination of profile & mode
There can only be one REST declaration per mode
... url Σ0..1uriLogical uri to reference this statement
... version Σ0..1stringLogical id for this version of the statement
... name Σ0..1stringInformal name for this conformance statement
... status ?! Σ0..1codedraft | active | retired
ConformanceResourceStatus (Required)
... experimental Σ0..1booleanIf for testing purposes, not real usage
... publisher Σ0..1stringName of the publisher (Organization or individual)
... contact Σ0..*BackboneElementContact details of the publisher
.... name Σ0..1stringName of a individual to contact
.... telecom Σ0..*ContactPointContact details for individual or publisher
... date Σ1..1dateTimePublication Date(/time)
... description Σ I0..1stringHuman description of the conformance statement
... requirements 0..1stringWhy is this needed?
... copyright 0..1stringUse and/or publishing restrictions
... kind Σ1..1codeinstance | capability | requirements
ConformanceStatementKind (Required)
... software Σ I0..1BackboneElementSoftware that is covered by this conformance statement
.... name Σ1..1stringA name the software is known by
.... version Σ0..1stringVersion covered by this statement
.... releaseDate Σ0..1dateTimeDate this version released
... implementation Σ I0..1BackboneElementIf this describes a specific instance
.... description Σ1..1stringDescribes this specific instance
.... url Σ0..1uriBase URL for the installation
... fhirVersion Σ1..1idFHIR Version the system uses
... acceptUnknown Σ1..1codeno | extensions | elements | both
UnknownContentCode (Required)
... format Σ1..*codeformats supported (xml | json | mime type)
MimeType (Required)
... profile 0..*Reference(StructureDefinition)Profiles for use cases supported
... rest Σ I0..*BackboneElementIf the endpoint is a RESTful one
A given resource can only be described once per RESTful mode
.... mode Σ1..1codeclient | server
RestfulConformanceMode (Required)
.... documentation 0..1stringGeneral description of implementation
.... security 0..1BackboneElementInformation about security of implementation
..... cors 0..1booleanAdds CORS Headers (http://enable-cors.org/)
..... service 0..*CodeableConceptOAuth | SMART-on-FHIR | NTLM | Basic | Kerberos | Certificates
RestfulSecurityService (Extensible)
..... description 0..1stringGeneral description of how security works
..... certificate 0..*BackboneElementCertificates associated with security profiles
...... type 0..1codeMime type for certificate
MimeType (Required)
...... blob 0..1base64BinaryActual certificate
.... resource Σ I1..*BackboneElementResource served on the REST interface
Search parameter names must be unique in the context of a resource
..... type Σ1..1codeA resource type that is supported
ResourceType (Required)
..... profile 0..1Reference(StructureDefinition)Base System profile for all uses of resource
..... interaction 1..*BackboneElementWhat operations are supported?
...... code 1..1coderead | vread | update | delete | history-instance | validate | history-type | create | search-type
TypeRestfulInteraction (Required)
...... documentation 0..1stringAnything special about operation behavior
..... versioning 0..1codeno-version | versioned | versioned-update
ResourceVersionPolicy (Required)
..... readHistory 0..1booleanWhether vRead can return past versions
..... updateCreate 0..1booleanIf update can commit to a new identity
..... conditionalCreate 0..1booleanIf allows/uses conditional create
..... conditionalUpdate 0..1booleanIf allows/uses conditional update
..... conditionalDelete 0..1codenot-supported | single | multiple - how conditional delete is supported
ConditionalDeleteStatus (Required)
..... searchInclude 0..*string_include values supported by the server
..... searchRevInclude 0..*string_revinclude values supported by the server
..... searchParam I0..*BackboneElementSearch params supported by implementation
Search parameters can only have chain names when the search parameter type is 'reference'
...... name 1..1stringName of search parameter
...... definition 0..1uriSource of definition for parameter
...... type 1..1codenumber | date | string | token | reference | composite | quantity | uri
SearchParamType (Required)
...... documentation 0..1stringServer-specific usage
...... target 0..*codeTypes of resource (if a resource reference)
ResourceType (Required)
...... modifier 0..*codemissing | exact | contains | not | text | in | not-in | below | above | type
SearchModifierCode (Required)
...... chain 0..*stringChained names supported
.... interaction 0..*BackboneElementWhat operations are supported?
..... code 1..1codetransaction | search-system | history-system
SystemRestfulInteraction (Required)
..... documentation 0..1stringAnything special about operation behavior
.... transactionMode 0..1codenot-supported | batch | transaction | both
TransactionMode (Required)
.... searchParam 0..*see searchParamSearch params for searching all resources
.... operation 0..*BackboneElementDefinition of an operation or a custom query
..... name 1..1stringName by which the operation/query is invoked
..... definition 1..1Reference(OperationDefinition)The defined operation/query
.... compartment 0..*uriCompartments served/used by system
... messaging I0..*BackboneElementIf messaging is supported
.... endpoint 0..*BackboneElementA messaging service end-point
..... protocol 1..1Codinghttp | ftp | mllp +
MessageTransport (Extensible)
..... address 1..1uriAddress of end-point
.... reliableCache 0..1unsignedIntReliable Message Cache Length (min)
.... documentation 0..1stringMessaging interface behavior details
.... event 1..*BackboneElementDeclare support for this event
..... code 1..1CodingEvent type
MessageEvent (Preferred)
..... category 0..1codeConsequence | Currency | Notification
MessageSignificanceCategory (Required)
..... mode 1..1codesender | receiver
ConformanceEventMode (Required)
..... focus 1..1codeResource that's focus of message
ResourceType (Required)
..... request 1..1Reference(StructureDefinition)Profile that describes the request
..... response 1..1Reference(StructureDefinition)Profile that describes the response
..... documentation 0..1stringEndpoint-specific event documentation
... document I0..*BackboneElementDocument definition
.... mode 1..1codeproducer | consumer
DocumentMode (Required)
.... documentation 0..1stringDescription of document support
.... profile 1..1Reference(StructureDefinition)Constraint on a resource used in the document

doco Documentation for this format

UML Diagram

Conformance (DomainResource)url : uri [0..1]version : string [0..1]name : string [0..1]status : code [0..1] « ConformanceResourceStatus! »experimental : boolean [0..1]publisher : string [0..1]date : dateTime [1..1]description : string [0..1]requirements : string [0..1]copyright : string [0..1]kind : code [1..1] « ConformanceStatementKind! »fhirVersion : id [1..1]acceptUnknown : code [1..1] « UnknownContentCode! »format : code [1..*] « MimeType! »profile : Reference [0..*] « StructureDefinition »Contactname : string [0..1]telecom : ContactPoint [0..*]Softwarename : string [1..1]version : string [0..1]releaseDate : dateTime [0..1]Implementationdescription : string [1..1]url : uri [0..1]Restmode : code [1..1] « RestfulConformanceMode! »documentation : string [0..1]transactionMode : code [0..1] « TransactionMode! »compartment : uri [0..*]Securitycors : boolean [0..1]service : CodeableConcept [0..*] « RestfulSecurityService+ »description : string [0..1]Certificatetype : code [0..1] « MimeType! »blob : base64Binary [0..1]Resourcetype : code [1..1] « ResourceType! »profile : Reference [0..1] « StructureDefinition »versioning : code [0..1] « ResourceVersionPolicy! »readHistory : boolean [0..1]updateCreate : boolean [0..1]conditionalCreate : boolean [0..1]conditionalUpdate : boolean [0..1]conditionalDelete : code [0..1] « ConditionalDeleteStatus! »searchInclude : string [0..*]searchRevInclude : string [0..*]ResourceInteractioncode : code [1..1] « TypeRestfulInteraction! »documentation : string [0..1]SearchParamname : string [1..1]definition : uri [0..1]type : code [1..1] « SearchParamType! »documentation : string [0..1]target : code [0..*] « ResourceType! »modifier : code [0..*] « SearchModifierCode! »chain : string [0..*]SystemInteractioncode : code [1..1] « SystemRestfulInteraction! »documentation : string [0..1]Operationname : string [1..1]definition : Reference [1..1] « OperationDefinition »MessagingreliableCache : unsignedInt [0..1]documentation : string [0..1]Endpointprotocol : Coding [1..1] « MessageTransport+ »address : uri [1..1]Eventcode : Coding [1..1] « MessageEvent? »category : code [0..1] « MessageSignificanceCategory! »mode : code [1..1] « ConformanceEventMode! »focus : code [1..1] « ResourceType! »request : Reference [1..1] « StructureDefinition »response : Reference [1..1] « StructureDefinition »documentation : string [0..1]Documentmode : code [1..1] « DocumentMode! »documentation : string [0..1]profile : Reference [1..1] « StructureDefinition »contact[0..*]software[0..1]implementation[0..1]certificate[0..*]security[0..1]interaction[1..*]searchParam[0..*]resource[1..*]interaction[0..*]searchParam[0..*]operation[0..*]rest[0..*]endpoint[0..*]event[1..*]messaging[0..*]document[0..*]

XML Template

<Conformance xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <url value="[uri]"/><!-- 0..1 Logical uri to reference this statement -->
 <version value="[string]"/><!-- 0..1 Logical id for this version of the statement -->
 <name value="[string]"/><!-- 0..1 Informal name for this conformance statement -->
 <status value="[code]"/><!-- 0..1 draft | active | retired -->
 <experimental value="[boolean]"/><!-- 0..1 If for testing purposes, not real usage -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher (Organization or individual) -->
 <contact>  <!-- 0..* Contact details of the publisher -->
  <name value="[string]"/><!-- 0..1 Name of a individual to contact -->
  <telecom><!-- 0..* ContactPoint Contact details for individual or publisher --></telecom>
 </contact>
 <date value="[dateTime]"/><!-- 1..1 Publication Date(/time) -->
 <description value="[string]"/><!-- ?? 0..1 Human description of the conformance statement -->
 <requirements value="[string]"/><!-- 0..1 Why is this needed? -->
 <copyright value="[string]"/><!-- 0..1 Use and/or publishing restrictions -->
 <kind value="[code]"/><!-- 1..1 instance | capability | requirements -->
 <software>  <!-- ?? 0..1 Software that is covered by this conformance statement -->
  <name value="[string]"/><!-- 1..1 A name the software is known by -->
  <version value="[string]"/><!-- 0..1 Version covered by this statement -->
  <releaseDate value="[dateTime]"/><!-- 0..1 Date this version released -->
 </software>
 <implementation>  <!-- ?? 0..1 If this describes a specific instance -->
  <description value="[string]"/><!-- 1..1 Describes this specific instance -->
  <url value="[uri]"/><!-- 0..1 Base URL for the installation -->
 </implementation>
 <fhirVersion value="[id]"/><!-- 1..1 FHIR Version the system uses -->
 <acceptUnknown value="[code]"/><!-- 1..1 no | extensions | elements | both -->
 <format value="[code]"/><!-- 1..* formats supported (xml | json | mime type)  -->
 <profile><!-- 0..* Reference(StructureDefinition) Profiles for use cases supported --></profile>
 <rest>  <!-- ?? 0..* If the endpoint is a RESTful one -->
  <mode value="[code]"/><!-- 1..1 client | server -->
  <documentation value="[string]"/><!-- 0..1 General description of implementation -->
  <security>  <!-- 0..1 Information about security of implementation -->
   <cors value="[boolean]"/><!-- 0..1 Adds CORS Headers (http://enable-cors.org/) -->
   <service><!-- 0..* CodeableConcept OAuth | SMART-on-FHIR | NTLM | Basic | Kerberos | Certificates --></service>
   <description value="[string]"/><!-- 0..1 General description of how security works -->
   <certificate>  <!-- 0..* Certificates associated with security profiles -->
    <type value="[code]"/><!-- 0..1 Mime type for certificate  -->
    <blob value="[base64Binary]"/><!-- 0..1 Actual certificate -->
   </certificate>
  </security>
  <resource>  <!-- 1..* Resource served on the REST interface -->
   <type value="[code]"/><!-- 1..1 A resource type that is supported -->
   <profile><!-- 0..1 Reference(StructureDefinition) Base System profile for all uses of resource --></profile>
   <interaction>  <!-- 1..* What operations are supported? -->
    <code value="[code]"/><!-- 1..1 read | vread | update | delete | history-instance | validate | history-type | create | search-type -->
    <documentation value="[string]"/><!-- 0..1 Anything special about operation behavior -->
   </interaction>
   <versioning value="[code]"/><!-- 0..1 no-version | versioned | versioned-update -->
   <readHistory value="[boolean]"/><!-- 0..1 Whether vRead can return past versions -->
   <updateCreate value="[boolean]"/><!-- 0..1 If update can commit to a new identity -->
   <conditionalCreate value="[boolean]"/><!-- 0..1 If allows/uses conditional create -->
   <conditionalUpdate value="[boolean]"/><!-- 0..1 If allows/uses conditional update -->
   <conditionalDelete value="[code]"/><!-- 0..1 not-supported | single | multiple - how conditional delete is supported -->
   <searchInclude value="[string]"/><!-- 0..* _include values supported by the server -->
   <searchRevInclude value="[string]"/><!-- 0..* _revinclude values supported by the server -->
   <searchParam>  <!-- 0..* Search params supported by implementation -->
    <name value="[string]"/><!-- 1..1 Name of search parameter -->
    <definition value="[uri]"/><!-- 0..1 Source of definition for parameter -->
    <type value="[code]"/><!-- 1..1 number | date | string | token | reference | composite | quantity | uri -->
    <documentation value="[string]"/><!-- 0..1 Server-specific usage -->
    <target value="[code]"/><!-- 0..* Types of resource (if a resource reference) -->
    <modifier value="[code]"/><!-- 0..* missing | exact | contains | not | text | in | not-in | below | above | type -->
    <chain value="[string]"/><!-- 0..* Chained names supported -->
   </searchParam>
  </resource>
  <interaction>  <!-- 0..* What operations are supported? -->
   <code value="[code]"/><!-- 1..1 transaction | search-system | history-system -->
   <documentation value="[string]"/><!-- 0..1 Anything special about operation behavior -->
  </interaction>
  <transactionMode value="[code]"/><!-- 0..1 not-supported | batch | transaction | both -->
  <searchParam><!-- 0..* Content as for Conformance.rest.resource.searchParam Search params for searching all resources --></searchParam>
  <operation>  <!-- 0..* Definition of an operation or a custom query -->
   <name value="[string]"/><!-- 1..1 Name by which the operation/query is invoked -->
   <definition><!-- 1..1 Reference(OperationDefinition) The defined operation/query --></definition>
  </operation>
  <compartment value="[uri]"/><!-- 0..* Compartments served/used by system -->
 </rest>
 <messaging>  <!-- ?? 0..* If messaging is supported -->
  <endpoint>  <!-- 0..* A messaging service end-point -->
   <protocol><!-- 1..1 Coding http | ftp | mllp + --></protocol>
   <address value="[uri]"/><!-- 1..1 Address of end-point -->
  </endpoint>
  <reliableCache value="[unsignedInt]"/><!-- 0..1 Reliable Message Cache Length (min) -->
  <documentation value="[string]"/><!-- 0..1 Messaging interface behavior details -->
  <event>  <!-- 1..* Declare support for this event -->
   <code><!-- 1..1 Coding Event type --></code>
   <category value="[code]"/><!-- 0..1 Consequence | Currency | Notification -->
   <mode value="[code]"/><!-- 1..1 sender | receiver -->
   <focus value="[code]"/><!-- 1..1 Resource that's focus of message -->
   <request><!-- 1..1 Reference(StructureDefinition) Profile that describes the request --></request>
   <response><!-- 1..1 Reference(StructureDefinition) Profile that describes the response --></response>
   <documentation value="[string]"/><!-- 0..1 Endpoint-specific event documentation -->
  </event>
 </messaging>
 <document>  <!-- ?? 0..* Document definition -->
  <mode value="[code]"/><!-- 1..1 producer | consumer -->
  <documentation value="[string]"/><!-- 0..1 Description of document support -->
  <profile><!-- 1..1 Reference(StructureDefinition) Constraint on a resource used in the document --></profile>
 </document>
</Conformance>

JSON Template

{doco
  "resourceType" : "Conformance",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "url" : "<uri>", // Logical uri to reference this statement
  "version" : "<string>", // Logical id for this version of the statement
  "name" : "<string>", // Informal name for this conformance statement
  "status" : "<code>", // draft | active | retired
  "experimental" : <boolean>, // If for testing purposes, not real usage
  "publisher" : "<string>", // Name of the publisher (Organization or individual)
  "contact" : [{ // Contact details of the publisher
    "name" : "<string>", // Name of a individual to contact
    "telecom" : [{ ContactPoint }] // Contact details for individual or publisher
  }],
  "date" : "<dateTime>", // R!  Publication Date(/time)
  "description" : "<string>", // C? Human description of the conformance statement
  "requirements" : "<string>", // Why is this needed?
  "copyright" : "<string>", // Use and/or publishing restrictions
  "kind" : "<code>", // R!  instance | capability | requirements
  "software" : { // C? Software that is covered by this conformance statement
    "name" : "<string>", // R!  A name the software is known by
    "version" : "<string>", // Version covered by this statement
    "releaseDate" : "<dateTime>" // Date this version released
  },
  "implementation" : { // C? If this describes a specific instance
    "description" : "<string>", // R!  Describes this specific instance
    "url" : "<uri>" // Base URL for the installation
  },
  "fhirVersion" : "<id>", // R!  FHIR Version the system uses
  "acceptUnknown" : "<code>", // R!  no | extensions | elements | both
  "format" : ["<code>"], // R!  formats supported (xml | json | mime type) 
  "profile" : [{ Reference(StructureDefinition) }], // Profiles for use cases supported
  "rest" : [{ // C? If the endpoint is a RESTful one
    "mode" : "<code>", // R!  client | server
    "documentation" : "<string>", // General description of implementation
    "security" : { // Information about security of implementation
      "cors" : <boolean>, // Adds CORS Headers (http://enable-cors.org/)
      "service" : [{ CodeableConcept }], // OAuth | SMART-on-FHIR | NTLM | Basic | Kerberos | Certificates
      "description" : "<string>", // General description of how security works
      "certificate" : [{ // Certificates associated with security profiles
        "type" : "<code>", // Mime type for certificate 
        "blob" : "<base64Binary>" // Actual certificate
      }]
    },
    "resource" : [{ // R!  Resource served on the REST interface
      "type" : "<code>", // R!  A resource type that is supported
      "profile" : { Reference(StructureDefinition) }, // Base System profile for all uses of resource
      "interaction" : [{ // R!  What operations are supported?
        "code" : "<code>", // R!  read | vread | update | delete | history-instance | validate | history-type | create | search-type
        "documentation" : "<string>" // Anything special about operation behavior
      }],
      "versioning" : "<code>", // no-version | versioned | versioned-update
      "readHistory" : <boolean>, // Whether vRead can return past versions
      "updateCreate" : <boolean>, // If update can commit to a new identity
      "conditionalCreate" : <boolean>, // If allows/uses conditional create
      "conditionalUpdate" : <boolean>, // If allows/uses conditional update
      "conditionalDelete" : "<code>", // not-supported | single | multiple - how conditional delete is supported
      "searchInclude" : ["<string>"], // _include values supported by the server
      "searchRevInclude" : ["<string>"], // _revinclude values supported by the server
      "searchParam" : [{ // Search params supported by implementation
        "name" : "<string>", // R!  Name of search parameter
        "definition" : "<uri>", // Source of definition for parameter
        "type" : "<code>", // R!  number | date | string | token | reference | composite | quantity | uri
        "documentation" : "<string>", // Server-specific usage
        "target" : ["<code>"], // Types of resource (if a resource reference)
        "modifier" : ["<code>"], // missing | exact | contains | not | text | in | not-in | below | above | type
        "chain" : ["<string>"] // Chained names supported
      }]
    }],
    "interaction" : [{ // What operations are supported?
      "code" : "<code>", // R!  transaction | search-system | history-system
      "documentation" : "<string>" // Anything special about operation behavior
    }],
    "transactionMode" : "<code>", // not-supported | batch | transaction | both
    "searchParam" : [{ Content as for Conformance.rest.resource.searchParam }], // Search params for searching all resources
    "operation" : [{ // Definition of an operation or a custom query
      "name" : "<string>", // R!  Name by which the operation/query is invoked
      "definition" : { Reference(OperationDefinition) } // R!  The defined operation/query
    }],
    "compartment" : ["<uri>"] // Compartments served/used by system
  }],
  "messaging" : [{ // C? If messaging is supported
    "endpoint" : [{ // A messaging service end-point
      "protocol" : { Coding }, // R!  http | ftp | mllp +
      "address" : "<uri>" // R!  Address of end-point
    }],
    "reliableCache" : "<unsignedInt>", // Reliable Message Cache Length (min)
    "documentation" : "<string>", // Messaging interface behavior details
    "event" : [{ // R!  Declare support for this event
      "code" : { Coding }, // R!  Event type
      "category" : "<code>", // Consequence | Currency | Notification
      "mode" : "<code>", // R!  sender | receiver
      "focus" : "<code>", // R!  Resource that's focus of message
      "request" : { Reference(StructureDefinition) }, // R!  Profile that describes the request
      "response" : { Reference(StructureDefinition) }, // R!  Profile that describes the response
      "documentation" : "<string>" // Endpoint-specific event documentation
    }]
  }],
  "document" : [{ // C? Document definition
    "mode" : "<code>", // R!  producer | consumer
    "documentation" : "<string>", // Description of document support
    "profile" : { Reference(StructureDefinition) } // R!  Constraint on a resource used in the document
  }]
}

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Conformance IDomainResourceA conformance statement
Conformance statements of kind 'requirements' do not have software or implementation elements
A Conformance statement SHALL have at least one of REST, messaging or document
Conformance statements of kind 'software' do not have implementation elements
A Conformance statement SHALL have at least one of description, software, or implementation
Messaging end-point is required (and is only permitted) when statement is for an implementation
The set of documents must be unique by the combination of profile & mode
There can only be one REST declaration per mode
... url Σ0..1uriLogical uri to reference this statement
... version Σ0..1stringLogical id for this version of the statement
... name Σ0..1stringInformal name for this conformance statement
... status ?! Σ0..1codedraft | active | retired
ConformanceResourceStatus (Required)
... experimental Σ0..1booleanIf for testing purposes, not real usage
... publisher Σ0..1stringName of the publisher (Organization or individual)
... contact Σ0..*BackboneElementContact details of the publisher
.... name Σ0..1stringName of a individual to contact
.... telecom Σ0..*ContactPointContact details for individual or publisher
... date Σ1..1dateTimePublication Date(/time)
... description Σ I0..1stringHuman description of the conformance statement
... requirements 0..1stringWhy is this needed?
... copyright 0..1stringUse and/or publishing restrictions
... kind Σ1..1codeinstance | capability | requirements
ConformanceStatementKind (Required)
... software Σ I0..1BackboneElementSoftware that is covered by this conformance statement
.... name Σ1..1stringA name the software is known by
.... version Σ0..1stringVersion covered by this statement
.... releaseDate Σ0..1dateTimeDate this version released
... implementation Σ I0..1BackboneElementIf this describes a specific instance
.... description Σ1..1stringDescribes this specific instance
.... url Σ0..1uriBase URL for the installation
... fhirVersion Σ1..1idFHIR Version the system uses
... acceptUnknown Σ1..1codeno | extensions | elements | both
UnknownContentCode (Required)
... format Σ1..*codeformats supported (xml | json | mime type)
MimeType (Required)
... profile 0..*Reference(StructureDefinition)Profiles for use cases supported
... rest Σ I0..*BackboneElementIf the endpoint is a RESTful one
A given resource can only be described once per RESTful mode
.... mode Σ1..1codeclient | server
RestfulConformanceMode (Required)
.... documentation 0..1stringGeneral description of implementation
.... security 0..1BackboneElementInformation about security of implementation
..... cors 0..1booleanAdds CORS Headers (http://enable-cors.org/)
..... service 0..*CodeableConceptOAuth | SMART-on-FHIR | NTLM | Basic | Kerberos | Certificates
RestfulSecurityService (Extensible)
..... description 0..1stringGeneral description of how security works
..... certificate 0..*BackboneElementCertificates associated with security profiles
...... type 0..1codeMime type for certificate
MimeType (Required)
...... blob 0..1base64BinaryActual certificate
.... resource Σ I1..*BackboneElementResource served on the REST interface
Search parameter names must be unique in the context of a resource
..... type Σ1..1codeA resource type that is supported
ResourceType (Required)
..... profile 0..1Reference(StructureDefinition)Base System profile for all uses of resource
..... interaction 1..*BackboneElementWhat operations are supported?
...... code 1..1coderead | vread | update | delete | history-instance | validate | history-type | create | search-type
TypeRestfulInteraction (Required)
...... documentation 0..1stringAnything special about operation behavior
..... versioning 0..1codeno-version | versioned | versioned-update
ResourceVersionPolicy (Required)
..... readHistory 0..1booleanWhether vRead can return past versions
..... updateCreate 0..1booleanIf update can commit to a new identity
..... conditionalCreate 0..1booleanIf allows/uses conditional create
..... conditionalUpdate 0..1booleanIf allows/uses conditional update
..... conditionalDelete 0..1codenot-supported | single | multiple - how conditional delete is supported
ConditionalDeleteStatus (Required)
..... searchInclude 0..*string_include values supported by the server
..... searchRevInclude 0..*string_revinclude values supported by the server
..... searchParam I0..*BackboneElementSearch params supported by implementation
Search parameters can only have chain names when the search parameter type is 'reference'
...... name 1..1stringName of search parameter
...... definition 0..1uriSource of definition for parameter
...... type 1..1codenumber | date | string | token | reference | composite | quantity | uri
SearchParamType (Required)
...... documentation 0..1stringServer-specific usage
...... target 0..*codeTypes of resource (if a resource reference)
ResourceType (Required)
...... modifier 0..*codemissing | exact | contains | not | text | in | not-in | below | above | type
SearchModifierCode (Required)
...... chain 0..*stringChained names supported
.... interaction 0..*BackboneElementWhat operations are supported?
..... code 1..1codetransaction | search-system | history-system
SystemRestfulInteraction (Required)
..... documentation 0..1stringAnything special about operation behavior
.... transactionMode 0..1codenot-supported | batch | transaction | both
TransactionMode (Required)
.... searchParam 0..*see searchParamSearch params for searching all resources
.... operation 0..*BackboneElementDefinition of an operation or a custom query
..... name 1..1stringName by which the operation/query is invoked
..... definition 1..1Reference(OperationDefinition)The defined operation/query
.... compartment 0..*uriCompartments served/used by system
... messaging I0..*BackboneElementIf messaging is supported
.... endpoint 0..*BackboneElementA messaging service end-point
..... protocol 1..1Codinghttp | ftp | mllp +
MessageTransport (Extensible)
..... address 1..1uriAddress of end-point
.... reliableCache 0..1unsignedIntReliable Message Cache Length (min)
.... documentation 0..1stringMessaging interface behavior details
.... event 1..*BackboneElementDeclare support for this event
..... code 1..1CodingEvent type
MessageEvent (Preferred)
..... category 0..1codeConsequence | Currency | Notification
MessageSignificanceCategory (Required)
..... mode 1..1codesender | receiver
ConformanceEventMode (Required)
..... focus 1..1codeResource that's focus of message
ResourceType (Required)
..... request 1..1Reference(StructureDefinition)Profile that describes the request
..... response 1..1Reference(StructureDefinition)Profile that describes the response
..... documentation 0..1stringEndpoint-specific event documentation
... document I0..*BackboneElementDocument definition
.... mode 1..1codeproducer | consumer
DocumentMode (Required)
.... documentation 0..1stringDescription of document support
.... profile 1..1Reference(StructureDefinition)Constraint on a resource used in the document

doco Documentation for this format

UML Diagram

Conformance (DomainResource)url : uri [0..1]version : string [0..1]name : string [0..1]status : code [0..1] « ConformanceResourceStatus! »experimental : boolean [0..1]publisher : string [0..1]date : dateTime [1..1]description : string [0..1]requirements : string [0..1]copyright : string [0..1]kind : code [1..1] « ConformanceStatementKind! »fhirVersion : id [1..1]acceptUnknown : code [1..1] « UnknownContentCode! »format : code [1..*] « MimeType! »profile : Reference [0..*] « StructureDefinition »Contactname : string [0..1]telecom : ContactPoint [0..*]Softwarename : string [1..1]version : string [0..1]releaseDate : dateTime [0..1]Implementationdescription : string [1..1]url : uri [0..1]Restmode : code [1..1] « RestfulConformanceMode! »documentation : string [0..1]transactionMode : code [0..1] « TransactionMode! »compartment : uri [0..*]Securitycors : boolean [0..1]service : CodeableConcept [0..*] « RestfulSecurityService+ »description : string [0..1]Certificatetype : code [0..1] « MimeType! »blob : base64Binary [0..1]Resourcetype : code [1..1] « ResourceType! »profile : Reference [0..1] « StructureDefinition »versioning : code [0..1] « ResourceVersionPolicy! »readHistory : boolean [0..1]updateCreate : boolean [0..1]conditionalCreate : boolean [0..1]conditionalUpdate : boolean [0..1]conditionalDelete : code [0..1] « ConditionalDeleteStatus! »searchInclude : string [0..*]searchRevInclude : string [0..*]ResourceInteractioncode : code [1..1] « TypeRestfulInteraction! »documentation : string [0..1]SearchParamname : string [1..1]definition : uri [0..1]type : code [1..1] « SearchParamType! »documentation : string [0..1]target : code [0..*] « ResourceType! »modifier : code [0..*] « SearchModifierCode! »chain : string [0..*]SystemInteractioncode : code [1..1] « SystemRestfulInteraction! »documentation : string [0..1]Operationname : string [1..1]definition : Reference [1..1] « OperationDefinition »MessagingreliableCache : unsignedInt [0..1]documentation : string [0..1]Endpointprotocol : Coding [1..1] « MessageTransport+ »address : uri [1..1]Eventcode : Coding [1..1] « MessageEvent? »category : code [0..1] « MessageSignificanceCategory! »mode : code [1..1] « ConformanceEventMode! »focus : code [1..1] « ResourceType! »request : Reference [1..1] « StructureDefinition »response : Reference [1..1] « StructureDefinition »documentation : string [0..1]Documentmode : code [1..1] « DocumentMode! »documentation : string [0..1]profile : Reference [1..1] « StructureDefinition »contact[0..*]software[0..1]implementation[0..1]certificate[0..*]security[0..1]interaction[1..*]searchParam[0..*]resource[1..*]interaction[0..*]searchParam[0..*]operation[0..*]rest[0..*]endpoint[0..*]event[1..*]messaging[0..*]document[0..*]

XML Template

<Conformance xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <url value="[uri]"/><!-- 0..1 Logical uri to reference this statement -->
 <version value="[string]"/><!-- 0..1 Logical id for this version of the statement -->
 <name value="[string]"/><!-- 0..1 Informal name for this conformance statement -->
 <status value="[code]"/><!-- 0..1 draft | active | retired -->
 <experimental value="[boolean]"/><!-- 0..1 If for testing purposes, not real usage -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher (Organization or individual) -->
 <contact>  <!-- 0..* Contact details of the publisher -->
  <name value="[string]"/><!-- 0..1 Name of a individual to contact -->
  <telecom><!-- 0..* ContactPoint Contact details for individual or publisher --></telecom>
 </contact>
 <date value="[dateTime]"/><!-- 1..1 Publication Date(/time) -->
 <description value="[string]"/><!-- ?? 0..1 Human description of the conformance statement -->
 <requirements value="[string]"/><!-- 0..1 Why is this needed? -->
 <copyright value="[string]"/><!-- 0..1 Use and/or publishing restrictions -->
 <kind value="[code]"/><!-- 1..1 instance | capability | requirements -->
 <software>  <!-- ?? 0..1 Software that is covered by this conformance statement -->
  <name value="[string]"/><!-- 1..1 A name the software is known by -->
  <version value="[string]"/><!-- 0..1 Version covered by this statement -->
  <releaseDate value="[dateTime]"/><!-- 0..1 Date this version released -->
 </software>
 <implementation>  <!-- ?? 0..1 If this describes a specific instance -->
  <description value="[string]"/><!-- 1..1 Describes this specific instance -->
  <url value="[uri]"/><!-- 0..1 Base URL for the installation -->
 </implementation>
 <fhirVersion value="[id]"/><!-- 1..1 FHIR Version the system uses -->
 <acceptUnknown value="[code]"/><!-- 1..1 no | extensions | elements | both -->
 <format value="[code]"/><!-- 1..* formats supported (xml | json | mime type)  -->
 <profile><!-- 0..* Reference(StructureDefinition) Profiles for use cases supported --></profile>
 <rest>  <!-- ?? 0..* If the endpoint is a RESTful one -->
  <mode value="[code]"/><!-- 1..1 client | server -->
  <documentation value="[string]"/><!-- 0..1 General description of implementation -->
  <security>  <!-- 0..1 Information about security of implementation -->
   <cors value="[boolean]"/><!-- 0..1 Adds CORS Headers (http://enable-cors.org/) -->
   <service><!-- 0..* CodeableConcept OAuth | SMART-on-FHIR | NTLM | Basic | Kerberos | Certificates --></service>
   <description value="[string]"/><!-- 0..1 General description of how security works -->
   <certificate>  <!-- 0..* Certificates associated with security profiles -->
    <type value="[code]"/><!-- 0..1 Mime type for certificate  -->
    <blob value="[base64Binary]"/><!-- 0..1 Actual certificate -->
   </certificate>
  </security>
  <resource>  <!-- 1..* Resource served on the REST interface -->
   <type value="[code]"/><!-- 1..1 A resource type that is supported -->
   <profile><!-- 0..1 Reference(StructureDefinition) Base System profile for all uses of resource --></profile>
   <interaction>  <!-- 1..* What operations are supported? -->
    <code value="[code]"/><!-- 1..1 read | vread | update | delete | history-instance | validate | history-type | create | search-type -->
    <documentation value="[string]"/><!-- 0..1 Anything special about operation behavior -->
   </interaction>
   <versioning value="[code]"/><!-- 0..1 no-version | versioned | versioned-update -->
   <readHistory value="[boolean]"/><!-- 0..1 Whether vRead can return past versions -->
   <updateCreate value="[boolean]"/><!-- 0..1 If update can commit to a new identity -->
   <conditionalCreate value="[boolean]"/><!-- 0..1 If allows/uses conditional create -->
   <conditionalUpdate value="[boolean]"/><!-- 0..1 If allows/uses conditional update -->
   <conditionalDelete value="[code]"/><!-- 0..1 not-supported | single | multiple - how conditional delete is supported -->
   <searchInclude value="[string]"/><!-- 0..* _include values supported by the server -->
   <searchRevInclude value="[string]"/><!-- 0..* _revinclude values supported by the server -->
   <searchParam>  <!-- 0..* Search params supported by implementation -->
    <name value="[string]"/><!-- 1..1 Name of search parameter -->
    <definition value="[uri]"/><!-- 0..1 Source of definition for parameter -->
    <type value="[code]"/><!-- 1..1 number | date | string | token | reference | composite | quantity | uri -->
    <documentation value="[string]"/><!-- 0..1 Server-specific usage -->
    <target value="[code]"/><!-- 0..* Types of resource (if a resource reference) -->
    <modifier value="[code]"/><!-- 0..* missing | exact | contains | not | text | in | not-in | below | above | type -->
    <chain value="[string]"/><!-- 0..* Chained names supported -->
   </searchParam>
  </resource>
  <interaction>  <!-- 0..* What operations are supported? -->
   <code value="[code]"/><!-- 1..1 transaction | search-system | history-system -->
   <documentation value="[string]"/><!-- 0..1 Anything special about operation behavior -->
  </interaction>
  <transactionMode value="[code]"/><!-- 0..1 not-supported | batch | transaction | both -->
  <searchParam><!-- 0..* Content as for Conformance.rest.resource.searchParam Search params for searching all resources --></searchParam>
  <operation>  <!-- 0..* Definition of an operation or a custom query -->
   <name value="[string]"/><!-- 1..1 Name by which the operation/query is invoked -->
   <definition><!-- 1..1 Reference(OperationDefinition) The defined operation/query --></definition>
  </operation>
  <compartment value="[uri]"/><!-- 0..* Compartments served/used by system -->
 </rest>
 <messaging>  <!-- ?? 0..* If messaging is supported -->
  <endpoint>  <!-- 0..* A messaging service end-point -->
   <protocol><!-- 1..1 Coding http | ftp | mllp + --></protocol>
   <address value="[uri]"/><!-- 1..1 Address of end-point -->
  </endpoint>
  <reliableCache value="[unsignedInt]"/><!-- 0..1 Reliable Message Cache Length (min) -->
  <documentation value="[string]"/><!-- 0..1 Messaging interface behavior details -->
  <event>  <!-- 1..* Declare support for this event -->
   <code><!-- 1..1 Coding Event type --></code>
   <category value="[code]"/><!-- 0..1 Consequence | Currency | Notification -->
   <mode value="[code]"/><!-- 1..1 sender | receiver -->
   <focus value="[code]"/><!-- 1..1 Resource that's focus of message -->
   <request><!-- 1..1 Reference(StructureDefinition) Profile that describes the request --></request>
   <response><!-- 1..1 Reference(StructureDefinition) Profile that describes the response --></response>
   <documentation value="[string]"/><!-- 0..1 Endpoint-specific event documentation -->
  </event>
 </messaging>
 <document>  <!-- ?? 0..* Document definition -->
  <mode value="[code]"/><!-- 1..1 producer | consumer -->
  <documentation value="[string]"/><!-- 0..1 Description of document support -->
  <profile><!-- 1..1 Reference(StructureDefinition) Constraint on a resource used in the document --></profile>
 </document>
</Conformance>

JSON Template

{doco
  "resourceType" : "Conformance",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "url" : "<uri>", // Logical uri to reference this statement
  "version" : "<string>", // Logical id for this version of the statement
  "name" : "<string>", // Informal name for this conformance statement
  "status" : "<code>", // draft | active | retired
  "experimental" : <boolean>, // If for testing purposes, not real usage
  "publisher" : "<string>", // Name of the publisher (Organization or individual)
  "contact" : [{ // Contact details of the publisher
    "name" : "<string>", // Name of a individual to contact
    "telecom" : [{ ContactPoint }] // Contact details for individual or publisher
  }],
  "date" : "<dateTime>", // R!  Publication Date(/time)
  "description" : "<string>", // C? Human description of the conformance statement
  "requirements" : "<string>", // Why is this needed?
  "copyright" : "<string>", // Use and/or publishing restrictions
  "kind" : "<code>", // R!  instance | capability | requirements
  "software" : { // C? Software that is covered by this conformance statement
    "name" : "<string>", // R!  A name the software is known by
    "version" : "<string>", // Version covered by this statement
    "releaseDate" : "<dateTime>" // Date this version released
  },
  "implementation" : { // C? If this describes a specific instance
    "description" : "<string>", // R!  Describes this specific instance
    "url" : "<uri>" // Base URL for the installation
  },
  "fhirVersion" : "<id>", // R!  FHIR Version the system uses
  "acceptUnknown" : "<code>", // R!  no | extensions | elements | both
  "format" : ["<code>"], // R!  formats supported (xml | json | mime type) 
  "profile" : [{ Reference(StructureDefinition) }], // Profiles for use cases supported
  "rest" : [{ // C? If the endpoint is a RESTful one
    "mode" : "<code>", // R!  client | server
    "documentation" : "<string>", // General description of implementation
    "security" : { // Information about security of implementation
      "cors" : <boolean>, // Adds CORS Headers (http://enable-cors.org/)
      "service" : [{ CodeableConcept }], // OAuth | SMART-on-FHIR | NTLM | Basic | Kerberos | Certificates
      "description" : "<string>", // General description of how security works
      "certificate" : [{ // Certificates associated with security profiles
        "type" : "<code>", // Mime type for certificate 
        "blob" : "<base64Binary>" // Actual certificate
      }]
    },
    "resource" : [{ // R!  Resource served on the REST interface
      "type" : "<code>", // R!  A resource type that is supported
      "profile" : { Reference(StructureDefinition) }, // Base System profile for all uses of resource
      "interaction" : [{ // R!  What operations are supported?
        "code" : "<code>", // R!  read | vread | update | delete | history-instance | validate | history-type | create | search-type
        "documentation" : "<string>" // Anything special about operation behavior
      }],
      "versioning" : "<code>", // no-version | versioned | versioned-update
      "readHistory" : <boolean>, // Whether vRead can return past versions
      "updateCreate" : <boolean>, // If update can commit to a new identity
      "conditionalCreate" : <boolean>, // If allows/uses conditional create
      "conditionalUpdate" : <boolean>, // If allows/uses conditional update
      "conditionalDelete" : "<code>", // not-supported | single | multiple - how conditional delete is supported
      "searchInclude" : ["<string>"], // _include values supported by the server
      "searchRevInclude" : ["<string>"], // _revinclude values supported by the server
      "searchParam" : [{ // Search params supported by implementation
        "name" : "<string>", // R!  Name of search parameter
        "definition" : "<uri>", // Source of definition for parameter
        "type" : "<code>", // R!  number | date | string | token | reference | composite | quantity | uri
        "documentation" : "<string>", // Server-specific usage
        "target" : ["<code>"], // Types of resource (if a resource reference)
        "modifier" : ["<code>"], // missing | exact | contains | not | text | in | not-in | below | above | type
        "chain" : ["<string>"] // Chained names supported
      }]
    }],
    "interaction" : [{ // What operations are supported?
      "code" : "<code>", // R!  transaction | search-system | history-system
      "documentation" : "<string>" // Anything special about operation behavior
    }],
    "transactionMode" : "<code>", // not-supported | batch | transaction | both
    "searchParam" : [{ Content as for Conformance.rest.resource.searchParam }], // Search params for searching all resources
    "operation" : [{ // Definition of an operation or a custom query
      "name" : "<string>", // R!  Name by which the operation/query is invoked
      "definition" : { Reference(OperationDefinition) } // R!  The defined operation/query
    }],
    "compartment" : ["<uri>"] // Compartments served/used by system
  }],
  "messaging" : [{ // C? If messaging is supported
    "endpoint" : [{ // A messaging service end-point
      "protocol" : { Coding }, // R!  http | ftp | mllp +
      "address" : "<uri>" // R!  Address of end-point
    }],
    "reliableCache" : "<unsignedInt>", // Reliable Message Cache Length (min)
    "documentation" : "<string>", // Messaging interface behavior details
    "event" : [{ // R!  Declare support for this event
      "code" : { Coding }, // R!  Event type
      "category" : "<code>", // Consequence | Currency | Notification
      "mode" : "<code>", // R!  sender | receiver
      "focus" : "<code>", // R!  Resource that's focus of message
      "request" : { Reference(StructureDefinition) }, // R!  Profile that describes the request
      "response" : { Reference(StructureDefinition) }, // R!  Profile that describes the response
      "documentation" : "<string>" // Endpoint-specific event documentation
    }]
  }],
  "document" : [{ // C? Document definition
    "mode" : "<code>", // R!  producer | consumer
    "documentation" : "<string>", // Description of document support
    "profile" : { Reference(StructureDefinition) } // R!  Constraint on a resource used in the document
  }]
}

 

Alternate definitions: Schema/Schematron, Resource Profile (XML, JSON), Questionnaire

6.16.3.1 Terminology Bindings

PathDefinitionTypeReference
Conformance.status The lifecycle status of a Value Set or Concept Map.RequiredConformanceResourceStatus
Conformance.kind How a conformance statement is intended to be used.RequiredConformanceStatementKind
Conformance.acceptUnknown A code that indicates whether an application accepts unknown elements or extensions when reading resources.RequiredUnknownContentCode
Conformance.format
Conformance.rest.security.certificate.type
The mime type of an attachment. Any valid mime type is allowed.RequiredBCP 13 (RFCs 2045, 2046, 2047, 4288, 4289 and 2049)
Conformance.rest.mode The mode of a RESTful conformance statement.RequiredRestfulConformanceMode
Conformance.rest.security.service Types of security services used with FHIR.ExtensibleRestfulSecurityService
Conformance.rest.resource.type
Conformance.rest.resource.searchParam.target
Conformance.messaging.event.focus
One of the resource types defined as part of FHIR.Requiredhttp://hl7.org/fhir/valueset/resource-typesResourceType
Conformance.rest.resource.interaction.code Operations supported by REST at the type or instance level.RequiredTypeRestfulInteraction
Conformance.rest.resource.versioning How the system supports versioning for a resource.RequiredResourceVersionPolicy
Conformance.rest.resource.conditionalDelete A code that indicates how the server supports conditional delete.RequiredConditionalDeleteStatus
Conformance.rest.resource.searchParam.type Data types allowed to be used for search parameters.RequiredSearchParamType
Conformance.rest.resource.searchParam.modifier A supported modifier for a search parameter.RequiredSearchModifierCode
Conformance.rest.interaction.code Operations supported by REST at the system level.RequiredSystemRestfulInteraction
Conformance.rest.transactionMode A code that indicates how transactions are supported.RequiredTransactionMode
Conformance.messaging.endpoint.protocol The protocol used for message transport.ExtensibleMessageTransport
Conformance.messaging.event.code One of the message events defined as part of FHIR.Preferredhttp://hl7.org/fhir/valueset/message-eventsMessageEvent
Conformance.messaging.event.category The impact of the content of a message.RequiredMessageSignificanceCategory
Conformance.messaging.event.mode The mode of a message conformance statement.RequiredConformanceEventMode
Conformance.document.mode Whether the application produces or consumes documents.RequiredDocumentMode

6.16.3.2 Constraints

  • cnf-1: A Conformance statement SHALL have at least one of REST, messaging or document (xpath: exists(f:rest) or exists(f:messaging) or exists(f:document))
  • cnf-12: On Conformance.rest.resource: Search parameter names must be unique in the context of a resource (xpath on f:Conformance/f:rest/f:resource: count(f:searchParam)=count(distinct-values(f:searchParam/f:name/@value)))
  • cnf-13: On Conformance.rest.resource.searchParam: Search parameters can only have chain names when the search parameter type is 'reference' (xpath on f:Conformance/f:rest/f:resource/f:searchParam: not(exists(f:chain)) or (f:type/@value = 'reference'))
  • cnf-14: Conformance statements of kind 'requirements' do not have software or implementation elements (xpath: not(exists(f:software) or exists(f:implementation)) or (f:kind/@value != 'requirements'))
  • cnf-15: Conformance statements of kind 'software' do not have implementation elements (xpath: not(exists(f:implementation)) or (f:kind/@value != 'capability'))
  • cnf-2: A Conformance statement SHALL have at least one of description, software, or implementation (xpath: count(f:software | f:implementation | f:description) > 0)
  • cnf-3: Messaging end-point is required (and is only permitted) when statement is for an implementation (xpath: not(exists(f:messaging/f:endpoint)) or f:kind/@value = 'instance')
  • cnf-7: The set of documents must be unique by the combination of profile & mode (xpath: count(f:document[f:mode/@value='producer'])=count(distinct-values(f:document[f:mode/@value='producer']/f:profile/f:reference/@value)) and count(f:document[f:mode/@value='consumer'])=count(distinct-values(f:document[f:mode/@value='consumer']/f:profile/f:reference/@value)))
  • cnf-8: There can only be one REST declaration per mode (xpath: count(f:rest)=count(distinct-values(f:rest/f:mode/@value)))
  • cnf-9: On Conformance.rest: A given resource can only be described once per RESTful mode (xpath on f:Conformance/f:rest: count(f:resource)=count(distinct-values(f:resource/f:type/@value)))

6.16.4 Notes:

  • The Conformance resource provides for an application to describe its use of the RESTful paradigm messaging events, or FHIR documents. Usually, an application would only describe one, but more than one may be described
  • RESTful conformance rules:
    • RESTful servers are required to provide this resource on demand. Servers SHALL specify what resource types and operations are supported, and SHOULD also specify profiles for each resource type.
    • RESTful clients SHOULD publish a conformance statement
    • The search parameters that a server supports (or a client makes use of) are specified in the resource profile that the conformance statement references
    • Resource Types or operations that are not listed are not supported
  • Messaging conformance rules:
    • The interpretation of request and response depends on the mode. If the mode is sender, then request specifies what the application sends, and response specifies what it accepts. If the mode is "receiver", then this is reversed
    • If a request or response is not specified for an event, then no rules are made for it
    • Events that are not listed are not supported
  • Document conformance rules:
    • Document profiles should directly constrain the Document.information.class & type elements so that there is no ambiguity concerning which profile any given document conforms to.
  • Other service based use of resources: Due to the variability of these services, the Conformance resource does not attempt to describe service based use of resources. The various service specifications will need to describe this usage in their own way.

6.16.4.1 Supporting Profiles

A conformance profile declares two different kinds of profiles for the functionality it describes. For a discussion of the use of these two types of resources, see two uses for profiles.

6.16.5 Search Parameters

Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

NameTypeDescriptionPaths
datedateThe conformance statement publication dateConformance.date
descriptionstringText search in the description of the conformance statementConformance.description
eventtokenEvent code in a conformance statementConformance.messaging.event.code
fhirversiontokenThe version of FHIRConformance.version
formattokenformats supported (xml | json | mime type)Conformance.format
modetokenMode - restful (server/client) or messaging (sender/receiver)Conformance.rest.mode
namestringName of the conformance statementConformance.name
profilereferenceA profile id invoked in a conformance statementConformance.rest.resource.profile
(StructureDefinition)
publisherstringName of the publisher of the conformance statementConformance.publisher
resourcetokenName of a resource mentioned in a conformance statementConformance.rest.resource.type
securitytokenOAuth | SMART-on-FHIR | NTLM | Basic | Kerberos | CertificatesConformance.rest.security.service
softwarestringPart of a the name of a software applicationConformance.software.name
statustokenThe current status of the conformance statementConformance.status
supported-profilereferenceProfiles for use cases supportedConformance.profile
(StructureDefinition)
urluriThe uri that identifies the conformance statementConformance.url
versiontokenThe version identifier of the conformance statementConformance.version