• Documentation
  • Publishing Dashboard Pages

Publishing Dashboard Pages


After a dashboard page is published, application users can access the dashboard page by URL or other applications.

Prerequisites


You need to be assigned the required asset permission and operation permission, and a menu group containing the Dashboards > Dashboards menu. If not assigned, contact the application administrator.

Procedure


  1. Select Dashboards > Dashboard from the left navigation pane of Application Portal.
  2. Select the edit icon i_edit of the target page to enter the page editor.
  3. Select Save > Save and Publish from the top tool bar.
  4. Configure the following information in the pop-up window:
    • Visibility: Select Public if you want to share the page in the current environment. Otherwise, select Internal.
    • Data Type: Select the data source of the page to publish, including Normal Data, Mock Data, and Cache Data.
    • Description: Enter the description for publishing the page.
  5. Select OK.

Note

You can also select Version > More > Publish to publish in the Page Details page. For more information about Page Details, see Managing Page Details.

Copying the page URL


You can use page URL to access the dashboard page or integrate the page into other pages. DTV provides the following types of page URLs:

  • Page URL: Application users cannot edit page information such as widget size and hidden box in this URL.
  • Editable URL: Application users can edit page information such as widget size and hidden box in this URL.


You can get page URLs by the following ways:

  • After finishing publishing, you can copy the URL of the publish page in the pop-up window.
  • In the Project Editor, move the cursor over i_op icon on the page card and select Copy URL.
  • In the Page Details page, select Version > More > Copy URL.

Specifying Page Properties through URL


After you have published your dashboard, you can specify the following page properties using URL parameters.

  • Display mode
  • Page parameter
  • Time zone


Specify the parameter values in the following URL format.

  • End the URL with ? and then separate the name of the parameter and its value with =. For example, the URL www.website.com?key=2 contains the parameter key with the value 2.
  • If you need to use multiple parameters, use & to separate them. For example, the URL www.website.com?key=2&month=Aug&name=My+Dashboard contains three keys - key, month, and name.


Note

You cannot use spaces in the URL. If the parameter value contains spaces, use the + character instead.

Display Mode


By default, an appropriate display mode is applied to a page based on users’ screen widths.

  • Big Panel: For screen widths larger than 1920 pixels
  • Web: For screen widths larger than 768 pixels, but smaller than 1920 pixels
  • Mobile: For screen widths smaller than 768 pixels


However, you can specify the display mode of the page by specifying a value for the URL parameter _responsive_mode_.

  • Big Panel: _responsive_mode_=lg
  • Web: _responsive_mode_=web
  • Mobile: _responsive_mode_=mb

Page Parameter


If your page contains page parameters, you can specify a value for them by appending the URL with {parameter key}={value}.


If you specify a parameter value that is:

  • A list of values: a list of values separated by commas are displayed
  • Empty: nothing appears

Time Zone


You can convert time data from one time zone to another by appending the _tz_ page parameter to the URL. Time zone conversion is generally used to display time value dynamically, or to query/filter time data with a specific time zone. For example, if you specify _tz_=+02:00 and have a filter value of “12:00”, then time values like “15:59+08:00” are filtered out.


The behaviors are as follows:

  • _tz_=L or the _tz_ page parameter is not specified in the URL (default): No time zone conversion. The time zone in the time data is ignored.
  • _tz_=B: If the time data has a time zone, then it is converted to the browser time zone. If the time doesn’t have a time zone, then it is considered as UTC 0 and converted accordingly.
  • _tz_=(timezone): If the time has a time zone, then it is converted to the specified time zone. If the time doesn’t have a time zone, then it is considered as UTC 0 and converted accordingly. For example _tz_=+08:00 means converting time to its equivalent in UTC+8.


The example of the Time Zone parameter is shown as below:


  • _tz_=L or the _tz_ page parameter is not specified in the URL
    • Scenario: A dashboard has been configured to display information from solar sites in both China and England. A user located in China selected 01 March on a time filter. The current time is 01 March in China and 28 Feb in England.
    • Result: The generated power for the day shows only the generated power for the China sites.
  • _tz_=B or _tz_=(timezone)
    • Scenario: A dashboard has been configured to display information from solar sites in both China and England. The current time is 01 March in China and 28 Feb in England.
    • Result: The generated power for the day shows the sum of generated power for the China and England sites.


Integrating Dashboards into Applications


Each published dashboard contains a URL so you can easily integrate it into your applications. You can specify the dashboard URL as the menu URL for the application to display the dashboard as a menu in the application. For more information about setting the URL in an application menu, see Manage Application Shortcuts.