1.2.2.6 Result Purge Rules

Rules to automatically purge results under certain conditions can be set in Server Console using the Result Purge Rules dialog.

To open the dialog, select Tools > Purge Rules in the Server Console menu bar.

Note:

Rules are applied in the order shown in this dialog, from the top down. See Setting the Rule Order for further information.

Adding a Rule

To add a rule:

1. Click the Add Rule button on the Result Purge Rules dialog. The New Rule dialog is displayed.

2. The Enabled checkbox is checked by default. To create a new rule without enabling it immediately, uncheck it.

3. Complete the fields as follows:

   1. Name - Enter a name for the rule. This field is mandatory.

   2. Purge results after - Specify the number of hours, days, weeks or months after which the results should be purged. Enter the number in the free-text field, and select the unit of time from the drop-down list. Alternatively, select "never" to ensure that results matching the rule criteria will not be purged. This field is mandatory.

   3. Project - If required, select a specific project for the rule.

   4. Job - If required, select a specific job for the rule.

   5. Run Label - Either specify an exact Run Label (by entering it, or selecting it from the drop-down list), or enter a regular expression in the Regex field to capture Run Labels containing specific terms. For example, the Regex .*test.* would capture all Run Labels containing the word "test".

4. Click OK to save the new rule, or Cancel to abandon.

Editing a Rule

To edit a rule:

1. Either double click the rule, or select it and click the Edit Rule button. A dialog with all the details of the rule is displayed.

2. Edit the fields as required.

3. Click OK to save the changes, or Cancel to abandon.

Enabling or Disabling a Rule

To enable or disable a rule, uncheck the Enabled check box next to it. This checkbox can also be edited when the rule is opened for editing.

Deleting a Rule

To delete a rule, select it in the Result Purge Rule dialog and click the Delete Rule button.

If a rule is deleted in error, click Cancel to close the dialog, not OK. On reopening, the accidentally deleted rule will be present again.

Setting the Rule Order

There are four buttons on the bottom right of the Result Purge Rule dialog for changing the order of the rules.

To move a rule, select it then:

• click the Move rule to top button to move it to the top of the list;

• click the Move rule up button to move it one place up the list;

• click the Move rule down button to move to one place down the list; or

• click the Move rule to the bottom button to move it to the bottom of the list.