概述
最近调研了一下 tableau extensions 的实现,有一些心得,记录下来,供以后开发时参考,相信对其他人也有用。
总的来说,写 tableau extensions 还是挺简单的,只是要熟悉一点 tableau 的业务逻辑。这是我仿照 Image Viewer 插件写的 轮播图插件
参考资料:
extensions-api
extensions-api 文档
原理
tableau extensions 的原理其实就是在 tableau 里面打开一个内嵌网页而已,而在这个网页里面可以接入 tableau 的 sdk 来和 tableau dashboard 进行数据交互。
需要注意的是:
- 内嵌网页的内核是 chrome。
- tableau extensions 只能在 tableau 的仪表盘里面运行。
- 由于插件其实是一个内嵌网页,所以在插件里面你可以使用任何库,包括 jquery,vue,react 等等。
可以做哪些事
由于 tableau extensions 可以使用 sdk 和 tableau 进行数据的双向流动,所以它非常灵活,可以做这些事情:
- 能够获取 tableau dashboard 的数据
- 能够操作 tableau dashboard 的数据
- 能够监听关于数据的操作事件,然后做出一些响应。(所以能够和 tableau dashboard 的其它模块的一些操作进行联动)
- 能够打开 tableau dashboard 的配置框,让用户给自己手动进行一些配置。
基本结构
插件的基本结构如下(以我开发的轮播图插件为例):
- ImageSwiper.trex
- imageswiper.css
- imageswiper.html
- imageswiper.js
- imageswiperDialog.html
- imageswiperDialog.js
插件的加载过程如下:
- 安装插件: 引入配置文件 ImageSwiper.trex
- 在 ImageSwiper.trex 文件中有 imageswiper.html 的加载地址,tableau 会利用这个地址加载 imageswiper.html
- imageswiper.html 会加载 imageswiper.css 和 imageswiper.js
- 如果有配置 tableau 的配置框的话,在 imageswiper.js 里面会引入 imageswiperDialog.html 的地址,然后 tableau 根据这个地址加载配置框 imageswiperDialog.html
- imageswiperDialog.html 会加载 imageswiperDialog.js
所以要查看其它 tableau extensions 的源码是很简单的,只需要在 trex 配置文件里面查看插件 html 的地址,然后一步步去看源码就可以了。
调试
我当时是在 tableau desktop 上面写插件的,这样就看不到插件打印出来的内容,所以当时调试得非常困难。
等我写完插件才发现,可以直接使用 chrome 来进行调试。这是文档,这是chrome插件下载地址。