Action properties

When you select an action, its properties are displayed at the bottom of the panel, where you can edit them. Mandatory property values are displayed by default, marked by asterisks and with a yellow background. If you try to add an action without specifying one or more mandatory values, the action turns red and the rule cannot be saved.

You can add further properties by selecting them from the drop-down list. When you add new properties, they become mandatory, therefore you cannot leave them blank, but you can delete them by clicking the close icon.

You can also add the same property multiple times assigning different values to it. In this case all these properties are logically correlated by the conjunction and, creating a cumulative filter.

For examples, when you define your event filter, if you want to exclude some files from it, you can define as event properties all the filenames that match/tmp/tool/oldfiles, and all the filenames that do not match /tmp/tools/ newfiles. Additionally, you can also remove the non-required properties, by clicking the close icon X icon next to them. You cannot remove mandatory properties.

Using variable information into action properties

To better qualify your action, you can use some event properties as variable information that can be added to the action properties.

For example, you can include the job name in the mail body, if you have mail notification as a response action to a job-related event. You can include this variable information together with normal text in action properties that require a string value. For those properties that require a numeric value, you can enter either the variable information or a number.

The event properties that can be used as variable information for the actions can be selected from the list that is displayed if you click the button Variable. Select Machine-readable format check box when you want to use the variable as input to a command or a script. Alternatively, you can recall this information within the action property by copying the event alias (displayed in the first row of the event box) and pasting it into the action property field, complying with the following syntax:

%{event_alias.property_name}: Use it to include normal text information. This can be useful if you want to see this text in a message or an email.
${event_alias.property_name}: Use it to include machine-readable information. This can be useful if you want to use the action as input to a command or a script.