Appearance
一、子报表核心概念
1.1 什么是子报表
子报表（SubReport）是嵌套在主报表模板内、完全独立的附属报表模块，核心作用并非实现主从明细数据关联，而是将多个完全独立、业务无关的报表模板合并为一个整体，实现一次性拼接打印、统一导出输出。
子报表拥有独立的数据源、独立的布局样式、独立的统计逻辑，与主报表不存在主键关联、一对多绑定关系。简单理解：主报表+多个子报表 = 一套完整的合并打印单据合集，如同医院就医时打印机一次性输出病情说明、治疗单、付款单、取药单多张独立单据，所有内容一次性连续打印输出。
核心定位：解决单报表只能展示单一业务数据的局限，实现多维度、多模块、独立业务报表的拼接整合输出。
1.2 核心适用场景
所有需要一次性合并打印多张不同维度、无主从关联报表的场景，均需使用子报表开发，系统典型场景如下：
- 收银每日汇总报表：主报表展示门店日销售总览，嵌套多个子报表，分别输出商品类别销售统计、收款方式统计、优惠折扣统计、报废商品统计、退货明细统计，多模块数据拼接为一份完整日报
- 仓储综合台账报表：主报表展示仓库基础信息，子报表分别嵌套货架档案统计、货位物料汇总、库存盈亏统计、出入库流水报表，合并输出仓储全维度台账
- 业务综合单据打印：盘点业务汇总单为主报表，子报表嵌套盘点差异表、漏盘明细表、盈亏原因统计表，一次打印全套盘点资料
- 多单据合并输出场景：类似医院多单据批量打印，系统支持将汇总报表、明细报表、统计报表、备注说明报表等各类独立模板，通过子报表拼接，实现一键批量输出
1.3 子报表核心优势
- 业务整合性强：将分散的多维度独立报表整合为一体，无需单独打印多张报表，一键完成全套资料输出
- 完全独立解耦：子报表与主报表、子报表与子报表之间数据、布局、逻辑完全独立，互不干扰、互不依赖
- 复用性极高：单个子报表模板可独立开发，可被多个主报表嵌套调用，无需重复开发同类统计模块
- 维护便捷：单一业务模块数据、样式修改，仅需对应调整子报表，不影响主报表和其他附属报表
- 输出规整统一：多报表拼接后自动适配分页、行距、排版，输出格式统一，规避多张单独打印报表格式混乱、页码错乱问题
二、子报表、主从明细报表核心区别（重点区分）
日常开发中极易混淆子报表（合并打印）与主从明细报表（一对多关联），二者核心逻辑完全不同，具体差异如下：
| 对比项 | 主从明细报表（一对多） | 子报表（本功能定义） |
|---|---|---|
| 核心逻辑 | 数据层级关联，主数据过滤明细数据 | 多独立报表拼接，纯打印整合，无数据关联 |
| 数据关系 | 存在主键外键关联，一条主记录对应多条明细 | 主报表与子报表、子报表之间无任何数据关联、无字段绑定 |
| 渲染规则 | 主记录循环，明细跟随主记录逐条渲染 | 主报表、所有子报表各自独立渲染，按排版顺序拼接输出 |
| 适用场景 | 单据表头+单据明细、档案+附属明细 | 多维度统计合并打印、多独立单据批量输出 |
| 依赖关系 | 明细完全依赖主数据，无法独立存在 | 每个子报表均可独立运行、独立预览，仅打印时拼接整合 |
三、子报表核心设计原理
3.1 核心运行逻辑
子报表的核心是报表拼接与合并输出，无任何主从过滤、数据绑定逻辑。报表机器在渲染时，会按页面排版顺序，依次加载主报表、各个子报表的独立数据源，分别完成渲染后，自动拼接为一整套完整报表文档，统一进行预览、打印、导出操作。
标准运行规则：
- 主报表：承载整体报表标题、汇总总览、基础公共信息，为整套合并报表的载体框架
- 子报表：每个子报表对应一套独立业务数据、独立SQL、独立布局，互不干扰
- 渲染顺序：自上而下依次渲染主报表、子报表1、子报表2、子报表3……，自动处理分页衔接
- 数据逻辑：各模块数据完全独立，无需关联字段、无需主从匹配
3.2 标准子报表组成结构
作为独立的附属报表模块，单个子报表标准结构包含3个核心部分，结构完整、独立可用：
- 子栏：一个单独的BAND（报表带），用来放置子报表控件
- 子报表容器（SubReport控件）：嵌套在子栏中的承载容器，用于包裹整套独立子报表内容，控制模块位置、宽度、间距
- 独立报表主体：包含子报表专属标题、自定义字段布局、数据展示行、统计行，完全独立设计
- 独立数据源：每个子报表配置专属SQL数据集，单独查询对应业务数据，与主报表数据源完全隔离
四、子报表完整开发设计步骤（标准规范）
4.1 前期需求与数据准备
开发子报表前，梳理整套合并报表的模块拆分，明确各模块独立业务数据：
- 定义主报表模块：确定主报表承载的公共内容，如报表标题、统计日期、门店信息、整体汇总数据
- 拆分独立子报表模块：按业务维度拆分附属报表，例如日报拆分：类别销售统计、收款统计、报废统计、退货统计，每个维度单独作为一个子报表
- 配置独立数据源：为每个子报表编写专属查询SQL，各自查询对应业务数据，无需关联主报表字段
- 校验数据独立性：确保每个子报表可单独执行SQL、单独预览输出，无数据依赖
4.2 主报表基础布局配置
- 打开报表设计器，搭建主报表基础框架：整体报表标题、公共参数展示区域、主汇总数据区域、页脚信息
- 根据业务需求，在主报表对应位置插入多个子栏，子栏的位置是无所谓的，可以随便放
- 每个子栏放上一个【子报表控件（SubReport）】
- 设置某个BAND（边条）打印完成以后调用一个子栏，如果我们不需要子报表反复打印，我们就应该选择只出现一次的BAND来调用子栏，例如：总结 和 主项汇总 这样类型的BAND边带。
- 绑定子栏是很容易的，设置 子带区 属性即可
- 如果我们需要的子报表太多了，现有的BAND边带不够用怎么办？我们可以让 子栏 再来定义他的 子带区，嗯 就是你想的这样，套娃 套娃 ... ...
- 调整每个子报表容器样式：宽度和高度这些是不重要的，重要的是 —— 必须保证，子报表控件完全落在 子栏 里面，如图
- 核心禁忌：无需配置主从关联、无需绑定主表主键，彻底摒弃一对多关联逻辑
4.3 子报表独立布局开发（核心步骤）
每个子报表均为独立报表（子报表是一个单独的页面），需单独完成该报表的布局设计：
- 进入子报表编辑界面：切换页面，进入子报表设计画布，各子报表编辑互不影响
- **编辑注意事项：**跟普通的报表一样进行编辑，也需要定义数据字典（将需要的数据集合拉进来），也需要放主项数据带和指定主项数据源，没有什么特殊的设置方法，特别需要注意的是 —— 设置页面类型和大小，尽量跟主报表的页面类型大小相同。
- 绑定专属数据源：为当前子报表添加独立数据集，配置专属查询SQL，加载对应业务数据
- 搭建子报表结构：按需添加子报表标题Band、表头Band、数据Band、汇总Band，完整搭建独立报表样式
- 字段排版设计：拖拽当前子报表数据源字段，完成对齐、字体、边框、颜色样式配置
- 独立样式配置：单独设置子报表分页规则、空数据展示规则、表头续打规则
- 单独预览校验：单个子报表可独立预览，确认数据、样式无误后，再退出编辑
4.4 整体预览调试与发布
- 整体拼接校验：预览完整报表，检查主报表、所有子报表是否按顺序正常渲染，无缺失、错乱、重叠
- 数据独立性校验：确认各子报表数据互不干扰，修改某一个子报表数据/样式，不影响其他模块
- 多场景测试：测试全数据、部分数据、空数据场景，测试分页打印、导出Excel/PDF效果
- 定稿发布：调试无误后保存模板，完成合并报表功能发布
五、开发注意事项与性能优化
- 数据隔离优化：严格保证主报表、各子报表数据源独立，禁止共用数据集、禁止跨模块数据关联，从根源避免数据错乱
- 渲染性能优化：精简各子报表冗余控件、空白Band，优化单模块SQL查询效率，避免多子报表同时渲染导致卡顿
- 维护优化：每个子报表单独命名、标注业务用途、备注SQL功能，方便多人开发、后续迭代修改
- 打印适配优化：所有子报表统一适配跟主报表页面相同的打印尺寸，控制列数宽度，避免明细列过多导致打印溢出、排版错位
- 功能适配优化：根据业务场景灵活配置子报表显示/隐藏，支持动态控制部分模块按需输出，提升报表通用性