接口后台分页适用于接口类数据源。启用后，系统会在每次预览或翻页时，把当前页码和每页条数写入接口入参，然后根据接口返回的总记录数计算总页数。
适用数据源
接口后台分页支持以下数据源类型：
- 低代码服务中心
- Http 请求
- Rpc 框架标准请求
- Rpc 标准请求
前置条件
使用接口后台分页前，需要接口本身支持分页查询：
- 接口入参中存在当前页字段，例如
pageNo。 - 接口入参中存在每页条数字段，例如
pageSize。 - 接口返回结果中存在总记录数字段，例如
total、body.total。 - 接口返回当前页列表数据，报表继续按普通出参数据集方式绑定字段。
注意：“出参总条数”表示总记录数，不是总页数。系统会根据“总记录数 / 每页条数”自动计算总页数。
配置项说明
| 配置项 | 说明 | 示例 |
|---|---|---|
| 当前页参数 | 翻页时写入当前页码的接口入参字段。第一页为 1。 |
pageNo、query.pageNo |
| 每页条数参数 | 翻页时写入每页条数的接口入参字段。 | pageSize、query.pageSize |
| 出参总条数 | 从接口返回结果中读取总记录数的字段。 | total、body.total |
其中，“每页条数参数”配置的是接口入参字段路径，不是直接填写每页条数数值。实际传入接口的每页条数来自引擎配置中的 pageSize，默认值为 10。
使用步骤
- 在数据源设置中配置接口数据源，并完成入参和出参定义。
- 确认接口入参中已定义当前页字段和每页条数字段。
- 确认接口出参中已定义总记录数字段。
- 在报表中绑定接口返回的数据字段，完成报表模板设计。
- 打开“引擎属性”。
- 勾选“启用后台分页”。
- 在接口分页配置中选择“当前页参数”“每页条数参数”“出参总条数”。
- 保存后进行预览。
