MDM: Medical Document Management
MDM moves clinical documents and their status: a dictated note becoming available, a transcription being edited, a document being replaced. The document itself travels in OBX segments beneath a TXA header.
Recognising MDM messages
MDM announces itself in MSH-9 like this:
MDM^T01^MDM_T01- MSH-9.1
MDMmessage code: what kind of message this is (medical document management) - MSH-9.2
T01trigger event: what happened in the real world: original document notification - MSH-9.3
MDM_T01message structure: which segments to expect, and in what order
How to use these specifications explains MSH-9 in full, with a worked example.
Message structures
MDM takes 2 structures.
MDM_T01: Original Document Notification
6 different trigger events send this structure:
- T01Original Document Notification
- T03Document Status Change Notification
- T05Document Addendum Notification
- T07Document Edit Notification
- T09Document Replacement Notification
- T11Document Cancel Notification
The segments below are the same for all 6. HL7 varies the meaning, not the shape: there is no separate MDM_T03 layout. What changes is MSH-9, which tells the receiver which of the 6 happened and therefore what to do with the message.
You must always send: MSH, EVN, PID, PV1, TXA. Everything else is optional, or required only inside a group you chose to send.
| Segment | Name | OPT | Cardinality |
|---|---|---|---|
| MSH | R | 1..1 | |
| SFT | O | 0..* | |
| EVN | R | 1..1 | |
| PID | R | 1..1 | |
| PV1 | R | 1..1 | |
| COMMON_ORDER | a group of 4 segments, repeated together | O | 0..* |
| ORCin COMMON_ORDER | R | 1..1 | |
| TIMINGin COMMON_ORDER | a group of 2 segments, repeated together | O | 0..* |
| TQ1in TIMING | R | 1..1 | |
| TQ2in TIMING | O | 0..* | |
| OBRin COMMON_ORDER | R | 1..1 | |
| NTEin COMMON_ORDER | O | 0..* | |
| TXA | R | 1..1 |
R inside a group means required of that group. Send the group and you must include that segment; leave the group out and it never appears. This structure has 2 such groups: COMMON_ORDER, TIMING.
MDM_T02: Original Document Notification and Content
5 different trigger events send this structure:
- T02Original Document Notification and Content
- T04T04
- T06Document Addendum Notification and Content
- T08Document Edit Notification and Content
- T10Document Replacement Notification and Content
The segments below are the same for all 5. HL7 varies the meaning, not the shape: there is no separate MDM_T04 layout. What changes is MSH-9, which tells the receiver which of the 5 happened and therefore what to do with the message.
You must always send: MSH, EVN, PID, PV1, TXA, OBX. Everything else is optional, or required only inside a group you chose to send.
| Segment | Name | OPT | Cardinality |
|---|---|---|---|
| MSH | R | 1..1 | |
| SFT | O | 0..* | |
| EVN | R | 1..1 | |
| PID | R | 1..1 | |
| PV1 | R | 1..1 | |
| COMMON_ORDER | a group of 4 segments, repeated together | O | 0..* |
| ORCin COMMON_ORDER | R | 1..1 | |
| TIMINGin COMMON_ORDER | a group of 2 segments, repeated together | O | 0..* |
| TQ1in TIMING | R | 1..1 | |
| TQ2in TIMING | O | 0..* | |
| OBRin COMMON_ORDER | R | 1..1 | |
| NTEin COMMON_ORDER | O | 0..* | |
| TXA | R | 1..1 | |
| OBSERVATION | a group of 2 segments, repeated together | R | 1..* |
| OBX | R | 1..1 | |
| NTE | O | 0..* |
R inside a group means required of that group. Send the group and you must include that segment; leave the group out and it never appears. This structure has 3 such groups: COMMON_ORDER, TIMING, OBSERVATION.
Trigger events
The trigger event is the real-world thing that made the message get sent. MDM defines 11.
| Event | Name | Structure |
|---|---|---|
| T01 | Original Document Notification | MDM_T01 |
| T02 | Original Document Notification and Content | MDM_T02 |
| T03 | Document Status Change Notification | MDM_T01 |
| T04 | T04 | MDM_T02 |
| T05 | Document Addendum Notification | MDM_T01 |
| T06 | Document Addendum Notification and Content | MDM_T02 |
| T07 | Document Edit Notification | MDM_T01 |
| T08 | Document Edit Notification and Content | MDM_T02 |
| T09 | Document Replacement Notification | MDM_T01 |
| T10 | Document Replacement Notification and Content | MDM_T02 |
| T11 | Document Cancel Notification | MDM_T01 |