Difference between revisions of "Message Wrappers section of the v3Guide"
Rene spronk (talk | contribs) (new page) |
Rene spronk (talk | contribs) (3.9 section edit) |
||
Line 1: | Line 1: | ||
− | Section 3.9 of the v3Guide (May2006) which needs to be updated to reflect the latest thinking on wrappers and infrastructure. | + | Section 3.9 of the v3Guide (May2006) which needs to be updated to reflect the latest thinking on wrappers and infrastructure. The Wiki links have been added with the sole intent that terms are used in a consisten manner; the links won't show up in the v3Guide in ballot or normative standard publications. |
== 3.9 Version 3 Message Wrappers and Infrastructure == | == 3.9 Version 3 Message Wrappers and Infrastructure == | ||
− | HL7 Version 3 provides a substantial level of functionality in the provision of envelopes to support the transport of HL7 messages from sender to receiver. HL7 calls these wrappers. Inside the wrapper is Domain Content. | + | HL7 Version 3 provides a substantial level of functionality in the provision of envelopes to support the transport of HL7 messages from sender to receiver. HL7 calls these wrappers. Inside the wrapper is [[Domain Content]]. |
− | Wrappers are all defined in the same way as for message content, by defining | + | Wrappers are all defined in the same way as for message content, by defining object classes and related relationships. These specifications can then be used to generate an ITS-defined syntax (e.g. XML schema) to go on the wire. |
− | The | + | The Messaging Infrastructure part of the standard is organised as four separate domains. The four domains are:- |
#Transmission Infrastructure | #Transmission Infrastructure | ||
#Message Control Act | #Message Control Act | ||
#Query Infrastructure | #Query Infrastructure | ||
− | #Master File Infrastructure | + | #Master File - Registry Infrastructure |
− | + | Whenever domain payloads are transmitted in the form of messages they will use the wrappers as defined by the above domains. HL7 has defined a rich set of transmission oriented functions within the HL7 standards scope because there is no de facto way of providing these functions in a single standard that could be adopted. Standars such as Webservices or ebXML provide similar functionality, whereas MLLP or FTP do not. | |
− | + | === 3.9.1 HL7 Transmission Wrapper === | |
− | |||
− | === 3.9.1 HL7 Transmission Wrapper | ||
The HL7 Transmission wrapper is required for all Version 3 messages. It contains a large number of optional fields so the message overhead will vary from one context to another. Technical committees or realms who perform refinement on the transmission wrapper need to ensure that tooling is in place to pick up their modified wrapper rather than just the default. For instance when using an XML ITS, the final output needs to be an XML schema comprising message content, the transmission wrapper, and, optionally, a Control Act wrapper. | The HL7 Transmission wrapper is required for all Version 3 messages. It contains a large number of optional fields so the message overhead will vary from one context to another. Technical committees or realms who perform refinement on the transmission wrapper need to ensure that tooling is in place to pick up their modified wrapper rather than just the default. For instance when using an XML ITS, the final output needs to be an XML schema comprising message content, the transmission wrapper, and, optionally, a Control Act wrapper. |
Revision as of 07:49, 29 March 2006
Section 3.9 of the v3Guide (May2006) which needs to be updated to reflect the latest thinking on wrappers and infrastructure. The Wiki links have been added with the sole intent that terms are used in a consisten manner; the links won't show up in the v3Guide in ballot or normative standard publications.
Contents
3.9 Version 3 Message Wrappers and Infrastructure
HL7 Version 3 provides a substantial level of functionality in the provision of envelopes to support the transport of HL7 messages from sender to receiver. HL7 calls these wrappers. Inside the wrapper is Domain Content.
Wrappers are all defined in the same way as for message content, by defining object classes and related relationships. These specifications can then be used to generate an ITS-defined syntax (e.g. XML schema) to go on the wire.
The Messaging Infrastructure part of the standard is organised as four separate domains. The four domains are:-
- Transmission Infrastructure
- Message Control Act
- Query Infrastructure
- Master File - Registry Infrastructure
Whenever domain payloads are transmitted in the form of messages they will use the wrappers as defined by the above domains. HL7 has defined a rich set of transmission oriented functions within the HL7 standards scope because there is no de facto way of providing these functions in a single standard that could be adopted. Standars such as Webservices or ebXML provide similar functionality, whereas MLLP or FTP do not.
3.9.1 HL7 Transmission Wrapper
The HL7 Transmission wrapper is required for all Version 3 messages. It contains a large number of optional fields so the message overhead will vary from one context to another. Technical committees or realms who perform refinement on the transmission wrapper need to ensure that tooling is in place to pick up their modified wrapper rather than just the default. For instance when using an XML ITS, the final output needs to be an XML schema comprising message content, the transmission wrapper, and, optionally, a Control Act wrapper.
Associated with use of the wrapper are a number of services that are available as needed:-
Three messages are defined to support these functions and each one has an R-MIM and HMD. The two acknowledgement message types with very different roles. One is to support reliable delivery at the network level. Increasingly however HL7 V3 messaging will make use of external transport services that do not require use of an HL7-defined network acknowledgement. The same is true of the optional message sequence number protocol. It is an essential component of supporting reliable delivery at the network level, but again not required if an external reliable transport is used such as the three HL7 transport profiles now all at DSTU.
The application acknowledgement is very different. It is triggered only by inclusion in an Interaction and with a defined trigger event. It may carry domain content and therefore combine the general functionality of an application acknowledgement, with the specific response defined by the domain for this Interaction.
All the message structures in the Transmission Domain have mandatory attributes which define the sending and receiving systems in a message transmission (DeviceID). Additional information about the Sender and Receiver in other classes, but the use of a mandatory attribute ensures that a transport protocol such as the ebXML DSTU can define an attribute copy procedure which will allow the values in Device ID to be also held in the ebXML wrappers. A later paragraph in this Section summarises the commonalities and differences between the three transport DSTU specifications.
The Transmission wrapper offers an additional set of functions to support polling. These functions are included for compatibility with some early V2 use. Polling is probably a matter of limited interest to implementors, other than those with particular legacy problems.
- Send Poll Response w/ Message
- Send Accept Ack/Poll Next Msg
3.9.2 Control Act wrapper(ballot: Infrastructure Domain)
Additional richness in functionality is provided by the Control Act wrapper, which is used when information about the interaction which has triggered a message needs to be communicated within that message to the receiver. In some cases, these interactions will have been fully defined by the interaction model and therefore there is no need for such information to be included inthe message. Two particular areas of application are query sessions and registry interactions (such as Master Person Index). Technical committees will individually decide when a Control Act wrapper needs to be specified for a particular message. A generic wrapper definition is supplied as part of the Infrastructure ballot. Technical Committees may carry out refinement on the wrapper to meet their own needs. Future tooling will need to be able incorporate domain-specific wrappers when necessary. This is outside the capability of the current tooling.
These wrappers are described in the HL7 ballot in three main groupings, described as separate domains:
- Message Control Act Infrastructure (MCAI) -defining the Control Act itself.
- Query Infrastructure (QUQI) -which describes how to use the wrapper to support queries
- Master File Infrastructure (MFMI)
3.9.3 Message Control Act Infrastructure
MCAI defines the detail of the Control Act. Key uses are for Query and Master File applications, these are summarised in the next two paragraphs.
3.9.4 Query Infrastructure
The objective is to set up a general structure for queries and their response. Three messages are defined along with appropriate roles and interactions.
- Query General Activate Query Continue
- Query General Response
- Query by Parameter specification
3.9.5 Master File Infrastructure
A typical application is an MPI Master Patient Index. Again, the intention is to define a general set of messages that can be used to maintain any type of patient or professional database, or similar.
In these functional areas, there are no specific messages against the message functionality required. The Control Act is used to define what is needed, together with a set of standard trigger events, and an appropriate state diagram.