HL7 Inbound (MLLP Receive)
The HL7 Inbound device is used to receive HL7v2 over the network. It is fairly well documented within the device user interface, so this page will give a quick overview of the device.
Use the Connection tab to input the network interface and port to listen on.
Input the listening port, and optionally specify a specific IP to listen on.
The Max Message Size field defaults to 10MB, and any message over this size will be truncated and moved to the error queue.
You can choose to add an Error Rule or Filter Rule as an HL7 expression. For example, you could route all messages from a specific sender to the filter queue by entering an expression like MSH-4 = ‘XXX’.
The Options tab exposes Encoding, Framing, Continuation support, and logging options.
The Debug Logging option writes the raw message stream to a file, enabling inspection of the network content. This feature should only be enabled while debugging.
The SSL Encryption tab is used to configure both client and server certificates. You can specify a server certificate from the OS certificate store, or, create your own self-signed. You can enable validation of client identity by creating or importing certificates used by upstream systems. More Information.
Use the String Replacement tab to perform simple text replacements (exact match or regex match) on the incoming HL7 prior to it being parsed and validated. If the source system is sending invalid HL7 (for example, 4 character segments), this provides a simple work around.
The Ack Transform tab is used to modify the structure of the HL7 Ack sent back to the source system. It is a hosted instance of the HL7 Transform device, and provides a powerful way to tailor your ACKs, should you wish to.
The Diagnostics tab provides Connexion host network information.
Event Hooks
The HL7 Inbound device publishes the following event hooks: