【V5.0 新功能】可视化插件API接口增强

可视化插件一直是仪表板的一大重头戏，仪表板中很多酷炫的视觉效果都可以通过可视化插件接口来定制开发，诸如社区目前所提供的各类地图插件：流向地图、点地图、色阶地图等等，都是通过可视化接口对接地图API来实现的。那么在Wyn Enterprise 5.0 中，对于可视化插件能力都有哪些提升呢？让我们一起来看看吧！

1、可视化插件数据绑定开放更多设置接口
在此之前，可视化插件如果想对所绑定的数据进行更多设置，只能统一在数据绑定区域顶部里边设置，也就是下图所在的位置：

在5.0版本，我们对于绑定的字段，单独开放了接口，可以更加灵活的控制绑定数据的格式化设置：

比如上图，假如我们绑定了一个image字段，我们可以设置它的渲染方式为文本还是图片等等：

更多的设置还有，对于绑定数据的格式以及单位等等的设置，具体的使用可以参考帮助文档：https://help.grapecity.com.cn/display/wyn500/Data+Binding
增加的设置项名为：【itemOptions】

2、属性设置增加列表编辑器
对于可视化插件的属性设置也是可视化插件的一个重要功能，如下图是3D四棱锥插件的属性设置项：

通过调整不同设置项，使得可视化插件呈现不同的形态和功能。那在5.0版本中，我们对属性增加了列表编辑器这个类型，也就是下图这类属性设置：

这个功能的重头戏其实在于颜色预警的应用中，该类型属性除了设置为上图这种单项，也可以将其每项定义为一个对象类型：

比如这个属性设置用在颜色预警中就特别有用，我们设置当数据处于0-59之间时，呈现红色；处于60-70之间时，呈现黄色等等。同时也可以在右上角自定义添加更多设置项，而无需像之前一样，只能事先定义固定数量的设置项：

更多文档请参考：https://help.grapecity.com.cn/display/wyn500/Options
增加的property名为【Collection】

3、可视化插件增加id和版本号
从5.0版本开始，我们对可视化插件增加了版本号功能，在打包插件时，在配置文件中可进行设置，设置后上传至Wyn，在列表栏就会多一项版本号：

这样就可以记录当前插件更新的版本历史，更好的管理和使用插件。同时在打包插件时，会为每个插件生成一个固定的id。那么这样做有什么用处呢？我们通常都有这样的需求，从一个环境A后台导出仪表板导入到另一个环境B，那如果没有id往往就会造成插件冗余的问题。也就是说比如两个环境都安装了一个可视化插件，我们即将导出的这个仪表板中使用了这个插件，那么从A环境导出仪表板时带了这个可视化插件到B环境，那么此时这个B环境就会同时存在两个可视化插件，系统无法检测这两个插件其实是同一个插件，那么在5.0中使用了id，之后就不会再出现此问题。


4、可视化插件增加在Div渲染功能
在5.0版本以前，Wyn的可视化插件只能渲染在可视化插件所提供的渲染区域内，这个渲染区域是一个与外界隔离的iframe，这样能够保证可视化插件iframe内的环境与仪表板其他部分进行一个隔离，不会对仪表板功能造成污染。但这样也有一个弊端，比如我们无法将在iframe内的插件扩展显示到插件区域外，就像这个日期时间插件一样：

如果这个用插件实现，5.0版本之前可视化插件只能显示在一个小区域内，不能扩展在外侧。但如果现在启用了div渲染功能，就可以使这个插件显示在这个区域外侧。
同时div渲染也会带来整个仪表板加载性能的提升，因为使用了更少的iframe。
注意：使用div渲染模式需要格外小心，因为你不小心可能就会改变页面其他元素，导致影响到仪表板正常功能的运转。
在以下位置开启div渲染，默认在iframe内渲染，关闭可开启在div内渲染：


5、插件可控制页面切换
在5.0版本，我们开放了在可视化插件内部切换仪表板页面的接口。也就是说，当一个仪表板有多个页面时，我们可以在可视化插件内部控制多页面的切换。
接口使用可参考帮助文档：https://help.grapecity.com.cn/pages/viewpage.action?pageId=57503832#VisualAPI%E6%8E%A5%E5%8F%A3%E6%96%87%E6%A1%A3-commandService

那么这个接口的开放主要用途在哪呢？其实我们在日常仪表板使用过程中也许有这样的需求：仪表板顶部有好几个按钮，这些按钮的位置保持不变，底部页面进行切换：

比如上图这个仪表板，顶部有好几个页面入口进行不同页面的切换，那么在5.0版本中就可以借助可视化插件非常方便实现页面的定向切换。

好了，关于可视化插件API的更新就讲到这里，希望大家能够更加深入和灵活的使用Wyn Enterprise的可视化插件接口能力，对做出一个完美的大屏是大有裨益的~~