2nd DSTU Draft For Comment

This page is part of the FHIR Specification (v0.4.0: DSTU 2 Draft). 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 R2

6.12 Resource MessageHeader - Content

This resource maintained by the FHIR Management Group Work Group

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.

6.12.1 Scope and Usage

The MessageHeader resource is defined in order to support Messaging using FHIR resources. The principle 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]/Message), 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.

6.12.2 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. MessageHeader DomainResourceA resource that describes a message that is exchanged between systems
... identifier 1..1idId of this message
... timestamp 1..1instantTime that the message was sent
... event M1..1CodingCode for the event this message represents
MessageEvent (Incomplete)
... response M0..1ElementIf this is a reply to prior message
.... identifier 1..1idId of original message
.... code M1..1codeok | transient-error | fatal-error
ResponseType (Required)
.... details 0..1OperationOutcomeSpecific list of hints/warnings/errors
... source 1..1ElementMessage Source Application
.... name 0..1stringName of system
.... software 0..1stringName of software running the system
.... version 0..1stringVersion of software running
.... contact 0..1ContactPointHuman contact for problems
.... endpoint 1..1uriActual message source address or id
... destination 0..*ElementMessage Destination Application(s)
.... name 0..1stringName of system
.... target 0..1DeviceParticular delivery destination within the destination
.... endpoint 1..1uriActual destination address or id
... enterer 0..1PractitionerThe source of the data entry
... author 0..1PractitionerThe source of the decision
... receiver 0..1Practitioner | OrganizationIntended "real-world" recipient for the data
... responsible 0..1Practitioner | OrganizationFinal responsibility for event
... reason 0..1CodeableConceptCause of event
EventReason (Example)
... data 0..*AnyThe actual content of the message

UML Diagram

MessageHeader (DomainResource)The identifier of this messageidentifier : id 1..1The time that the message was senttimestamp : instant 1..1Code that identifies the event this message represents and connects it with its definition. Events defined as part of the FHIR specification have the system value "http://hl7.org/fhir/message-type" (this element modifies the meaning of other elements)event : Coding 1..1 « One of the message events defined as part of FHIRMessageEvent+ »The person or device that performed the data entry leading to this message. Where there is more than one candidate, pick the most proximal to the message. Can provide other enterers in extensionsenterer : Reference(Practitioner) 0..1The logical author of the message - the person or device that decided the described event should happen. Where there is more than one candidate, pick the most proximal to the MessageHeader. Can provide other authors in extensionsauthor : Reference(Practitioner) 0..1Allows data conveyed by a message to be addressed to a particular person or department when routing to a specific application isn't sufficientreceiver : Reference(Practitioner|Organization) 0..1The person or organization that accepts overall responsibility for the contents of the message. The implication is that the message event happened under the policies of the responsible partyresponsible : Reference(Practitioner|Organization) 0..1Coded indication of the cause for the event - indicates a reason for the occurance of the event that is a focus of this messagereason : CodeableConcept 0..1 « (Reason for event occurrenceEventReason) »The actual data of the message - a reference to the root/focus class of the eventdata : Reference(Any) 0..*ResponseThe id of the message that this message is a response toidentifier : id 1..1Code that identifies the type of response to the message - whether it was successful or not, and whether it should be resent or not (this element modifies the meaning of other elements)code : code 1..1 « The kind of response to a messageResponseType »Full details of any issues found in the messagedetails : Reference(OperationOutcome) 0..1MessageSourceHuman-readable name for the source systemname : string 0..1May include configuration or other information useful in debuggingsoftware : string 0..1Can convey versions of multiple systems in situations where a message passes through multiple handsversion : string 0..1An e-mail, phone, website or other contact point to use to resolve issues with message communicationscontact : ContactPoint 0..1Identifies the routing target to send acknowledgements toendpoint : uri 1..1MessageDestinationHuman-readable name for the target systemname : string 0..1Identifies the target end system in situations where the initial message transmission is to an intermediary systemtarget : Reference(Device) 0..1Indicates where the message should be routed toendpoint : uri 1..1Information about the message that this message is a response to. Only present if this message is a response (this element modifies the meaning of other elements)response0..1The source application from which this message originatedsource1..1The destination application which the message is intended fordestination0..*

