Rules UI and using Rules Overview

Create, delete or change the definitions of rules:

1. From the main menu, ensure that the channel you want to work with is selected.

2. Select Rules from the menu actions to bring up the user interface for working with rules:
   

   

3. In the screenshot above, there are now two window panes on the right-hand side:
   In the left pane, you can create, delete, activate/deactivate, select and import/export rules.
   In the right pane, you can work with a selected rule: name the rule and give it the appropriate conditions and actions.

Working with Rules

Select by clicking the rule you want to work with, or select the appropriate icon to create, delete, activate/deactivate or import/export rules.

Rules can be grouped into a hierarchy with children and siblings. Hover the cursor over the create rule icon to see the options: CTRL + click to create a child rule and CTRL + SHIFT + click to create a sibling rule:

Existing rules can be activated/deactivated as required. In the example below for example the rule Another_page is deactivated while Morning_Show are activated.

The Import/Export of rules is from/to XML-files. Since existing rules will be overwritten when importing rules, make sure you want to overwrite, or create a copy safely stored to disk as backup, before importing.

Defining Rules for Conditions and Actions

Once you have selected a rule, you can use the rules panel to create conditions and actions for the rule:

Referring to the screen-shot above:

1. Name the rule (if newly created).

2. Create or delete conditions. You can have as many conditions as needed. Conditions are expressions that specify if the rule should be applied. Using the various condition operators you can answer questions such as: if the next film is for the ages over 12, display a legal-age page as graphics 10 seconds into the film.

3. Define the conditions of the rule. A rule is only applied if all the criteria in the conditions are met. Click the column Attribute, Operator or Value to select possible values from a dropdown-list or to change the actual Value. Condition types are explained in more detail in the next section, Rules criteria and conditions.

4. If all conditions for the rule are met, the rule will be acted upon and you can specify what should happen: do Nothing, insert a specific Page, a predefined Action or a Pilot Data Element. Clicking on the Page, Action or Pilot Data Element button will enable a dropdown list where you can select the appropriate element as shown in the screenshots below:
   
   Take Page
   

   

   
   
   Take Action
   

   

   
   
   Take PDE (Pilot Data Element)
   

   

   
   
   

Modifiers / checkbox selectors in the Rules UI panel:

• Select the Reference checkbox to allow page/action to be added as a referenced page/action.

• Select the Add Continue checkbox to add Continue action after the event added by rules. This option lets you set the offset time for the continue action.

• Relative to: the starting reference point for time calculations, example: Start or End.

• Offset: The offset from the selected reference point.

• Positive: if selected, the offset is positive from the reference point.

• Duration: Duration for the action. If no duration is set, the call-back will be the origin page.

Rules Criteria and Conditions

Any number of conditions can be applied to a rule so that the rule is applied only when specific criteria are met. If there are no conditions, rules are applied on every primary event when a playlist is imported.

Conditions are made up of an attribute representing a column in the playlist table, an operator (greater than, less than, equal to, etc.) and a value (time, number, text). Only when the condition as defined is met will the rule be applied on a particular event. Likewise, when there are multiple conditions, only when all of them are met will the rule be applied to an event.

For any event dealing with time (for example 19:00:00), Viz Multichannel can look up elements that start after a given time (>) or at a given time and later (>=). In addition, Viz Multichannel can perform partial matches on strings which lets you find primary elements that are“right before”, “first one before this” or “current one at this time”.

Rules are executed in the order they are listed. However, the order of the rules has no impact on the final result as there is no adjustment for any pages already added. This means that when you are setting up rules you should make sure that the end-result you are seeking is not dependent on the order in which the rules are run.

While defining rules, it is possible that many of them share some common conditions. By having a parent rule defined with such conditions, we can define the remaining in child rules. The child rules will therefore only run if all the conditions in parent rule are met.

Partial Match

In order to find partial matches such as “NEWS*” to match against “NEWSROOM” you must use the partial match operator (~=). This allows for string based comparisons of partial hits (“contains”) and time-based comparisons (“currently playing”).

The partial match operator can also be negated with !~= which can be read as “does NOT partial match”.

The logic for time-based look-up using the partial match operator is a proper check of the “time” (for example at 19:00:00) and start-time of a primary element (for example at 18:45:00), its duration (for example 00:30:00) and detecting that the primary element is currently on air.

Condition Types

Back up and Restore Rules

All rules and their associated conditions can be saved as XML files for later use.