Harmony Monitors

The Harmony Monitor is an object that listens (on a specified port) for incoming messages from Cleo Harmony and then uses Message Filters and Events to execute other integration processes in Clarify.

Business Use

As part of the Cleo Integration Suite (CIS), this monitor checks for and reacts to incoming data by starting other tasks and processes as part of your integration solution.

This object is part of the integration between Clarify and Harmony, and the primary means of capturing and processing messages from Harmony.

How the Object works

This monitor works by using an open port to process messages to and from Harmony. When messages are received, Clarify will search through any deployed Message Filters for a matching condition or rule, and then launch related Events.
Note: One common use of the monitor with Message Filters is to filter on the Harmony Connection Alias, which is the Harmony Host Alias or the actual Connection in and out of Harmony itself (and not the Clarify Connector Host Alias).
Note: Another option is to assign an Event directly from the monitor editor (although this approach only fires one Event per monitor).

The monitor's open port also serves as the means for Harmony to send and receive messages between Clarify. In fact, this monitor is necessary to receive instructions that kick off outbound processes in Clarify (to Harmony). An enabled Harmony Monitor is required for both inbound and outbound communication between Harmony and Clarify.

Process Summary

To use this object, you must:

  • Create the monitor.
  • Define the monitor by assigning the port that will be listened to, and then either:
    • using any deployed Message Filters (and leaving the Event blank) -recommended.
    • selecting an Event to fire when the monitor receives a message; if you plan to use multiple Events, then multiple monitors are required.
  • Deploy and enable the monitor (or set it to run as a service).