A Message Filter is an object used to apply user-defined rules and conditions on inbound messages (AS2 generally) coming from external channels such as Cleo Harmony or other third-party software. While AS2 is not the only message type, it is the most common.
Based on how the conditions are met, specific Events are set to launch.
The Event then executes a Business Process. The payload parameter of the Event is assigned the payload of the incoming message.
Message content is variable; a message can contain data, a request for services (a command), an event notification, and possibly some combination of them all.
As one of several source interface objects used to bring information into Clarify, its ultimate purpose is to launch an Event and begin a process based on the newly-received information.
One Message Filter can launch one or many Events.
Probably the most common use of the Message Filter is as a “catch-all” for all incoming AS2 messages. You may have one Message Filter that’s instructed to launch the ReceiveEDI Event for every message. On the other hand, trading partner volume may require a more customized approach.
Let’s say you have several smaller trading partners whose incoming message traffic is small enough to manage with the “catch-all” message filter. But your biggest trading partner sends hundreds of messages daily, and you need to treat their processing in Clarify differently. In this case, you create a specific condition in your Message Filter that directs any messages coming from that specific trading partner to another Event dedicated to that trading partner’s messages. This is a common way to practice dedicated pipelining control.
At the system level, the Message Filter applies the above examples using rules and conditions this way: When the message header AS2–From "is" "SmallTradPartner", then launch the “normal” Event. Next, there could be an additional rule that speaks to the Large Trading Partner. When the message header AS2 –From "is" LargeTradPartner, then launch the “Large” Event.
- A “catch-all” mechanism that simply launches an Event for all incoming AS2 messages.
- Filtering high-volume or high-value customers so that their incoming messages are processed through different pipelines in your system environment.
How the Object Works
Message Filters apply user-defined rules and conditions against incoming AS2 message header properties and values; when conditions are met (or evaluated to be true), Clarify launches an Event. When you create your Message Filter, the following information must be defined:
Message Header properties
- Is, Is Not
- Starts with/Ends with
- Date is/Date Before/Date After
Events must exist in your Project prior to defining the Message Filter object. For more information, please see the topics on Events.
- Create the object.
- Select the incoming channel
- Build the rules and conditions.
- Add the associated Events.