集成仪表板设计器

1. 概述

1.1 功能概述

通过IFrame无缝集成Wyn仪表板设计器，用户可直接在业务系统中快速创建和编辑数据仪表板，实现嵌入式可视化开发。

2. 操作步骤

2.1 新建仪表板

2.1.1 准备仪表板URL

1. 先准备好创建仪表板设计器的URL。例如：

   http://localhost:51980/dashboards/create

2.1.2 添加用户令牌

1. 在获取到 URL 后，需要添加用户令牌来进行身份认证和权限认证，其格式为一系列包含字母和数字的字符串。关于如何生成和获取令牌请参考生成令牌一节。在获取到令牌后，将其添加到目标 URL 的末尾，并使用“?token=” 进行连接，得到最终的 URL 字串。

   例如：http://localhost:51980/dashboards/create?token=A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B6

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

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

通过URL中的datasetId参数可以预置数据集或数据模型，用户可在嵌入式仪表板设计器中直接基于指定数据集/模型创建可视化组件，实现开箱即用的分析体验，大幅提升业务效率。

1. 例如：某数据集的Id 如下：

   
   

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

   例如：http://localhost:51980/dashboards/create?token=A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B6&datasetId=5584142f-365b-45da-b82c-3e2893a5ccd9

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

   
   

2.2 编辑仪表板

2.2.1 获取仪表板URL

1. 在文档门户中，选择需要集成的仪表板，单击页面操作栏的在新窗口浏览仪表板按钮 ，即可在新的浏览器窗口中打开仪表板，然后将仪表板的URL地址拷贝粘贴到记事本中待用。

   
   

2. 在记事本中将 URL中 的 view 修改为 edit 即可，例如：

   原URL：http://localhost:51980/dashboards/view/36216337-ba1b-44b5-a219-0f93a54119ed?theme=default&lng=zh-CN
   
   修改后的URL：http://localhost:51980/dashboards/edit/36216337-ba1b-44b5-a219-0f93a54119ed?theme=default&lng=zh-CN

   注意：

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

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

2.2.2 添加用户令牌

1. 在获取到 URL 后，需要添加用户令牌来进行身份认证和权限认证，其格式为一系列包含字母和数字的字符串。关于如何生成生成和获取令牌请参考生成令牌一节。在获取到令牌后，将其添加到目标 URL 的末尾，并使用 “&token=” 进行连接，得到的最终的 URL 字串。

   例如：http://localhost:51980/dashboards/edit/36216337-ba1b-44b5-a219-0f93a54119ed?theme=default&lng=zh-CN&token=A2D2D9E4EBF94D15F0597A9A1D2A756ED8AE0874D2BD4B1C01070DAAFCB9A4B6

   注意：生成令牌时使用的用户，应具有创建仪表板的权限以及对目标仪表板的编辑权限。

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