工作流插件-自定义节点

---

工作流插件可以将常用的数据处理逻辑封装为自定义工作流节点，供组织成员在工作流中直接使用。插件内部可以使用分支、AIGC、API 请求、代码块、JSON 解析等节点，将复杂的数据处理过程封装为简单易用的自定义节点。

开发完成后，可以发布插件供组织内使用，也可以将已发布的插件导出为文件，在其他组织中导入或升级。

场景示例

在工作流中进行外部API对接时，经常需要将数据进行不同方式的加密。之前需要用户自己通过代码块来处理，操作不够方便，且不懂代码的用户难以掌握。 此时可以在工作流中封装一个自定义节点，实现以下功能：选择一种加密方式（MD5、sha1、sha256、HMAC），将输入数据根据进行加密。提供给组织所有人使用。

创建工作流插件

创建入口

在【插件中心】>【工作流节点】中，点击【制作插件】，开始创建工作流插件。

设置节点名称、图标、和使用说明

说明会在用户使用节点时进行显示。

设置输入参数

可额外设置选项、检查项类型的输入方式，和设置分组标题，用于输入时的交互呈现，方便用户输入。

设置数据处理步骤

在数据处理的节点块中，添加并配置需要的数据处理节点。

设置输出参数

添加输出参数，参数值可以选择数据处理节点中的输出值。

发布并测试

点击右上角发布按钮进行发布，发布后，在工作流中添加节点时就可以在插件分类中看到此节点。此时就可以自己在工作中使用和测试节点了。

在组织中发布

当自己使用测试没有问题后，可以在插件中心中将插件发布到组织。发布后组织下所有人都可以使用此节点。

管理插件

在【我创建的】插件列表中，可以对自己创建的插件进行编辑、删除、发布新版本等操作。

点击插件名称可以修改插件名称、图标等信息；点击【编辑】可以修改插件的数据处理步骤和输入、输出参数。

完成修改后，可以发布新版本。

最新的版本并不一定是公开发布的版本,可以选择任一版本设为当前版本。

导出插件

已发布的插件可以导出为插件文件，用于在其他组织中导入或升级。

路径:选择需要导出的已发布版本，点击【导出】，导出 .mdye 格式的插件文件。

设置导出授权：

导出时，可以勾选【导入时校验授权密钥】，为插件设置导入授权条件。

• 密钥：必填。系统生成 8 位随机数字字母组合作为授权密钥。
• 到期时间：设置插件授权的有效期。未设置时永久有效。
• 指定组织：指定允许导入插件的组织。未指定时，所有组织均可导入。

启用授权校验后，导入插件时需要通过密钥、有效期和授权组织校验。

导出历史

插件导出后，可以在导出历史中下载已导出的插件文件；如果导出时设置了授权条件，还可以查看对应的授权密钥和有效期。

导入或升级插件

在插件中心的【组织】插件列表中，点击【导入】，上传 .mdye 插件文件。

系统会根据插件的同源 ID 判断当前组织是否已存在对应插件：

• 不存在同源插件：直接导入并生成新的插件。

• 存在同源插件：可以选择新增插件，或覆盖更新已有插件。 选择覆盖更新后，可以使用导入文件中的新版本内容升级已有插件。

导入完成后，插件会显示在组织的工作流插件列表中。