OpenTV ENTera & OpenTV Platform Documentation
OpenTV ENTera & OpenTV Platform Documentation
Breadcrumbs

Create the page hierarchy

Overview

The page (template) hierarchy that you set up in Rails Builder determines the pages that are available in your client application.

Setting up the page hierarchy is usually the responsibility of the operator.

You can use a single hierarchy for all the device types that you support – Rails Builder enables you to target a page (template) to a defined group of devices.

This allows you, for example, to add a page that will only be displayed on one type of device.

1. Add a top-level page

To add a top-level page:

  1. From the Operator Console (OpCon) home page, click Rails Builder.

  2. In Templates on the left side of the screen, click + New Template.

  3. In Name, type the name of the page. For example, Main_Menu.
    Notes:

    • This is displayed as the title of the page if you do not specify anything in Title.

    • By default, ION expects the top-level page to be called Main_Menu, but NAGRAVISION can configure it to use a different value. See ION-specific FAQs.

  4. In Title, select each locale in turn in the locale drop-down and type the title for that locale.

  5. If yours is a shared system deployment (where there can be multiple tenants), select the correct tenant in Tenant ID.

  6. Optionally, to hide the template, enable the Hidden toggle.

  7. Under Layout Properties:

    1. In Name, type the name of the layout. This is usually the same as the name of the page.

    2. In Title, select each locale in turn in the locale drop-down and type the title for that locale.

    3. If you are using ION as your client application, you can add various parameters to control ION’s look and feel. Referring to Top-level page properties in ION-specific configuration properties, add the required key/value pairs under Additional Properties.

  8. Click Create Template.

The new template will be displayed in the Templates pane and the layout will be displayed in the right pane. They will both have a yellow icon to indicate that there are no active layouts.

2. Add child pages

To add child pages, in Rails Builder:

  1. In Templates on the left side of the screen, find the top-level page that you just added.

  2. Click menu_black.png and then select Add Child Template.

  3. Follow steps 3 to 7 in the procedure above to fill in the template and layout details.

  4. If you want to target the page to a specific group of devices, click + Select Segment Target under Segment Targeting.
    This is explained in detail in 3. Target a template to a device group, below.

  5. Click Create Template.

  6. Repeat the above steps for each additional child page you want to add.

  7. If you are using ION as your client application:

    1. For each layout (in the right pane), click menu_black.png and then select Edit Layout Properties.

    2. Under Additional Properties, add the following key/value pairs:

      1. screenId – core ION screens use IDs in the range 1 to 31. For additional screens, use IDs greater than 1000. These IDs must be unique.

      2. routeName – for ION Desktop (web), you must provide a unique route name (string value). ION’s core screens use specific values. For additional screens, any string value is allowed as long as it is unique.

      There are many other properties that you can set here to control ION’s behaviour – see Individual page properties in ION-specific configuration properties.

  8. Click Save.

  9. Click Save Layout.

  10. Click < Back to layout.

  11. Click <-Templates and Layouts.

3. Target a template to a device group

You may need certain pages to be available only on specific types of device. For example, for a managed device where you control what is installed on it, you could have an “Apps” page that lets your users access these pre-installed applications easily. But you would not want the page to be available on open devices where you cannot control what is installed.

To target an existing template to a specific device group:

3.1 Create a device profile to represent the devices

This is described in more detail in Creating and managing device profiles.

  1. From the OpCon home page, click System Configuration.

  2. In the left pane, click Device Management.

  3. If yours is a shared deployment, select the appropriate tenant from the drop-down list. (In a non-shared deployment, there is no tenant drop-down.)

  4. In the right pane, select the Device Profiles tab if it is not already selected.

  5. If no profile exists for the device type you want to add, click ADD PROFILE.

  6. In Profile Name, type a name for the profile (for example, Launcher or WebOS).

  7. Optionally, in Device Type, type a name for the type of device (for example, Small screen devices).

  8. To enable the profile, click the Status switch.

  9. Leave In Home Restricted disabled.

  10. Under Features, do not add any fields.

  11. Click CREATE.

  12. Click CONTINUE.

3.2 Create a device classifier to assign devices to the device profile

This is described in more detail in Creating and managing device classifiers.

  1. From the OpCon home page, click System Configuration.

  2. In the left pane, click Device Management.

  3. If yours is a shared deployment, select the appropriate tenant from the drop-down list. (In a non-shared deployment, there is no tenant drop-down.)

  4. In the right pane, select the Device Classifiers tab.

  5. Click ADD CLASSIFIER.

  6. In Name, type a name for the device classifier.

  7. To enable the classifier, click the Status switch.

  8. Leave Device Limit unset.

  9. In Device Profile, select the profile that you created above.

  10. Click ADD RULES.

  11. In Operator, select the operator to be used (for example, EQUALS).

  12. In Key, select the field to be used to identify the device type (for example OS_TYPE).

  13. In Value, type the value (for example, WebOS).

  14. Optionally, in Rules Id, type an ID for the rule.

  15. If you need to add more rules to correctly classify devices, repeat steps 10 to 14.

  16. Click CREATE.

  17. Click CONTINUE.

3.3 Create a segment to target the device profile

To create a segment:

  1. From the OpCon homepage, click Rails Builder.

  2. In the drop-down at the top left, click Segment Targeting:

    image-20260617-105831.png

  3. Select the Segment Targets tab.

  4. Click Create Segment Target.

  5. In Name, type a name for the segment.

  6. In the segment selector, click and then select OPF:

    image-20260617-165411.png

  7. In the new selector that appears, select DeviceProfile:

    image-20260617-165549.png

  8. In the new selector that appears, select the device profile that you created above.

  9. Click Target runs permanently (no end date) to enable it.

  10. In Start Date, select today’s date.

  11. Click Save Targeting Experiment.

  12. Click Continue.

3.4 Enable segment targeting for the template

  1. From the OpCon homepage, click Rails Builder.

  2. Find the template that you want to only be available on certain device types.

  3. Click menu_black.png and then select Action Segment Target.

  4. Check the checkbox for each segment that the template should target. (You can select multiple segments.)

  5. Click Apply.

A target icon indicates that the template is now targeted to one or more segments:

image-20260617-170849.png

4. Activate the page’s layout

When you are ready to enable the page, activate its layout:

  1. From the OpCon homepage, click Rails Builder.

  2. Click on the template that you want to enable.

  3. In the right pane, click menu_black.png on the layout and select Set as Default:

    image-20260617-172049.png

  4. The icons for both the layout and the template will turn green to indicate that they are active:

    image-20260617-171742.png