Order Catalog Implementation Guide
current - CI Build
Order Catalog Implementation Guide
current - CI Build
Order Catalog Implementation Guide, published by HL7 International - Orders and Observations Work Group. This is not an authorized publication; it is the continuous build for version current). This version is based on the current content of https://github.com/HL7/fhir-order-catalog/ and changes regularly. See the Directory of published versions
| Official URL: http://hl7.org/fhir/uv/order-catalog/StructureDefinition/CatalogMessageDefinition | Version: current | |||
| Draft as of 2020-04-02 | Computable Name: CatalogMessageDefinition | |||
This profile constrains MessageDefinition in the context of messaging the content of catalogs, in conformance with the FHIR messaging framework
This profile specifies the event codes that are available for messaging the content of catalogs between a system owning a catalog and a system interested in the catalog content, in whole or in part.
Usage:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
This structure is derived from MessageDefinition
| Name | Flags | Card. | Type | Description & Constraints |
|---|---|---|---|---|
  MessageDefinition | 0..* | MessageDefinition | A resource that defines a type of message that can be exchanged between systems | |
  event[x] | S | 1..1 | Coding | Event code Binding: Message event codes for exchanging order catalog content (extensible): message events for messages conveying order-catalog content |
 category | 0..1 | code | consequence | currency | notification Fixed Value: consequence | |
 responseRequired | S | 1..1 | code | always | on-error | never | on-success |
| Documentation for this format | ||||
| Path | Conformance | ValueSet |
| MessageDefinition.event[x] | extensible | CatalogMessageEventVS |
| Name | Flags | Card. | Type | Description & Constraints |
|---|---|---|---|---|
| MessageDefinition | C | 0..* | MessageDefinition | A resource that defines a type of message that can be exchanged between systems |
 implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created |
 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 |
| event[x] | SΣ | 1..1 | Coding | Event code Binding: Message event codes for exchanging order catalog content (extensible): message events for messages conveying order-catalog content |
| category | Σ | 0..1 | code | consequence | currency | notification Binding: MessageSignificanceCategory (required): The impact of the content of a message. Fixed Value: consequence |
| responseRequired | S | 1..1 | code | always | on-error | never | on-success Binding: messageheader-response-request (required): This enables the capability currently available through MSH-16 (Application Level acknowledgement) in HL7 Version 2 to declare at a message definition level whether a response is required or only upon error or success, or never. Example General: always |
| Documentation for this format | ||||
| Path | Conformance | ValueSet / Code |
| MessageDefinition.status | required | PublicationStatus |
| MessageDefinition.event[x] | extensible | CatalogMessageEventVS |
| MessageDefinition.category | required | Fixed Value: consequence |
| MessageDefinition.responseRequired | required | messageheader-response-request |
| Id | Grade | Path(s) | Details | Requirements |
| cnl-0 | warning | MessageDefinition | Name should be usable as an identifier for the module by machine processing applications such as code generation : name.exists() implies name.matches('[A-Z]([A-Za-z0-9_]){1,254}') | |
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both : extension.exists() != value.exists() |
| Name | Flags | Card. | Type | Description & Constraints | ||||
|---|---|---|---|---|---|---|---|---|
| MessageDefinition | C | 0..* | MessageDefinition | A resource that defines a type of message that can be exchanged between systems | ||||
| 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): IETF language tag
| |||||
| text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |||||
| contained | 0..* | Resource | Contained, inline Resources | |||||
 extension | 0..* | Extension | Additional content defined by implementations | |||||
| modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored | ||||
| url | ΣC | 0..1 | uri | Business Identifier for a given MessageDefinition | ||||
| identifier | Σ | 0..* | Identifier | Primary key for the message definition on a given server | ||||
| version | Σ | 0..1 | string | Business version of the message definition | ||||
| name | ΣC | 0..1 | string | Name for this message definition (computer friendly) | ||||
| title | Σ | 0..1 | string | Name for this message definition (human friendly) | ||||
| replaces | Σ | 0..* | canonical(MessageDefinition) | Takes the place of | ||||
| 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/steward (organization or individual) | ||||
| contact | Σ | 0..* | ContactDetail | Contact details for the publisher | ||||
| description | Σ | 0..1 | markdown | Natural language description of the message definition | ||||
| useContext | Σ | 0..* | UsageContext | The context that the content is intended to support | ||||
| jurisdiction | Σ | 0..* | CodeableConcept | Intended jurisdiction for message definition (if applicable) Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use. | ||||
| purpose | Σ | 0..1 | markdown | Why this message definition is defined | ||||
| copyright | 0..1 | markdown | Use and/or publishing restrictions | |||||
| base | Σ | 0..1 | canonical(MessageDefinition) | Definition this one is based on | ||||
| parent | Σ | 0..* | canonical(ActivityDefinition | PlanDefinition) | Protocol/workflow this is part of | ||||
| event[x] | SΣ | 1..1 | Coding | Event code Binding: Message event codes for exchanging order catalog content (extensible): message events for messages conveying order-catalog content | ||||
| category | Σ | 0..1 | code | consequence | currency | notification Binding: MessageSignificanceCategory (required): The impact of the content of a message. Fixed Value: consequence | ||||
 focus | ΣC | 0..* | BackboneElement | Resource(s) that are the subject of the event | ||||
 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 | Type of resource Binding: ResourceType (required): One of the resource types defined as part of this version of FHIR. | ||||
