Digital Tooling Implementation Guide
0.0.11 - release

Digital Tooling Implementation Guide - Local Development build (v0.0.11) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Resource Profile: Capability Statement profile for use with the Health New Zealand Te Whatu Ora OpenAPI spec converter

Official URL: https://fhir-ig.digital.health.nz/hnz-digital-tooling/StructureDefinition/hnz-capability-statement Version: 0.0.11
Active as of 2024-08-28 Computable Name: HnzToolingCapabilityStatement

A CapabilityStatement profile that constrains and documents the Capability Statement to the Health New Zealand Te Whatu Ora OpenAPI spec converter requirements

Usage:

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

This structure is derived from CapabilityStatement

NameFlagsCard.TypeDescription & Constraintsdoco
.. CapabilityStatement C 0..* CapabilityStatement A statement of system capabilities
contact-url-invariant: The CapabilityStatement must have at least one contact where the system is a url.
... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
.... HnzApiSpecBuilderExtension 1..1 (Complex) Resource Metadata Extension
URL: https://fhir-ig.digital.health.nz/hnz-digital-tooling/StructureDefinition/resource-metadata-extension
... version 1..1 string The version of API, displayed in the OpenAPI contact section
... contact 1..* ContactDetail Contact details for the publisher
.... url 1..1 url The URL of the server that the OpenAPI spec will be generated for. Used in example searchset fullUrls
... format 1..1 code The media types supported by the API, e.g. application/json or application/fhir+json
... rest
.... mode 1..1 code The mode of the RESTful interface. A mode of server MUST be provided to generate an OpenAPI spec
.... security
..... service 0..* CodeableConcept The security service that the server supports, to annotate in the OpenAPI security section
.... resource 1..* BackboneElement Resource served on the REST interface
..... type 1..1 code The type of resource that the server supports. This MUST be provided to generate OpenAPI paths
..... profile 0..1 canonical(StructureDefinition) The base profile that the resource supports. If not provided, the base resource schema from the FHIR specification will be used
..... supportedProfile 0..* canonical(StructureDefinition) The profiles that the resource supports. This MUST be provided to generate OpenAPI schemas based on the FHIR profiles, and examples on each resource
..... interaction 0..* BackboneElement The interactions that the resource supports. This MUST be provided to generate OpenAPI operations
..... searchParam 0..* BackboneElement The search parameters that the resource supports. This MUST be provided to generate OpenAPI parameters on each resource
..... operation 0..* BackboneElement Custom operations that the resource supports. This MUST be provided to generate a OpenAPI path/operation
...... name 1..1 string The name of the operation that the resource supports
...... definition 1..1 canonical(OperationDefinition) The canonical URL of the operation definition that the resource supports
.... operation 0..* Custom operations that the server supports at at system level. This MUST be provided to generate a OpenAPI path/operation

doco Documentation for this format

Constraints

IdGradePath(s)DetailsRequirements
contact-url-invarianterrorCapabilityStatementThe CapabilityStatement must have at least one contact where the system is a url.
: contact.telecom.where(system = 'url').exists()
NameFlagsCard.TypeDescription & Constraintsdoco
.. CapabilityStatement C 0..* CapabilityStatement A statement of system capabilities
cpb-0: Name should be usable as an identifier for the module by machine processing applications such as code generation
cpb-1: A Capability Statement SHALL have at least one of REST, messaging or document element.
cpb-2: A Capability Statement SHALL have at least one of description, software, or implementation element.
cpb-3: Messaging end-point is required (and is only permitted) when a statement is for an implementation.
cpb-7: The set of documents must be unique by the combination of profile and mode.
cpb-14: If kind = instance, implementation must be present and software may be present
cpb-15: If kind = capability, implementation must be absent, software must be present
cpb-16: If kind = requirements, implementation and software must be absent
contact-url-invariant: The CapabilityStatement must have at least one contact where the system is a url.
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
.... HnzApiSpecBuilderExtension 1..1 (Complex) Resource Metadata Extension
URL: https://fhir-ig.digital.health.nz/hnz-digital-tooling/StructureDefinition/resource-metadata-extension
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... status ?!Σ 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.

... date Σ 1..1 dateTime Date last changed
... contact Σ 1..* ContactDetail Contact details for the publisher
... kind ΣC 1..1 code instance | capability | requirements
Binding: CapabilityStatementKind (required): How a capability statement is intended to be used.

... implementation ΣC 1..1 BackboneElement If this describes a specific instance
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... description Σ 1..1 string Describes this specific instance
.... url Σ 1..1 url The URL of the server that the OpenAPI spec will be generated for. Used in example searchset fullUrls
... fhirVersion Σ 1..1 code FHIR Version the system supports
Binding: FHIRVersion (required): All published FHIR Versions.

