JeecgBoot在线表单开发中sys_depart表如何配置？

Question

在JeecgBoot在线表单开发中，如何正确配置`sys_depart`表以实现部门字段的下拉选择或树形展示？这是常见的技术问题。通常需要配置字段类型为“部门选择器”或“树形数据”，并关联`sys_depart`表的主键与父级字段（如`id`和`parent_id`）。同时，需确保系统字典或API接口正确返回部门树结构，以便在表单中正常渲染。若配置不当，可能导致数据无法加载或展示异常。

Answer 1

一、背景与基础概念

JeecgBoot 是一款基于 Spring Boot 和 Vue 的低代码开发平台，支持在线表单的快速构建。在实际业务中，部门字段（如所属部门）常需通过下拉选择或树形结构展示，这就涉及对 sys_depart 表的正确配置。

sys_depart 表是 JeecgBoot 中用于存储部门信息的核心数据表，其关键字段包括：

• id：部门主键
• parent_id：父级部门ID
• depart_name：部门名称

实现部门字段展示的关键在于字段类型的选择以及数据接口的正确对接。

二、配置步骤详解

1. 进入 JeecgBoot 在线表单设计器
2. 添加一个新字段或编辑已有字段
3. 将字段类型设置为“部门选择器”或“树形数据”
4. 配置数据库字段映射为 sys_depart.id
5. 在“扩展属性”中填写如下 JSON 配置：

   
   {
     "table": "sys_depart",
     "textField": "depart_name",
     "valueField": "id",
     "parentIdField": "parent_id"
   }
         

三、系统字典与接口返回规范

为了确保前端组件能正确渲染树结构，后端接口必须返回符合格式的树状数据。例如：

[
  {
    "id": "1",
    "departName": "总部",
    "parentId": "0",
    "children": [
      {
        "id": "2",
        "departName": "技术部",
        "parentId": "1",
        "children": []
      }
    ]
  }
]
  

该结构应遵循递归嵌套方式，前端组件才能识别并渲染为树形或下拉树结构。

四、常见问题与排查方法

问题现象	可能原因	解决办法
部门数据无法加载	未正确关联 sys_depart 表字段	检查扩展属性配置是否匹配字段名
树形结构显示异常	接口返回数据格式错误	使用 Postman 检查 API 返回是否为标准树结构
选择框无数据	权限配置限制访问 sys_depart 表	检查用户角色是否有对应菜单权限和数据权限

五、流程图分析

graph TD
      A[开始] --> B[创建或编辑在线表单字段]
      B --> C{字段类型选择}
      C -->|部门选择器| D[配置sys_depart表字段]
      C -->|树形数据| E[设置树形结构参数]
      D --> F[检查系统字典或API接口]
      E --> F
      F --> G{数据是否正确返回?}
      G -->|是| H[前端正常渲染]
      G -->|否| I[调试接口/调整SQL语句]

六、高级配置建议

• 可结合 JeecgBoot 的动态 SQL 功能，按组织架构动态筛选部门数据
• 若存在多层级机构管理需求，建议启用 data_source_type 字段区分数据源
• 对于大型企业系统，推荐引入缓存机制（如 Redis）提升部门数据读取效率
• 可自定义部门字段展示模板，实现更复杂的 UI 效果