视图插件开发小技巧

分享 明道云视图插件webhook  收藏
7 / 320

前言

当我们没有技术背景的研发人员去开发我们的视图插件往往会遇到很多问题,其中之一就是怎么和明道的数据进行打通、进行交互,对于专业的前端人员来说会相对比较简单,只需要按照文档进行操作调用前端接口即可,但是对于非专业的人员来说往往对代码接口是不熟悉的,虽然也可以用 cursor 去完成插件的开发。

例如我的同事李江、俊良在最近分享了有关 cursor 开发视图插件教程,感兴趣也可以了解一下相关文章:当 Cursor 遇见明道云:一场插件开发的技术漫游

回到主题,在用插件和明道云数据进行打通的时候我们可以用 webhook 的方式或者封装业务流程 API 响应的方式去进行数据的变更,对接口进行版本的管理。

为何要写这篇文章

我本身用代码开发过一些视图插件,在开发过程中,我常常会需要变更记录的数据,例如四象限视图点击完成的时候,我需要去变更记录的完成状态,我当然可以用插件的更新接口去更新状态,但是这时候会有一个问题,要是后续我的需求变更了,我点击完成的时候还需要修改别的值,这时候我们就需要继续进入到我们的代码中去修改,就算运用了 cursor 这么好用的工具,你还是会经历代码的变更、打包上传一系列的操作,如果是不熟悉代码的业务人员,发生了错误,你将会排查很久以至于拖延进度

image.png

但是你这时候如果在明道云写一个 webhook 的接口,只需要告诉 cursor、或者自行调用 webhook 的接口,传几个参数,然后回到我们熟悉的领域——编写明道云工作流。这样的操作,就算你后续代码找不到了、需求变更了,你都可以只需要修改明道云里面的工作流就可以快速的实现版本的更新。

image.png

这个是我编写的四象限相关的 webhook 接口,但是领导隔了一个月让我修改一些简单的需求,我没有做好代码的存储工作,以至于我没办法更新,但是好歹我大部分操作是通过 webhook 接口的方式操作明道云数据,以至于我在几分钟就修改后了需求。

这篇文章为谁而写

其实也算记录我之前遇到的一些问题以及解决路径,在前端接口文档不熟悉的情况下,来到我们熟悉的领域会让我们更加如鱼得水,不需要去熟悉接口文档,只需要用 cursor 编写好样式,需要数据操作的部分可以交给 webhook,大大减少了我们开发的难易程度。
实现需求的技术路径不止一条,不要把自己只局限于一种工具,在我看来只需要实现客户需求的工具就是好工具,不管是用代码、cursor、明道云自带的工作流,这些结合起来都能给我们带来很多舒适体验

场景示例

1.脚本获取明道云论坛、博客、直播课的内容通过 webhook 的方式传输至明道,在工作流中对数据进行分类、标注、分支判断处理

image.png

2.通过脚本获取 QQ 邮箱中邮件正文、内容、附件,对附件通过七牛云链接解析通过 webhook 的方式传输到明道云,在工作流中进行一系列化的处理,例如数据分类、pdf 发票识别,其余工作表的数据新增更新。
3.四象限点击完成按钮的时候触发 webhook,在工作流中判断是否是 okr 行动,去修改相关的记录数据。或者是拖拽四象限任务卡片的时候,通过 webhook 修改任务的优先级,便于对任务的排序

image.png

愿这些分享能对你有些许帮助,在试图插件开发过程中找到自己的开发节奏,期待看到更多精彩的插件诞生!