XML Template

<MessageHeader xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier value="[id]"/><!-- 1..1 Id of this message -->
 <timestamp value="[instant]"/><!-- 1..1 Time that the message was sent -->
 <event><!-- 1..1 Coding Code for the event this message represents --></event>
 <response>  <!-- 0..1 If this is a reply to prior message -->
  <identifier value="[id]"/><!-- 1..1 Id of original message -->
  <code value="[code]"/><!-- 1..1 ok | transient-error | fatal-error -->
  <details><!-- 0..1 Reference(OperationOutcome) Specific list of hints/warnings/errors --></details>
 </response>
 <source>  <!-- 1..1 Message Source Application -->
  <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>
  <endpoint value="[uri]"/><!-- 1..1 Actual message source address or id -->
 </source>
 <destination>  <!-- 0..* Message Destination Application(s) -->
  <name value="[string]"/><!-- 0..1 Name of system -->
  <target><!-- 0..1 Reference(Device) Particular delivery destination within the destination --></target>
  <endpoint value="[uri]"/><!-- 1..1 Actual destination address or id -->
 </destination>
 <enterer><!-- 0..1 Reference(Practitioner) The source of the data entry --></enterer>
 <author><!-- 0..1 Reference(Practitioner) The source of the decision --></author>
 <receiver><!-- 0..1 Reference(Practitioner|Organization) 
     Intended "real-world" recipient for the data --></receiver>
 <responsible><!-- 0..1 Reference(Practitioner|Organization) 
     Final responsibility for event --></responsible>
 <reason><!-- 0..1 CodeableConcept Cause of event --></reason>
 <data><!-- 0..* Reference(Any) The actual content of the message --></data>
</MessageHeader>

JSON Template

{doco
  "resourceType" : "MessageHeader",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : "<id>", // R! Id of this message
  "timestamp" : "<instant>", // R! Time that the message was sent
  "event" : { Coding }, // R! Code for the event this message represents
  "response" : { // If this is a reply to prior message
    "identifier" : "<id>", // R! Id of original message
    "code" : "<code>", // R! ok | transient-error | fatal-error
    "details" : { Reference(OperationOutcome) } // Specific list of hints/warnings/errors
  },
  "source" : { // R! Message Source Application
    "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
    "endpoint" : "<uri>" // R! Actual message source address or id
  },
  "destination" : [{ // Message Destination Application(s)
    "name" : "<string>", // Name of system
    "target" : { Reference(Device) }, // Particular delivery destination within the destination
    "endpoint" : "<uri>" // R! Actual destination address or id
  }],
  "enterer" : { Reference(Practitioner) }, // The source of the data entry
  "author" : { Reference(Practitioner) }, // The source of the decision
  "receiver" : { Reference(Practitioner|Organization) }, // 
     Intended "real-world" recipient for the data
  "responsible" : { Reference(Practitioner|Organization) }, // 
     Final responsibility for event
  "reason" : { CodeableConcept }, // Cause of event
  "data" : [{ Reference(Any) }] // The actual content of the message
}

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. MessageHeader DomainResourceA resource that describes a message that is exchanged between systems
... identifier 1..1idId of this message
... timestamp 1..1instantTime that the message was sent
... event M1..1CodingCode for the event this message represents
MessageEvent (Incomplete)
... response M0..1ElementIf this is a reply to prior message
.... identifier 1..1idId of original message
.... code M1..1codeok | transient-error | fatal-error
ResponseType (Required)
.... details 0..1OperationOutcomeSpecific list of hints/warnings/errors
... source 1..1ElementMessage Source Application
.... name 0..1stringName of system
.... software 0..1stringName of software running the system
.... version 0..1stringVersion of software running
.... contact 0..1ContactPointHuman contact for problems
.... endpoint 1..1uriActual message source address or id
... destination 0..*ElementMessage Destination Application(s)
.... name 0..1stringName of system
.... target 0..1DeviceParticular delivery destination within the destination
.... endpoint 1..1uriActual destination address or id
... enterer 0..1PractitionerThe source of the data entry
... author 0..1PractitionerThe source of the decision
... receiver 0..1Practitioner | OrganizationIntended "real-world" recipient for the data
... responsible 0..1Practitioner | OrganizationFinal responsibility for event
... reason 0..1CodeableConceptCause of event
EventReason (Example)
... data 0..*AnyThe actual content of the message

