[]
如果要在业务应用系统中集成Wyn 的仪表板和报表,可采用URL集成方式。
URL集成的核心是生成被集成报表或仪表板的完整URL。文中以仪表板为例为您介绍。
1. 在新窗口打开仪表板
选择仪表板,单击页面右上角的新窗口按钮,在新的浏览器窗口中打开仪表板。
2. 拷贝浏览器地址栏URL
将仪表板的URL地址拷贝粘贴到记事本中待用。
3. 获取访问令牌
进入系统 后台管理 > 生成令牌。
输入令牌信息,单击生成令牌按钮即可生成该用户名的令牌字串。单击右侧的获取令牌按钮即可将令牌复制。
注意
生成令牌时使用的用户名,应具有待访问报表或仪表板的查看权限。
比如专门为集成创建一个名为guest的用户,再创建一个名为“集成用户”的角色,并将guest用户加入该角色。然后设置待集成报表或仪表板的权限,允许“集成用户”【只读】。
4. 将刚刚复制的令牌粘贴到第(2)步中URL的末尾,并使用 “&token=” 进行连接,得到的URL字串如下:
http://localhost:51980/dashboards/view/5d5cafe6e98abc00018ff4e5?theme=default&lng=zh-CN&token=0b77ebfe232bff06248ce245c24af6aa84010b5f747ef41e605b08ae310a6fed
type=info
提示
为了防止与第三方系统的token冲突,我们可以将Wyn 的令牌参数“token“改为其他的字符串,比如“tokentest”。具体修改方法,请见如何修改Wyn的用户令牌名称“token”。
如此做的话,最后的URL则为:
http://localhost:51980/dashboards/view/5d5cafe6e98abc00018ff4e5?theme=default&lng=zh&tokentest=0b77ebfe232bff06248ce245c24af6aa84010b5f747ef41e605b08ae310a6fed
5. 使用带令牌的URL字串
将该URL字串设置为业务系统页面文件中某个iframe的src属性或者超链接的href属性。
例如:
<iframe src="http://localhost:51980/dashboards/view/5d5cafe6e98abc00018ff4e5?theme=default&lng=zh-CN&token=0b77ebfe232bff06248ce245c24af6aa84010b5f747ef41e605b08ae310a6fed" style="height:90%;width:90%;border:none;background:grey;" />
效果如下图:
如果想在新的浏览器窗口中打开仪表板内容,只需设置一个超链接,href设置为上面的URL即可。例如:
<a target="blank" href="http://localhost:51980/dashboards/view/5d5cafe6e98abc00018ff4e5/?display=singlepage&theme=default&token=0b77ebfe232bff06248ce245c24af6aa84010b5f747ef41e605b08ae310a6fed">跳转查看Wyn文档</a>
集成报表时的操作步骤与仪表板一致,唯一不同的是:在集成报表时,支持使用文档ID和文档名称两种集成方法。
也就是说,集成单张报表时,既可以使用原URL中的文档ID,也可以将文档ID替换为文档的名称进行集成。这在集成多张报表时就带来了一定的便利性。
比如,在集成上图中的文档时,我们可以使用如下两个URL:
http://localhost:51980/reports/view/0ddb33e9-3211-4d96-9d25-ca34458dd8b9?display=singlepage¶mpanel=top&theme=default&lng=zh&token=xxxxxxx
或
http://localhost:51980/reports/view/1-表格-财政教育经费投入情况表?display=singlepage¶mpanel=top&theme=default&lng=zh&token=xxxxxxx
注意
使用文档名称进行集成时,一旦系统中的文档名称发生变化,那么使用原URL将无法打开文档。
如果想要在业务系统中集成某个报表或者仪表板的设计页面,只需将集成URL中的“ view ”改为“ edit ”即可,例如:
http://localhost:51980/reports/edit/...&token=2cb6c4d1717902b9a...
请特别注意数据集权限的设置。如果想要在集成的页面中进行仪表板或报表的编辑保存操作,则需将仪表板或报表所绑定的数据集也分享给用于生成令牌的用户。
如果想要在业务系统中集成创建新的报表或者仪表板的页面,只需将集成URL中的“ view ”改为“ create ”并省略“ id ”部分,例如:
创建新报表:http://localhost:51980/reports/create?token=2cb6c4d1717902b9a...
创建新仪表板:http://localhost:51980/dashboards/create?token=2cb6c4d1717902b9a...
如需集成新建页面,则需用于生成令牌的用户具有创建对应文档的权限。
在集成仪表板设计器时,有时需要指定一个数据来源,即数据集或数据模型。
这样的话,最终用户在使用设计器时就可以直接创建组件和仪表板,无需再自己选择数据来源,更加方便业务顺利进展。
具体方法也很简单,只需在集成仪表板设计器的URL中使用 datasetId 参数指定数据集或模型即可。
比如某数据集的Id 如下:
那么在集成仪表板设计时就可以这样指定:
http://localhost:51980/dashboards/create?token=2cb6c4d1717902b9a... &datasetId=b0082554-9c66-4605-8cf3-5f1ffbd9c314
使用上面的链接打开后,当您添加组件时则会自动加载数据集,如下图。