JimuReport积木报表 — SQL数据源报表带参展示
2026-10-24 17:36:25
JimuReport积木报表 — SQL数据源报表带参展示
在JimuReport积木报表中，SQL数据源报表带参展示是一个常见的需求，它允许用户通过传递参数来动态地查询和展示数据。以下是实现这一功能的详细操作步骤：
一、数据源编辑与查看
点击“编辑”按钮
首先，在积木报表的设计界面中，找到需要编辑的SQL数据源报表，并点击其“编辑”按钮。这将打开数据源的编辑界面。
修改SQL语句
在数据源编辑界面中，找到SQL语句编辑区域。为了添加参数，需要在SQL语句中使用特定的格式来标识参数，即'${}'。例如，如果我们要根据性别（sex）来筛选数据，可以在SQL语句中写入类似'WHERE sex = '${sex}'的语句。
拼写格式：'${}'
点击SQL解析：在SQL语句编辑区域下方，点击“SQL解析”按钮。这将打开一个对话框，用于配置参数的详细信息。
参数：即${}里面的内容，如sex。
参数文本：即参数的描述，用于帮助用户理解该参数的含义。
默认值：可以为参数设置一个默认值，当没有传递该参数时，将使用默认值进行查询。
点击确定按钮：配置完参数信息后，点击确定按钮即可添加成功。
页面访问传参
完成SQL语句和参数的配置后，点击“保存”和“预览”按钮对信息进行保存，并预览报表。在预览时，需要在浏览器地址栏中手动输入参数。参数的格式应为?参数名=参数值，如果有多个参数，则使用&符号连接，如?sex=1&name=2。
示例：如果我们要查询性别为“男”的数据，可以在浏览器地址栏中输入?sex=男。
二、菜单配置
为了方便用户通过菜单直接访问带参数的报表，我们需要在系统中配置菜单。
复制浏览器的链接
首先，在预览报表时，复制浏览器地址栏中的完整链接。这个链接包含了报表的路径和参数信息。
在系统管理菜单管理进行配置
登录到积木报表的管理后台，找到“系统管理”->“菜单管理”模块。
点击新增按钮填写信息
在菜单管理界面中，点击“新增”按钮，填写新菜单的信息。注意以下几点：
前段组件：必须按照格式填写layouts/IframePageView。
链接地址：用{{ window._CONFIG['domianURL'] }}代替IP地址、端口号和项目名称，并附加报表的路径和参数信息。例如，如果复制的链接是
http://localhost:8080/report/preview?sex=男，则填写为{{ window._CONFIG['domianURL'] }}/report/preview?sex=男（注意，实际使用时需要去掉sex=男的默认值，因为用户可能会通过菜单传递不同的参数）。末尾必须携带参数：如?sex（但不需要指定默认值，因为用户会通过菜单传递实际值）。
是否为路由菜单：选择“是”。
角色授权
最后，在系统管理->角色授权模块中，找到对应的角色，并为其授权刚才创建的菜单。这样，拥有该角色的用户就可以通过菜单直接访问带参数的报表了。
路径：系统管理->角色授权->找到自己对应的角色，鼠标放到“更多”->“授权”。
勾选菜单：在授权界面中，勾选刚才创建的菜单。
刷新页面：授权完成后，刷新页面即可看到新菜单。
通过以上步骤，我们就成功实现了在JimuReport积木报表中SQL数据源报表带参展示的功能。用户现在可以通过菜单直接访问并传递参数来查询和展示所需的数据。
热门标签
