功能概述

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

新建仪表板

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

1. 准备仪表板URL

例如：

http://localhost:51980/dashboards/create

2. 添加用户令牌

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

A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B6

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

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

type=warning

注意

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

3. （可选）指定数据集或模型

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

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

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

比如某数据集的Id 如下：

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

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

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

编辑仪表板

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

1. 获取仪表板URL

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

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

将 URL中 的“ view ”改为“ edit ”即可，例如：

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

2. 添加用户令牌

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

A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B6

如何生成和获取令牌请参考生成令牌一节。

type=warning

注意

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

如果想要在集成的页面中编辑保存仪表板，则需将仪表板使用的数据集也分享给生成令牌的用户。

在获取到令牌后，将其添加到目标 URL 的末尾，并使用 “&token=” 进行连接，得到最终的URL字串如下：

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

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