R6 Ballot (2nd Draft)

Publish-box (todo)

2.15 Resource MessageHeader - Content

Infrastructure And Messaging icon Work GroupMaturity Level: 4 Trial UseSecurity Category: Not Classified Compartments: Device, Practitioner

The header for a message exchange that is either requesting or responding to an action. The reference(s) that are the subject of the action as well as other information related to the action are typically transmitted in a bundle in which the MessageHeader resource instance is the first resource in the bundle.

2.15.1 Scope and Usage

The MessageHeader resource is defined in order to support Messaging using FHIR resources. The principal usage of the MessageHeader resource is when messages are exchanged. However, as a resource that can be used with the RESTful framework, the MessageHeader resource has the normal resource end-point ([base-url]/MessageHeader), which is used to manage a set of static messages resources. This could be used to make an archive of past messages available. Creating or updating Message resources in this fashion does not represent the actual occurrence of any event, nor can it trigger any logic associated with the actual event. It is just for managing a set of message resources.

2.15.2 References to this Resource

2.15.3 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. MessageHeader TU DomainResource A resource that describes a message that is exchanged between systems

Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... event[x] Σ 1..1 The real world event that triggered this messsage
Binding: MessageEvent (Example)
.... eventCoding Coding
.... eventUri uri
.... eventCanonical canonical(EventDefinition | SubscriptionTopic)
... destination Σ 0..* BackboneElement Message destination application(s)

.... endpoint[x] Σ 0..1 Actual destination address or Endpoint resource
..... endpointUrl url
..... endpointReference Reference(Endpoint)
.... name Σ 0..1 string Name of system
.... receiver Σ 0..1 Reference(Device | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson) Intended "real-world" recipient for the data
... source Σ 1..1 BackboneElement Message source application
.... endpoint[x] Σ 0..1 Actual source address or Endpoint resource
..... endpointUrl url
..... endpointReference Reference(Endpoint)
.... name Σ 0..1 string Name of system
.... software Σ 0..1 string Name of software running the system
.... version Σ 0..1 string Version of software running
.... contact Σ 0..1 ContactPoint Human contact for problems
.... sender Σ 0..1 Reference(Device | Organization | Patient | Practitioner | PractitionerRole) Real world sender of the message
... response Σ 0..1 BackboneElement If this is a reply to prior message
.... identifier Σ 1..1 Identifier Bundle.identifier of original message
.... code Σ 1..1 code ok | transient-error | fatal-error
Binding: Response Type (Required)
.... details Σ 0..1 Reference(OperationOutcome) Specific list of hints/warnings/errors
... focus Σ 0..* Reference(Any) The actual content of the message

... definition Σ 0..1 canonical(MessageDefinition) Link to the definition for this message

doco Documentation for this format icon

See the Extensions for this resource

UML Diagram (Legend)

MessageHeader (DomainResource)Code that identifies the event this message represents and connects it with its definition. Events defined as part of the FHIR specification are defined by the implementation. Alternatively a uri , canonical uri to the EventDefinition or SubscriptionTopicevent[x] : DataType [1..1] « Coding|uri|canonical(EventDefinition| SubscriptionTopic); null (Strength=Example)MessageEvent?? »Coded indication of the cause for the event - indicates a reason for the occurrence of the event that is a focus of this messagereason : CodeableConcept [0..1] « null (Strength=Example)ExampleMessageReasonCodes?? »The actual data of the message - a reference to the root/focus class of the event. This is allowed to be a Parameters resourcefocus : Reference [0..*] « Any »Permanent link to the MessageDefinition for this messagedefinition : canonical [0..1] « MessageDefinition »MessageDestinationIndicates where the message should be routedendpoint[x] : DataType [0..1] « url|Reference(Endpoint) »Human-readable name for the target systemname : string [0..1]Allows data conveyed by a message to be addressed to a particular person or department when routing to a specific application isn't sufficientreceiver : Reference [0..1] « Device|Organization|Patient| Practitioner|PractitionerRole|RelatedPerson »MessageSourceIdentifies the routing target to send acknowledgements toendpoint[x] : DataType [0..1] « url|Reference(Endpoint) »Human-readable name for the source systemname : string [0..1]May include configuration or other information useful in debuggingsoftware : string [0..1]Can convey versions of multiple systems in situations where a message passes through multiple handsversion : string [0..1]An e-mail, phone, website or other contact point to use to resolve issues with message communicationscontact : ContactPoint [0..1]Identifies the sending entity to allow the use of a trust relationshipsender : Reference [0..1] « Device|Organization|Patient|Practitioner| PractitionerRole »ResponseThe Bundle.identifier of the message to which this message is a responseidentifier : Identifier [1..1]Code that identifies the type of response to the message - whether it was successful or not, and whether it should be resent or notcode : code [1..1] « null (Strength=Required)ResponseType! »Full details of any issues found in the messagedetails : Reference [0..1] « OperationOutcome »The destination application which the message is intended fordestination[0..*]The source application from which this message originatedsource[1..1]Information about the message that this message is a response to. Only present if this message is a responseresponse[0..1]

