[]
        
(Showing Draft Content)

示例一:集成仪表板/报表以及设计器

如果要在业务应用系统中集成Wyn 的仪表板和报表,可采用URL集成方式。

URL集成的核心是生成被集成报表或仪表板的完整URL。文中以仪表板为例为您介绍。

操作示例

1. 在新窗口打开仪表板

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

image2021-6-5_15-41-42.png

2. 拷贝浏览器地址栏URL

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

image2021-6-5_15-42-10.png

3. 获取访问令牌

进入系统 后台管理 > 生成令牌。

image2021-6-5_15-46-7.png

输入令牌信息,单击生成令牌按钮即可生成该用户名的令牌字串。单击右侧的获取令牌按钮即可将令牌复制。

image2021-6-5_15-46-54.png

注意

生成令牌时使用的用户名,应具有待访问报表或仪表板的查看权限。

比如专门为集成创建一个名为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;" />

效果如下图:

image2021-6-5_15-48-3.png

如果想在新的浏览器窗口中打开仪表板内容,只需设置一个超链接,href设置为上面的URL即可。例如:

<a target="blank" href="http://localhost:51980/dashboards/view/5d5cafe6e98abc00018ff4e5/?display=singlepage&theme=default&token=0b77ebfe232bff06248ce245c24af6aa84010b5f747ef41e605b08ae310a6fed">跳转查看Wyn文档</a>

集成单张报表的特殊说明

集成报表时的操作步骤与仪表板一致,唯一不同的是:在集成报表时,支持使用文档ID和文档名称两种集成方法。

也就是说,集成单张报表时,既可以使用原URL中的文档ID,也可以将文档ID替换为文档的名称进行集成。这在集成多张报表时就带来了一定的便利性。

image2020-8-28_16-52-40.png


比如,在集成上图中的文档时,我们可以使用如下两个URL:

http://localhost:51980/reports/view/0ddb33e9-3211-4d96-9d25-ca34458dd8b9?display=singlepage&parampanel=top&theme=default&lng=zh&token=xxxxxxx

http://localhost:51980/reports/view/1-表格-财政教育经费投入情况表?display=singlepage&parampanel=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 如下:

image2021-11-15_15-16-55.png


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

http://localhost:51980/dashboards/create?token=2cb6c4d1717902b9a... &datasetId=b0082554-9c66-4605-8cf3-5f1ffbd9c314

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

image2021-11-15_15-24-37.png