发布仪表盘页面


发布仪表盘页面后,终端用户才能通过 URL 或通过其他应用访问仪表盘页面。

前提条件


开始之前,请确保当前账号已被分配所需的资产权限、操作权限点和包含 DTV 中心 > 仪表盘页面 在内的菜单组。如未分配,联系应用管理员。

操作步骤


  1. 在应用门户的左侧导航栏中,选择 DTV 中心 > 仪表盘页面

  2. 选择目标页面的 i_edit 图标进入页面编辑器。

  3. 在页面编辑器的顶部工具栏中选择 保存 > 保存并发布

  4. 在发布弹窗中配置以下信息:

    • 可见范围:如需将此页面共享给当前环境其它 OU,选择 公开。否则,选择 内部

    • 数据来源:选择发布页面所使用的数据来源,包括 实际数据模拟数据缓存数据

    • 描述:输入页面发布的描述。

  5. 选择 确定

备注

亦可在页面详情页中选择 页面版本 > 其他设置 > 发布 发布页面。有关页面详情页的更多信息,参见 管理页面详情

获取页面 URL


页面 URL 可用于直接访问仪表盘页面或将仪表盘页面嵌入其它页面中。DTV 提供以下类型的页面 URL:

  • 页面 URL:终端用户通过此 URL 访问页面时不可编辑组件大小、隐藏区等信息。

  • 在线编辑 URL:终端用户通过此 URL 访问页面时可以编辑组件大小、隐藏区等信息。


可通过以下方式获取页面 URL:

  • 完成发布后,系统会跳出显示发布成功弹窗,在弹窗中可复制发布页面的 URL。

  • 项目编辑器 中,将光标移动至页面卡片的 i_op 图标上,选择 复制 URL

  • 页面详情 中,选择 页面版本 > 其他设置 > 复制 URL

通过 URL 指定页面属性


发布仪表盘页面后,可以使用 URL 参数指定以下页面属性:

  • 展示模式

  • 页面参数

  • 时区


通过以下 URL 格式指定参数值:

  • ? 结束 URL,使用 = 分隔参数的键值及其值。例如,URL www.website.com?key=2key 参数的值设定为 2

  • 使用 & 分隔多个参数。例如,URL www.website.com?key=2&month=Aug&name=My+Dashboard 包含三个参数:keymonthname


备注

在 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 的更多信息,参见 管理应用快捷方式