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¶
Select Dashboards > Dashboard from the left navigation pane of Application Portal.
Select the edit icon of the target page to enter the page editor.
Select Save > Save and Publish from the top tool bar.
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.
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:
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 URLwww.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 URLwww.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 URLScenario: 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.