898198 / plugin_view_samples

明道云插件样例

明道云视图插件案例

插件名称	源代码
地图	https://github.com/mingdaocom/plugin_view_samples/tree/master/map
明细表	https://github.com/mingdaocom/plugin_view_samples/tree/master/table
时间轴	https://github.com/mingdaocom/plugin_view_samples/tree/master/timeline

如何开发一个插件

视图插件开发文档

如何安装已有插件到组织

1.克隆案例或其它视图插件仓库到本地

打开控制台，克隆仓库到本地 git clone https://github.com/mingdaocom/plugin_view_samples.git

编辑器打开插件目录，以 timeline 为例。
在 timeline 文件夹内执行 npm i 安装项目依赖

2.新建开发插件视图

在应用里新建一个工作表并新建一个开发插件视图。

跟随视图配置"开发调试"引导，完成”安装 mdye cli“这一步，完成后输入mdye --version 确认是否安装成功，正常显示版本号即为成功。

这一步不是每次都要执行，安装成功后后面无需再次执行。

3.更改本地 mdye.json 配置

查看"建立本地项目"这一步，使用 --id 后跟的参数替换本地项目内 mdye.json 文件里的对应的配置，命令内含 --host 时需要替换配置文件内的 host，没有的话不需要。

修改后的 mdye.json 文件

到这一步已成功将本地的项目与明道云内建立的视图插件进行了关联。
如果项目仓库存在.config/params-config.json文件，请执行 mdye sync-params 命令来将插件的参数配置同步到在明道云建立的视图插件。

刷新明道云页面，打开对应视图的视图配置，会在"插件设置"里看到刚刚同步上去的参数配置，这个时候可以将插件名称改成想要的名字，这里改成"时间轴视图"（修改名称在任意一步都可以）。

4.构建插件并推送到明道云

执行 mdye build 构建项目

如果 build 报错，请先确认第一步里的 npm i 是否已正确执行。

执行 mdye push -m 初始化 推送文件到明道云

打开视图配置查看"提交"部分，标题"已提交"下面会出现刚刚提交的版本，可以选中前面的单选框来预览此次提交，选中后视图区域会自动刷新。

时间轴视图插件时间字段为必填字段，请先在表单配置内添加一个日期字段，在"参数映射"配置内将"时间"字段设为刚刚添加的字段后插件即可运行，右上角新建记录查看效果。

5.发布插件

在上面提到的提交列表里可以点击更多按钮发布选择的提交记录。

6.应用管理员在插件中心开启插件

从明道云首页进入插件中心可以看到刚刚发布的插件。

开启插件发布状态

这个时候已经可以在新建视图里看到刚刚发布的"时间轴视图"了，Enjoy it！