UML Diagram

MessageHeader (DomainResource)The identifier of this messageidentifier : id 1..1The time that the message was senttimestamp : instant 1..1Code that identifies the event this message represents and connects it with its definition. Events defined as part of the FHIR specification have the system value "http://hl7.org/fhir/message-type" (this element modifies the meaning of other elements)event : Coding 1..1 « One of the message events defined as part of FHIRMessageEvent+ »The person or device that performed the data entry leading to this message. Where there is more than one candidate, pick the most proximal to the message. Can provide other enterers in extensionsenterer : Reference(Practitioner) 0..1The logical author of the message - the person or device that decided the described event should happen. Where there is more than one candidate, pick the most proximal to the MessageHeader. Can provide other authors in extensionsauthor : Reference(Practitioner) 0..1Allows data conveyed by a message to be addressed to a particular person or department when routing to a specific application isn't sufficientreceiver : Reference(Practitioner|Organization) 0..1The person or organization that accepts overall responsibility for the contents of the message. The implication is that the message event happened under the policies of the responsible partyresponsible : Reference(Practitioner|Organization) 0..1Coded indication of the cause for the event - indicates a reason for the occurance of the event that is a focus of this messagereason : CodeableConcept 0..1 « (Reason for event occurrenceEventReason) »The actual data of the message - a reference to the root/focus class of the eventdata : Reference(Any) 0..*ResponseThe id of the message that this message is a response toidentifier : id 1..1Code that identifies the type of response to the message - whether it was successful or not, and whether it should be resent or not (this element modifies the meaning of other elements)code : code 1..1 « The kind of response to a messageResponseType »Full details of any issues found in the messagedetails : Reference(OperationOutcome) 0..1MessageSourceHuman-readable name for the source systemname : string 0..1May include configuration or other information useful in debuggingsoftware : string 0..1Can convey versions of multiple systems in situations where a message passes through multiple handsversion : string 0..1An e-mail, phone, website or other contact point to use to resolve issues with message communicationscontact : ContactPoint 0..1Identifies the routing target to send acknowledgements toendpoint : uri 1..1MessageDestinationHuman-readable name for the target systemname : string 0..1Identifies the target end system in situations where the initial message transmission is to an intermediary systemtarget : Reference(Device) 0..1Indicates where the message should be routed toendpoint : uri 1..1Information about the message that this message is a response to. Only present if this message is a response (this element modifies the meaning of other elements)response0..1The source application from which this message originatedsource1..1The destination application which the message is intended fordestination0..*

XML Template

<MessageHeader xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier value="[id]"/><!-- 1..1 Id of this message -->
 <timestamp value="[instant]"/><!-- 1..1 Time that the message was sent -->
 <event><!-- 1..1 Coding Code for the event this message represents --></event>
 <response>  <!-- 0..1 If this is a reply to prior message -->
  <identifier value="[id]"/><!-- 1..1 Id of original message -->
  <code value="[code]"/><!-- 1..1 ok | transient-error | fatal-error -->
  <details><!-- 0..1 Reference(OperationOutcome) Specific list of hints/warnings/errors --></details>
 </response>
 <source>  <!-- 1..1 Message Source Application -->
  <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>
  <endpoint value="[uri]"/><!-- 1..1 Actual message source address or id -->
 </source>
 <destination>  <!-- 0..* Message Destination Application(s) -->
  <name value="[string]"/><!-- 0..1 Name of system -->
  <target><!-- 0..1 Reference(Device) Particular delivery destination within the destination --></target>
  <endpoint value="[uri]"/><!-- 1..1 Actual destination address or id -->
 </destination>
 <enterer><!-- 0..1 Reference(Practitioner) The source of the data entry --></enterer>
 <author><!-- 0..1 Reference(Practitioner) The source of the decision --></author>
 <receiver><!-- 0..1 Reference(Practitioner|Organization) 
     Intended "real-world" recipient for the data --></receiver>
 <responsible><!-- 0..1 Reference(Practitioner|Organization) 
     Final responsibility for event --></responsible>
 <reason><!-- 0..1 CodeableConcept Cause of event --></reason>
 <data><!-- 0..* Reference(Any) The actual content of the message --></data>
