HL7 relay framework is used to broadcast HL7 messages to multiple listeners on the same network, and centralize workflows. This is necessary when the HL7 message sender software is unable to send a message to multiple devices.
The HL7 Relay demo is an end user application and consists of a Windows Service, AddIn library, and a manager application for controlling the state of the Windows Service as well as the settings used by both the Windows Service and AddIn library.
The projects source code is located in LEADTOOLS directory: <INSTALL_DIR>\LEADTOOLS23\Examples\HL7\DotNet
For the complete list of HL7 demos, refer to Leadtools.Medical.HL7 Getting Started -> .NET Framework tab -> Sample Programs.
The Windows Service can be started and stopped using the buttons at the top of the application. The port used may be adjusted as well.
The Windows Service tab allows installation or removal of the Windows Service.
Various listeners can be relayed various HL7 messages depending on the type of message the HL7 Relay receives.
First provide a list of listeners that will receive the relayed message.
There are two options on how to tell the HL7 Relay where to relay the messages:
Use the HL7 Destinations tab to add listeners where HL7 messages should be relayed to.
Use the HL7 Groups tab to associate an HL7 Destination with an HL7 Message type or types.
Below is an example where the HL7 Message type ADT_A01
is associated with the HL7 Modality Worklist destination. The HL7 Modality Worklist destination is defined in the HL7 Destinations list.
Use the HL7 Destination Lookup tab to define the HL7 field that will contain the name of the location to relay the message to. This option is used for a very specific user case and will not typically be available in most environments.
The demo has two destinations are already configured:
HL7 Modality Worklist - This is HL7 Modality Worklist AddIn. The L23_MWL_SCP64
worklist server is set within the Leadtools.Dicom.Server.Manager_Original.exe
demo as shown in the below screenshot.
HL7 Patient Update - This is the HL7 Patient Update Addin. The L23_PACS_SCP64
storage server is set within the StorageServerManagerDemo_Original.exe
demo as shown in the below screenshot.
With the HL7 Relay Service running, send the HL7 ADT_A01
message using the HL7 Messaging demo HL7Messaging_Original.exe
to the HL7 Relay Service. The service will receive the message, match it to the HL7 Group, and relay it to the listeners listed within the group.
The Log Options tab of the HL7 Relay Demo HL7RelayDemo_Original.exe
provides several logging channels to log the activity, either to the demo itself (Debug Viewer), a file, the Windows Event Viewer, and/or a Database.
The below capture is a walkthrough illustrating how the HL7 Relay is configured with the HL7 MWL Worklist Addin. Then the HL7 Messaging Demo is used to send a ADT_A01 message to the HL7 Relay Service. Finally, it is shown that the message was received and processed by the HL7 MWL Worklist Addin.
The same approach can be applied to use the demo with the HL7 Patient Update Addin.
Programming With Leadtools.Medical.HL7
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document