成员合并场景
1. 简介
1.1 插件简介
成员合并指将多个成员单选或成员多选字段进行合并,合并后回写到新的成员多选字段中,或将成员编号合并写入单行文本字段。
1.2 应用场景
常用于某些表单存在多个成员字段,需要将多个成员字段合并到一个成员字段里,以便后续进行过滤条件、数据权限的设置等。
1.3 预期效果
以合并部分人员为例,效果如下所示:
1.4 使用说明
1)该插件为免费插件,付费版用户可免费使用。
2)该插件需要具有 API 权限才能使用。
2. 插件安装及配置
2.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:表单增强工具插件安装。
- 安装成功后,可参考本文【2.2 配置插件】和【2.3 启用插件】,前往「开放平台 >> 插件管理」处启用插件。
2)插件市场处安装
在简道云「插件市场」处,安装「表单增强工具」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。
2.2 配置插件
安装后,在「插件管理」处,点击插件右侧的「设置」按钮,将「简道云 API Key 」配置进去。
在「开放平台>>密钥管理」处,可以创建「API KEY」,查看并复制「API KEY」。
2.3 启用插件
在插件管理中,打开「表单增强工具」插件右侧开关,启用插件。
3. 表单搭建
插件使用可先安装:表单增强工具配套模板表单。本文将按照示例表单进行讲解。
1)新建「成员合并」表单,字段设置如下所示:
字段名称 | 字段类型 | 字段设置 |
业务编号 | 单行文本 | 在「字段属性 >> 默认值」处选择「公式编辑」,公式设置如下: CONCATENATE(TEXT(SYSTIME(),"yyyyMMddHHmm"),RIGHT("000"+RECNO(),3)) |
成员单选 | 成员单选 | —— |
成员多选 | 成员多选 | |
合并成员 | ||
合并成员编号 | 单行文本 | 返回值 |
2)表单搭建完成后,在「扩展功能 >> 数据推送」处,点击「设置字段别名」,如下所示:
- 成员单选:设置为 file1;
- 成员多选:设置为 file2;
- 成员合并:设置为 result。
注:
1)需要合并的成员字段,可以是多个,将需要合并的成员字段分别设置好别名即可。
2)字段别名可自定义设置,本文仅做示例,后续在插件设置中,对应设置自定义的别名即可。
4. 智能助手配置
4.1 添加智能助手
在「扩展功能 >> 智能助手」处新建智能助手「成员合并」,设置触发方式为「表单触发」。
4.2 设置触发动作
进入触发动作设置页面,点击「添加动作」,设置触发动作如下:
- 当新增数据时;
- 当修改数据任意字段修改时。
4.3 设置插件节点
添加插件节点,进行如下设置:
- 执行插件:选择「表单增强工具包 」>>「成员合并 」;
- 应用 ID:设置为字段值,勾选「触发数据--应用ID」;
- 表单 ID:设置为字段值,勾选「触发数据--表单ID」;
- 签署 ID:设置为字段值,勾选「触发数据--数据ID」;
- 成员别名:选择自定义,填写设置的字段别名「file1,file2」;
- 结果别名:选择自定义,填写设置的字段别名「result 」
- 执行结果:添加「合并成员编号 」字段,选择「文本类型」。
4.4 设置修改数据节点
设置修改数据如下:
- 选择修改对象:选择表单修改数据「成员合并」;
- 筛选出要修改的数据:点击添加条件,「业务编号」等于任意一个「触发数据--业务编号」;
- 设置字段值:添加字段「合并成员编号」=「节点字段值」「插件节点-合并成员编号」。
4.5 效果演示
效果参见本文【1.3 预期效果】。