发布仪表盘页面¶
发布仪表盘页面后,终端用户才能通过 URL 或通过其他应用访问仪表盘页面。
前提条件¶
开始之前,请确保当前账号已被分配所需的资产权限、操作权限点和包含 DTV 中心 > 仪表盘页面 在内的菜单组。如未分配,联系应用管理员。
操作步骤¶
在应用门户的左侧导航栏中,选择 DTV 中心 > 仪表盘页面。
在页面编辑器的顶部工具栏中选择 保存 > 保存并发布。
在发布弹窗中配置以下信息:
可见范围:如需将此页面共享给当前环境其它 OU,选择 公开。否则,选择 内部。
数据来源:选择发布页面所使用的数据来源,包括 实际数据、模拟数据 和 缓存数据。
描述:输入页面发布的描述。
选择 确定。
备注
亦可在页面详情页中选择 页面版本 > 其他设置 > 发布 发布页面。有关页面详情页的更多信息,参见 管理页面详情。
获取页面 URL¶
页面 URL 可用于直接访问仪表盘页面或将仪表盘页面嵌入其它页面中。DTV 提供以下类型的页面 URL:
页面 URL:终端用户通过此 URL 访问页面时不可编辑组件大小、隐藏区等信息。
在线编辑 URL:终端用户通过此 URL 访问页面时可以编辑组件大小、隐藏区等信息。
可通过以下方式获取页面 URL:
通过 URL 指定页面属性 ¶
发布仪表盘页面后,可以使用 URL 参数指定以下页面属性:
展示模式
页面参数
时区
通过以下 URL 格式指定参数值:
以
?
结束 URL,使用=
分隔参数的键值及其值。例如,URLwww.website.com?key=2
将 key 参数的值设定为 2。使用
&
分隔多个参数。例如,URLwww.website.com?key=2&month=Aug&name=My+Dashboard
包含三个参数:key、month 和 name。
备注
在 URL 中不能使用空格,若参数值包含空格,需使用 + 字符代替。
响应模式¶
默认情况下,页面响应模式会根据用户的屏幕宽度进行自适应。
大屏:对于大于 1920 像素的屏幕宽度
网页:对于大于 768 像素但小于 1920 像素的屏幕宽度
移动端:对于小于 768 像素的屏幕宽度
但也可以通过修改 URL 参数 _responsive_mode_
的值来指定页面的展示模式。
大屏:
_responsive_mode_=lg
网页:
_responsive_mode_=web
移动端:
_responsive_mode_=mb
页面参数¶
如果页面包含页面参数,可以通过为 URL 添加 {parameter_key}={value}
为它们指定值。
如果指定的参数值为:
值列表:将显示以逗号分隔的值列表
空:不显示任何内容
时区 ¶
可以通过将 _tz_
页面参数附加到 URL 的方式,将时间数据从一个时区转换到另一个时区。时区转换一般用于动态展示时间值或者用于查询/过滤具有特定时区的时间数据。例如,如果指定 _tz_=+02:00
并且具有过滤器值 12:00
,将过滤掉如 15:59+08:00 等时间值。
这些行为如下所示:
未在 URL 中指定 _tz_=L 或
_tz_
页面参数(默认):无时区转换,将忽略时区。_tz_=B:如果时间数据具有时区,则将其统一转换为浏览器时区。如果时间没有时区,则将其视为 UTC 0 并进行相应转换。
_tz_=(timezone):如果时间具有时区,则将其统一转换为指定时区。如果时间没有时区,则将其视为 UTC 0 并进行相应转换。例如,
_tz_=+08:00
意味着将时间转换为其 UTC+8 格式的等效值。
时区参数的示例如下所示:
未在 URL 中指定 _tz_=L 或
_tz_
页面参数场景:仪表盘页面已配置为展示来自中国和英国太阳能站点的信息。一名位于中国的用户在时间过滤器中选择了 3 月 1 日。中国的当前时间是 3 月 1 日,英国的时间是 2 月 28 日。
结果:当天的发电量只显示中国站点的发电量。
_tz_=B 或 _tz_=(timezone)
场景:仪表盘页面配置为展示来自中国和英国太阳能站点的信息。中国的当前时间是 3 月 1 日,英国的时间是 2 月 28 日。
结果:当天的发电量显示中国和英国站点的发电量总和。
将仪表盘页面集成到应用中¶
每个发布的仪表盘页面都包含一个 URL 用于将其集成到应用中。可以将仪表盘页面 URL 指定为应用的菜单 URL,将仪表盘页面展示为应用中的菜单。有关在应用菜单中设置 URL 的更多信息,参见 管理应用快捷方式。