自建插件 - 简道云

自建插件

注：本功能需要有代码能力，若不会代码建议使用 0 代码方案解决(使用市场插件或提交需求)

1. 简介

从本质上讲，自建插件就是用户定义的代码段，这段代码在业务系统发生指定事件时被调用。一个插件中可以包含多个这样的代码段，用来响应系统中的不同事件。自建插件可以实现与第三方平台进行业务协作。

1）自建插件从 2022 年 11 月开始内测，已有近 100 家企业测试使用自建插件，目前内测企业已开发并配置了近 300 个自建插件。使用场景广泛，如，ERP 系统单据查询、文字识别 OCR 插件、钉钉通讯录成员信息同步和回写、内部表单之间的数据互通、通过企业微信群机器人进行消息推送等。

2）企业可以根据需要自行开发更多自建插件。

1）使用场景广泛。自建插件功能不一定非要依赖 API 才能使用，故自建插件可实现的场景比 API 对接更加广泛。

2）自建插件支持复用

3）降低开发成本。自建插件可以实现研发开发插件后，业务人员对插件进行配置和使用。相比 API 对接中，需要全程由研发人员进行开发和配置，自建插件大大降低了开发成本。

本功能为付费高级功能，需简道云企业版及以上版本可用（试用版可进行试用），您可升级简道云版本来使用该功能，版本升级可点击：商务咨询。

登录简道云，从工作台进入开放平台后，在插件管理处可以自建插件。如下图所示：

创建后先对插件进行重命名。

注：

1）新建插件前，需要先进行身份认证。

2）单个企业内的自建插件数量上限为 500 个。

自建插件包括插件属性、插件设计以及保存与调试这 3 部分内容。

插件的创建步骤为：「新建插件 >> 插件属性 >> 插件设计 >> 保存与调试」。

自建插件最关键的一步在于插件设计。只有插件设置好了，才可以通过插件成功执行对应的程序。

插件设计完成后，打开插件右侧的开关，并开启云币支付，即可启用插件。

1）开发者完成自建插件开发后，可根据自身需求对插件进行导出。点击需要导出的自建插件右侧的三个小圆点，选择导出，插件将以 zip 压缩包的形式下载至本地：

2）若开发者需要导入其他插件进行使用，点击「新建插件」右侧的三个小圆点，选择导入插件。在导入插件详情页中，上传插件包并确认插件信息无误后，点击「确定」即可导入成功。

1）若开发者需要对插件进行更新，点击原插件右侧的三个小圆点，选择「更新」。在更新插件详情页中，上传插件包并确认插件变更信息无误后，点击「确定」即可更新成功。

2）点击「查看变更」后，进入代码比对详情页。左侧函数处可以查看到对应函数的变更标识，同时在代码比对详情页中，可以查看到具体的代码删除、新增等信息。如下所示：

自建插件每次触发将会扣除 0.0001 云币（1 万次触发 = 1 元），为保证您的自建插件可正常触发，请及时前往「企业管理 >> 版本信息 >> 云币支付设置」处开启「触发开放平台插件时以云币支付」功能开关，并保证账户内有足够的云币。

注：独享版使用自建插件时，触发自建插件不会扣除云币。

本篇文档主要用于解决您自建插件过程中可能会遇到的问题，如您仍有疑问，欢迎您扫描下方二维码加入插件交流群进行咨询。