</MessageHeader>

JSON Template

{doco
  "resourceType" : "MessageHeader",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : "<id>", // R! Id of this message
  "timestamp" : "<instant>", // R! Time that the message was sent
  "event" : { Coding }, // R! Code for the event this message represents
  "response" : { // If this is a reply to prior message
    "identifier" : "<id>", // R! Id of original message
    "code" : "<code>", // R! ok | transient-error | fatal-error
    "details" : { Reference(OperationOutcome) } // Specific list of hints/warnings/errors
  },
  "source" : { // R! Message Source Application
    "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
    "endpoint" : "<uri>" // R! Actual message source address or id
  },
  "destination" : [{ // Message Destination Application(s)
    "name" : "<string>", // Name of system
    "target" : { Reference(Device) }, // Particular delivery destination within the destination
    "endpoint" : "<uri>" // R! Actual destination address or id
  }],
  "enterer" : { Reference(Practitioner) }, // The source of the data entry
  "author" : { Reference(Practitioner) }, // The source of the decision
  "receiver" : { Reference(Practitioner|Organization) }, // 
     Intended "real-world" recipient for the data
  "responsible" : { Reference(Practitioner|Organization) }, // 
     Final responsibility for event
  "reason" : { CodeableConcept }, // Cause of event
  "data" : [{ Reference(Any) }] // The actual content of the message
}

 

Alternate definitions: Schema/Schematron, Resource Profile (XML, JSON), Questionnaire

6.12.2.1 Terminology Bindings

PathDefinitionTypeReference
MessageHeader.event One of the message events defined as part of FHIRIncompletehttp://hl7.org/fhir/valueset/message-events
MessageHeader.response.code The kind of response to a messageFixedhttp://hl7.org/fhir/response-code
MessageHeader.reason Reason for event occurrenceExamplehttp://hl7.org/fhir/vs/message-reason-encounter

6.12.3 Notes:

  • The resources referenced by the enterer, author and responsible elements may all be included in the message bundle or left out on the basis that the recipient (and any intermediaries) are able to locate/resolve the resources independently. The former would be suitable for loosely coupled systems, and the latter for tightly coupled systems. The messaging conformance statement for an application may reference a profile that describes how the bundling occurs
  • The actual content of the data resource is specified for each message event (see the list on the messaging page). Any resources referenced in the data 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 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 author and the 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)

6.12.4 Search Parameters

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

NameTypeDescriptionPaths
codetokenok | transient-error | fatal-errorMessageHeader.response.code
datareferenceThe actual content of the messageMessageHeader.data
(Any)
destinationstringName of systemMessageHeader.destination.name
destination-uritokenActual destination address or idMessageHeader.destination.endpoint
eventtokenCode for the event this message representsMessageHeader.event
receiverreferenceIntended "real-world" recipient for the dataMessageHeader.receiver
(Organization, Practitioner)
response-idtokenId of original messageMessageHeader.response.identifier
sourcestringName of systemMessageHeader.source.name
source-uritokenActual message source address or idMessageHeader.source.endpoint
src-idtokenId of this messageMessageHeader.identifier
timestampdateTime that the message was sentMessageHeader.timestamp