FilterByUserAndIP

Wed May 27 04:49:40 EDT 2009

This handler compares an IP address within an alert (from a parsed variable that you name) to a list of filters (address ranges). You can use this handler to create include/exclude logic for paging according to IP address domains.

An instance of this handler contains one or more filters. Each filter specifies a user and an IP address range. You can define more than one range for each user, if that is easier.

When a page is ready to be sent to a user, this handler looks at all the IP ranges you defined for that user. The handler then looks up the variable you named in the "variable" property, parses it as an IP address, and then tests it against the list of ranges. The variable must contain the dot-notation numberic IP address, e.g. "127.0.0.1"

If the IP address matches a range for the user, the handler returns true; otherwise false. However, if there was a problem parsing the IP address in the variable, the handler returns the value of the "valueIfVariableNotFound" property. Or if there are simply no ranges defined for the user, the hander returns the value of the "valueIfUserRangeNotDefined" property.

Ranges for each of four octets in the IP address can be a single number, multiple numbers with commas, or ranges using hyphens. The following example will ultimately match any number between 1 and 10:

1,2,3-6,7,8-10