JeecgBoot项目中动态设置表格查询条件的实现方法

问题背景

在使用JeecgBoot框架开发时，很多开发者会遇到需要动态设置表格查询条件的需求。特别是在基于路由参数动态初始化查询表单的场景下，如何正确地为BasicTable组件的searchFormSchema属性赋值成为一个常见的技术难点。

核心问题分析

当开发者尝试通过直接修改searchFormSchema数组中的defaultValue属性来动态设置查询条件时，虽然数据能够成功传递，但页面却无法正确渲染这些动态设置的值。这种现象通常表现为：

1. 开发者通过路由参数获取到需要设置的查询值
2. 使用类似searchFormSchema[8].defaultValue的方式赋值
3. 控制台检查数据结构确认值已正确设置
4. 但页面UI上对应的查询条件输入框却显示为空

解决方案

经过技术验证，正确的实现方式应该是通过表单实例的方法来动态设置值，而不是直接修改schema配置。具体实现步骤如下：

1. 获取表单实例

首先需要获取到表单的实例对象，这可以通过JeecgBoot提供的getForm()方法实现：

const { setFieldsValue, getFieldsValue } = getForm();

2. 使用setFieldsValue方法

获取到表单实例后，使用其setFieldsValue方法来动态设置表单字段的值：

setFieldsValue({
  plnbez: '物料编号值',
  getri_begin: '2024-12-01',
  getri: '2024-12-01',
  getri_end: '2024-12-01'
});

3. 实现时机

这个设置操作应该在组件初始化完成后执行，通常可以放在onMounted生命周期钩子中：

onMounted(() => {
  // 获取路由参数
  const routeParams = useRoute().params;
  // 设置表单值
  const { setFieldsValue } = getForm();
  setFieldsValue({
    plnbez: routeParams.matnrStr,
    // 其他字段...
  });
});

技术原理

这种实现方式之所以有效，是因为：

1. 表单实例维护着自己的状态管理，直接修改schema配置不会触发表单的状态更新
2. setFieldsValue是Ant Design Form提供的API，它会同步更新表单状态和UI显示
3. 这种方法遵循了React/Vue的数据驱动原则，通过正规API操作而不是直接修改配置

最佳实践建议

1. 初始化顺序：确保在表单渲染完成后再调用setFieldsValue
2. 数据类型匹配：确保设置的值类型与表单字段定义的类型一致
3. 性能优化：对于大量字段的批量设置，建议合并为一次setFieldsValue调用
4. 错误处理：添加try-catch块处理可能的设置失败情况

扩展应用

这种动态设置表单值的方法不仅适用于表格查询条件，还可以应用于：

1. 表单编辑场景下的数据回填
2. 基于业务逻辑的动态表单值计算
3. 多步骤表单中跨步骤的数据传递
4. 表单联动场景下的值自动填充

通过掌握这种动态设置表单值的技术，开发者可以更灵活地实现各种复杂的业务表单交互需求。