This
page
is
part
of
the
FHIR
Specification
(v3.0.2:
STU
3).
(v3.3.0:
R4
Ballot
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
.
Page
versions:
R5
R4B
R4
R3
Infrastructure
And
Messaging
Work
Group
|
Maturity
Level
:
|
Draft | Compartments : Not linked to any defined compartments |
Detailed Descriptions for the elements in the MessageDefinition resource.
| MessageDefinition | |
| Element Id | MessageDefinition |
| Definition |
Defines the characteristics of a message that can be shared between systems, including the type of event that initiates the message, the content to be transmitted and what response(s), if any, are permitted. |
| Control | 1..1 |
| Requirements |
Allows messages to be defined once and re-used across systems. |
| Comments |
This would be a MIF-level artifact. |
| MessageDefinition.url | |
| Element Id | MessageDefinition.url |
| Definition |
An
absolute
URI
that
is
used
to
identify
this
message
definition
when
it
is
referenced
in
a
specification,
model,
design
or
an
|
| Control | 0..1 |
| Type | uri |
| Requirements |
Allows the message definition to be referenced by a single globally unique identifier. |
| Summary | true |
| Comments |
Can
be
a
urn:uuid:
or
a
The URL SHOULD include the major version of the message definition. For more information see Technical and Business Versions . |
| MessageDefinition.identifier | |
| Element Id | MessageDefinition.identifier |
| Definition |
A formal identifier that is used to identify this message definition when it is represented in other formats, or referenced in a specification, model, design or an instance. |
| Note | This is a business identifer, not a resource identifier (see discussion ) |
| Control | 0..1 |
| Type | Identifier |
| Requirements |
Allows externally provided and/or usable business identifiers to be easily associated with the module. |
| Summary | true |
| Comments |
Typically,
this
is
used
for
identifiers
that
can
go
in
an
HL7
V3
II
(instance
identifier)
data
type,
|
| MessageDefinition.version | |
| Element Id | MessageDefinition.version |
| Definition |
The identifier that is used to identify this version of the message definition when it is referenced in a specification, model, design or instance. This is an arbitrary value managed by the message definition author and is not expected to be globally unique. For example, it might be a timestamp (e.g. yyyymmdd) if a managed version is not available. There is also no expectation that versions can be placed in a lexicographical sequence. |
| Note | This is a business versionId, not a resource version id (see discussion ) |
| Control | 0..1 |
| Type | string |
| Summary | true |
| Comments |
There
may
be
different
message
definition
instances
that
have
the
same
identifier
but
different
versions.
The
version
can
be
appended
to
the
url
in
a
reference
to
allow
a
|
| MessageDefinition.name | |
| Element Id | MessageDefinition.name |
| Definition |
A natural language name identifying the message definition. This name should be usable as an identifier for the module by machine processing applications such as code generation. |
| Control | 0..1 |
| Type | string |
| Requirements |
Support human navigation and code generation. |
| Summary | true |
| Comments |
The
name
is
not
expected
to
be
globally
unique.
The
name
should
be
a
simple
|
| MessageDefinition.title | |
| Element Id | MessageDefinition.title |
| Definition |
A short, descriptive, user-friendly title for the message definition. |
| Control | 0..1 |
| Type | string |
| Summary | true |
| Comments |
This name does not need to be machine-processing friendly and may contain punctuation, white-space, etc. |
| MessageDefinition.replaces | |
| Element Id | MessageDefinition.replaces |
| Definition | A MessageDefinition that is superseded by this definition. |
| Control | 0..* |
| Type | canonical ( MessageDefinition ) |
| Summary | true |
| MessageDefinition.status | |
| Element Id | MessageDefinition.status |
| Definition |
The status of this message definition. Enables tracking the life-cycle of the content. |
| Control | 1..1 |
| Terminology Binding | PublicationStatus ( Required ) |
| Type | code |
| Is Modifier | true (Reason: null) |
| Summary | true |
| Comments |
Allows
filtering
of
message
definitions
that
are
appropriate
for
use
|
| MessageDefinition.experimental | |
| Element Id | MessageDefinition.experimental |
| Definition |
A
|
| Control | 0..1 |
| Type | boolean |
| Is Modifier | true (Reason: null) |
| Requirements |
Enables experimental content to be developed following the same lifecycle that would be used for a production-level message definition. |
| Summary | true |
| Comments |
Allows
filtering
of
message
|
| MessageDefinition.date | |
| Element Id | MessageDefinition.date |
| Definition |
The
date
(and
optionally
time)
when
the
message
definition
was
published.
The
date
must
change
|
| Control | 1..1 |
| Type | dateTime |
| Alternate Names | Revision Date |
| Summary | true |
| Comments |
Note that this is not the same as the resource last-modified-date, since the resource may be a secondary representation of the message definition. Additional specific dates may be added as extensions or be found by consulting Provenances associated with past versions of the resource. |
| MessageDefinition.publisher | |
| Element Id | MessageDefinition.publisher |
| Definition |
The
name
of
the
|
| Control | 0..1 |
| Type | string |
| Requirements |
Helps
establish
the
|
| Summary | true |
| Comments |
Usually
an
|
| MessageDefinition.contact | |
| Element Id | MessageDefinition.contact |
| Definition |
Contact details to assist a user in finding and communicating with the publisher. |
| Control | 0..* |
| Type | ContactDetail |
| Summary | true |
| Comments |
May be a web site, an email address, a telephone number, etc. |
| MessageDefinition.description | |
| Element Id | MessageDefinition.description |
| Definition |
A free text natural language description of the message definition from a consumer's perspective. |
| Control | 0..1 |
| Type | markdown |
| Summary | true |
| Comments |
This description can be used to capture details such as why the message definition was built, comments about misuse, instructions for clinical use and interpretation, literature references, examples from the paper world, etc. It is not a rendering of the message definition as conveyed in the 'text' field of the resource itself. This item SHOULD be populated unless the information is available from context (e.g. the language of the profile is presumed to be the predominant language in the place the profile was created). |
| MessageDefinition.useContext | |
| Element Id | MessageDefinition.useContext |
| Definition |
The content was developed with a focus and intent of supporting the contexts that are listed. These terms may be used to assist with indexing and searching for appropriate message definition instances. |
| Control | 0..* |
| Type | UsageContext |
| Requirements |
Assist in searching for appropriate content. |
| Summary | true |
| Comments |
When
multiple
useContexts
are
specified,
there
is
no
expectation
|
| MessageDefinition.jurisdiction | |
| Element Id | MessageDefinition.jurisdiction |
| Definition |
A legal or geographic region in which the message definition is intended to be used. |
| Control | 0..* |
| Terminology Binding | Jurisdiction ValueSet ( Extensible ) |
| Type | CodeableConcept |
| Summary | true |
| Comments |
It may be possible for the message definition to be used in jurisdictions other than those for which it was originally designed or intended. |
| MessageDefinition.purpose | |
| Element Id | MessageDefinition.purpose |
| Definition |
|
| Control | 0..1 |
| Type | markdown |
| Summary | true |
| Comments |
This
element
does
not
describe
the
usage
of
the
message
|
| MessageDefinition.copyright | |
| Element Id | MessageDefinition.copyright |
| Definition |
A copyright statement relating to the message definition and/or its contents. Copyright statements are generally legal restrictions on the use and publishing of the message definition. |
| Control | 0..1 |
| Type | markdown |
| Requirements |
Consumers must be able to determine any legal restrictions on the use of the message definition and/or its content. |
| Alternate Names | License; Restrictions |
| MessageDefinition.base | |
| Element Id | MessageDefinition.base |
| Definition |
The MessageDefinition that is the basis for the contents of this resource. |
| Control | 0..1 |
| Type |
|
| Summary | true |
| MessageDefinition.parent | |
| Element Id | MessageDefinition.parent |
| Definition |
Identifies a protocol or workflow that this MessageDefinition represents a step in. |
| Control | 0..* |
| Type |
|
| Summary | true |
|
|
|
|
|
|
| Definition |
|
| Control | 1..1 |
| Terminology Binding | the Event List in the messaging framework |
| Type | Coding | uri |
|
|
|
|
|
|
| MessageDefinition.category | |
| Element Id | MessageDefinition.category |
| Definition |
The impact of the content of the message. |
| Control | 0..1 |
| Terminology Binding | MessageSignificanceCategory ( Required ) |
| Type | code |
| Summary | true |
| MessageDefinition.focus | |
| Element Id | MessageDefinition.focus |
| Definition |
Identifies the resource (or resources) that are being addressed by the event. For example, the Encounter for an admit message or two Account records for a merge. |
| Control | 0..* |
| Summary | true |
| Invariants |
Defined
on
this
element
md-1 : Max must be postive int or * ( expression
:
max='*'
or
(max.toInteger()
>
0),
xpath:
f:max/@value='*'
or
number(f:max/@value)
>
0)
|
| MessageDefinition.focus.code | |
| Element Id | MessageDefinition.focus.code |
| Definition |
The kind of resource that must be the focus for this message. |
| Control | 1..1 |
| Terminology Binding | Any defined Resource Type name |
| Type | code |
| Summary | true |
| Comments |
Multiple focuses addressing different resources may occasionally occur. E.g. to link or unlink a resource from a particular account or encounter, etc. |
| MessageDefinition.focus.profile | |
| Element Id | MessageDefinition.focus.profile |
| Definition |
A profile that reflects constraints for the focal resource (and potentially for related resources). |
| Control | 0..1 |
| Type |
|
| Requirements |
This profile allows setting boundaries for what content must appear within the message bundle vs. outside based on the declared aggregation constraints on referenced resources on this and related profiles. |
| Comments |
This should be present for most message definitions. However, if the message focus is only a single resource and there is no need to include referenced resources or otherwise enforce the presence of particular elements, it can be omitted. |
| MessageDefinition.focus.min | |
| Element Id | MessageDefinition.focus.min |
| Definition |
Identifies the minimum number of resources of this type that must be pointed to by a message in order for it to be valid against this MessageDefinition. |
| Control |
|
| Type | unsignedInt |
|
|
|
| MessageDefinition.focus.max | |
| Element Id | MessageDefinition.focus.max |
| Definition |
Identifies the maximum number of resources of this type that must be pointed to by a message in order for it to be valid against this MessageDefinition. |
| Control | 0..1 |
| Type | string |
| Invariants |
Affect
this
element
md-1 : Max must be postive int or * ( expression
:
max='*'
or
(max.toInteger()
>
0),
xpath:
f:max/@value='*'
or
number(f:max/@value)
>
0)
|
| MessageDefinition.responseRequired | |
| Element Id | MessageDefinition.responseRequired |
| Definition |
|
| Control | 0..1 |
| Terminology Binding | messageheader-response-request ( Required ) |
| Type |
|
|
|
This enables the capability currently available through MSH-16 (Application Level acknowledgement) in HL7 Version 2 to declare at a message instance level whether a response is required or only upon error or success, or never. |
| MessageDefinition.allowedResponse | |
| Element Id | MessageDefinition.allowedResponse |
| Definition |
Indicates what types of messages may be sent as an application-level response to this message. |
| Control | 0..* |
| Comments |
This
indicates
an
application
level
response
to
|
| MessageDefinition.allowedResponse.message | |
| Element Id | MessageDefinition.allowedResponse.message |
| Definition |
A reference to the message definition that must be adhered to by this supported response. |
| Control | 1..1 |
| Type |
|
| MessageDefinition.allowedResponse.situation | |
| Element Id | MessageDefinition.allowedResponse.situation |
| Definition |
Provides a description of the circumstances in which this response should be used (as opposed to one of the alternative responses). |
| Control | 0..1 |
| Type | markdown |