Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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
maxLevel3
minLevel3

...

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 within the <axisconfig name="AxisJava2.0"> element in the <ESB_HOME>/repository/conf/axis2/axis2.xml file:

...

After deploying the toolbox, you can access the HL7 message console in BAM through which you can monitor HL7 messages coming from the ESB.

  1.   Log in to the dashboard

    Log in to BAM management console

    and click BAM Dashboards menu.
    Image Removed

    using admin/admin credentials. Any user with admin privileges can log in.

     The

    Click Message Console

    Dashboard opens.
    Note that if

    in the Dashboards menu.
    Image Added

    Info

    If you have multiple dashboards installed, all available ones will be displayed at the top for you to select from. Select the Message Console dashboard.  

  2. EIn the Message Console Dashboard 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
  3. The message search page opens.

    The fields of the message search page are described below:

    FieldDescription

    Message type

    Stream name to perform the search on. For HL7 messages, select bam_hl7_data_publisher_store. This field is mandatory.

    Status

    Message status (success/failure/all)

    Max Rows

    Maximum number of search results to be displayed
    Start time/End TimeTime interval to search messages


  4. Click Add new condition section to enter more search conditions. An example is given below:
  5.   Click the Search Messages icon. Matching results appear on the Search Results page.  For example,

    You can click,

    • 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   
  6.  To see details of the HL7 messages in BAM, select Explore Cluster under Cassandra Explorer menu of the Tools menu in the management console.

  7. 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
  8. Browse keyspace bam_hl7_data_publisher_store -> event_ks. For example,

...