复选框填充

1. 简介

1.1 案例简介

复选框填充插件是指，将单行文本的值分割成复选框的内容。本案例以开发自建插件「复选框填充」为例，介绍如何开发一个完整的插件，并实现在表单中调用插件的效果。

1.2 业务背景

传统复选框需预先设置选项值，导致在业务场景中无法实时按需新增选项。如临时增减审批条款、临时增减实验选项等。

1.3 设计思路

1）新建「员工基本信息表」表单，用于录入用户提供的基本信息，如姓名、性别、年龄以及兴趣等；

2）开发自建插件「复选框填充」，用于将获取到的单行文本值转换为复选框组值，具体包括：

3）在表单中设置前端事件，调用自建插件「复选框填充」，从而实现将获取到的用户兴趣转换为复选框组，并自动填充至复选框组选项中的效果。

1.4 预期效果

以将员工的兴趣转换为复选框组值为例，效果如下所示：

2. 表单搭建

新建「员工基本信息表」，所需字段及字段设置如下：

3. 自建插件设计

3.1 新建自建插件

在「开放平台 >> 开发者后台 >> 自建插件」处，点击「新建插件」，并在「插件设计」页面中修改自建插件的名字为「复选框填充」。

3.2 新建函数

进入「插件设计」页面中，系统默认添加一个后端函数，点击函数右侧的三个小圆点，选择「编辑名称」，并修改函数名称为「单行文本值转换为复选框」。

3.3 设计参数

3.3.1 设计请求参数

点击「请求参数」，在页面中添加并设置字段控件，如下所示：

3.3.2 设计返回参数

点击「返回参数」，添加返回参数，并进行如下设置：

3.4 编辑代码

请求参数和返回参数都设计完成后，点击「代码」进入代码编辑页面。代码示例如下所示：

import json

# 定义键和值
key = "Str" # 你可以根据需要修改键名
value = triggerConf.get('Str1')   # 值为 "text"
value1=value.split(',')
# 创建一个字典，表示键值对
data = {key: value1}

# 将字典转换为 JSON 格式的字符串
json_data = json.dumps(data)

return json_data

3.5 保存并启用

参数和代码都设计完成后，点击右上角的「保存」按钮，并返回至「自建插件」页面中，打开「复选框填充」右侧开关，即可启用插件。

4. 调用插件

4.1 添加按钮执行动作

进入「员工基本信息表」表单中，点击「是否开始计算」按钮，在「字段属性 >> 执行动作」处点击「设置」，添加一个前端事件。

4.2 设置事件名称和说明

添加好前端事件后，首先设置前端事件的基础信息，即事件名称和事件说明，用于区分前端事件。设置完成后，点击「下一步」。

4.3 设置执行动作

设置执行动作如下：

全部设置完成后，点击「保存」按钮。

4.4 效果演示

效果参见本文【1.3 预期效果】。

5. 共创伙伴

诚挚感谢个人共创伙伴余绪东老师基于简道云开放平台的 API 接口能力打造「复选框填充」插件。该插件通过单行文本智能分割技术，实现填写时自由增删复选框内容，既保障数据采集灵活性又满足审批流程动态调整需求。进一步体现了简道云自建插件无需复杂编码即可将业务需求转化为轻量化工具的能力。

立即探索自建插件，解锁属于您的数字化创新力！