[]
        
在线Demo 免费试用
(Showing Draft Content)

Wyn插件开发概览

1.1 什么是 Wyn 可视化插件

Wyn 支持通过自定义可视化插件扩展仪表板能力。插件上传到系统后,可以像内置组件一样被拖拽到设计器中,完成数据绑定、属性配置、交互分析和结果展示。


插件常见形态包括:

  • 基础图表:柱状图、折线图、饼图等

  • 特殊图表:组织结构图、桑基图、词云、关系图等

  • 地图类:热力地图、流向地图、组合地图等

  • 交互控件:下拉框、日期选择器、参数选择器等

  • 展示组件:动态数字、滚动文本、3D 效果组件等

从系统视角看,Wyn 插件本质上由两部分组成:

  • 静态声明:告诉 Wyn 这个插件需要什么数据、有哪些属性、支持哪些动作与分析能力

  • 运行时代码:告诉 Wyn 这个插件如何渲染、如何响应交互、如何联动其他组件

1.2 插件在 Wyn 中的运行模型

一个典型插件通常围绕以下对象工作:

核心对象

作用

WynVisual

所有插件都要继承的基础类

VisualHost

宿主环境,提供事件、属性、选择、过滤、命令等服务

DataView

Wyn 根据数据绑定规则计算后的数据视图

SelectionId

选择对象,用于交叉筛选、提示信息、保留/排除、钻取等

visual.json

插件元信息与运行参数定义

capabilities.json

数据、属性、动作、分析能力定义

src/visual.ts

插件主实现文件

可以把插件理解为一个四层模型:

  1. 定义层:visual.jsoncapabilities.jsonvisual.d.ts

  2. 实现层:src/visual.tsstyle/visual.lessi18nResources/*

  3. 运行层:update(options)、过滤、联动、参数、动作栏、颜色分配

  4. 交付层:本地调试、打包 .viz、上传系统、授权与升级

1.3 插件来源

Wyn 中的可视化插件主要有三种来源:

1.3.1 系统内置插件

系统内置 30+ 可视化插件,管理员可在「系统管理 > 文档管理 > 可视化插件」查看与管理,普通用户可在仪表板设计器中直接使用。


文档中提到的内置免费插件示例包括:

  • 图片旋转 3D、图片旋转 2D、图片轮播

  • 3D 饼图、扩展饼图、组合饼图、嵌套饼图

  • 动态数字、动态标题、滚动文本、日期时间

  • 组织结构图、桑基图、关系图、箱线图、瀑布图、直方图

  • 热力日历图、流向地图、组合地图、天气预报、监控视频、视频播放

文档中还提到部分内置收费插件,例如:

  • 3D 饼图(收费)

  • 3D 组合地图(收费)

1.3.2 应用市场插件

当内置插件无法满足业务需求时,可以从应用市场下载适配版本的插件,再上传到 Wyn 系统中使用。


进入应用市场的常见方式:

  • 从仪表板设计器中的“下载更多插件”进入

  • 从系统管理中的“可视化插件”页面进入

  • 直接访问应用市场网站后下载

1.3.3 自定义开发插件

对于企业专属样式、行业图表、个性化交互或业务流程型控件,可以基于 Wyn 提供的接口自行开发插件,并打包为 .viz 文件上传系统。

1.4 角色分工

角色

主要职责

业务用户

在设计器中拖拽插件、绑定数据、配置属性、查看分析结果

仪表板设计人员

设计仪表板布局,配置插件属性、交互和参数联动

开发人员

编写插件代码、定义接口、调试与打包

系统管理员

启用开发者模式、上传插件、设置运行参数、执行授权管理

1.5 收费插件与授权说明

根据原始资料,收费插件的管理规则主要包括:

  • 收费插件可试用 90 天

  • 试用期间通常带有试用版提示或水印

  • 正式授权通常通过导入 .cvl 授权文件完成

  • 授权按大版本生效,例如 1.x2.x 视为不同大版本

  • 小版本升级通常不需要重新购买授权

  • 试用版 Wyn 无法使用正式授权插件

授权导入的典型入口:

  • 「系统管理 > 运维管理 > 产品授权 > 可视化插件授权」

授权导入时,若右侧状态图标显示为绿色,则表示当前授权条件满足。

1.6 给客户的使用建议

面向客户使用时,建议优先用下面的方式理解 Wyn 插件:

  • 先看插件能否满足业务展示目标

  • 再看它需要哪些字段绑定

  • 然后看它有哪些可配置属性

  • 最后看它支持哪些交互、过滤、钻取、导出与共享动作

如果客户只是“使用插件”,无需理解所有开发接口;如果客户需要“定制插件”,则应系统阅<工程结构与配置说明>和<能力声明模型与接口说明>。