Engage HL7 Adapter
Release Notes - Version 1.4.5
Updated: April 16, 2021
About Engage HL7 Adapter
The Engage HL7 Adapter
is used to connect with an existing HL7 capable system. By creating multiple HL7 adapter
instances, an installation can allow for communication with different departments and system
types within a single facility.
An Engage HL7 Adapter
is used to communicate with any other system or database that is HL7 capable. It brings the
pertinent information, such as lab results, to the Engage server and stores those events in
the Data Manager. This information is then potentially later sent to the recipient database of
that HL7 message based upon appliance configurations. The content of the message varies
depending on the HL7 configuration in the appliance, but an HL7 message may include data such
as patient information and history, lab results, and radiology reports.
This section summarizes the new features in this release.
What's New in Engage HL7 Adapter 1.3
The Engage HL7 Adapter 1.3 SR1 (1.3.2) solution is a maintenance release that does not introduce any new
What's New in Engage HL7 Adapter
The Engage HL7 Adapter 1.4 (1.4.5) solution provides the following new features:
This adapter has been re-built for compatibility with Platform 5.5.
This adapter has been updated to improve handling of messages during failover. (ADP-4114, ADP-4336)
- When sending a message because of a fired rule, the adapter opens a new connection only if
one does not exist or if the previous one is no longer usable, and the adapter maintains the
outbound connection used for at least 60 minutes after the message is sent. (ADP-5308)
Multiple definitions can be configured for the same segment within a message definition.
Statistics are displayed in the adapter's Details, and can be refreshed without reloading
the entire adapter. (ADP-3788)
The "acknowledgment on a different port" fields have been removed from inbound and
outbound connection configuration. (ADP-3453)
The activity state of ongoing alerts are re-evaluated when the highest priority event
within a message receives changes. (ADP-5223)
If an alert is active and a subsequent message does not contain a currently active alert
with the same location settings, then the alert will be inactivated. If a subsequent
message does not contain the currently active alert for the location and the highest
priority remaining alert is currently suppressed, then a new active alert will be created.
If an alert is active and a subsequent message for the same location contains both that
alert and a higher priority alert, then the old active alert will be inactivated and a new
suppressed alert will be created for it (and a new active alert will be created for the
higher priority alert).
This section provides information about fixes and improvements made to the Engage HL7 Adapter product.
What's Fixed in the Engage HL7 Adapter 1.3 SR1
The following issues are fixed in Engage HL7 Adapter 1.3 SR1
HL7 can stop marking alerts as inactive. (ADP-5180)
- A timing issue can cause a null pointer exception on the date comparison to the most
recently received time.
- Nothing stops exceptions thrown in the periodic task that marks alerts inactive from being
thrown back to the ScheduledExecutorService that runs them, which would cause the job to stop
- Prevent null pointer exception by initiating/updating time before/during Map insertion
- Add try/catch around inactive check to keep it from stopping.
HL7 file based ID generator can overflow. (ADP-5134)
Configure the parser that generates the ACK to use a UUID based message id generator instead
of the default file based processor that uses sequential numbers.
What's Fixed in the Engage HL7 Adapter 1.4
The following issues are fixed in Engage HL7 Adapter 1.4
Message Type marked for discard no longer causes package export to fail. (ADP-3864)
Referencing invalid capture groups in HL7 preprocessing rules no longer causes an exception
and skew statistics. (ADP-3825)
HL7 now creates an audit message when it cannot listen on a port because it is already in
This release of the Engage HL7 Adapter has no known issues.