XML Template

<MessageHeader xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <event[x]><!-- 1..1 Coding|uri|canonical(EventDefinition|SubscriptionTopic) The real world event that triggered this messsage --></event[x]>
 <destination>  <!-- 0..* Message destination application(s) -->
  <endpoint[x]><!-- 0..1 url|Reference(Endpoint) Actual destination address or Endpoint resource --></endpoint[x]>
  <name value="[string]"/><!-- 0..1 Name of system -->
  <receiver><!-- 0..1 Reference(Device|Organization|Patient|Practitioner|
    PractitionerRole|RelatedPerson) Intended "real-world" recipient for the data --></receiver>
 </destination>
 <source>  <!-- 1..1 Message source application -->
  <endpoint[x]><!-- 0..1 url|Reference(Endpoint) Actual source address or Endpoint resource --></endpoint[x]>
  <name value="[string]"/><!-- 0..1 Name of system -->
  <software value="[string]"/><!-- 0..1 Name of software running the system -->
  <version value="[string]"/><!-- 0..1 Version of software running -->
  <contact><!-- 0..1 ContactPoint Human contact for problems --></contact>
  <sender><!-- 0..1 Reference(Device|Organization|Patient|Practitioner|
    PractitionerRole) Real world sender of the message --></sender>
 </source>
 <reason><!-- 0..1 CodeableConcept Cause of event --></reason>
 <response>  <!-- 0..1 If this is a reply to prior message -->
  <identifier><!-- 1..1 Identifier Bundle.identifier of original message --></identifier>
  <code value="[code]"/><!-- 1..1 ok | transient-error | fatal-error -->
  <details><!-- 0..1 Reference(OperationOutcome) Specific list of hints/warnings/errors --></details>
 </response>
 <focus><!-- 0..* Reference(Any) The actual content of the message --></focus>
 <definition><!-- 0..1 canonical(MessageDefinition) Link to the definition for this message --></definition>
</MessageHeader>

JSON Template

{doco
  "resourceType" : "MessageHeader",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  // event[x]: The real world event that triggered this messsage. One of these 3:
  "eventCoding" : { Coding },
  "eventUri" : "<uri>",
  "eventCanonical" : "<canonical(EventDefinition|SubscriptionTopic)>",
  "destination" : [{ // Message destination application(s)
    // endpoint[x]: Actual destination address or Endpoint resource. One of these 2:
    "endpointUrl" : "<url>",
    "endpointReference" : { Reference(Endpoint) },
    "name" : "<string>", // Name of system
    "receiver" : { Reference(Device|Organization|Patient|Practitioner|
    PractitionerRole|RelatedPerson) } // Intended "real-world" recipient for the data
  }],
  "source" : { // R!  Message source application
    // endpoint[x]: Actual source address or Endpoint resource. One of these 2:
    "endpointUrl" : "<url>",
    "endpointReference" : { Reference(Endpoint) },
    "name" : "<string>", // Name of system
    "software" : "<string>", // Name of software running the system
    "version" : "<string>", // Version of software running
    "contact" : { ContactPoint }, // Human contact for problems
    "sender" : { Reference(Device|Organization|Patient|Practitioner|
    PractitionerRole) } // Real world sender of the message
  },
  "reason" : { CodeableConcept }, // Cause of event
  "response" : { // If this is a reply to prior message
    "identifier" : { Identifier }, // R!  Bundle.identifier of original message
    "code" : "<code>", // R!  ok | transient-error | fatal-error
    "details" : { Reference(OperationOutcome) } // Specific list of hints/warnings/errors
  },
  "focus" : [{ Reference(Any) }], // The actual content of the message
  "definition" : "<canonical(MessageDefinition)>" // Link to the definition for this message
}

