Connectors
The Connectors screen supports viewing and editing HL7 connectors.
Connectors may be:
- Senders - used to send HL7 messages from OpenVPMS to an external system
- Receivers - used to receive HL7 messages from an external system
The buttons are as follows:
| New | create a new Connector |
| Edit | edit the selected Connector |
| Delete | delete the selected Connector - a confirmation window will appear |
| Messages | displays HL7 messages sent or received via the selected Connector |
| Stop | stops messaging for a Sender. Messages will be queued until the Sender is started. |
| Start | starts messaging for a Sender |
Creating a new HL7 Connector
The New button is used to create a new HL7 Connector:
The available Connectors are:
| HL7 MLLP Receiver | used to receive HL7 messages from an external application |
|---|---|
| HL7 MLLP Sender | used to send HL7 messages to an external application |
HL7 MLLP Receiver
This is the create/edit/view screen for HL7 MLLP Receivers. These are responsible for receiving HL7 messages using the MLLP protocol over TCP/IP, from external applications.
The fields are as follows:
| Id | the receiver identifier |
| Name | the receiver name |
| Active | uncheck this box to deactivate the receiver. Deactivating the receiver prevents HL7 messages being received. |
| Port | The TCP/IP port to listen on |
| Sending Application | Uniquely identifies the sending application among all other applications within the network. |
| Sending Facility | Identifies the sending application facility. |
| Receiving Application | Uniquely identifies the receiving application among all other applications within the network. |
| Receiving Facility | Identifies the receiving application facility. |
| Mapping | The HL7 Mapping to use when creating messages. |
HL7 MLLP Sender
This is the create/edit/view screen for HL7 MLLP Senders. These are responsible for sending HL7 messages using the MLLP protocol over TCP/IP, to external applications.
The fields are as follows:
| Id | the sender identifier |
| Name | the sender name |
| Active | uncheck this box to deactivate the sender. Deactivating the sender prevents HL7 messages being sent. |
| Host | The host to connect to |
| Port | The port to connect to |
| Sending Application | Uniquely identifies the sending application among all other applications within the network. |
| Sending Facility | Identifies the sending application facility. |
| Receiving Application | Uniquely identifies the receiving application among all other applications within the network. |
| Receiving Facility | Identifies the receiving application facility. |
| Response Timeout | The maximum time to wait for responses, in seconds. |
| Retry Interval | The time to wait after an error occurs, before resubmitting a message. |
| Mapping | The HL7 Mapping to use when creating messages. |
Messages
The Messages window displays HL7 messages sent or received via a HL7 Connector.
The buttons are as follows:
| Find | Find all messages matching the criteria. Also press this to refresh the display. |
| OK | Closes the window |
| Resubmit |
Resubmits a message to an external application. Only applies to:
|
| Dequeue |
This is used to prevent a message from being sent. Once dequeued, the message cannot be re-queued. Only applies to Sender connectors. |