VariableLookupFile

Wed May 27 04:16:50 EDT 2009

This handler replaces variable values. It references a replacement mapping file you specify in the "file" property. The file must be plain text, with the format value=replacment on separate lines. If the file's name is relative (not absolute), the file is offset from the application's home directory.

Augur first parses variables from received events, as defined in a rule tree. This handler runs next, to replace specified variable's value, if an associated replacement if found. Otherwise, the original variable remains unchanged. You specify the name of the variable to be affected in the "variable" property.

See Other

The ElementLookupFile and ElementLookupList plug-ins are similar, but they both replace an alert's element field.

Example

Some events contain identifiers that have little meaning to staff. For example, an event may contain a circuit number. This handler could be used to replace the circuit number with a customer name. The lookup file would contain the list of circuit numbers and their associated customer.