| profile | 0..1 | canonical(StructureDefinition) | Profile that must be adhered to by focus | |||||
| min | Σ | 1..1 | unsignedInt | Minimum number of focuses of this type | ||||
| max | C | 0..1 | string | Maximum number of focuses of this type | ||||
| responseRequired | S | 1..1 | code | always | on-error | never | on-success Binding: messageheader-response-request (required): This enables the capability currently available through MSH-16 (Application Level acknowledgement) in HL7 Version 2 to declare at a message definition level whether a response is required or only upon error or success, or never. Example General: always | ||||
| allowedResponse | 0..* | BackboneElement | Responses to this message | |||||
| 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 | ||||
| message | 1..1 | canonical(MessageDefinition) | Reference to allowed message definition response | |||||
| situation | 0..1 | markdown | When should this response be used | |||||
| graph | 0..1 | canonical(GraphDefinition) | Canonical reference to a GraphDefinition | |||||
| Documentation for this format | ||||||||
| Path | Conformance | ValueSet / Code | ||||
| MessageDefinition.language | preferred | CommonLanguages
| ||||
| MessageDefinition.status | required | PublicationStatus | ||||
| MessageDefinition.jurisdiction | extensible | Jurisdiction ValueSet | ||||
| MessageDefinition.event[x] | extensible | CatalogMessageEventVS | ||||
| MessageDefinition.category | required | Fixed Value: consequence | ||||
| MessageDefinition.focus.code | required | ResourceType | ||||
| MessageDefinition.responseRequired | required | messageheader-response-request |
| Id | Grade | Path(s) | Details | Requirements |
| cnl-1 | warning | MessageDefinition.url | URL should not contain | or # - these characters make processing canonical references problematic : url.matches('([^|#])*') | |
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
| md-1 | error | MessageDefinition.focus | Max must be postive int or * : max='*' or (max.toInteger() > 0) |
This structure is derived from MessageDefinition
Differential View
This structure is derived from MessageDefinition
| Name | Flags | Card. | Type | Description & Constraints |
|---|---|---|---|---|
| MessageDefinition | 0..* | MessageDefinition | A resource that defines a type of message that can be exchanged between systems | |
| event[x] | S | 1..1 | Coding | Event code Binding: Message event codes for exchanging order catalog content (extensible): message events for messages conveying order-catalog content |
| category | 0..1 | code | consequence | currency | notification Fixed Value: consequence | |
| responseRequired | S | 1..1 | code | always | on-error | never | on-success |
| Documentation for this format | ||||
| Path | Conformance | ValueSet |
| MessageDefinition.event[x] | extensible | CatalogMessageEventVS |
Key Elements View
| Name | Flags | Card. | Type | Description & Constraints |
|---|---|---|---|---|
| MessageDefinition | C | 0..* | MessageDefinition | A resource that defines a type of message that can be exchanged between systems |
| implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created |
| 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 |
| event[x] | SΣ | 1..1 | Coding | Event code Binding: Message event codes for exchanging order catalog content (extensible): message events for messages conveying order-catalog content |
| category | Σ | 0..1 | code | consequence | currency | notification Binding: MessageSignificanceCategory (required): The impact of the content of a message. Fixed Value: consequence |
| responseRequired | S | 1..1 | code | always | on-error | never | on-success Binding: messageheader-response-request (required): This enables the capability currently available through MSH-16 (Application Level acknowledgement) in HL7 Version 2 to declare at a message definition level whether a response is required or only upon error or success, or never. Example General: always |
| Documentation for this format | ||||
| Path | Conformance | ValueSet / Code |
| MessageDefinition.status | required | PublicationStatus |
| MessageDefinition.event[x] | extensible | CatalogMessageEventVS |
| MessageDefinition.category | required | Fixed Value: consequence |
| MessageDefinition.responseRequired | required | messageheader-response-request |
| Id | Grade | Path(s) | Details | Requirements |
| cnl-0 | warning | MessageDefinition | Name should be usable as an identifier for the module by machine processing applications such as code generation : name.exists() implies name.matches('[A-Z]([A-Za-z0-9_]){1,254}') | |
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both : extension.exists() != value.exists() |
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints | ||||
|---|---|---|---|---|---|---|---|---|
| MessageDefinition | C | 0..* | MessageDefinition | A resource that defines a type of message that can be exchanged between systems | ||||
| 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): IETF language tag
| |||||
| text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |||||
| contained | 0..* | Resource | Contained, inline Resources | |||||
| extension | 0..* | Extension | Additional content defined by implementations | |||||
| modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored | ||||
| url | ΣC | 0..1 | uri | Business Identifier for a given MessageDefinition | ||||
| identifier | Σ | 0..* | Identifier | Primary key for the message definition on a given server | ||||
| version | Σ | 0..1 | string | Business version of the message definition | ||||
| name | ΣC | 0..1 | string | Name for this message definition (computer friendly) | ||||
| title | Σ | 0..1 | string | Name for this message definition (human friendly) | ||||
| replaces | Σ | 0..* | canonical(MessageDefinition) | Takes the place of | ||||
| 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/steward (organization or individual) | ||||
| contact | Σ | 0..* | ContactDetail | Contact details for the publisher | ||||
| description | Σ | 0..1 | markdown | Natural language description of the message definition | ||||
| useContext | Σ | 0..* | UsageContext | The context that the content is intended to support | ||||
| jurisdiction | Σ | 0..* | CodeableConcept | Intended jurisdiction for message definition (if applicable) Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use. | ||||
| purpose | Σ | 0..1 | markdown | Why this message definition is defined | ||||
| copyright | 0..1 | markdown | Use and/or publishing restrictions | |||||
| base | Σ | 0..1 | canonical(MessageDefinition) | Definition this one is based on | ||||
| parent | Σ | 0..* | canonical(ActivityDefinition | PlanDefinition) | Protocol/workflow this is part of | ||||
| event[x] | SΣ | 1..1 | Coding | Event code Binding: Message event codes for exchanging order catalog content (extensible): message events for messages conveying order-catalog content | ||||
| category | Σ | 0..1 | code | consequence | currency | notification Binding: MessageSignificanceCategory (required): The impact of the content of a message. Fixed Value: consequence | ||||
| focus | ΣC | 0..* | BackboneElement | Resource(s) that are the subject of the event | ||||
| 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 | Type of resource Binding: ResourceType (required): One of the resource types defined as part of this version of FHIR. | ||||
| profile | 0..1 | canonical(StructureDefinition) | Profile that must be adhered to by focus | |||||
| min | Σ | 1..1 | unsignedInt | Minimum number of focuses of this type | ||||
| max | C | 0..1 | string | Maximum number of focuses of this type | ||||
| responseRequired | S | 1..1 | code | always | on-error | never | on-success Binding: messageheader-response-request (required): This enables the capability currently available through MSH-16 (Application Level acknowledgement) in HL7 Version 2 to declare at a message definition level whether a response is required or only upon error or success, or never. Example General: always | ||||
| allowedResponse | 0..* | BackboneElement | Responses to this message | |||||
| 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 | ||||
| message | 1..1 | canonical(MessageDefinition) | Reference to allowed message definition response | |||||
| situation | 0..1 | markdown | When should this response be used | |||||
| graph | 0..1 | canonical(GraphDefinition) | Canonical reference to a GraphDefinition | |||||
| Documentation for this format | ||||||||
| Path | Conformance | ValueSet / Code | ||||
| MessageDefinition.language | preferred | CommonLanguages
| ||||
| MessageDefinition.status | required | PublicationStatus | ||||
| MessageDefinition.jurisdiction | extensible | Jurisdiction ValueSet | ||||
| MessageDefinition.event[x] | extensible | CatalogMessageEventVS | ||||
| MessageDefinition.category | required | Fixed Value: consequence | ||||
| MessageDefinition.focus.code | required | ResourceType | ||||
| MessageDefinition.responseRequired | required | messageheader-response-request |
| Id | Grade | Path(s) | Details | Requirements |
| cnl-1 | warning | MessageDefinition.url | URL should not contain | or # - these characters make processing canonical references problematic : url.matches('([^|#])*') | |
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both : extension.exists() != value.exists() | |
| md-1 | error | MessageDefinition.focus | Max must be postive int or * : max='*' or (max.toInteger() > 0) |
This structure is derived from MessageDefinition
Other representations of profile: CSV, Excel, Schematron
IG © 2021+ HL7 International - Orders and Observations Work Group. Package hl7.fhir.uv.order-catalog#current based on FHIR 5.0.0-ballot. Generated 2023-01-08
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change