The HL7 data agent is used to collect and monitor HL7 messages coming from WSO2 ESB. The following sections explain how to configure the HL7 data agent in the ESB and monitor HL7 messages in BAM:
| Table of Contents | ||||
|---|---|---|---|---|
|
...
HL7 data agent (message publisher) comes by default with the HL7 transport that you installed earlier. To enable the data agent in the ESB and configure it to connect to BAM, set the following parameters in within the <axisconfig name="AxisJava2.0"> element in the <ESB_HOME>/repository/conf/axis2/axis2.xml file:
| Configuration | XML Code |
|---|---|
| Enable HL7 data agent | <parameter name="transport.hl7.PublisherEnable">true</parameter> |
| Set the BAM server URL to which the data agent in the ESB connects to |
Provide the IP address of your BAM server. |
| Set the BAM server credentials |
|
| Set secure authentication. This is optional. |
Provide the IP address of the BAM server. |
| Enable message status validation (Success or failure) |
Enable this parameter with the ones above to get the message status. |
...
| Code Block |
|---|
hl7.tbox
|--streamDefn <folder>
|--hl7_data_publisher_def <file>
|--streams.properties <file>
|--dashboard
|--dashboard.properties <file>
|--jaggery <folder> |
The contents of the toolbox are described below:
...
Monitoring HL7 messages using BAM
Use either BAM message console or Cassandra explorer to monitor the HL7 messages as follows.
| Anchor | ||||
|---|---|---|---|---|
|
After deploying the toolbox, you can access the HL7 message console in BAM through which you can monitor HL7 messages coming from the ESB.
...
Enter the connection details to Cassandra cluster and click Login.
- Connection URL : Connection URL of the Cassandra cluster with IP and port. e.g., localhost:9160. This field is mandatory.
- Username/Password : Credentials of the cluster
The message search page opens.
The fields of the message search page are described below:
| Field | Description |
|---|---|
Message type | Stream name to perform the search on. For HL7 messages, select |
| Status | Message status (success/failure/all) |
Max Rows | Maximum number of search results to be displayed |
| Start time/End Time | Time interval to search messages |
...
- The Expand Message icon to view message content
- An activity ID (value is equal to to Message control ID) to view all events that belong to the activity
...
For instructions on how to monitor HL7 messages using the BAM message console, see Message Console.
| Anchor | ||||
|---|---|---|---|---|
|
Follow the below steps to monitor HL7 messages using Cassandra explorer.
- To see details of the HL7 messages in BAM, select Explore Cluster under Cassandra Explorer menu of the Tools menu in the management console.
- Connect to the Cassandra cluster.
- Connection Url* : Connection URL of the Cassandra cluster with IP and port. e.g., localhost:9160. This field is mandatory.
- Username/Password : Credentials of the cluster
- Maximum Result Count : Maximum number of results retrieved from the Cassandra cluster
- Browse keyspace
bam_hl7_data_publisher_store -> event_ks. For example,
...