检索栏设置

栅格布局

检索栏用于把用户输入写入全局作用域,再将这些值传给数据集入参。完整链路是:

检索控件 → 映射字段(全局作用域变量)→ 数据集入参 → 查询 → 报表刷新

配置顺序:

  1. 在数据集中定义查询需要的入参。
  2. 在全局作用域中创建类型匹配的变量。
  3. 将数据集入参注入对应的作用域变量。
  4. 放置检索控件,并把控件“映射字段”设置为同一个作用域变量。
  5. 配置选项数据源、默认值、校验和响应器。
  6. 放置搜索/重置按钮,保存后进行预览。

验证方法:预览时修改控件值并点击搜索,确认请求参数变化且报表数据随之变化;点击重置后,确认控件和作用域恢复到初始状态。

常见问题:控件能输入但查询条件不生效,通常是控件映射字段和数据集入参没有绑定同一个作用域变量,或变量类型与入参类型不一致。

报表检索栏的作用是在预览时,通过一些指定的检索条件,过滤出符合条件的数据。检索栏在设计器的筛选条件区进行配置,有编辑跟显示两个按钮。

点击编辑按钮则进入检索栏的编辑状态,上方展示了检索栏可以使用的一些控件,通过拖拽可以将控件放置到下方,我们可以自由调整控件的放置位置,所有拖拽出来的控件根据栅格布局进行展示,点击完成编辑则退出编辑状态。如下图所示:

点击显示按钮则进入检索栏的预览状态,我们可以看到已经配置好的检索栏的控件和样式,在该状态下可以点击编辑按钮进去编辑状态,也可以点击隐藏按钮退出预览状态。

栅格布局就是网格布局,基本原理基于将容器划分为一个或多个网格轨道(Grid Tracks),这些轨道通过行(Grid Rows)和列(Grid Columns)组成,形成网格单元格(Grid Cells)。

用栅格布局的原因是能同时处理行和列,适用于复杂的页面布局,并且可以动态调整网格的大小、位置和比例。在设计器中,我们选中其中一列后,可以在右侧配置面板中调整该列在一行中所占的列数,还可以调整左侧的间隔格数,如下图所示:

一行一共有24列,拖入的组件可以通过栅格布局进行排布,想要删除已经放入栅格布局的控件,可以选中该控件然后点击右下角的删除按钮。

如下图所示,是一个典型的栅格布局,有两行,第一行放了三列,每列栅格占据的列数是8,第二行放了4列,前两列栅格占据的列数是8,后两列栅格占据的列数是4。