JeecgBoot高级查询中部门选择组件配置单选的实现方法

在JeecgBoot 3.7.1版本中，开发者在使用高级查询功能时，经常会遇到需要配置部门选择组件的需求。默认情况下，部门选择组件(superQuerySchema中的sel_depart视图)是支持多选的，但在某些业务场景下，我们可能需要限制用户只能选择单个部门。

问题背景

在JeecgBoot的高级查询配置中，开发者通常会使用如下代码定义查询字段：

export const superQuerySchema = {
  departId: { title: '部门ID', order: 3, view: 'sel_depart', type: 'string' }
};

当开发者尝试通过添加multiple: false属性来限制为单选时，发现这个配置并不生效，部门选择弹窗依然允许用户选择多个部门。

解决方案

经过分析，正确的配置方式应该是使用fieldExtendJson属性来传递额外的配置参数。具体实现如下：

export const superQueryConfig = {
  departId: { 
    title: '部门ID', 
    order: 3, 
    view: 'sel_depart', 
    type: 'string', 
    fieldExtendJson: '{"multiSelect":false}' 
  }
};

技术原理

1. fieldExtendJson的作用：这个属性允许开发者以JSON字符串的形式传递额外的配置参数给前端组件。

2. multiSelect参数：当设置为false时，会通知部门选择组件禁用多选功能。

3. 配置优先级：通过fieldExtendJson传递的配置具有较高优先级，会覆盖组件的默认行为。

实际应用

在实际项目中，这种配置方式可以应用于多种场景：

1. 权限控制：当业务逻辑要求用户只能选择一个部门进行查询时。

2. 简化操作：在不需要多选的场景下，减少用户操作复杂度。

3. 数据一致性：确保查询结果只针对单一部门，避免多选带来的数据混淆。

注意事项

1. JSON字符串必须使用双引号，单引号会导致解析错误。

2. 属性名称区分大小写，必须使用"multiSelect"而不是"multiselect"或"MultiSelect"。

3. 这种配置方式同样适用于JeecgBoot中的其他类似组件。

通过这种配置方式，开发者可以灵活控制高级查询中部门选择组件的选择行为，满足不同业务场景的需求。