The HL7 Listener supports receiving messages in batches. To do so, OnBase automatically parses and processes messages between Batch Header Segments (BHS), and Batch Trailer Segments (BTS) as a batch. This is intended and useful for patient and chart-related HL7 messages. Sending messages to OnBase as a batch allows the HL7 Listener to process messages concurrently, which improves throughput. Additionally, this can result in fewer round trips between an HL7 interface and the OnBase HL7 Listener, which reduces the impact of latency in high latency environments.
The following displays an example of batch message formatting. Note that further information regarding the HL7 batch protocol can be found in official documentation regarding the HL7 standard specification.
BHS|^~\&||||||||||101||
MSH|^~\&|||||||ADT^A08|123456||||||||||
PID|1|1|22||SMITH^JOHN^S|||M|||123 MAIN ST^ANYTOWN^PA^17859||||||||||
MSH|^~\&|||||||ADT^A28|123457||||||||||
PID|2|2|33||DOE^JOHN^L|||M|||456 MAIN ST^ANYTOWN^PA^17859||||||||||
MSH|^~\&|||||||ADT^A08|123458||||||||||
PID|1|1|22||SMITH^JOHN^S|||M|||123 MAIN ST^ANYTOWN^PA^17859||||||||||
PV1||R|||||||||||||||||1|
MSH|^~\&|||||||SIU^S12|123459||||||||||
PID|3|3|44||SMITH^JANE^E|||F|||123 MAIN ST^ANYTOWN^PA^17859||||||||||
PV1||R||||||||||||||||||
BTS|4|
The following example displays acknowledgements sent back by OnBase. In this example, three messages were processed successfully, and the fourth message failed to process.
BHS|^~\&||||||||||101||
MSH|^~\&|||||||ACK|123456||||||||||
MSA|AA|123456|||
MSH|^~\&|||||||ACK|123457||||||||||
MSA|AA|123457|||
MSH|^~\&|||||||ACK|123458||||||||||
MSA|AA|123458|||
MSH|^~\&|||||||ACK|123459||||||||||
MSA|AR|123459|Error: Cannot perform a create or update operation without a Chart.||
BTS|4|