... format Σ 1..1 code The media types supported by the API, e.g. application/json or application/fhir+json
Binding: Mime Types (required): The mime type of an attachment. Any valid mime type is allowed.



doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
CapabilityStatement.statusrequiredPublicationStatus
http://hl7.org/fhir/ValueSet/publication-status|4.0.1
from the FHIR Standard
CapabilityStatement.kindrequiredCapabilityStatementKind
http://hl7.org/fhir/ValueSet/capability-statement-kind|4.0.1
from the FHIR Standard
CapabilityStatement.fhirVersionrequiredFHIRVersion
http://hl7.org/fhir/ValueSet/FHIR-version|4.0.1
from the FHIR Standard
CapabilityStatement.formatrequiredMime Types (a valid code from urn:ietf:bcp:13)
http://hl7.org/fhir/ValueSet/mimetypes|4.0.1
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
contact-url-invarianterrorCapabilityStatementThe CapabilityStatement must have at least one contact where the system is a url.
: contact.telecom.where(system = 'url').exists()
NameFlagsCard.TypeDescription & Constraintsdoco
.. CapabilityStatement C 0..* CapabilityStatement A statement of system capabilities
cpb-0: Name should be usable as an identifier for the module by machine processing applications such as code generation
cpb-1: A Capability Statement SHALL have at least one of REST, messaging or document element.
cpb-2: A Capability Statement SHALL have at least one of description, software, or implementation element.
cpb-3: Messaging end-point is required (and is only permitted) when a statement is for an implementation.
cpb-7: The set of documents must be unique by the combination of profile and mode.
cpb-14: If kind = instance, implementation must be present and software may be present
cpb-15: If kind = capability, implementation must be absent, software must be present
cpb-16: If kind = requirements, implementation and software must be absent
contact-url-invariant: The CapabilityStatement must have at least one contact where the system is a url.
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... language 0..1 code Language of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguages Max Binding
... text 0..1 Narrative Text summary of the resource, for human interpretation
... contained 0..* Resource Contained, inline Resources
... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
.... HnzApiSpecBuilderExtension 1..1 (Complex) Resource Metadata Extension
URL: https://fhir-ig.digital.health.nz/hnz-digital-tooling/StructureDefinition/resource-metadata-extension
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... url Σ 0..1 uri Canonical identifier for this capability statement, represented as a URI (globally unique)
... version Σ 1..1 string The version of API, displayed in the OpenAPI contact section
... name ΣC 0..1 string Name for this capability statement (computer friendly)
... title Σ 0..1 string Name for this capability statement (human friendly)
... status ?!Σ 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.

... experimental Σ 0..1 boolean For testing purposes, not real usage
... date Σ 1..1 dateTime Date last changed
... publisher Σ 0..1 string Name of the publisher (organization or individual)
... contact Σ 1..* ContactDetail Contact details for the publisher
... description C 0..1 markdown Natural language description of the capability statement
... useContext Σ 0..* UsageContext The context that the content is intended to support
... jurisdiction Σ 0..* CodeableConcept Intended jurisdiction for capability statement (if applicable)
Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use.


... purpose 0..1 markdown Why this capability statement is defined
... copyright 0..1 markdown Use and/or publishing restrictions
... kind ΣC 1..1 code instance | capability | requirements
Binding: CapabilityStatementKind (required): How a capability statement is intended to be used.

... instantiates Σ 0..* canonical(CapabilityStatement) Canonical URL of another capability statement this implements
... imports Σ 0..* canonical(CapabilityStatement) Canonical URL of another capability statement this adds to
... software ΣC 0..1 BackboneElement Software that is covered by this capability statement
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... name Σ 1..1 string A name the software is known by
.... version Σ 0..1 string Version covered by this statement
.... releaseDate Σ 0..1 dateTime Date this version was released
... implementation ΣC 1..1 BackboneElement If this describes a specific instance
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... description Σ 1..1 string Describes this specific instance
.... url Σ 1..1 url The URL of the server that the OpenAPI spec will be generated for. Used in example searchset fullUrls
.... custodian Σ 0..1 Reference(Organization) Organization that manages the data
... fhirVersion Σ 1..1 code FHIR Version the system supports
Binding: FHIRVersion (required): All published FHIR Versions.

... format Σ 1..1 code The media types supported by the API, e.g. application/json or application/fhir+json
Binding: Mime Types (required): The mime type of an attachment. Any valid mime type is allowed.


