FHIR Release 3 (STU) R4 Ballot #1 (Mixed Normative/Trial use)

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

2.48 Resource MessageDefinition - Content

Infrastructure And Messaging Work Group Maturity Level : 0 1   Draft Compartments : Not linked to any defined compartments

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.

2.48.1 Scope and Usage

Implementers should be familiar with the messaging concepts and descriptions found in Messaging using FHIR Resources before working with this resource.

This resource is referenced by capabilitystatement CapabilityStatement and MessageHeader

2.48.2 Resource Content

Structure

Name Flags Card. Type Description & Constraints doco
. . MessageDefinition D DomainResource A resource that defines a type of message that can be exchanged between systems
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . url Σ 0..1 uri Logical URI to reference Canonical identifier for this message definition definition, represented as a URI (globally unique)
. . . identifier Σ 0..1 Identifier Additional identifier for the message definition
. . . version Σ 0..1 string Business version of the message definition
. . . name Σ 0..1 string Name for this message definition (computer friendly)
. . . title Σ 0..1 string Name for this message definition (human friendly)
. . . replaces Σ 0..* canonical Takes the place of
... status ?! Σ 1..1 code draft | active | retired | unknown
PublicationStatus ( Required )
. . . experimental ?! Σ 0..1 boolean For testing purposes, not real usage
. . . date Σ 1..1 dateTime Date this was last changed
. . . publisher Σ 0..1 string Name of the publisher (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 Context The context that the content is intended to support
. . . jurisdiction Σ 0..* CodeableConcept Intended jurisdiction for message definition (if applicable)
Jurisdiction ValueSet ( Extensible )
. . . purpose Σ 0..1 markdown Why this message definition is defined
. . . copyright 0..1 markdown Use and/or publishing restrictions
. . . base Σ 0..1 Reference ( MessageDefinition canonical ) Definition this one is based on
. . . parent Σ 0..* Reference ( ActivityDefinition | PlanDefinition canonical ) Protocol/workflow this is part of
. . replaces . event[x] Σ 0..* 1..1 Reference ( MessageDefinition ) Takes Event code or link to the place of EventDefinition
MessageEvent ( Example )
. . . . event eventCoding Coding Σ
. . . . eventUri 1..1 Coding uri Event type MessageEvent ( Example )
. . . category Σ 0..1 code Consequence | Currency | Notification
MessageSignificanceCategory ( Required )
. . . focus Σ I 0..* BackboneElement Resource(s) that are the subject of the event
+ Max must be postive int or *
. . . . code Σ 1..1 code Type of resource
ResourceType ( Required )
. . . . profile 0..1 Reference ( StructureDefinition canonical ) Profile that must be adhered to by focus
. . . . min Σ 0..1 1..1 unsignedInt Minimum number of focuses of this type
. . . . max I 0..1 string Maximum number of focuses of this type
. . . responseRequired 0..1 boolean code Is a response required? Response circumstances
messageheader-response-request ( Required )
. . . allowedResponse 0..* BackboneElement Responses to this message
. . . . message 1..1 Reference ( MessageDefinition canonical ) Reference to allowed message definition response
. . . . situation 0..1 markdown When should this response be used

doco Documentation for this format

UML Diagram ( Legend )

MessageDefinition ( DomainResource ) An absolute URI that is used to identify this message definition when it is referenced in a specification, model, design or an instance. instance; also called its canonical identifier. This SHALL be a URL, SHOULD be globally unique, unique and SHOULD be an a literal address at which this message definition is (or will be) published. The URL SHOULD include the major version of the message definition. For more information see [Technical and Business Versions](resource.html#versions) published url : uri [0..1] 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 identifier : Identifier [0..1] 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 version : string [0..1] 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 name : string [0..1] A short, descriptive, user-friendly title for the message definition title : string [0..1] A MessageDefinition that is superseded by this definition replaces : canonical [0..*] The status of this message definition. Enables tracking the life-cycle of the content (this element modifies the meaning of other elements) status : code [1..1] « The lifecycle status of a Value Set or Concept Map. an artifact. (Strength=Required) PublicationStatus ! » A boolean Boolean value to indicate that this message definition is authored for testing purposes (or education/evaluation/marketing), education/evaluation/marketing) and is not intended to be used for genuine usage (this element modifies the meaning of other elements) experimental : boolean [0..1] The date (and optionally time) when the message definition was published. The date must change if and when the business version changes and it must change if the status code changes. In addition, it should change when the substantive content of the message definition changes date : dateTime [1..1] The name of the individual or organization or individual that published the message definition publisher : string [0..1] Contact details to assist a user in finding and communicating with the publisher contact : ContactDetail [0..*] A free text natural language description of the message definition from a consumer's perspective description : markdown [0..1] 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 useContext : UsageContext [0..*] A legal or geographic region in which the message definition is intended to be used jurisdiction : CodeableConcept [0..*] « Countries and regions within which this artifact is targeted for use (Strength=Extensible) Jurisdiction ValueSet + » Explaination Explanation of why this message definition is needed and why it has been designed as it has purpose : markdown [0..1] 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 copyright : markdown [0..1] The MessageDefinition that is the basis for the contents of this resource base : Reference canonical [0..1] MessageDefinition Identifies a protocol or workflow that this MessageDefinition represents a step in parent : Reference [0..*] ActivityDefinition | PlanDefinition A MessageDefinition that is superseded by this definition replaces : Reference canonical [0..*] MessageDefinition A coded identifier of a supported messaging event Event code or link to the EventDefinition event event[x] : Type [1..1] « Coding [1..1] | uri ; One of the message events defined as part of this version of FHIR. (Strength=Example) MessageEvent ?? » The impact of the content of the message category : code [0..1] « The impact of the content of a message. (Strength=Required) MessageSignificanceCategory ! » Indicates Declare at a message definition level whether a response is required for this message or only upon error or success, or never responseRequired : boolean code [0..1] « Response definition (Strength=Required) messageheader-response-request ! » Focus The kind of resource that must be the focus for this message code : code [1..1] « One of the resource types defined as part of this version of FHIR. (Strength=Required) ResourceType ! » A profile that reflects constraints for the focal resource (and potentially for related resources) profile : Reference canonical [0..1] StructureDefinition 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 min : unsignedInt [0..1] [1..1] 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 max : string [0..1] AllowedResponse A reference to the message definition that must be adhered to by this supported response message : Reference canonical [1..1] MessageDefinition Provides a description of the circumstances in which this response should be used (as opposed to one of the alternative responses) situation : markdown [0..1] 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 focus [0..*] Indicates what types of messages may be sent as an application-level response to this message allowedResponse [0..*]

XML Template 

<

<MessageDefinition 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 Canonical identifier for this message definition, represented as a URI (globally unique) -->

 <identifier><!-- 0..1 Identifier Additional identifier for the message definition --></identifier>
 <
 <
 <
 <
 <
 <
 <

 <version value="[string]"/><!-- 0..1 Business version of the message definition -->
 <name value="[string]"/><!-- 0..1 Name for this message definition (computer friendly) -->
 <title value="[string]"/><!-- 0..1 Name for this message definition (human friendly) -->
 <replaces><!-- 0..* canonical(MessageDefinition) Takes the place of --></replaces>
 <status value="[code]"/><!-- 1..1 draft | active | retired | unknown -->
 <experimental value="[boolean]"/><!-- 0..1 For testing purposes, not real usage -->
 <date value="[dateTime]"/><!-- 1..1 Date last changed -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher (organization or individual) -->

 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>
 <
 <</useContext>

 <description value="[markdown]"/><!-- 0..1 Natural language description of the message definition -->
 <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext>

 <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for message definition (if applicable) --></jurisdiction>
 <
 <
 <</base>
 <</parent>
 <</replaces>
 <</event>
 <

 <purpose value="[markdown]"/><!-- 0..1 Why this message definition is defined -->
 <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions -->
 <base><!-- 0..1 canonical(MessageDefinition) Definition this one is based on --></base>
 <parent><!-- 0..* canonical(ActivityDefinition|PlanDefinition) Protocol/workflow this is part of --></parent>
 <event[x]><!-- 1..1 Coding|uri Event code  or link to the EventDefinition --></event[x]>
 <category value="[code]"/><!-- 0..1 Consequence | Currency | Notification -->

 <focus>  <!-- 0..* Resource(s) that are the subject of the event -->
  <
  <</profile>
  <
  <

  <code value="[code]"/><!-- 1..1 Type of resource -->
  <profile><!-- 0..1 canonical(StructureDefinition) Profile that must be adhered to by focus --></profile>
  <min value="[unsignedInt]"/><!-- 1..1 Minimum number of focuses of this type -->
  <max value="[string]"/><!-- ?? 0..1 Maximum number of focuses of this type -->

 </focus>
 <

 <responseRequired value="[code]"/><!-- 0..1 Response circumstances -->

 <allowedResponse>  <!-- 0..* Responses to this message -->
  <</message>
  <

  <message><!-- 1..1 canonical(MessageDefinition) Reference to allowed message definition response --></message>
  <situation value="[markdown]"/><!-- 0..1 When should this response be used -->

 </allowedResponse>
</MessageDefinition>

JSON Template 

{doco
  "resourceType" : "",

  "resourceType" : "MessageDefinition",

  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
    "
    "
    "
    "

  "url" : "<uri>", // Canonical identifier for this message definition, represented as a URI (globally unique)
  "identifier" : { Identifier }, // Additional identifier for the message definition
  "version" : "<string>", // Business version of the message definition
  "name" : "<string>", // Name for this message definition (computer friendly)
  "title" : "<string>", // Name for this message definition (human friendly)
  "replaces" : ["<canonical>"], // Takes the place of
  "status" : "<code>", // R!  draft | active | retired | unknown
  "experimental" : <boolean>, // For testing purposes, not real usage
  "date" : "<dateTime>", // R!  Date last changed
  "publisher" : "<string>", // Name of the publisher (organization or individual)
  "contact" : [{ ContactDetail }], // Contact details for the publisher
  "description" : "<markdown>", // Natural language description of the message definition
  "useContext" : [{ UsageContext }], // The context that the content is intended to support
  "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for message definition (if applicable)
  "purpose" : "<markdown>", // Why this message definition is defined
  "copyright" : "<markdown>", // Use and/or publishing restrictions
  "base" : "<canonical>", // Definition this one is based on
  "parent" : ["<canonical>"], // Protocol/workflow this is part of
  // event[x]: Event code  or link to the EventDefinition. One of these 2:

  "eventCoding" : { Coding },
  "eventUri" : "<uri>",
  "category" : "<code>", // Consequence | Currency | Notification
  "focus" : [{ // Resource(s) that are the subject of the event
    "code" : "<code>", // R!  Type of resource
    "profile" : "<canonical>", // Profile that must be adhered to by focus
    "min" : "<unsignedInt>", // R!  Minimum number of focuses of this type
    "max" : "<string>" // C? Maximum number of focuses of this type

  }],
  "
  "
    "
    "

  "responseRequired" : "<code>", // Response circumstances
  "allowedResponse" : [{ // Responses to this message
    "message" : "<canonical>", // R!  Reference to allowed message definition response
    "situation" : "<markdown>" // When should this response be used

  }]
}

Turtle Template 

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:MessageDefinition;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:

  fhir:MessageDefinition.url [ uri ]; # 0..1 Canonical identifier for this message definition, represented as a URI (globally unique)

  fhir:MessageDefinition.identifier [ Identifier ]; # 0..1 Additional identifier for the message definition
  fhir:MessageDefinition.version [ string ]; # 0..1 Business version of the message definition
  fhir:MessageDefinition.name [ string ]; # 0..1 Name for this message definition (computer friendly)
  fhir:MessageDefinition.title [ string ]; # 0..1 Name for this message definition (human friendly)
  fhir:MessageDefinition.replaces [ canonical(MessageDefinition) ], ... ; # 0..* Takes the place of

  fhir:MessageDefinition.status [ code ]; # 1..1 draft | active | retired | unknown
  fhir:
  fhir:
  fhir:

  fhir:MessageDefinition.experimental [ boolean ]; # 0..1 For testing purposes, not real usage
  fhir:MessageDefinition.date [ dateTime ]; # 1..1 Date last changed
  fhir:MessageDefinition.publisher [ string ]; # 0..1 Name of the publisher (organization or individual)

  fhir:MessageDefinition.contact [ ContactDetail ], ... ; # 0..* Contact details for the publisher
  fhir:MessageDefinition.description [ markdown ]; # 0..1 Natural language description of the message definition
  fhir:

  fhir:MessageDefinition.useContext [ UsageContext ], ... ; # 0..* The context that the content is intended to support

  fhir:MessageDefinition.jurisdiction [ CodeableConcept ], ... ; # 0..* Intended jurisdiction for message definition (if applicable)
  fhir:

  fhir:MessageDefinition.purpose [ markdown ]; # 0..1 Why this message definition is defined

  fhir:MessageDefinition.copyright [ markdown ]; # 0..1 Use and/or publishing restrictions
  fhir:
  fhir:
  fhir:
  fhir:

  fhir:MessageDefinition.base [ canonical(MessageDefinition) ]; # 0..1 Definition this one is based on
  fhir:MessageDefinition.parent [ canonical(ActivityDefinition|PlanDefinition) ], ... ; # 0..* Protocol/workflow this is part of
  # MessageDefinition.event[x] : 1..1 Event code  or link to the EventDefinition. One of these 2
    fhir:MessageDefinition.eventCoding [ Coding ]
    fhir:MessageDefinition.eventUri [ uri ]

  fhir:MessageDefinition.category [ code ]; # 0..1 Consequence | Currency | Notification
  fhir:MessageDefinition.focus [ # 0..* Resource(s) that are the subject of the event
    fhir:MessageDefinition.focus.code [ code ]; # 1..1 Type of resource
    fhir:
    fhir:

    fhir:MessageDefinition.focus.profile [ canonical(StructureDefinition) ]; # 0..1 Profile that must be adhered to by focus
    fhir:MessageDefinition.focus.min [ unsignedInt ]; # 1..1 Minimum number of focuses of this type

    fhir:MessageDefinition.focus.max [ string ]; # 0..1 Maximum number of focuses of this type
  ], ...;
  fhir:

  fhir:MessageDefinition.responseRequired [ code ]; # 0..1 Response circumstances

  fhir:MessageDefinition.allowedResponse [ # 0..* Responses to this message
    fhir:

    fhir:MessageDefinition.allowedResponse.message [ canonical(MessageDefinition) ]; # 1..1 Reference to allowed message definition response

    fhir:MessageDefinition.allowedResponse.situation [ markdown ]; # 0..1 When should this response be used
  ], ...;
]

Changes since DSTU2 R3

MessageDefinition
MessageDefinition.replaces
  • Type changed from Reference(MessageDefinition) to canonical
MessageDefinition.base
  • Type changed from Reference(MessageDefinition) to canonical
MessageDefinition.parent
  • Type changed from Reference(ActivityDefinition|PlanDefinition) to canonical
MessageDefinition.event[x]
  • Renamed from event to event[x]
  • Add uri
MessageDefinition.focus.profile
  • Type changed from Reference(StructureDefinition) to canonical
MessageDefinition.focus.min
  • Min Cardinality changed from 0 to 1
  • Default Value "0" removed
MessageDefinition.responseRequired
  • Type changed from boolean to code
  • Add Binding http://hl7.org/fhir/ValueSet/messageheader-response-request (required)
  • Default Value "false" removed
MessageDefinition.allowedResponse.message
  • Type changed from Reference(MessageDefinition) to canonical

This resource did not exist in Release 2 See the Full Difference for further information

This analysis is available as XML or JSON .

Structure

Name Flags Card. Type Description & Constraints doco
. . MessageDefinition D DomainResource A resource that defines a type of message that can be exchanged between systems
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . url Σ 0..1 uri Logical URI to reference Canonical identifier for this message definition definition, represented as a URI (globally unique)
. . . identifier Σ 0..1 Identifier Additional identifier for the message definition
. . . version Σ 0..1 string Business version of the message definition
. . . name Σ 0..1 string Name for this message definition (computer friendly)
. . . title Σ 0..1 string Name for this message definition (human friendly)
. . . replaces Σ 0..* canonical Takes the place of
... status ?! Σ 1..1 code draft | active | retired | unknown
PublicationStatus ( Required )
. . . experimental ?! Σ 0..1 boolean For testing purposes, not real usage
. . . date Σ 1..1 dateTime Date this was last changed
. . . publisher Σ 0..1 string Name of the publisher (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 Context The context that the content is intended to support
. . . jurisdiction Σ 0..* CodeableConcept Intended jurisdiction for message definition (if applicable)
Jurisdiction ValueSet ( Extensible )
. . . purpose Σ 0..1 markdown Why this message definition is defined
. . . copyright 0..1 markdown Use and/or publishing restrictions
. . . base Σ 0..1 Reference ( MessageDefinition canonical ) Definition this one is based on
. . . parent Σ 0..* Reference ( ActivityDefinition | PlanDefinition canonical ) Protocol/workflow this is part of
. . replaces . event[x] Σ 0..* 1..1 Reference ( MessageDefinition ) Takes Event code or link to the place of EventDefinition
MessageEvent ( Example )
. . . . event eventCoding Coding Σ
. . . . eventUri 1..1 Coding uri Event type MessageEvent ( Example )
. . . category Σ 0..1 code Consequence | Currency | Notification
MessageSignificanceCategory ( Required )
. . . focus Σ I 0..* BackboneElement Resource(s) that are the subject of the event
+ Max must be postive int or *
. . . . code Σ 1..1 code Type of resource
ResourceType ( Required )
. . . . profile 0..1 Reference ( StructureDefinition canonical ) Profile that must be adhered to by focus
. . . . min Σ 0..1 1..1 unsignedInt Minimum number of focuses of this type
. . . . max I 0..1 string Maximum number of focuses of this type
. . . responseRequired 0..1 boolean code Is a response required? Response circumstances
messageheader-response-request ( Required )
. . . allowedResponse 0..* BackboneElement Responses to this message
. . . . message 1..1 Reference ( MessageDefinition canonical ) Reference to allowed message definition response
. . . . situation 0..1 markdown When should this response be used

doco Documentation for this format

UML Diagram ( Legend )

MessageDefinition ( DomainResource ) An absolute URI that is used to identify this message definition when it is referenced in a specification, model, design or an instance. instance; also called its canonical identifier. This SHALL be a URL, SHOULD be globally unique, unique and SHOULD be an a literal address at which this message definition is (or will be) published. The URL SHOULD include the major version of the message definition. For more information see [Technical and Business Versions](resource.html#versions) published url : uri [0..1] 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 identifier : Identifier [0..1] 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 version : string [0..1] 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 name : string [0..1] A short, descriptive, user-friendly title for the message definition title : string [0..1] A MessageDefinition that is superseded by this definition replaces : canonical [0..*] The status of this message definition. Enables tracking the life-cycle of the content (this element modifies the meaning of other elements) status : code [1..1] « The lifecycle status of a Value Set or Concept Map. an artifact. (Strength=Required) PublicationStatus ! » A boolean Boolean value to indicate that this message definition is authored for testing purposes (or education/evaluation/marketing), education/evaluation/marketing) and is not intended to be used for genuine usage (this element modifies the meaning of other elements) experimental : boolean [0..1] The date (and optionally time) when the message definition was published. The date must change if and when the business version changes and it must change if the status code changes. In addition, it should change when the substantive content of the message definition changes date : dateTime [1..1] The name of the individual or organization or individual that published the message definition publisher : string [0..1] Contact details to assist a user in finding and communicating with the publisher contact : ContactDetail [0..*] A free text natural language description of the message definition from a consumer's perspective description : markdown [0..1] 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 useContext : UsageContext [0..*] A legal or geographic region in which the message definition is intended to be used jurisdiction : CodeableConcept [0..*] « Countries and regions within which this artifact is targeted for use (Strength=Extensible) Jurisdiction ValueSet + » Explaination Explanation of why this message definition is needed and why it has been designed as it has purpose : markdown [0..1] 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 copyright : markdown [0..1] The MessageDefinition that is the basis for the contents of this resource base : Reference canonical [0..1] MessageDefinition Identifies a protocol or workflow that this MessageDefinition represents a step in parent : Reference [0..*] ActivityDefinition | PlanDefinition A MessageDefinition that is superseded by this definition replaces : Reference canonical [0..*] MessageDefinition A coded identifier of a supported messaging event Event code or link to the EventDefinition event event[x] : Type [1..1] « Coding [1..1] | uri ; One of the message events defined as part of this version of FHIR. (Strength=Example) MessageEvent ?? » The impact of the content of the message category : code [0..1] « The impact of the content of a message. (Strength=Required) MessageSignificanceCategory ! » Indicates Declare at a message definition level whether a response is required for this message or only upon error or success, or never responseRequired : boolean code [0..1] « Response definition (Strength=Required) messageheader-response-request ! » Focus The kind of resource that must be the focus for this message code : code [1..1] « One of the resource types defined as part of this version of FHIR. (Strength=Required) ResourceType ! » A profile that reflects constraints for the focal resource (and potentially for related resources) profile : Reference canonical [0..1] StructureDefinition 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 min : unsignedInt [0..1] [1..1] 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 max : string [0..1] AllowedResponse A reference to the message definition that must be adhered to by this supported response message : Reference canonical [1..1] MessageDefinition Provides a description of the circumstances in which this response should be used (as opposed to one of the alternative responses) situation : markdown [0..1] 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 focus [0..*] Indicates what types of messages may be sent as an application-level response to this message allowedResponse [0..*]

XML Template 

<

<MessageDefinition 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 Canonical identifier for this message definition, represented as a URI (globally unique) -->

 <identifier><!-- 0..1 Identifier Additional identifier for the message definition --></identifier>
 <
 <
 <
 <
 <
 <
 <

 <version value="[string]"/><!-- 0..1 Business version of the message definition -->
 <name value="[string]"/><!-- 0..1 Name for this message definition (computer friendly) -->
 <title value="[string]"/><!-- 0..1 Name for this message definition (human friendly) -->
 <replaces><!-- 0..* canonical(MessageDefinition) Takes the place of --></replaces>
 <status value="[code]"/><!-- 1..1 draft | active | retired | unknown -->
 <experimental value="[boolean]"/><!-- 0..1 For testing purposes, not real usage -->
 <date value="[dateTime]"/><!-- 1..1 Date last changed -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher (organization or individual) -->

 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>
 <
 <</useContext>

 <description value="[markdown]"/><!-- 0..1 Natural language description of the message definition -->
 <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext>

 <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for message definition (if applicable) --></jurisdiction>
 <
 <
 <</base>
 <</parent>
 <</replaces>
 <</event>
 <

 <purpose value="[markdown]"/><!-- 0..1 Why this message definition is defined -->
 <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions -->
 <base><!-- 0..1 canonical(MessageDefinition) Definition this one is based on --></base>
 <parent><!-- 0..* canonical(ActivityDefinition|PlanDefinition) Protocol/workflow this is part of --></parent>
 <event[x]><!-- 1..1 Coding|uri Event code  or link to the EventDefinition --></event[x]>
 <category value="[code]"/><!-- 0..1 Consequence | Currency | Notification -->

 <focus>  <!-- 0..* Resource(s) that are the subject of the event -->
  <
  <</profile>
  <
  <

  <code value="[code]"/><!-- 1..1 Type of resource -->
  <profile><!-- 0..1 canonical(StructureDefinition) Profile that must be adhered to by focus --></profile>
  <min value="[unsignedInt]"/><!-- 1..1 Minimum number of focuses of this type -->
  <max value="[string]"/><!-- ?? 0..1 Maximum number of focuses of this type -->

 </focus>
 <

 <responseRequired value="[code]"/><!-- 0..1 Response circumstances -->

 <allowedResponse>  <!-- 0..* Responses to this message -->
  <</message>
  <

  <message><!-- 1..1 canonical(MessageDefinition) Reference to allowed message definition response --></message>
  <situation value="[markdown]"/><!-- 0..1 When should this response be used -->

 </allowedResponse>
</MessageDefinition>

JSON Template 

{doco
  "resourceType" : "",

  "resourceType" : "MessageDefinition",

  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
    "
    "
    "
    "

  "url" : "<uri>", // Canonical identifier for this message definition, represented as a URI (globally unique)
  "identifier" : { Identifier }, // Additional identifier for the message definition
  "version" : "<string>", // Business version of the message definition
  "name" : "<string>", // Name for this message definition (computer friendly)
  "title" : "<string>", // Name for this message definition (human friendly)
  "replaces" : ["<canonical>"], // Takes the place of
  "status" : "<code>", // R!  draft | active | retired | unknown
  "experimental" : <boolean>, // For testing purposes, not real usage
  "date" : "<dateTime>", // R!  Date last changed
  "publisher" : "<string>", // Name of the publisher (organization or individual)
  "contact" : [{ ContactDetail }], // Contact details for the publisher
  "description" : "<markdown>", // Natural language description of the message definition
  "useContext" : [{ UsageContext }], // The context that the content is intended to support
  "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for message definition (if applicable)
  "purpose" : "<markdown>", // Why this message definition is defined
  "copyright" : "<markdown>", // Use and/or publishing restrictions
  "base" : "<canonical>", // Definition this one is based on
  "parent" : ["<canonical>"], // Protocol/workflow this is part of
  // event[x]: Event code  or link to the EventDefinition. One of these 2:

  "eventCoding" : { Coding },
  "eventUri" : "<uri>",
  "category" : "<code>", // Consequence | Currency | Notification
  "focus" : [{ // Resource(s) that are the subject of the event
    "code" : "<code>", // R!  Type of resource
    "profile" : "<canonical>", // Profile that must be adhered to by focus
    "min" : "<unsignedInt>", // R!  Minimum number of focuses of this type
    "max" : "<string>" // C? Maximum number of focuses of this type

  }],
  "
  "
    "
    "

  "responseRequired" : "<code>", // Response circumstances
  "allowedResponse" : [{ // Responses to this message
    "message" : "<canonical>", // R!  Reference to allowed message definition response
    "situation" : "<markdown>" // When should this response be used

  }]
}

Turtle Template 

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:MessageDefinition;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:

  fhir:MessageDefinition.url [ uri ]; # 0..1 Canonical identifier for this message definition, represented as a URI (globally unique)

  fhir:MessageDefinition.identifier [ Identifier ]; # 0..1 Additional identifier for the message definition
  fhir:MessageDefinition.version [ string ]; # 0..1 Business version of the message definition
  fhir:MessageDefinition.name [ string ]; # 0..1 Name for this message definition (computer friendly)
  fhir:MessageDefinition.title [ string ]; # 0..1 Name for this message definition (human friendly)
  fhir:MessageDefinition.replaces [ canonical(MessageDefinition) ], ... ; # 0..* Takes the place of

  fhir:MessageDefinition.status [ code ]; # 1..1 draft | active | retired | unknown
  fhir:
  fhir:
  fhir:

  fhir:MessageDefinition.experimental [ boolean ]; # 0..1 For testing purposes, not real usage
  fhir:MessageDefinition.date [ dateTime ]; # 1..1 Date last changed
  fhir:MessageDefinition.publisher [ string ]; # 0..1 Name of the publisher (organization or individual)

  fhir:MessageDefinition.contact [ ContactDetail ], ... ; # 0..* Contact details for the publisher
  fhir:MessageDefinition.description [ markdown ]; # 0..1 Natural language description of the message definition
  fhir:

  fhir:MessageDefinition.useContext [ UsageContext ], ... ; # 0..* The context that the content is intended to support

  fhir:MessageDefinition.jurisdiction [ CodeableConcept ], ... ; # 0..* Intended jurisdiction for message definition (if applicable)
  fhir:

  fhir:MessageDefinition.purpose [ markdown ]; # 0..1 Why this message definition is defined

  fhir:MessageDefinition.copyright [ markdown ]; # 0..1 Use and/or publishing restrictions
  fhir:
  fhir:
  fhir:
  fhir:

  fhir:MessageDefinition.base [ canonical(MessageDefinition) ]; # 0..1 Definition this one is based on
  fhir:MessageDefinition.parent [ canonical(ActivityDefinition|PlanDefinition) ], ... ; # 0..* Protocol/workflow this is part of
  # MessageDefinition.event[x] : 1..1 Event code  or link to the EventDefinition. One of these 2
    fhir:MessageDefinition.eventCoding [ Coding ]
    fhir:MessageDefinition.eventUri [ uri ]

  fhir:MessageDefinition.category [ code ]; # 0..1 Consequence | Currency | Notification
  fhir:MessageDefinition.focus [ # 0..* Resource(s) that are the subject of the event
    fhir:MessageDefinition.focus.code [ code ]; # 1..1 Type of resource
    fhir:
    fhir:

    fhir:MessageDefinition.focus.profile [ canonical(StructureDefinition) ]; # 0..1 Profile that must be adhered to by focus
    fhir:MessageDefinition.focus.min [ unsignedInt ]; # 1..1 Minimum number of focuses of this type

    fhir:MessageDefinition.focus.max [ string ]; # 0..1 Maximum number of focuses of this type
  ], ...;
  fhir:

  fhir:MessageDefinition.responseRequired [ code ]; # 0..1 Response circumstances

  fhir:MessageDefinition.allowedResponse [ # 0..* Responses to this message
    fhir:

    fhir:MessageDefinition.allowedResponse.message [ canonical(MessageDefinition) ]; # 1..1 Reference to allowed message definition response

    fhir:MessageDefinition.allowedResponse.situation [ markdown ]; # 0..1 When should this response be used
  ], ...;
]

Changes since DSTU2

MessageDefinition
MessageDefinition.replaces
  • Type changed from Reference(MessageDefinition) to canonical
MessageDefinition.base
  • Type changed from Reference(MessageDefinition) to canonical
MessageDefinition.parent
  • Type changed from Reference(ActivityDefinition|PlanDefinition) to canonical
MessageDefinition.event[x]
  • Renamed from event to event[x]
  • Add uri
MessageDefinition.focus.profile
  • Type changed from Reference(StructureDefinition) to canonical
MessageDefinition.focus.min
  • Min Cardinality changed from 0 to 1
  • Default Value "0" removed
MessageDefinition.responseRequired
  • Type changed from boolean to code
  • Add Binding http://hl7.org/fhir/ValueSet/messageheader-response-request (required)
  • Default Value "false" removed
MessageDefinition.allowedResponse.message
  • Type changed from Reference(MessageDefinition) to canonical

This resource did not exist in Release 2 See the Full Difference for further information

This analysis is available as XML or JSON .

 

Alternate definitions: Master Definition ( XML , + JSON ), , XML Schema / Schematron (for ) + JSON Schema , ShEx (for Turtle ) + see the extensions & the dependency analysis

2.48.2.1 Terminology Bindings

Path Definition Type Reference
MessageDefinition.status The lifecycle status of a Value Set or Concept Map. an artifact. Required PublicationStatus
MessageDefinition.jurisdiction Countries and regions within which this artifact is targeted for use Extensible Jurisdiction ValueSet
MessageDefinition.event MessageDefinition.event[x] One of the message events defined as part of this version of FHIR. Example Message Events
MessageDefinition.category The impact of the content of a message. Required MessageSignificanceCategory
MessageDefinition.focus.code One of the resource types defined as part of this version of FHIR. Required Resource Types
MessageDefinition.responseRequired Response definition Required messageheader-response-request

2.48.2.2 Constraints

  • md-1 : On MessageDefinition.focus: Max must be postive int or * ( expression on MessageDefinition.focus: max='*' or (max.toInteger() > 0) )

2.48.3 Search Parameters

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

Name Type Description Expression In Common
category token The behavior associated with the message MessageDefinition.category
date date The message definition publication date MessageDefinition.date
description string The description of the message definition MessageDefinition.description
event token The event that triggers the message or link to the event definition. MessageDefinition.event
focus token A resource that is a permitted focus of the message MessageDefinition.focus.code
identifier token External identifier for the message definition MessageDefinition.identifier
jurisdiction token Intended jurisdiction for the message definition MessageDefinition.jurisdiction
name string Computationally friendly name of the message definition MessageDefinition.name
publisher string Name of the publisher of the message definition MessageDefinition.publisher
status token The current status of the message definition MessageDefinition.status
title string The human-friendly name of the message definition MessageDefinition.title
url uri The uri that identifies the message definition MessageDefinition.url
version token The business version of the message definition MessageDefinition.version