1、创新技术推动应用进步北京润乾信息系统技术有限公司润乾报表（开发版）技术白皮书北京润乾信息系统技术有限公司创新技术推动应用进步北京润乾信息系统技术有限公司目录第 1 章 总体说明 .61 软件概述 .62 架构图 .63 产品构成 .7第 2 章 功能特点 .81 报表设计 .81) 类 Excel 的报表设计方式 .82) 单元格类型 .123) 套打绘制及相关功能 .134) 多数据源 .145) 内建数据集 .156) 表达式与函数 .157) 分片混合扩展与相关引用 .168) 灵活快捷的分组汇总 .169) 行列对称的扩展机制 .1710) 层次座标 .1711) 子报表 .1712)
2、 统计图的定义 .1813) 报表参数与宏 .2014) 向导与工具 .212 报表服务器 .241) 报表展现输出 .242) 多源关联报表 .33创新技术推动应用进步北京润乾信息系统技术有限公司第 3 章 部署与应用方案 .691 报表设计模式 .691) 本地设计（独立应用） .692) 集成（远程）设计 .702 报表应用部署方式 .711) J2EE 的 B/S 应用 .712) 非 J2EE 的 B/S 应用 723) Windows 下的 GUI 应用 .724) Java Application.733 数据报送应用方式 .741) 联机填报 .742) 脱机填报 .754 支
3、持环境 .76第 4 章 性能指标与控制 .771 性能分析 .771) 决定运算速度的关键 .772) 并发数量 .772 实测指标 .781) 容量 .782) 响应 .783) 并发 .78第 5 章 集成接口 .791 数据源 .791) JDBC.79创新技术推动应用进步北京润乾信息系统技术有限公司2) 数据文件和自定义数据源 .792 JAVA API.801) 数据源与连接池 .812) 运算与展现 .813) 报表模板 .813 前端接口 .821) JSP/HTML.822) ActiveX 与 DLL .834 设计器接口 .841) 模板文件远程访问 .842) 自定义函
4、数登记 .84第 6 章 特点与优势总结 .841 非线性报表模型 .842 全面的细节优化 .853 纯 JAVA 报表软件 .854 丰富的 API 接口 865 强有力的填报功能 .866 开放的系统 .877 可靠的本土支持 .87创新技术推动应用进步北京润乾信息系统技术有限公司第 1 章 总 体 说 明1 软 件 概 述润乾报表是用于报表制作及数据填报的大型企业级报表软件，它提供了高效的报表设计方案、强大的报表展现能力、灵活的部署机制，并且具备强有力的填报功能，配合以全面的用户权限管理、报表调度功能和交互功能，为企业级统计分析、展现提供了高性能、高效率的报表系统解决方案。润乾报表软件
5、的核心特点在于开创性地提出了非线性报表数学模型，采用了革命性的多源关联分片、不规则分组、自由格间运算、行列对称等技术，使得复杂报表的设计简单化，以往难以实现的报表可以轻松实现，避免了大量的复杂 SQL 编写与前期数据准备，报表设计的效率提高了一个数量级。润乾报表是一个纯 Java 报表工具，提供了全面的 API 接口，是开发 Web 报表软件的理想选择。Java 报表工具的跨平台特性，使得它能很好地支持大型系统的需要。润乾报表不需安装控件，采用标准的纯 HTML 的 Web 报表，支持 ie、netscape 等多种浏览器，可以支持 PDF，Excel 等输出，提供了全面的页面与打印控制，并且
6、能够满足 Web 报表的多种展现需要。同时，润乾报表对图表有良好的支持，可以生成柱图、饼图、折线图、仪表盘、雷达图、甘特图、双轴柱线图等三十几种图表。2 架 构 图创新技术推动应用进步北京润乾信息系统技术有限公司总体架构图3 产 品 构 成润乾报表由报表模板设计工具润乾报表设计器和一系列的功能组件组成，润乾报表的各项功能都被封装在各个独立的功能组件中，组件之间可以无缝拼合，方便挂接和拆卸，灵活的组件组装机制可以保证按照客户企业需要量身订制解决方案，同时，也为将来功能升级带来方便。报表设计器设计编辑报表模板，自带报表运算引擎，连接数据库后可预览打印报表，可导出以其它格式保存。报表设计器可独立工作
7、，以 Java 应用程序（JavaApplication）的形式提交。开发版设计器 无 RAT 输出；无导出 /打印组件功能开发版服务器 多源关联报表，可以同时读取多数据源中的数据，并对其进行相互关联计算。创新技术推动应用进步北京润乾信息系统技术有限公司开发版增强统计套件非线性增强算法模块，提供除多源关联之外的其他非线性功能，如增强函数、枚举分组、动态格间计算等。开发版即时报表套件 即时报表，相当于一个 WEB 端的、纯 HTML 方式的报表向导。第 2 章 功 能 特 点1 报 表 设 计1) 类 EXCEL 的 报 表 设 计 方 式类 EXCEL 的 编 辑润乾报表采用类 Excel 的
8、方式进行报表的绘制和编辑，如下图：润乾报表主编辑界面采用类 Excel 的可视化网格式编辑方案，不仅可以以可所见即所得的方式绘制出复杂表样，而且可免去使用传统控件拖拽式编辑时对齐数据项的繁琐，在保证格式整齐美观的同时大幅提高绘制效率，避免打印与显示因分辨率不一致而出现的失真现象。另外，熟悉 Excel 使用的人员相当多，类 Excel 的报表设计方式显然更易于报表绘制工作的上手。这种方案已逐步成为报表样式绘制方案的主流。创新技术推动应用进步北京润乾信息系统技术有限公司类 Excel 的单元格组织机制导 入 EXCEL 文 件直接用设计器打开 excel 文件：润乾报表可直接打开用 Excel
9、绘制好的报表格式，然后在报表设计器中进一步修改，以充分保护用户以往在 Excel 上的积累，大大减少重复工作。Excel 原表创新技术推动应用进步北京润乾信息系统技术有限公司润乾报表直接打开 Excel 报表格式（设计器中可直接打开 xls 文件）导入 excel 文件：润乾报表提供自动将 excel 文件转换为报表模板 raq 文件的功能。导入 excel 文件（自动转换为 raq）公 式 调 整插入行列时的公式调整：润乾报表在编辑过程中能够象 Excel 一样自动调整公式，如在单元格 B1 中引用了 C1，当B 列和 C 列间插入一列时，引用的 C1 将会自动变成 D1，这对于报表中表达式
10、编辑非常必要。原报表，B2 中的表达式引用了 C2 和 D3创新技术推动应用进步北京润乾信息系统技术有限公司在 C 列前插入一列后，B2 格的表达式自动调整为 D2 和 E3拷贝剪切粘贴时的公式调整：从 B1 复制粘贴到 B2、B3等单元格，表达式自动由=C1+D1 变成=C2+D2、=C3+D3 等等。界 面 及 基 本 功 能润乾报表提供了非常美观的外观界面，可有多种配色风格。产品采用全中文菜单和对话框，常用的编辑手段均有快捷工具条以提高设计效率。在编辑过程中，提供缩放编辑功能，可以根据需要灵活设置缩放比例，更方便地进行报表的格式调整。在报表设计器中，可直接预览报表。标准版设计器支持直接打
11、印报表或导出为Excel、Word、PDF、Html、Txt、xml 等外部文件格式。还支持 RAT 输出，RAT 文件是润乾报表自有的文件格式，用以保存运算后的报表结果，其中带有统计图、纸张打印信息等，可由润乾报表设计器打开查看以实现报表的脱机浏览（不依赖于第三方软件且可在 UNIX 上显示），并可打印或再次输出成上述几种格式的文件。2) 单 元 格 类 型润乾报表的单元格支持如下四种基本类型：创新技术推动应用进步北京润乾信息系统技术有限公司 文本：一般的数值、文字及表达式，可以支持斜线。这种类型可以通过象 Excel 一样的表达式，从数据库中提取数据和进行各种计算。该类单元格的显示值可与数
12、据值分开，从而实现内部代码与显示之间的对应，显示内容可来自固定列表，也可来自数据库中的字典表。 图片文件：固定的图片，如企业 LOGO。 图片字段：来自数据库字段的图片，如人员照片。 HTML：单元格内的文字（或表达式的运算结果）被理解成为一段 HTML 代码，在报表WEB 展现时将被嵌入整个报表的 HTML 文本中，从而可实现用户自定义显示或编辑方案。通过各种类型的单元格，可以在报表中添加各种元素，实现各种复杂的报表。润乾报表的单元格类型还支持以下两种特殊类型： 子报表：单元格中嵌入或引入一个子报表。 统计图：单元格中嵌入一个统计图。3) 套 打 绘 制 及 相 关 功 能底 图 描 绘 实
13、 现 套 打 绘 制润乾报表采用底图描绘的方案解决套打时的报表绘制问题。可将需要套打的票据扫描成图片，作为报表设计的底图，然后依照图片上格线进行报表描绘，可保证绘制出的报表能够精确地套打进入印刷票据中。创新技术推动应用进步北京润乾信息系统技术有限公司底图描绘方式进行套打绘制（下面的表格及黑色字是底图，蓝色字是填入的数据）精 确 度 量润乾报表提供以毫米或像素为单位的精确度量，可保证报表的绘制和输出完全与纸张精准一致。并会根据纸张大小在设计界面中画出纸边虚线，以提示设计人员分页位置。4) 多 数 据 源润乾报表支持多数据源，同一张报表的数据来源可以是多个数据集甚至是多个数据库或是用户自定义的数据
14、集。通过这一功能，不仅可以采集来自不同来源的数据，更重要的是在润乾报表中可以在报表内直接使用多个不同数据集，而不需要强行用复杂的视图把它们连接在一起，从而大大提高了报表设计效率和提高了灵活性。创新技术推动应用进步北京润乾信息系统技术有限公司润乾报表多数据源 数据源的定义画面润乾报表支持多种数据集5) 内 建 数 据 集润乾报表支持内建数据集，即某个数据集的数据被写进报表模板文件之中，内建数据集和外部数据集有完全同样的运算，如扩展、过滤等。内建数据集可有如下应用：完 成 不 规 则 分 组大量中国复杂报表均可能有不规则分组要求（比如选择若干个城市显示相关的数据），润乾报表可以将这些不规则分组（如
15、可重分组、固定分组）方案设置进仅与当前报表相关的内建数据集中，而不必在数据库中创建冗余的数据表或视图。脱 机 浏 览创新技术推动应用进步北京润乾信息系统技术有限公司润乾报表提供将外部数据集转换为内建数据集的功能，这样即可将已做好的报表数据源绑定进报表，从而做到脱机（不连接数据库）运算和浏览，这一功能对于远程调试报表有巨大帮助（远程技术人员可以不必依赖于用户的数据环境而调试报表中的错误）。内建数据集绑定报表数据以实现脱机运算和浏览6) 表 达 式 与 函 数表 达 式润乾报表支持基于数据集和基于单元格的两类表达式，并且可以混合书写，如ds1.sum( amount )；B3+C3+sum(D3)
16、 ； ds1.select( id, typeid=C2)等。函 数润乾报表提供九大类系统函数：数据集函数、单元格函数、数学函数、字符串函数、日期时间函数、数据类型转换函数、数据类型判断函数、分页后运算函数、统计图运算函数。同时也允许用户自定义 JAVA 函数。润乾报表的函数功能非常强大，除了常规的计算函数外，更针对报表和统计分析的需要提供了特有的集合处理函数，可用以实现报表自动扩展、分组等变化。例如，润乾报表提供 Plot函数实现中国复杂报表中常见的按段分组需求，也可以实现多层或交叉分段汇总。7) 分 片 混 合 扩 展 与 相 关 引 用创新技术推动应用进步北京润乾信息系统技术有限公司润乾
17、报表摒弃传统条带扩展方案而采用单元格扩展机制，可以很容易完成同一报表中的分片扩展（并列或层次均可），并可实现固定行列与变动行列混合编排。各扩展片之间还可相互引用数据而并非完全无关。8) 灵 活 快 捷 的 分 组 汇 总润乾报表可简单完成带有多级分组与汇总的报表，采用单元格分组函数实现分组扩展，没有明显的分组区域，从而在增删分组或改变分组次序时不必象传统报表工具需要重新设计分组区内数据表达式。润乾报表独创的主格关联机制决定了统计汇总的范围，汇总表达式可以摆放在报表中任何合理的位置（分组上/下边或在分组明细同行合并成一个大格）。多级分组汇总报表9) 行 列 对 称 的 扩 展 机 制润乾报表行列
18、对称设计，无须专门的交叉表模型处理列向变动的报表。多层、分片交叉报表均可轻松实现，不限制层数，并可同样编写自由的汇总运算。创新技术推动应用进步北京润乾信息系统技术有限公司多层分片交叉汇总报表10) 层 次 座 标润乾报表独创的层次坐标和位移坐标概念能够对扩展后单元格/集进行命名，从而可以在表达式中精确描述出对其它单元格的引用，完美地解决自由格间运算。有规律的单元格跨行组运算可轻松实现，对于无规则的任意运算，润乾报表还提供类 Excel 式的格间运算。11) 子 报 表润乾报表支持不限嵌套层数的子报表功能。子报表分为引入式和嵌入式两种，引入式将子表数据和格式依次填到主表的单元格中，而嵌入式则将整
19、个子表缩放后嵌入到主表的某个单元格中。创新技术推动应用进步北京润乾信息系统技术有限公司嵌入式主子表引入式主子表12) 统 计 图 的 定 义统 计 图 常 规 定 义创新技术推动应用进步北京润乾信息系统技术有限公司润乾报表的统计图数据来源于报表内而非重新再设置数据源，因而也可以支持多表多库的统计图。同一张报表可绘制多个统计图，甚至可绘制在分组内，随着数据分组一起扩展成多个。统计图类型及数据定义 图形特性定义显示外观定义 时间状态图定义属 性 的 扩 展 和 外 围 产 品 的 支 持润乾报表提供强有力的统计图开发接口，支持通过二次开发和第三方产品，实现丰富的展现效果。创新技术推动应用进步北京润
20、乾信息系统技术有限公司在一些特殊情况下，系统提供的默认统计图如果都不能满足要求，那么就可以利用自定义统计图。自定义统计图可以满足任意一种特殊的统计样式和效果。只需要符合 API 接口即可实现，更为灵活。由于报表自身的单元格能支持嵌入 HTML 元素，所以还可以将其他支持交互的动态元素作为插件，和报表共同工作，实现一些更为美观和有特殊交互功能的展示效果。13) 报 表 参 数 与 宏润乾报表提供报表参数功能。参数具有数据类型，可以用于报表的数据源（SQL 语句）或报表中的运算表达式中。报表参数定义创新技术推动应用进步北京润乾信息系统技术有限公司数据集 sql 语句中使用参数参数的类型有普通参数、
21、动态参数和会话变量。 普通参数普通参数直接将输入的参数值传给报表进行运算。 动态参数动态参数是一个表达式（不用等号开头），报表运算时先解析该表达式，然后将表达式计算出的结果作为参数值传给报表进行运算，用动态参数的时候要注意参数的数据类型。动态参数适用于需要动态解析表达式的场合。 会话变量会话变量是指和用户个人信息相关的一些变量，比如用户名、岗位、部门、职位、角色等等，有了会话变量，就可以识别这个人的身份，知道这个人拥有哪些权限。用户在登录报表设计系统时，系统会读取该用户的会话变量，利用会话变量生成一些过滤条件，并把这些过滤条件强制叠加到报表中，这些过滤条件可以过滤掉这个用户不该看到的数据。于是
22、能够保证用户只能看到自己有权限看到的数据。创新技术推动应用进步北京润乾信息系统技术有限公司除参数外，润乾报表还提供特有的宏。宏没有数据类型，仅是简单地在语句或表达式中替换，给使用者提供更加灵活的控制方式。宏的类型分普通宏和动态宏。普通宏是直接将宏值传到报表中计算，动态宏是先计算传进来的宏，然后再把计算得到值做为宏值传到报表中参与计算。14) 向 导 与 工 具润乾报表软件提供了强有力的辅助工具，可以帮助用户更方便、更高效地进行报表设计。报 表 设 计 向 导润乾报表对于简单的行式、分组与交叉报表提供设计向导，用户只需要选择相应的数据表列即可以自动生成出报表。分组报表定义向导创新技术推动应用进步
23、北京润乾信息系统技术有限公司交叉报表定义向导SQL 编 辑 器润乾报表提供标准 SQL 编辑对话框，用户不必记忆数据库表/字段名称，可直接在 SQL 编辑器中选择要操作的数据元素，设计查询、排序条件等。同时润乾报表也支持直接输入 SQL 语句。创新技术推动应用进步北京润乾信息系统技术有限公司SQL 语句编辑器（字段选择）公 式 编 辑 /函 数 帮 助润乾报表提供可视化的表达式编辑对话框，用户不必记忆系统提供的众多函数与需要操作的数据集元素，表达式的大部分都可以简单地用鼠标点击出来，而且对所有系统函数均有详细的在线帮助。公式编辑器创新技术推动应用进步北京润乾信息系统技术有限公司函数帮助2 报
24、表 服 务 器1) 报 表 展 现 输 出报 表 元 素 的 外 观 属 性润乾报表对报表元素提供非常丰富的外观属性，所有属性都支持值和表达式两种设置方式，非常灵活易用。创新技术推动应用进步北京润乾信息系统技术有限公司单元格外观属性列表 值 值 显示格式：支持数值、货币、日期、时间、分数、科学计数等数十种显示格式。创新技术推动应用进步北京润乾信息系统技术有限公司单元格显示格式 显示值：支持显示值和数据值分开，从而实现内部代码与实际显示之间的对应。 显示 可视：设置当前单元格是否可见。 隐藏行/列 前景色/背景色：均支持调色板和透明显示。 尺寸调整方式：提供按单元格内容扩大、按设计尺寸不变、图片
25、填满单元格、缩小字体填充四种方式。 段落 自动换行：设置当前单元格的数据值长度超出单元格的宽度时，是否自动换行。 水平/纵向对齐：靠左、居中、靠右/靠上、居中、靠下。 缩进：与对齐配合，设置靠哪边就相对哪边缩进，居中时则相对两边同时缩进。 字体创新技术推动应用进步北京润乾信息系统技术有限公司 字体、字号 加粗、斜体、下划线 扩展 扩展方式：默认、纵向扩展、横向扩展、不可扩展。 左主格/上主格：不设置时按照缺省主格认定规则。 超链接 超链接：路径可以是相对路径也可以是绝对路径。 超链接窗口：超链接在网页上显示的目标窗口，缺省为_self。 分页 分页时伸缩：横向扩展表时保证标题居中或居右，适用于
26、除报表头、分组表头、数据区和表尾区以外的区域。 行/列后分页 单元格拆分：设置当分页断开正好位于合并格的中间时，合并格里的值是否拆分后在两页里显示。 WEB 变量名：在 html 网页上引用该单元格的数据值时使用的变量名，或参数模板中与目标报表中对应的参数名。 HTML 事件 提示：在 web 上发布报表后，鼠标移动到改单元格位置时所显示的提示信息。 其他 注释创新技术推动应用进步北京润乾信息系统技术有限公司 打印时能否修改：控制打印前是否可以修改该单元格中的数据。图 片 显 示 与 大 字 段 上 传润乾报表支持图片显示，可以支持的图片包括图片文件和图片字段，也支持自定义来源的图片。图片格式
27、支持 gifpngjpg 等。图片显示大字段上传润乾报表的大字段上传，不仅仅支持图片格式的文件，还支持其他格式的文件，例如 word文档、压缩包等等，只不过只有图片格式的文件才可以显示在报表中，其他格式的文件仅仅提供上传，不支持显示。统 计 图润乾报表支持如下 20 多种类型的统计图： 柱形图创新技术推动应用进步北京润乾信息系统技术有限公司 三维柱形图 三维簇状柱形图 堆积柱形图 三维堆积柱形图 饼图 三维饼图 折线图 三维折线图 区域图 三维区域图 条形图 三维条形图 三维簇状条形图 堆积条形图 散列图创新技术推动应用进步北京润乾信息系统技术有限公司 时序状态图 时间走势图 双轴柱线图 双轴
28、折线图 雷达图 甘特图 仪表盘 等（还包含自定义统计图）针对不同需要，在浏览器上可生成如下三种图片类型 GIF：256 色，可透明显示，不失真压缩； JPG：真彩色，不可透明，失真压缩； PNG：真彩色，可透明，不失真压缩。页 面 （ HTML） 输 出润乾报表可在 WEB 上生成标准的纯 HTML 输出格式，对 IE5 和 Netscape7 以及上版本均可支持且效果一致。统计图也完全以纯 HTML 图片形式展现，浏览器端无须事先安装任何插件。润乾报表在 WEB 上的展示，可根据实际需要随意嵌入到网页的任何地方。除静态 HTML 外，润乾报表还可生成固定表头（上/左均可）的可滚动报表以及行式分组可伸缩报表，大大方便了用户的使用。
