Current Rule Overview

Rules are used to change data and move/copy it from one place to another. For example you can use rules to update the database or export panelist credits.

The Current Rule page shows the details of the rule selected in the Rule List (go to Rule List for more information). When you select a rule in the Rule List, the Current Rule page opens at the General tab – see the next part here.

Note: Until you have selected a rule from the Rule List during the current session, the Current Rule menu command will take you to the Rule List.

The following buttons are common for all the tabs in the page:

• Back – takes you back to Rule list
• Save – saves any changes made.
• Duplicate – makes a duplicate copy of the rule. Use this if you need to make a rule that will be similar to an existing rule. You can then edit the copy.
• Execute – once you have set up the rule and are sure it is correct, click this button to run the rule.
• Validate Action Script – checks the script created in the Action tab to ensure there are no errors.
• Export Rule – exports the rule so it can be imported into a different Panel server.

Duplicating a Rule

To save time while creating a new rule, if you have an existing rule that is similar to the one you require then you can duplicate it.

1. In the Current Panel Rule page, click Duplicate.

The Duplicate Panel Rule dialog opens - .



Figure 1 - The Duplicate Panel Rule dialog

2. Type in a name for the new rule, then click Finish.

The rule is duplicated, and will appear in the Panel Rules list. The Panel Rule Details page opens showing the new duplicate rule. You can now edit the new rule as required.

Note: To prevent two rules sharing the same BitStream set, when a rule is duplicated, the BitStream set is also duplicated and the new BitStream set is given a new name. The new name is "<original file name> - Copy".

Executing a Rule

Run the rule to perform the actions that are specified.

1. In the Current Rule page, click Execute.

The rule is checked to ensure the required information is present. If it is acceptable, the Rule Execution Properties dialog opens - .



Figure 2 - The Rule Execution Properties dialog

2. Type any comments into the Comment field.
3. In the Start Time field, select when you want the task to be run.
4. Select ASAP to run the job as soon as it gets to the front of the task queue in the server. Select Schedule for Later Execution if you want the job to be run at a specific time in the future or if you want the job to be repeated at regular intervals.
5. Click OK.

If you have specified that the task is to run as soon as possible (ASAP) then a Task page opens showing a progress bar, the Task ID and the sequences being run and completed.

If you have specified that the task is to be scheduled for later execution, then a Recurrence Pattern dialog opens.

On completion, the text Task Completed is displayed at the bottom of the sequence list.

6. Click OK to close the Task page and return to the Panel Rule Details page.

Exporting a Rule

You can export rules to other servers and/or panels. Proceed as follows:

1. Save the rule to ensure all changes/updates are included.
2. Click Export Rule.

The Export Rule dialog opens - .



Figure 3 - The Rule Export dialog

3. Edit the email address to which the rule is to be sent, and add a comment, as necessary.
4. Click OK.

An email is sent to the specified address with the rule attached. This rule must now be imported into the destination server (go to Importing a Rule for more information).

Validating an Action Script

Click to check the script for compilation errors. If errors are found, they will be listed in a separate window. You must then correct the errors and validate again.