From Message Filter |
 | ||
|
This documentation page describes a feature of version 3.3 of Iguana. In version 4.0 or later of Iguana, any channel can have a message filter associated with it. For information on how to configure a message filter in version 4.0 or later of Iguana, see Configuring the Filter. | ||
 |
In order to configure the From Message Filter source component described in the Channel Source Components section of the manual, you will need to specify the following properties:
| Property | Description |
|---|---|
| Incoming channel name* | Inbound channel of the message filter to be used as the source for the channel being currently configured. |
| Filter index (sub-channel ID#)* | Sub-channel to use from the incoming channel. This value must be an integer >= 1. |
| Poll time (milliseconds)* | Number of milliseconds between subsequent queries to the database for the next outgoing message in the message filter with the "waiting" status (value is "W"). If no messages are "waiting", Iguana waits for another "poll time" interval before querying the database again. |
| Filter VMD Path (required to transform and ignore) | Absolute path to the message definition file that you have created to ignore and/or transform (graphical transformation or scripted transformation) messages. |
| No transformation | Neither graphical transformation or scripted transformation is performed. Incoming messages are simply routed, though filtering can take place via the Ignored Messages selection. |
| Scripted transformation | Configuration (required to transform) name used for performing the scripted transformation. |
| Graphical transformation | Incoming Configuration Name (required to transform): The incoming configuration defined in the above VMD file used for performing the graphical transformation. Configuration name (required to transform): The outgoing configuration defined in the above VMD file used for performing the graphical transformation. |
| Ignored messages | Comma-separated list of message names that are to be filtered out and ignored. These message names must match the ones defined in the associated Filter VMD file. |
| Error handling | This setting controls how errors affect the behavior of the channel. If Skip Message is selected, then errors get logged, the current message is skipped and the channel continues to try to forward the next message to the destination component. If Stop Channel is selected, then errors get logged, the channel stops and the channel must be restarted from the Iguana dashboard to continue forwarding messages. |
| Automatically purge error logs older than | Specify when error logs are stale and can be deleted. If this value is 0, then error logs will never be automatically purged. |
 | ||
| The values entered for Configuration Names and Ignored Messages are case-sensitive and must match exactly. | ||
 |