Making a Class Representation Visible on a Mobile Device

Introduction

This document describes how to add a newly-created representation to the Sage X3 client portal, and display it on a mobile device. This is achieved by defining and amending three components of the portal:

  • Dashboards, which are displayed in a browser tab when a user connects to the Web server.
  • Vignettes, which are autonomous components displayed in a dashboard.
  • Menu items, which define a link to a page managed by the software within a portal vignette.

The representation is defined in a menu item, which is contained in a vignette, which, in turn, appears on a dashboard (variant).

Prerequisites

Your representation class must be set for mobile phones. Set the Screen type field to "Mobile phone" in the Type block of the General tab.

Vignettes

Click Vignettes in the Personalization portal component displayed on the Home dashboard to create and maintain vignettes. A query facet screen with the list of existing vignettes is displayed.

To create a new vignette:

  1. Click Create on the right-hand panel.
  2. In the Information block:
    1. Enter the title of the vignette in the Title field. This field is mandatory.
    2. Set the Type field to "Menu".
  3. In the Filter block:
    1. In the Application field, enter the name of the application you want to associate the vignette to, or select it from the list of applications available. If the vignette must be displayed on all dashboards, leave this field blank.
    2. In the Endpoint field, enter the name of the endpoint you want to associate your representation to, or select it from the list of endpoints available.
      Leave it blank, if necessary.
  4. In the Content block, add the menu items to be added to the existing vignette.
    If you have not created your menu item yet, you can add menu items to Vignettes directly within the Menu items application.

Click Menu Items in the Personalization portal component displayed on the Home dashboard to create and maintain menu items. A query facet screen with the list of existing menu items is displayed.

To create a new menu item:

  1. Click Create on the right-hand panel.
  2. In the Information block:
    1. Enter a table code defined for a master table in the Code field.
    2. Enter the name to be displayed in the Title field. This field is mandatory.
    3. Set the Link type field to "Representation".
  3. In the Content block:
    1. In the Application field, enter the name of the application you want to associate the menu item to, or select it from the list of applications available. This field is mandatory for representation link types.
    2. In the Endpoint field, enter the same endpoint name you entered for the vignette, or select it from the list of endpoints available.
    3. Set the Representation field to the Sage X3 representation defined for the Sage X3 class required for the menu item, for example your mobile phone representation. This field is mandatory for representation link types.
    4. Set the Entity field to the Sage X3 class required for the menu item. This field is mandatory for representation link types.

  4. In the Display block, enter the required vignette codes, or select them from the list of vignettes displayed. You can also, create a vignette and add the menu items via the Content fields of the Vignettes application.

Dashboards

Click Dashboards in the Personalization portal component displayed on the Home dashboard to create and maintain dashboards. A query facet screen with the list of existing dashboards is displayed.

Each Home dashboard can have multiple variants associated with users, endpoints, roles, and an individual connection settings. You can create a new variant of the Home dashboard, and add your vignette and menu items to that variant.

To create a dashboard variant:

  1. Click Create dashboardDef on the right-hand panel.
  2. In the Information block:
    1. Enter the name to be displayed in the Title field. This field is mandatory.
    2. Enter a user-friendly description for the title in the Description field.
    3. Enter an identifiable name or code for your dashboard in the Dashboard name field. This field is mandatory.
    4. Select the Mobile dashboard check box.

  3. In the Variants block.
    1. Click Add.
    2. Enter an identifiable code for your dashboard variant in the Code field.
    3. Enter the default title for your dashboard variant in the Title field.
    4. Enter a user-friendly description for the title in the Description field.
    5. Select Applies to all applications if the new dashboard variant must be available on all applications (or endpoints).
    6. In the Application field, enter the specific application (or endpoint) the variant should be available for, or select it from the list of applications available.

    You can now add your vignette to this variant.

  4. Save your dashboard variant.

    Your vignettes and menu items are now available from the dashboard variant screen.

Making vignettes and menu items available from a mobile device

To make your vignettes and menu items available from a mobile device:

  1. Click Mobile Desktop Authoring (or personalization) from the User Preference Panel, in the Dashboard block link panel.
    Note: You can display the User Preference Panel by clicking the User Preference Panel icon in the top bar.
    A mobile phone emulator screen is displayed.
  2. Click either:
    • Application Manager, if displayed on the emulator window.
    • The menu icon located on the top left corner of the emulator window, and then click Setup.
  3. Locate your vignette.
  4. Click Add to download and install your vignette for a mobile device.

Completed result

On the client

You can select the new Dashboard variant from the Views drop-down list.

Note: You may need to log out and then log back in to your portal for the new dashboard variant to be available. After logging in, return to your regular home portal.

On a mobile device

The vignette is displayed on the emulator window as an application. Click your vignette to start the application.

The menu items for your class representations are displayed in a list.