... patchFormat Σ 0..* code Patch formats supported
Binding: Mime Types (required): The mime type of an attachment. Any valid mime type is allowed.


... implementationGuide Σ 0..* canonical(ImplementationGuide) Implementation guides supported
... rest ΣC 0..* BackboneElement If the endpoint is a RESTful one
cpb-9: A given resource can only be described once per RESTful mode.
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... mode Σ 1..1 code The mode of the RESTful interface. A mode of server MUST be provided to generate an OpenAPI spec
Binding: RestfulCapabilityMode (required): The mode of a RESTful capability statement.

.... documentation 0..1 markdown General description of implementation
.... security Σ 0..1 BackboneElement Information about security of implementation
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... cors Σ 0..1 boolean Adds CORS Headers (http://enable-cors.org/)
..... service Σ 0..* CodeableConcept The security service that the server supports, to annotate in the OpenAPI security section
Binding: RestfulSecurityService (extensible): Types of security services used with FHIR.


..... description 0..1 markdown General description of how security works
.... resource ΣC 1..* BackboneElement Resource served on the REST interface
cpb-12: Search parameter names must be unique in the context of a resource.
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... type Σ 1..1 code The type of resource that the server supports. This MUST be provided to generate OpenAPI paths
Binding: ResourceType (required): One of the resource types defined as part of this version of FHIR.

..... profile Σ 0..1 canonical(StructureDefinition) The base profile that the resource supports. If not provided, the base resource schema from the FHIR specification will be used
..... supportedProfile Σ 0..* canonical(StructureDefinition) The profiles that the resource supports. This MUST be provided to generate OpenAPI schemas based on the FHIR profiles, and examples on each resource
..... documentation 0..1 markdown Additional information about the use of the resource type
..... interaction 0..* BackboneElement The interactions that the resource supports. This MUST be provided to generate OpenAPI operations
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... code 1..1 code read | vread | update | patch | delete | history-instance | history-type | create | search-type
Binding: TypeRestfulInteraction (required): Operations supported by REST at the type or instance level.

...... documentation 0..1 markdown Anything special about operation behavior
..... versioning 0..1 code no-version | versioned | versioned-update
Binding: ResourceVersionPolicy (required): How the system supports versioning for a resource.

..... readHistory 0..1 boolean Whether vRead can return past versions
..... updateCreate 0..1 boolean If update can commit to a new identity
..... conditionalCreate 0..1 boolean If allows/uses conditional create
..... conditionalRead 0..1 code not-supported | modified-since | not-match | full-support
Binding: ConditionalReadStatus (required): A code that indicates how the server supports conditional read.

..... conditionalUpdate 0..1 boolean If allows/uses conditional update
..... conditionalDelete 0..1 code not-supported | single | multiple - how conditional delete is supported
Binding: ConditionalDeleteStatus (required): A code that indicates how the server supports conditional delete.

..... referencePolicy 0..* code literal | logical | resolves | enforced | local
Binding: ReferenceHandlingPolicy (required): A set of flags that defines how references are supported.


..... searchInclude 0..* string _include values supported by the server
..... searchRevInclude 0..* string _revinclude values supported by the server
..... searchParam 0..* BackboneElement The search parameters that the resource supports. This MUST be provided to generate OpenAPI parameters on each resource
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... name 1..1 string Name of search parameter
...... definition 0..1 canonical(SearchParameter) Source of definition for parameter
...... type 1..1 code number | date | string | token | reference | composite | quantity | uri | special
Binding: SearchParamType (required): Data types allowed to be used for search parameters.

...... documentation 0..1 markdown Server-specific usage
..... operation Σ 0..* BackboneElement Custom operations that the resource supports. This MUST be provided to generate a OpenAPI path/operation
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... name Σ 1..1 string The name of the operation that the resource supports
...... definition Σ 1..1 canonical(OperationDefinition) The canonical URL of the operation definition that the resource supports
...... documentation 0..1 markdown Specific details about operation behavior
.... interaction 0..* BackboneElement What operations are supported?
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... code 1..1 code transaction | batch | search-system | history-system
Binding: SystemRestfulInteraction (required): Operations supported by REST at the system level.

..... documentation 0..1 markdown Anything special about operation behavior
.... searchParam 0..* See searchParam (CapabilityStatement) Search parameters for searching all resources
.... operation Σ 0..* See operation (CapabilityStatement) Custom operations that the server supports at at system level. This MUST be provided to generate a OpenAPI path/operation
.... compartment 0..* canonical(CompartmentDefinition) Compartments served/used by system
... messaging ΣC 0..* BackboneElement If messaging is supported
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... endpoint 0..* BackboneElement Where messages should be sent
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... protocol 1..1 Coding http | ftp | mllp +
Binding: MessageTransport (extensible): The protocol used for message transport.

..... address 1..1 url Network address or identifier of the end-point
.... reliableCache 0..1 unsignedInt Reliable Message Cache Length (min)
.... documentation 0..1 markdown Messaging interface behavior details
.... supportedMessage Σ 0..* BackboneElement Messages supported by this system
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... mode Σ 1..1 code sender | receiver
Binding: EventCapabilityMode (required): The mode of a message capability statement.

..... definition Σ 1..1 canonical(MessageDefinition) Message supported by this system
... document ΣC 0..* BackboneElement Document definition
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... mode Σ 1..1 code producer | consumer
Binding: DocumentMode (required): Whether the application produces or consumes documents.

.... documentation 0..1 markdown Description of document support
.... profile Σ 1..1 canonical(StructureDefinition) Constraint on the resources used in the document

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
CapabilityStatement.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
http://hl7.org/fhir/ValueSet/languages
from the FHIR Standard
CapabilityStatement.statusrequiredPublicationStatus
http://hl7.org/fhir/ValueSet/publication-status|4.0.1
from the FHIR Standard
CapabilityStatement.jurisdictionextensibleJurisdiction ValueSet
http://hl7.org/fhir/ValueSet/jurisdiction
from the FHIR Standard
CapabilityStatement.kindrequiredCapabilityStatementKind
http://hl7.org/fhir/ValueSet/capability-statement-kind|4.0.1
from the FHIR Standard
CapabilityStatement.fhirVersionrequiredFHIRVersion
http://hl7.org/fhir/ValueSet/FHIR-version|4.0.1
from the FHIR Standard
CapabilityStatement.formatrequiredMime Types (a valid code from urn:ietf:bcp:13)
http://hl7.org/fhir/ValueSet/mimetypes|4.0.1
from the FHIR Standard
CapabilityStatement.patchFormatrequiredMime Types (a valid code from urn:ietf:bcp:13)
http://hl7.org/fhir/ValueSet/mimetypes|4.0.1
from the FHIR Standard
CapabilityStatement.rest.moderequiredRestfulCapabilityMode
http://hl7.org/fhir/ValueSet/restful-capability-mode|4.0.1
from the FHIR Standard
CapabilityStatement.rest.security.serviceextensibleRestfulSecurityService
http://hl7.org/fhir/ValueSet/restful-security-service
from the FHIR Standard
CapabilityStatement.rest.resource.typerequiredResourceType
http://hl7.org/fhir/ValueSet/resource-types|4.0.1
from the FHIR Standard
CapabilityStatement.rest.resource.interaction.coderequiredTypeRestfulInteraction
http://hl7.org/fhir/ValueSet/type-restful-interaction|4.0.1
from the FHIR Standard
CapabilityStatement.rest.resource.versioningrequiredResourceVersionPolicy
http://hl7.org/fhir/ValueSet/versioning-policy|4.0.1
from the FHIR Standard
CapabilityStatement.rest.resource.conditionalReadrequiredConditionalReadStatus
http://hl7.org/fhir/ValueSet/conditional-read-status|4.0.1
from the FHIR Standard
CapabilityStatement.rest.resource.conditionalDeleterequiredConditionalDeleteStatus
http://hl7.org/fhir/ValueSet/conditional-delete-status|4.0.1
from the FHIR Standard
CapabilityStatement.rest.resource.referencePolicyrequiredReferenceHandlingPolicy
http://hl7.org/fhir/ValueSet/reference-handling-policy|4.0.1
from the FHIR Standard
CapabilityStatement.rest.resource.searchParam.typerequiredSearchParamType
http://hl7.org/fhir/ValueSet/search-param-type|4.0.1
from the FHIR Standard
CapabilityStatement.rest.interaction.coderequiredSystemRestfulInteraction
http://hl7.org/fhir/ValueSet/system-restful-interaction|4.0.1
from the FHIR Standard
CapabilityStatement.messaging.endpoint.protocolextensibleMessageTransport
http://hl7.org/fhir/ValueSet/message-transport
from the FHIR Standard
CapabilityStatement.messaging.supportedMessage.moderequiredEventCapabilityMode
http://hl7.org/fhir/ValueSet/event-capability-mode|4.0.1
from the FHIR Standard
CapabilityStatement.document.moderequiredDocumentMode
http://hl7.org/fhir/ValueSet/document-mode|4.0.1
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
contact-url-invarianterrorCapabilityStatementThe CapabilityStatement must have at least one contact where the system is a url.
: contact.telecom.where(system = 'url').exists()

This structure is derived from CapabilityStatement

Summary

Mandatory: 6 elements(1 nested mandatory element)

Extensions

This structure refers to these extensions:

Differential View

This structure is derived from CapabilityStatement

NameFlagsCard.TypeDescription & Constraintsdoco
.. CapabilityStatement C 0..* CapabilityStatement A statement of system capabilities
contact-url-invariant: The CapabilityStatement must have at least one contact where the system is a url.
... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
.... HnzApiSpecBuilderExtension 1..1 (Complex) Resource Metadata Extension
URL: https://fhir-ig.digital.health.nz/hnz-digital-tooling/StructureDefinition/resource-metadata-extension
... version 1..1 string The version of API, displayed in the OpenAPI contact section
... contact 1..* ContactDetail Contact details for the publisher
.... url 1..1 url The URL of the server that the OpenAPI spec will be generated for. Used in example searchset fullUrls
... format 1..1 code The media types supported by the API, e.g. application/json or application/fhir+json
... rest
.... mode 1..1 code The mode of the RESTful interface. A mode of server MUST be provided to generate an OpenAPI spec
.... security
..... service 0..* CodeableConcept The security service that the server supports, to annotate in the OpenAPI security section
.... resource 1..* BackboneElement Resource served on the REST interface
..... type 1..1 code The type of resource that the server supports. This MUST be provided to generate OpenAPI paths
..... profile 0..1 canonical(StructureDefinition) The base profile that the resource supports. If not provided, the base resource schema from the FHIR specification will be used
..... supportedProfile 0..* canonical(StructureDefinition) The profiles that the resource supports. This MUST be provided to generate OpenAPI schemas based on the FHIR profiles, and examples on each resource
..... interaction 0..* BackboneElement The interactions that the resource supports. This MUST be provided to generate OpenAPI operations
..... searchParam 0..* BackboneElement The search parameters that the resource supports. This MUST be provided to generate OpenAPI parameters on each resource
..... operation 0..* BackboneElement Custom operations that the resource supports. This MUST be provided to generate a OpenAPI path/operation
...... name 1..1 string The name of the operation that the resource supports
...... definition 1..1 canonical(OperationDefinition) The canonical URL of the operation definition that the resource supports
.... operation 0..* Custom operations that the server supports at at system level. This MUST be provided to generate a OpenAPI path/operation

doco Documentation for this format

Constraints

IdGradePath(s)DetailsRequirements
contact-url-invarianterrorCapabilityStatementThe CapabilityStatement must have at least one contact where the system is a url.
: contact.telecom.where(system = 'url').exists()

Key Elements View

NameFlagsCard.TypeDescription & Constraintsdoco
.. CapabilityStatement C 0..* CapabilityStatement A statement of system capabilities
cpb-0: Name should be usable as an identifier for the module by machine processing applications such as code generation
cpb-1: A Capability Statement SHALL have at least one of REST, messaging or document element.
cpb-2: A Capability Statement SHALL have at least one of description, software, or implementation element.
cpb-3: Messaging end-point is required (and is only permitted) when a statement is for an implementation.
cpb-7: The set of documents must be unique by the combination of profile and mode.
cpb-14: If kind = instance, implementation must be present and software may be present
cpb-15: If kind = capability, implementation must be absent, software must be present
cpb-16: If kind = requirements, implementation and software must be absent
contact-url-invariant: The CapabilityStatement must have at least one contact where the system is a url.
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
.... HnzApiSpecBuilderExtension 1..1 (Complex) Resource Metadata Extension
URL: https://fhir-ig.digital.health.nz/hnz-digital-tooling/StructureDefinition/resource-metadata-extension
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... status ?!Σ 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.

... date Σ 1..1 dateTime Date last changed
... contact Σ 1..* ContactDetail Contact details for the publisher
... kind ΣC 1..1 code instance | capability | requirements
Binding: CapabilityStatementKind (required): How a capability statement is intended to be used.

... implementation ΣC 1..1 BackboneElement If this describes a specific instance
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... description Σ 1..1 string Describes this specific instance
.... url Σ 1..1 url The URL of the server that the OpenAPI spec will be generated for. Used in example searchset fullUrls
... fhirVersion Σ 1..1 code FHIR Version the system supports
Binding: FHIRVersion (required): All published FHIR Versions.

... format Σ 1..1 code The media types supported by the API, e.g. application/json or application/fhir+json
Binding: Mime Types (required): The mime type of an attachment. Any valid mime type is allowed.



doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
CapabilityStatement.statusrequiredPublicationStatus
http://hl7.org/fhir/ValueSet/publication-status|4.0.1
from the FHIR Standard
CapabilityStatement.kindrequiredCapabilityStatementKind
http://hl7.org/fhir/ValueSet/capability-statement-kind|4.0.1
from the FHIR Standard
CapabilityStatement.fhirVersionrequiredFHIRVersion
http://hl7.org/fhir/ValueSet/FHIR-version|4.0.1
from the FHIR Standard
CapabilityStatement.formatrequiredMime Types (a valid code from urn:ietf:bcp:13)
http://hl7.org/fhir/ValueSet/mimetypes|4.0.1
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
contact-url-invarianterrorCapabilityStatementThe CapabilityStatement must have at least one contact where the system is a url.
: contact.telecom.where(system = 'url').exists()

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. CapabilityStatement C 0..* CapabilityStatement A statement of system capabilities
cpb-0: Name should be usable as an identifier for the module by machine processing applications such as code generation
cpb-1: A Capability Statement SHALL have at least one of REST, messaging or document element.
cpb-2: A Capability Statement SHALL have at least one of description, software, or implementation element.
cpb-3: Messaging end-point is required (and is only permitted) when a statement is for an implementation.
cpb-7: The set of documents must be unique by the combination of profile and mode.
cpb-14: If kind = instance, implementation must be present and software may be present
cpb-15: If kind = capability, implementation must be absent, software must be present
cpb-16: If kind = requirements, implementation and software must be absent
contact-url-invariant: The CapabilityStatement must have at least one contact where the system is a url.
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... language 0..1 code Language of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguages Max Binding
... text 0..1 Narrative Text summary of the resource, for human interpretation
... contained 0..* Resource Contained, inline Resources
... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
.... HnzApiSpecBuilderExtension 1..1 (Complex) Resource Metadata Extension
URL: https://fhir-ig.digital.health.nz/hnz-digital-tooling/StructureDefinition/resource-metadata-extension
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... url Σ 0..1 uri Canonical identifier for this capability statement, represented as a URI (globally unique)
... version Σ 1..1 string The version of API, displayed in the OpenAPI contact section
... name ΣC 0..1 string Name for this capability statement (computer friendly)
... title Σ 0..1 string Name for this capability statement (human friendly)
... status ?!Σ 1..1 code draft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.

... experimental Σ 0..1 boolean For testing purposes, not real usage
... date Σ 1..1 dateTime Date last changed
... publisher Σ 0..1 string Name of the publisher (organization or individual)
... contact Σ 1..* ContactDetail Contact details for the publisher
... description C 0..1 markdown Natural language description of the capability statement
... useContext Σ 0..* UsageContext The context that the content is intended to support
... jurisdiction Σ 0..* CodeableConcept Intended jurisdiction for capability statement (if applicable)
Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use.


... purpose 0..1 markdown Why this capability statement is defined
... copyright 0..1 markdown Use and/or publishing restrictions
... kind ΣC 1..1 code instance | capability | requirements
Binding: CapabilityStatementKind (required): How a capability statement is intended to be used.

... instantiates Σ 0..* canonical(CapabilityStatement) Canonical URL of another capability statement this implements
... imports Σ 0..* canonical(CapabilityStatement) Canonical URL of another capability statement this adds to
... software ΣC 0..1 BackboneElement Software that is covered by this capability statement
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... name Σ 1..1 string A name the software is known by
.... version Σ 0..1 string Version covered by this statement
.... releaseDate Σ 0..1 dateTime Date this version was released
... implementation ΣC 1..1 BackboneElement If this describes a specific instance
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... description Σ 1..1 string Describes this specific instance
.... url Σ 1..1 url The URL of the server that the OpenAPI spec will be generated for. Used in example searchset fullUrls
.... custodian Σ 0..1 Reference(Organization) Organization that manages the data
... fhirVersion Σ 1..1 code FHIR Version the system supports
Binding: FHIRVersion (required): All published FHIR Versions.

... format Σ 1..1 code The media types supported by the API, e.g. application/json or application/fhir+json
Binding: Mime Types (required): The mime type of an attachment. Any valid mime type is allowed.


... patchFormat Σ 0..* code Patch formats supported
Binding: Mime Types (required): The mime type of an attachment. Any valid mime type is allowed.


... implementationGuide Σ 0..* canonical(ImplementationGuide) Implementation guides supported
... rest ΣC 0..* BackboneElement If the endpoint is a RESTful one
cpb-9: A given resource can only be described once per RESTful mode.
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... mode Σ 1..1 code The mode of the RESTful interface. A mode of server MUST be provided to generate an OpenAPI spec
Binding: RestfulCapabilityMode (required): The mode of a RESTful capability statement.

.... documentation 0..1 markdown General description of implementation
.... security Σ 0..1 BackboneElement Information about security of implementation
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... cors Σ 0..1 boolean Adds CORS Headers (http://enable-cors.org/)
..... service Σ 0..* CodeableConcept The security service that the server supports, to annotate in the OpenAPI security section
Binding: RestfulSecurityService (extensible): Types of security services used with FHIR.


..... description 0..1 markdown General description of how security works
.... resource ΣC 1..* BackboneElement Resource served on the REST interface
cpb-12: Search parameter names must be unique in the context of a resource.
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... type Σ 1..1 code The type of resource that the server supports. This MUST be provided to generate OpenAPI paths
Binding: ResourceType (required): One of the resource types defined as part of this version of FHIR.

..... profile Σ 0..1 canonical(StructureDefinition) The base profile that the resource supports. If not provided, the base resource schema from the FHIR specification will be used
..... supportedProfile Σ 0..* canonical(StructureDefinition) The profiles that the resource supports. This MUST be provided to generate OpenAPI schemas based on the FHIR profiles, and examples on each resource
..... documentation 0..1 markdown Additional information about the use of the resource type
..... interaction 0..* BackboneElement The interactions that the resource supports. This MUST be provided to generate OpenAPI operations
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... code 1..1 code read | vread | update | patch | delete | history-instance | history-type | create | search-type
Binding: TypeRestfulInteraction (required): Operations supported by REST at the type or instance level.

...... documentation 0..1 markdown Anything special about operation behavior
..... versioning 0..1 code no-version | versioned | versioned-update
Binding: ResourceVersionPolicy (required): How the system supports versioning for a resource.

..... readHistory 0..1 boolean Whether vRead can return past versions
..... updateCreate 0..1 boolean If update can commit to a new identity
..... conditionalCreate 0..1 boolean If allows/uses conditional create
..... conditionalRead 0..1 code not-supported | modified-since | not-match | full-support
Binding: ConditionalReadStatus (required): A code that indicates how the server supports conditional read.

..... conditionalUpdate 0..1 boolean If allows/uses conditional update
..... conditionalDelete 0..1 code not-supported | single | multiple - how conditional delete is supported
Binding: ConditionalDeleteStatus (required): A code that indicates how the server supports conditional delete.

..... referencePolicy 0..* code literal | logical | resolves | enforced | local
Binding: ReferenceHandlingPolicy (required): A set of flags that defines how references are supported.


..... searchInclude 0..* string _include values supported by the server
..... searchRevInclude 0..* string _revinclude values supported by the server
..... searchParam 0..* BackboneElement The search parameters that the resource supports. This MUST be provided to generate OpenAPI parameters on each resource
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... name 1..1 string Name of search parameter
...... definition 0..1 canonical(SearchParameter) Source of definition for parameter
...... type 1..1 code number | date | string | token | reference | composite | quantity | uri | special
Binding: SearchParamType (required): Data types allowed to be used for search parameters.

...... documentation 0..1 markdown Server-specific usage
..... operation Σ 0..* BackboneElement Custom operations that the resource supports. This MUST be provided to generate a OpenAPI path/operation
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
...... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
...... name Σ 1..1 string The name of the operation that the resource supports
...... definition Σ 1..1 canonical(OperationDefinition) The canonical URL of the operation definition that the resource supports
...... documentation 0..1 markdown Specific details about operation behavior
.... interaction 0..* BackboneElement What operations are supported?
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... code 1..1 code transaction | batch | search-system | history-system
Binding: SystemRestfulInteraction (required): Operations supported by REST at the system level.

..... documentation 0..1 markdown Anything special about operation behavior
.... searchParam 0..* See searchParam (CapabilityStatement) Search parameters for searching all resources
.... operation Σ 0..* See operation (CapabilityStatement) Custom operations that the server supports at at system level. This MUST be provided to generate a OpenAPI path/operation
.... compartment 0..* canonical(CompartmentDefinition) Compartments served/used by system
... messaging ΣC 0..* BackboneElement If messaging is supported
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... endpoint 0..* BackboneElement Where messages should be sent
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... protocol 1..1 Coding http | ftp | mllp +
Binding: MessageTransport (extensible): The protocol used for message transport.

..... address 1..1 url Network address or identifier of the end-point
.... reliableCache 0..1 unsignedInt Reliable Message Cache Length (min)
.... documentation 0..1 markdown Messaging interface behavior details
.... supportedMessage Σ 0..* BackboneElement Messages supported by this system
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... mode Σ 1..1 code sender | receiver
Binding: EventCapabilityMode (required): The mode of a message capability statement.

..... definition Σ 1..1 canonical(MessageDefinition) Message supported by this system
... document ΣC 0..* BackboneElement Document definition
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... mode Σ 1..1 code producer | consumer
Binding: DocumentMode (required): Whether the application produces or consumes documents.

.... documentation 0..1 markdown Description of document support
.... profile Σ 1..1 canonical(StructureDefinition) Constraint on the resources used in the document

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
CapabilityStatement.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
http://hl7.org/fhir/ValueSet/languages
from the FHIR Standard
CapabilityStatement.statusrequiredPublicationStatus
http://hl7.org/fhir/ValueSet/publication-status|4.0.1
from the FHIR Standard
CapabilityStatement.jurisdictionextensibleJurisdiction ValueSet
http://hl7.org/fhir/ValueSet/jurisdiction
from the FHIR Standard
CapabilityStatement.kindrequiredCapabilityStatementKind
http://hl7.org/fhir/ValueSet/capability-statement-kind|4.0.1
from the FHIR Standard
CapabilityStatement.fhirVersionrequiredFHIRVersion
http://hl7.org/fhir/ValueSet/FHIR-version|4.0.1
from the FHIR Standard
CapabilityStatement.formatrequiredMime Types (a valid code from urn:ietf:bcp:13)
http://hl7.org/fhir/ValueSet/mimetypes|4.0.1
from the FHIR Standard
CapabilityStatement.patchFormatrequiredMime Types (a valid code from urn:ietf:bcp:13)
http://hl7.org/fhir/ValueSet/mimetypes|4.0.1
from the FHIR Standard
CapabilityStatement.rest.moderequiredRestfulCapabilityMode
http://hl7.org/fhir/ValueSet/restful-capability-mode|4.0.1
from the FHIR Standard
CapabilityStatement.rest.security.serviceextensibleRestfulSecurityService
http://hl7.org/fhir/ValueSet/restful-security-service
from the FHIR Standard
CapabilityStatement.rest.resource.typerequiredResourceType
http://hl7.org/fhir/ValueSet/resource-types|4.0.1
from the FHIR Standard
CapabilityStatement.rest.resource.interaction.coderequiredTypeRestfulInteraction
http://hl7.org/fhir/ValueSet/type-restful-interaction|4.0.1
from the FHIR Standard
CapabilityStatement.rest.resource.versioningrequiredResourceVersionPolicy
http://hl7.org/fhir/ValueSet/versioning-policy|4.0.1
from the FHIR Standard
CapabilityStatement.rest.resource.conditionalReadrequiredConditionalReadStatus
http://hl7.org/fhir/ValueSet/conditional-read-status|4.0.1
from the FHIR Standard
CapabilityStatement.rest.resource.conditionalDeleterequiredConditionalDeleteStatus
http://hl7.org/fhir/ValueSet/conditional-delete-status|4.0.1
from the FHIR Standard
CapabilityStatement.rest.resource.referencePolicyrequiredReferenceHandlingPolicy
http://hl7.org/fhir/ValueSet/reference-handling-policy|4.0.1
from the FHIR Standard
CapabilityStatement.rest.resource.searchParam.typerequiredSearchParamType
http://hl7.org/fhir/ValueSet/search-param-type|4.0.1
from the FHIR Standard
CapabilityStatement.rest.interaction.coderequiredSystemRestfulInteraction
http://hl7.org/fhir/ValueSet/system-restful-interaction|4.0.1
from the FHIR Standard
CapabilityStatement.messaging.endpoint.protocolextensibleMessageTransport
http://hl7.org/fhir/ValueSet/message-transport
from the FHIR Standard
CapabilityStatement.messaging.supportedMessage.moderequiredEventCapabilityMode
http://hl7.org/fhir/ValueSet/event-capability-mode|4.0.1
from the FHIR Standard
CapabilityStatement.document.moderequiredDocumentMode
http://hl7.org/fhir/ValueSet/document-mode|4.0.1
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
contact-url-invarianterrorCapabilityStatementThe CapabilityStatement must have at least one contact where the system is a url.
: contact.telecom.where(system = 'url').exists()

This structure is derived from CapabilityStatement

Summary

Mandatory: 6 elements(1 nested mandatory element)

Extensions

This structure refers to these extensions:

 

Other representations of profile: CSV, Excel, Schematron