管理插件依赖
1. 简介
1.1 功能简介
管理插件依赖是指,企业可以根据业务需求自定义插件的运行环境,调用第三方依赖能力,实现更复杂的插件能力。解决企业用户由于内置库受限导致的开发运维成本高、系统稳定性差、响应周期过长等问题。
1.2 应用场景
适用于企业复杂业务下,需要引入第三方库的各类场景中。如:
- 门店业务提货场景中,需引入 xlrd、openpyxl 等第三方库,解析简道云表单附件字段上传的 excel 表;
- 会计计算场景中,需要引入numpy,pandas等第三方库,根据简道云表单字段进行复杂的数学计算;
- 销售签单场景中,需引入 opencv 等第三方库,简道云表单上传的图片进行识别,添加水印等复杂操作
- AI 交互场景中,需引入 openai 等第三方库,从简道云表单字段出发实现与AI的交互
1.3 预期效果
以 PyPinyin 库部署成功并在插件设计中引入为例,效果如下所示:

1.4 使用说明
1)可以使用「自建插件」功能的用户,即可免费使用「管理插件依赖」功能,否则需先购买「自建插件」功能。
2)插件调用自定义环境需要额外消耗云币,10000 次调用会消耗 2 云币。
2. 管理步骤
2.1 管理入口
1)在「自建插件」中,点击「管理插件依赖」按钮,进入插件依赖管理中。如下所示:

2)在「插件设计 >> 后端函数 >> 代码 >> 环境依赖」处,点击「管理插件依赖」即可进入插件依赖管理中。如下所示:

2.2 基础环境
基础环境是指简道云中默认支持使用的第三方库。不同代码语言所支持的第三方依赖库也不同。详情如下所示:
代码语言 | 基础环境依赖库 |
Node.js 20 |
|
Python 3.10 |
|

注;基础环境中的第三方依赖库,不支持进行修改。
2.3 自定义环境
自定义环境能承载用户按需自定义安装部署的第三方库。
2.3.1 新建自定义环境
1)在「自定义环境」中,点击「新建」按钮,选择安装第三方库所需的环境语言后,即可新建一个自定义环境。在新建的自定义环境中,支持按照对应语言规范,自由编辑依赖文档,包括新增、删除、修改依赖版本等操作。
以新增 Python 3.10 语言下的 Pypinyin 第三方库为例,如下图所示,在依赖文档中新增所需的依赖名与版本即可:

2)新增好第三方库后,点击「安装并部署」,即可等待部署完成。
注:
- 部署需要一定时间,建议在完成所有依赖库的新增与修改后,再统一执行部署。
- 等待部署时,支持其他操作或切出部署界面,部署不会中断。
- 部署时,请确认好第三方库的版本号,若无法找到配置中的部分库或版本,将导致安装失败。

3)部署成功后,在进行插件设计时,即可根据开发内容选择企业所需环境。如下所示:

2.3.2 编辑自定义环境
若需修改、新增自定义环境中的第三方库,支持在依赖文档页面中直接编辑,编辑完成后点击「保存并部署」。

2.3.3 删除自定义环境
若确认当前自定义环境无效,且删除后不会对企业业务产生影响,点击自定义环境右侧的三个小圆点,选择删除即可删除自定义环境。

2.4 查看引用视图
点击「查看引用视图」,在引用详情中查看该环境的引用情况,支持查看引用该环境的插件数量和插件名称,并支持点击函数后直接跳转至函数设计页面。如下所示:

2.5 第三方依赖安装日志
点击「第三方依赖安装日志」,即可查看自定义环境的安装日志。系统支持根据如下 4 个维度进行筛选查看:
- 所属环境
- 操作类型
- 操作人
- 操作时间

3. 注意事项
1)一个自建插件后端函数仅支持选择一个自定义环境。
2)系统中最多支持 2 个自定义环境,建议合理分配每个环境的三方库数量,完成所有依赖库的新增与修改后,统一执行部署。
3)若新环境与当前启用该环境的插件不兼容,会导致插件失效。建议在更新第三方依赖版本、删除第三方依赖时仔细检查是否存在新环境与调用该环境的插件之间的兼容问题,再执行部署。

400-111-0890
在线咨询