Turtle Template

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


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

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  # event[x] : 1..1 The real world event that triggered this messsage. One of these 3
    fhir:event [  a fhir:Coding ; Coding ]
    fhir:event [  a fhir:uri ; uri ]
    fhir:event [  a fhir:canonical ; canonical(EventDefinition|SubscriptionTopic) ]
  fhir:destination ( [ # 0..* Message destination application(s)
    # endpoint[x] : 0..1 Actual destination address or Endpoint resource. One of these 2
      fhir:endpoint [  a fhir:url ; url ]
      fhir:endpoint [  a fhir:Reference ; Reference(Endpoint) ]
    fhir:name [ string ] ; # 0..1 Name of system
    fhir:receiver [ Reference(Device|Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 Intended "real-world" recipient for the data
  ] ... ) ;
  fhir:source [ # 1..1 Message source application
    # endpoint[x] : 0..1 Actual source address or Endpoint resource. One of these 2
      fhir:endpoint [  a fhir:url ; url ]
      fhir:endpoint [  a fhir:Reference ; Reference(Endpoint) ]
    fhir:name [ string ] ; # 0..1 Name of system
    fhir:software [ string ] ; # 0..1 Name of software running the system
    fhir:version [ string ] ; # 0..1 Version of software running
    fhir:contact [ ContactPoint ] ; # 0..1 Human contact for problems
    fhir:sender [ Reference(Device|Organization|Patient|Practitioner|PractitionerRole) ] ; # 0..1 Real world sender of the message
  ] ;
  fhir:reason [ CodeableConcept ] ; # 0..1 Cause of event
  fhir:response [ # 0..1 If this is a reply to prior message
    fhir:identifier [ Identifier ] ; # 1..1 Bundle.identifier of original message
    fhir:code [ code ] ; # 1..1 ok | transient-error | fatal-error
    fhir:details [ Reference(OperationOutcome) ] ; # 0..1 Specific list of hints/warnings/errors
  ] ;
  fhir:focus  ( [ Reference(Any) ] ... ) ; # 0..* The actual content of the message
  fhir:definition [ canonical(MessageDefinition) ] ; # 0..1 Link to the definition for this message
]

Changes from both R4 and R4B

MessageHeader
MessageHeader.event[x]
  • Add Type canonical(EventDefinition | SubscriptionTopic)
MessageHeader.destination.endpoint[x]
  • Renamed from endpoint to endpoint[x]
  • Min Cardinality changed from 1 to 0
  • Add Type Reference(Endpoint)
MessageHeader.destination.receiver
  • Type Reference: Added Target Types Device, Patient, RelatedPerson
MessageHeader.source.endpoint[x]
  • Renamed from endpoint to endpoint[x]
  • Min Cardinality changed from 1 to 0
  • Add Type Reference(Endpoint)
MessageHeader.source.sender
  • Added Element
MessageHeader.response.identifier
  • Type changed from id to Identifier
MessageHeader.destination.target
  • Deleted
MessageHeader.sender
  • Deleted
MessageHeader.enterer
  • Deleted
MessageHeader.author
  • Deleted
MessageHeader.responsible
  • Deleted

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. MessageHeader TU DomainResource A resource that describes a message that is exchanged between systems

Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... event[x] Σ 1..1 The real world event that triggered this messsage
Binding: MessageEvent (Example)
.... eventCoding Coding
.... eventUri uri
.... eventCanonical canonical(EventDefinition | SubscriptionTopic)
... destination Σ 0..* BackboneElement Message destination application(s)

.... endpoint[x] Σ 0..1 Actual destination address or Endpoint resource
..... endpointUrl url
..... endpointReference Reference(Endpoint)
.... name Σ 0..1 string Name of system
.... receiver Σ 0..1 Reference(Device | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson) Intended "real-world" recipient for the data
... source Σ 1..1 BackboneElement Message source application
.... endpoint[x] Σ 0..1 Actual source address or Endpoint resource
..... endpointUrl url
..... endpointReference Reference(Endpoint)
.... name Σ 0..1 string Name of system
.... software Σ 0..1 string Name of software running the system
.... version Σ 0..1 string Version of software running
.... contact Σ 0..1 ContactPoint Human contact for problems
.... sender Σ 0..1 Reference(Device | Organization | Patient | Practitioner | PractitionerRole) Real world sender of the message
... response Σ 0..1 BackboneElement If this is a reply to prior message
.... identifier Σ 1..1 Identifier Bundle.identifier of original message
.... code Σ 1..1 code ok | transient-error | fatal-error
Binding: Response Type (Required)
.... details Σ 0..1 Reference(OperationOutcome) Specific list of hints/warnings/errors
... focus Σ 0..* Reference(Any) The actual content of the message

... definition Σ 0..1 canonical(MessageDefinition) Link to the definition for this message

doco Documentation for this format icon

See the Extensions for this resource

UML Diagram (Legend)

MessageHeader (DomainResource)Code that identifies the event this message represents and connects it with its definition. Events defined as part of the FHIR specification are defined by the implementation. Alternatively a uri , canonical uri to the EventDefinition or SubscriptionTopicevent[x] : DataType [1..1] « Coding|uri|canonical(EventDefinition| SubscriptionTopic); null (Strength=Example)MessageEvent?? »Coded indication of the cause for the event - indicates a reason for the occurrence of the event that is a focus of this messagereason : CodeableConcept [0..1] « null (Strength=Example)ExampleMessageReasonCodes?? »The actual data of the message - a reference to the root/focus class of the event. This is allowed to be a Parameters resourcefocus : Reference [0..*] « Any »Permanent link to the MessageDefinition for this messagedefinition : canonical [0..1] « MessageDefinition »MessageDestinationIndicates where the message should be routedendpoint[x] : DataType [0..1] « url|Reference(Endpoint) »Human-readable name for the target systemname : string [0..1]Allows data conveyed by a message to be addressed to a particular person or department when routing to a specific application isn't sufficientreceiver : Reference [0..1] « Device|Organization|Patient| Practitioner|PractitionerRole|RelatedPerson »MessageSourceIdentifies the routing target to send acknowledgements toendpoint[x] : DataType [0..1] « url|Reference(Endpoint) »Human-readable name for the source systemname : string [0..1]May include configuration or other information useful in debuggingsoftware : string [0..1]Can convey versions of multiple systems in situations where a message passes through multiple handsversion : string [0..1]An e-mail, phone, website or other contact point to use to resolve issues with message communicationscontact : ContactPoint [0..1]Identifies the sending entity to allow the use of a trust relationshipsender : Reference [0..1] « Device|Organization|Patient|Practitioner| PractitionerRole »ResponseThe Bundle.identifier of the message to which this message is a responseidentifier : Identifier [1..1]Code that identifies the type of response to the message - whether it was successful or not, and whether it should be resent or notcode : code [1..1] « null (Strength=Required)ResponseType! »Full details of any issues found in the messagedetails : Reference [0..1] « OperationOutcome »The destination application which the message is intended fordestination[0..*]The source application from which this message originatedsource[1..1]Information about the message that this message is a response to. Only present if this message is a responseresponse[0..1]

XML Template

<MessageHeader xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <event[x]><!-- 1..1 Coding|uri|canonical(EventDefinition|SubscriptionTopic) The real world event that triggered this messsage --></event[x]>
 <destination>  <!-- 0..* Message destination application(s) -->
  <endpoint[x]><!-- 0..1 url|Reference(Endpoint) Actual destination address or Endpoint resource --></endpoint[x]>
  <name value="[string]"/><!-- 0..1 Name of system -->
  <receiver><!-- 0..1 Reference(Device|Organization|Patient|Practitioner|
    PractitionerRole|RelatedPerson) Intended "real-world" recipient for the data --></receiver>
 </destination>
 <source>  <!-- 1..1 Message source application -->
  <endpoint[x]><!-- 0..1 url|Reference(Endpoint) Actual source address or Endpoint resource --></endpoint[x]>
  <name value="[string]"/><!-- 0..1 Name of system -->
  <software value="[string]"/><!-- 0..1 Name of software running the system -->
  <version value="[string]"/><!-- 0..1 Version of software running -->
  <contact><!-- 0..1 ContactPoint Human contact for problems --></contact>
  <sender><!-- 0..1 Reference(Device|Organization|Patient|Practitioner|
    PractitionerRole) Real world sender of the message --></sender>
 </source>
 <reason><!-- 0..1 CodeableConcept Cause of event --></reason>
 <response>  <!-- 0..1 If this is a reply to prior message -->
  <identifier><!-- 1..1 Identifier Bundle.identifier of original message --></identifier>
  <code value="[code]"/><!-- 1..1 ok | transient-error | fatal-error -->
  <details><!-- 0..1 Reference(OperationOutcome) Specific list of hints/warnings/errors --></details>
 </response>
 <focus><!-- 0..* Reference(Any) The actual content of the message --></focus>
 <definition><!-- 0..1 canonical(MessageDefinition) Link to the definition for this message --></definition>
</MessageHeader>

JSON Template

{doco
  "resourceType" : "MessageHeader",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  // event[x]: The real world event that triggered this messsage. One of these 3:
  "eventCoding" : { Coding },
  "eventUri" : "<uri>",
  "eventCanonical" : "<canonical(EventDefinition|SubscriptionTopic)>",
  "destination" : [{ // Message destination application(s)
    // endpoint[x]: Actual destination address or Endpoint resource. One of these 2:
    "endpointUrl" : "<url>",
    "endpointReference" : { Reference(Endpoint) },
    "name" : "<string>", // Name of system
    "receiver" : { Reference(Device|Organization|Patient|Practitioner|
    PractitionerRole|RelatedPerson) } // Intended "real-world" recipient for the data
  }],
  "source" : { // R!  Message source application
    // endpoint[x]: Actual source address or Endpoint resource. One of these 2:
    "endpointUrl" : "<url>",
    "endpointReference" : { Reference(Endpoint) },
    "name" : "<string>", // Name of system
    "software" : "<string>", // Name of software running the system
    "version" : "<string>", // Version of software running
    "contact" : { ContactPoint }, // Human contact for problems
    "sender" : { Reference(Device|Organization|Patient|Practitioner|
    PractitionerRole) } // Real world sender of the message
  },
  "reason" : { CodeableConcept }, // Cause of event
  "response" : { // If this is a reply to prior message
    "identifier" : { Identifier }, // R!  Bundle.identifier of original message
    "code" : "<code>", // R!  ok | transient-error | fatal-error
    "details" : { Reference(OperationOutcome) } // Specific list of hints/warnings/errors
  },
  "focus" : [{ Reference(Any) }], // The actual content of the message
  "definition" : "<canonical(MessageDefinition)>" // Link to the definition for this message
}

Turtle Template

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


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

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  # event[x] : 1..1 The real world event that triggered this messsage. One of these 3
    fhir:event [  a fhir:Coding ; Coding ]
    fhir:event [  a fhir:uri ; uri ]
    fhir:event [  a fhir:canonical ; canonical(EventDefinition|SubscriptionTopic) ]
  fhir:destination ( [ # 0..* Message destination application(s)
    # endpoint[x] : 0..1 Actual destination address or Endpoint resource. One of these 2
      fhir:endpoint [  a fhir:url ; url ]
      fhir:endpoint [  a fhir:Reference ; Reference(Endpoint) ]
    fhir:name [ string ] ; # 0..1 Name of system
    fhir:receiver [ Reference(Device|Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 Intended "real-world" recipient for the data
  ] ... ) ;
  fhir:source [ # 1..1 Message source application
    # endpoint[x] : 0..1 Actual source address or Endpoint resource. One of these 2
      fhir:endpoint [  a fhir:url ; url ]
      fhir:endpoint [  a fhir:Reference ; Reference(Endpoint) ]
    fhir:name [ string ] ; # 0..1 Name of system
    fhir:software [ string ] ; # 0..1 Name of software running the system
    fhir:version [ string ] ; # 0..1 Version of software running
    fhir:contact [ ContactPoint ] ; # 0..1 Human contact for problems
    fhir:sender [ Reference(Device|Organization|Patient|Practitioner|PractitionerRole) ] ; # 0..1 Real world sender of the message
  ] ;
  fhir:reason [ CodeableConcept ] ; # 0..1 Cause of event
  fhir:response [ # 0..1 If this is a reply to prior message
    fhir:identifier [ Identifier ] ; # 1..1 Bundle.identifier of original message
    fhir:code [ code ] ; # 1..1 ok | transient-error | fatal-error
    fhir:details [ Reference(OperationOutcome) ] ; # 0..1 Specific list of hints/warnings/errors
  ] ;
  fhir:focus  ( [ Reference(Any) ] ... ) ; # 0..* The actual content of the message
  fhir:definition [ canonical(MessageDefinition) ] ; # 0..1 Link to the definition for this message
]

Changes from both R4 and R4B

MessageHeader
MessageHeader.event[x]
  • Add Type canonical(EventDefinition | SubscriptionTopic)
MessageHeader.destination.endpoint[x]
  • Renamed from endpoint to endpoint[x]
  • Min Cardinality changed from 1 to 0
  • Add Type Reference(Endpoint)
MessageHeader.destination.receiver
  • Type Reference: Added Target Types Device, Patient, RelatedPerson
MessageHeader.source.endpoint[x]
  • Renamed from endpoint to endpoint[x]
  • Min Cardinality changed from 1 to 0
  • Add Type Reference(Endpoint)
MessageHeader.source.sender
  • Added Element
MessageHeader.response.identifier
  • Type changed from id to Identifier
MessageHeader.destination.target
  • Deleted
MessageHeader.sender
  • Deleted
MessageHeader.enterer
  • Deleted
MessageHeader.author
  • Deleted
MessageHeader.responsible
  • Deleted

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.

 

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

2.15.3.1 Terminology Bindings

Path ValueSet Type Documentation
MessageHeader.event[x] Example
MessageHeader.reason ExampleMessageReasonCodes Example

Example Message Reasons. These are the set of codes that might be used an updating an encounter using admin-update.
MessageHeader.response.code ResponseType Required

The kind of response to a message.

2.15.4 Notes:

  • There is no persistent identifier on MessageHeader that identifies the specific triggering event for the message - any such identity must be determined from the payload of the message.
  • The actual content of the focus resource is specified for each message event (see the list on the messaging page). Any resources referenced in the focus element are always included in the bundle
  • If MessageHeader.source.endpoint and MessageHeader.destination.endpoint, are literal URLs, then they SHOULD identify the addresses to which messages can be delivered. If they are logical URIs (i.e. non-dereferenceable), message delivery intermediaries must know how to deliver the message to the destination application.
  • The time of the event will be found in the focus resource. The time of the message will be found in Bundle.timestamp
  • The sender and receiver are not the actual technical systems - these are the human or organizations that make use of the technical systems
  • A receiver is not obligated to reject messages which do not explicitly identify it as receiver (e.g. a tracker will get messages that are destined for some other system)
  • The value set MessageEvent is populated by the authors of the resources declaring the events

2.15.5 Search Parameters

Search parameters for this resource. See also the full list of search parameters for this resource, and check the Extensions registry for search parameters on extensions related to 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
code token ok | transient-error | fatal-error MessageHeader.response.code
destination string Name of system MessageHeader.destination.name
event token Code for the event this message represents or link to event definition MessageHeader.event.ofType(Coding) | MessageHeader.event.ofType(canonical)
focus reference The actual content of the message MessageHeader.focus
(Any)
receiver reference Intended "real-world" recipient for the data MessageHeader.destination.receiver
(Practitioner, Organization, Device, Patient, PractitionerRole, RelatedPerson)
response-id token Id of original message MessageHeader.response.identifier
sender reference Real world sender of the message MessageHeader.source.sender
(Practitioner, Organization, Device, Patient, PractitionerRole)
source string Name of system MessageHeader.source.name