[{"id":"840f0737-df1d-47ae-bb0a-359b01fe0608","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"d5d9cdef-8854-4505-89be-a2bbc3cb4482","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"3dc3dd55-35b0-4d23-bf62-47bc3650e4ee","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"80d84fbc-d0f8-4e4a-947f-e3e4de9b49b2","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]},{"id":"9152b7ca-0186-4fe3-a26f-5a05f322db07","tags":[{"product":null,"links":null,"id":"adf72f47-7f61-4239-8392-b9bcc127fa80","name":"\u65B0\u589E","color":"green","productId":"0995490e-43fc-4d6e-bc8d-8e66f38b0c63"}]}]
        
(Showing Draft Content)

集成仪表板设计器

用户可以将 Wyn 仪表板设计器嵌入到 Web 应用程序的 IFrame 容器中,来快速实现创建新的仪表板或者编辑已有的仪表板。

新建仪表板

集成一个全新的空设计器。

1. 准备仪表板URL

例如:http://localhost:51980/dashboards/create

2. 添加用户令牌

在获取到 URL 后,需要添加用户令牌来进行身份认证和权限认证,其格式为一系列包含字母和数字的字符串,例如:

A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B6

有关如何生成和获取令牌请参考生成令牌一节。在获取到令牌后,将其添加到目标 URL 的末尾,并使用“?token=” 进行连接,得到的URL字串如下:

http://localhost:51980/dashboards/create?token=A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B6

type=info

提示

  1. 生成令牌时使用的用户,应具有创建仪表板的权限。

  2. 这里使用“?token=” 而没有使用“&token=”是因为URL中没有其他已有参数。仅添加第一个参数时使用问号“?” 进行连接,后续再添加其他参数直接使用“&”符号连接即可。

3. (可选)指定数据集或模型

在集成仪表板设计器时,有时需要指定一个数据来源,即数据集或数据模型。

这样的话,最终用户在使用设计器时就可以直接创建组件和仪表板,无需再自己选择数据来源,更加方便业务顺利进展。

具体方法也很简单,只需在集成仪表板设计器的URL中使用 datasetId 参数指定数据集或模型即可。

比如某数据集的Id 如下:

image.1a7844

那么在集成仪表板设计时就可以这样指定:

http://localhost:51980/dashboards/create?token=A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B6&datasetId=82554-9c66-4605-8cf3-5f1ffbd9c31

使用上面的链接打开后,当添加组件时则会自动加载数据集,如下图。

image.2731cf

编辑仪表板

在设计器中打开一个已有的仪表板。

1. 获取仪表板URL

选择需要集成的仪表板,单击页面右上角的 image 按钮,在新的浏览器窗口中打开仪表板。

image

将仪表板的URL地址拷贝粘贴到记事本中待用。

image

将 URL中 的“ view ”改为“ edit ”即可,例如:http://localhost:51980/dashboards/edit/a632af2f-ce09-47db-a97a-3678f338a9fc?theme=default&lng=zh-CN

type=warning

注意:

请注意数据集权限的设置,如果想要在集成的页面中进行仪表板的编辑保存操作,则需将仪表板所绑定的数据集也分享给用于生成令牌的用户。

2. 添加用户令牌

在获取到 URL 后,需要添加用户令牌来进行身份认证和权限认证,其格式为一系列包含字母和数字的字符串,例如:

A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B6

如何生成和获取令牌请参考生成令牌一节。在获取到令牌后,将其添加到目标 URL 的末尾,并使用 “&token=” 进行连接,得到最终的URL字串如下:

http://localhost:51980/dashboards/edit/a632af2f-ce09-47db-a97a-3678f338a9fc?theme=default&lng=zh-CN&token=A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B6

使用上面的链接打开后,效果如下图。在设计器中打开了指定的仪表板。

image

更多集成参数


参数

说明

可用值

1

lng

用来控制页面的显示语言。

en、zh-CN

2

theme

用来控制页面的系统主题色。

default、 ars、 blue、 red、 forest、 dark-forest、 light、 warm-light 和 green。

3

documentThemeId

集成时用来控制仪表板中使用的文档主题。

参数值为具体的文档主题ID。

6

dp

用于指定仪表板参数值。

参数值可以是“字符串”、“整数”、“浮点”、“日期时间”和“多维”类型。

语法:

&dp={"参数1名称":["参数1值1","参数1值2","参数1值3"],"参数2名称":["参数2值1","参数2值2","参数2值3"]}

9

clickAction

用于设置鼠标左键点击的触发项。

showTooltip、 keep、 exclude、 drillTo、 jumpTo

10

containerFilterScope

用于设置容器内组件的过滤范围。

page、 container

11

contextMenuActions

用于设置鼠标右键的菜单项。

showTooltip、 keep、 exclude 、drillTo、 jumpTo、 addMonitor、 command

12

datasetId

用来指定仪表板上组件默认绑定的数据集或者数据模型。

数据集或模型的ID。