报表数据源配置总翻车？这篇 JNPF 实操指南，小白也能 10 分钟搞定！

做报表建模时，数据源配置总踩坑？

要么 SQL 语句写错导致数据加载失败，要么配置式关联表混乱，要么数据接口参数不会填？

这篇超详细实操指南，从 SQL 语句、配置式到数据接口三种配置方式，再到数据转换技巧，一步步拆解 JNPF 报表数据集配置全流程，新手也能快速上手，再也不用对着界面发呆！

1. 数据源配置

点击添加数据集按钮，展示数据集新建页面，默认为 sql 语句配置页 数据集名称默认自动生成，名称可修改，生成规则：DataSet+随机数 6 位

在数据源配置页中，可设置数据集及数据转换。配置数据集后，点击单元格，单元类型选择数据集，字段名称下拉展示数据集中的字段，单元格绑定字段后，预览页面单元格可展示数据集对应数据

1.1 sql 语句配置

• 点击添加数据集，选择 sql 填写页面，填写正确 sql 语句及数据集名称后保存，数据字段展示在左侧

• 点击

• ，可对 sql 进行修改

• 点击

• ，可删除该数据集

1.2 配置式配置

• 点击添加数据集，选择配置式配置页面

• 点击新增数据库表，右侧展示数据库表设置

• 点击请选择，弹窗展示当前数据库连接下的所有表

• 数据表选择后，回显所选数据库表的所有字段，展示字段名和字段描述，默认全部勾选

• 可进行条件筛选，条件设置支持自定义、系统参数

• 注：当前位置设置条件筛选，即在数据预览中，展示的是当前表条件筛选后的数据；后续其他表与其进行连接，也是取当前表筛选后的字段与后续表进行连接

• 保存后，回显示页面中

• 点击刷新数据，展示配置的数据源数据

• 点击 sql 预览，展示当前配置式相应的 sql，可进行复制

• 点击筛选设置，可添加条件组

• 可进行条件筛选，条件设置支持自定义、系统参数

• 筛选设置后，即在配置式查询结果的基础上，再次进行条件筛选

• 结果集筛选，默认选中所有数据，即展示所有数据，点击下拉，支持以下类型

• 选择前 N 条数据，填写具体数据，前 10 条，则数据最终只展示条件筛选后的前 10 条数据

• 将鼠标移动至配置式的表上，展示添加及删除按钮

• 点击删除，弹窗提示，点击取消，取消删除操作；点击确定，删除数据库表

• 点击添加，右侧展示数据库表设置，选择后，展示字段名和字段描述，默认全部勾选，展示条件筛选，展示数据连接

• 数据连接为必填

• 数据连接配置关联关系，关联关系支持左连接、右连接、内连接、全连接（mysql 不支持）

• 点击新增关联字段，展示表单相应字段，不勾选的字段则不展示

• 点击条件筛选，条件设置支持自定义、系统参数，条件筛选设置后，即在两张表的筛选结果上，再增加条件进行筛选

规则说明：1、树形配置式规则：只有 1 个顶级数据表，层级最多 3 层，每个数据表只允许连接 2 张数据表。将层级配置和连接表配置参数放置在服务端配置文件中。2、必填、必选规则：数据集名称必填、数据源必选、关联字段必填、勾选数据表字段名最少选择 1 个字段。3、关联关系规则：只允许 2 张表进行关联。关联字段至少有 1 组字段关联。4、单数据源规则：切换数据源时会清空所有配置（含设计的连接表）5、树形删除规则：删除树形时默认删除全部子集 6、保存规则：SQL 语句和配置式选中哪个页面时保存则生效哪个数据集配置 7、别名规则：数据库两张表做连接查询时，默认在数据库表前面加上别名（别名标识如：a_表名、b_表名.....），其他表会根据字母顺序进行排序（字母_表名、字母_字段名），同一张表下‘字母_’是相同的，数据集中显示别名标识。8、条件规则：字段类型支持 double、bigint、date、time、text。默认值为 text。字段类型条件如下：

1.3 数据接口配置

• 点击添加数据集，选择数据接口。展示数据接口下拉框，点击展示数据接口，数据接口过滤掉：鉴权、真分页、SQL 的增加、修改、删除类型；所选数据集需配置字段列表，否则保存或刷新提示请先设置数据接口的字段列表！

• 若数据接口存在参数，则展示在下方，可选择参数来源及参数值

• 选择参数来源为自定义时，参数值需手动输入，选择参数来源为系统参数时，参数值为下拉框选择。

• 点击刷新数据，展示接口预览数据

2. 其他配置

2.1 数据转换配置

• 点击数据转换，可进行数据转换配置

• 点击添加后，字段下拉数据展示表字段，转换类型展示如下（部分类型转换可通过

• 修改为不同格式），设置后，可将数据库数据转换为控件相应展示数据

注意事项-数据转换

以上就是 JNPF 报表数据源配置的完整操作逻辑，不管是简单的 SQL 查询，还是多表关联的配置式操作，或是数据接口的参数配置，跟着步骤走就能少踩 90% 的坑。如果在实操中遇到特定场景（比如多表层级关联、特殊字段转换），可以在评论区留言交流～后续还会分享报表建模的进阶技巧，关注我，避免错过干货！

要不要我帮你整理一份数据源配置常见问题排查清单，涵盖配置失败、数据不展示、关联报错等高频问题及解决方案？