CN102830947A - 一种基于报表打印模板格式实现的报表打印控件 - Google Patents

Abstract

本发明提供了一种基于报表打印模板格式实现的报表打印控件，用以实现报表模板格式与数据分离，由报表打印控件引擎将数据引入模板，并格式化出打印文件。使用本发明提供的报表打印模板与打印控件，将大大简化各种应用程序打印功能的开发，软件开发人员也能在不修改应用程序代码的基础上对报表格式进行调整。

Description

一种基于报表打印模板格式实现的报表打印控件

技术领域

本发明属于软件应用系统的设计与开发技术，提供一种报表打印的模板定义方法和基于该模板的控件实现，采用报表数据与显示格式分享的技术，使报表打印开发易于修改和维护。

背景技术

在当今的业务管理信息系统开发中，报表打印功能是一项重要的功能，一般来说，当开发打印程序时，软件开发者必须使用如C#等开发语言来创建打印程序，为打印功能创建专有的打印代码，并要为打印报表的排版、位置、线条和数据手动编写代码，由于各类工具创建的打印程序的底层语言是复杂的，所以软件开发者无法容易地在现在应用程序不修改的情况下对报表格式进行调整。在C/S的开发模式下，打印功能的开发不同的软件开发工具有不同的方法，基本上报表的数据与打印的格式都写在程序中，修改和维护时要调整原程序，发布时重新更新可执行文件或部件，在B/S架构的系统中，客户端浏览器的打印功能很有限，很难在浏览器中实现精确的业务表单套打，在服务器中实现PDF打印也要求客户端安装比较复杂的PDF软件。当前一些报表设计器主要采用分区设计，典型的分为header页眉区、detail明细区和footer页脚区，这种设计将报表格式划分为相对固定的区域，实现中国区的复杂报表就比较难，本发明将detail明细区的功能由记录集数据域来实现，header页眉区由显示页号属性来实现，footer页脚区由跟随对象来实现，使用报表的格式定义更自由，能更灵活地表达报表格式。

因此，需要一种新的技术方案以解决上述问题。

发明内容

针对上述现有技术所存在的问题和不足，本发明的目的是提供一种基于报表打印模板格式实现的报表打印控件，使报表打印开发易于修改和维护。

为实现上述目的，本发明基于报表打印模板格式实现的报表打印控件可采用如下技术方案：

一种基于报表打印模板格式实现的报表打印控件，用以实现报表模板格式与数据分离，由报表打印控件引擎将数据引入模板，并格式化出打印文件。

优选的，所述报表打印模板格式将报表格式设定为由纸张、字体、线条、矩形、图片、文本标签、单项数据域、表格数据域和记录集数据域组成。

优选的，该报表打印控件基于ActiveX控件技术实现，包括读取报表打印模板接口、报表数据设置接口和打印接口，读取报表打印模板接口方法名为loadTemp，报表数据设置接口方法名为putData，打印接口名为print。

优选的，提供一种报表格式对象中的linkObj属性，用于实现复杂布局的报表打印。

优选的，提供格式化引擎格式化出打印文件，所述格式化引擎，包括以下格式化步骤：

a、检测报表打印模板中是否有记录集数据域，或有多个记录集数据域；

b、如果步骤a中无记录集数据域，打印的总页数为模板中其它元素定义的最大页数，如果步骤a中有记录集，则进入步骤c；

c、取记录集数据域关联的报表数据，根据记录集数据域的分页属性计算该记录集数据域的页数；

d、报表打印的总页数为各记录集数据域中页数最大的。

本发明提供一种报表打印的模板定义和基于该模板的打印控件的实现方法，本发明描述的报表打印模板将报表的格式和报表的数据分离，采用MVC设计模式将报表抽象为模板格式定义(View)、报表数据（Model）和打印控件引擎(Controller)三部分，报表打印模板格式定义由本发明所提供的格式元素组成，设计精巧的模板格式元素能将报表模板格式灵活地描述，并很好地将报表模板格式与报表数据分离，报表模板格式一般用XML来描述，但不限于用XML，在符合本发明报表模板格式定义的规范下，可以用自定义格式的文本定义，不依赖于任何具体的开发语言，报表模板还可以独立于应用程序，单独存放并能复用。本发明所描述的打印控件引擎负责对报表模板定义进行格式化，并提供报表数据接口，打印软件可以使用本发明提供的打印控件数据接口提供报表的动态数据。

使用本发明提供的报表打印模板与打印控件，将大大简化各种应用程序打印功能的开发，软件开发人员也能在不修改应用程序代码的基础上对报表格式进行调整。

附图说明

图1为本发明基于报表打印模板格式实现的报表打印控件的总体结构图

图2为本发明基于报表打印模板格式实现的报表打印控件中格式化引擎描述图。

具体实施方式

下面结合附图和具体实施方式，进一步阐明本发明，应理解下述具体实施方式仅用于说明本发明而不用于限制本发明的范围，在阅读了本发明之后，本领域技术人员对本发明的各种等价形式的修改均落于本申请所附权利要求所限定的范围。

名词解释：

ActiveX: 微软的组件技术，主要用于开发可用于Web的控件；

C/S: 一种软件架构,客户端访问数据库服务器；

B/S:  一种软件架构,使用浏览器作为客户端；

XML:  一种基本文本格式的数据交换方法，用来描述数据的标记语言。

报表打印的模板格式包括纸张、字体、线条、矩型框、图片、文本标签、单项数据域、表格数据域和记录集数据域等格式对象组成。

报表打印纸张属性由纸张类型、纸张宽度、纸张高度、上边柜、下边柜、左边柜和右边柜组成，打印纸张属性使用XML DTD描述为;

字体列表包括报表使用的所有字体的属性定义，其它对象使用字体时只关联字体的ID号，简化为报表对象的定义，字体的属性由名称、字体大小、是否为粗体、是否为斜体组成，

字体属性使用XML DTD描述为:

线条格式对象描述报表中的直线和斜线，包括线条的打印起始位置、线条的长度、线型、线宽、显示页号、跟随对象，使用XML DTD描述为：

显示页号pageNum是指该线条显示在打印报表的第几页，显示页号为0时表示所有页面都要打印该线条，一般用在打印报表的页眉等格式时。

跟随对象linkObj是本发明对位置相对复杂的元素设计的一个灵活的属性，它指定该元素位置是相对的，不是绝对的位置，linkObj指定跟随对象是打印对象中的记录集数据域对象，每一页中记录集数据域格式化为表格时，高度是动态的，所有跟随于记录集数据域的报表对象的位置在报表格式化中动态确定，跟随对象linkObj是借鉴了当前一些报表设计器的思想，但实现方式不一样，当前一些报表设计器主要采用分区设计，典型的分为header页眉区、detail明细区和footer页脚区，这种设计将报表格式划分为相对固定的区域，实现中国区的复杂报表就比较难，本发明将detail明细区的功能由记录集数据域来实现，header页眉区由显示页号属性来实现，footer页脚区由跟随对象来实现，使用报表的格式定义更自由，能更灵活地表达报表格式。

矩型格式对象描述报表中的线框，属性包括起始位置、矩型长宽、线型、线宽、边框类型、显示页号、跟随对象，本发明中的矩型格式对象可以对边框类型设置不同的值实现折线和对角线的打印，边框类型转换为二进制时，从低位到高位字节依次表示左边框、上边框、右边框、下边框、左对角线和或对象线，使用XML DTD描述为：

图片格式对象描述报表中的图片，属性包括图片文件名\起始位置、图片打印大小、图片打印方式，显示页号、跟随对象，使用XML DTD描述为：

文本标签格式对象描述报表中静态文本，使用XML DTD描述为：

单项数据域格式对象描述报表中的单项数据的打印格式，区别于表格数据和记录集数据，单项数据域有全局唯一name属性，数据域的数据由外部程序使用接口putData放入，调用的方式为putData(单项数据域name,数据值)，属性包括名称、打印位置、打印大小，显示页号、边框类型、边框宽度、边框模式、跟随对象、对齐方式和显示模式，使用XML DTD描述为

本发明描述的单项数据域格式的属性drawMode设置为Fit时，可以根据文本的长度自动使用大小合适的字体进行打印，以防止数据超长被截掉。单项数据域格式继承了矩型格式对象的所有属性，所以矩型格式对象的特性单项数据域也支持。

表格数据域是描述报表中有固定行数和列数的二维打印内容，它由列(Column)和行(Row)子格式对象组成，其中的一行一列为一个单元格，单元格可以看作单项数据域，表格数据域有全局唯一的标识名称，由属性name提供，它的宽度等于各列的宽度之和，高度等于各行高度之和，表格数据域的列数与行数是固定的，如果表格的记录数不确定，可以使用记录集数据域来描述，表格数据域的二维数据由接口putData提供，调用方式为putData(表格数据域name, 表格数据域单元格数据，行号，列号)，表格数据域使用XML DTD描述为：

列格式对象的使用XML DTD描述为：

行格式对象使用XML DTD描述为：

记录集数据域是本发明描述的报表打印模板的核心格式对象，用于报表明细数据的打印，也是ActiveX打印控件引擎格式化的重要依据，记录集数据域只包括列格式对象，列格式对象与表格数据域的列格式对象相同，记录集数据域不包含行格式对象，行高由height属性定义，记录集数据域可以灵活按多栏形式显示，由colNup和rowNup属性来定义，colNup表示纵向分栏数目，每栏之间的空白宽度由gapWidth属性定义，rowNup表示模向分栏数目，每栏之间的空白高度由gapHeight属性定义，分栏的数据填充顺序可以由上至下或由左至右，由dataFill属性定义，记录集数据域实现首页与非首页上下起始位置单独设置，由属性nextTop和nextBottom定义，isPadding属性用于一些报表需要使用空行来填充最后一页的记录，

记录集数据域的报表数据与表格数据域的数据类似，由外部程序调用ActiveX打印控件的putData接口设置，调用方式为putData(记录集数据域name,表格数据域单元格数据，行号，列号)，使用XML DTD描述为：

图1从总体上描述本发明的主要组成，首先要对打印的报表进行格式分析，按本发明提供的格式对象，将报表的打印格式进行定义，如表1所代表的报表：

表1：

表1具有代表性，按本发明的格式对象，可以描述为：

表1打印报表的数据主体为data记录集数据域，由于打印的列不多，一张A4大小的标准纸张可以分两个纵向的栏，所以设置记录集数据域data的colNup=2，标题文本由Label定义，并设置pageNum=0和 linkObj="data"，引擎格式化时将标题在每一个栏中复制打印，实现标题分栏的效果。Label text="制表人"是由跟随属性来决定位置，设置linkObj="data"和默认的pageNum=1，引擎格式化时计算出data记录集数据域当前页的实际高度后，再将”制表人"的位置计算出来，并只在每页的第一栏中跟随，区别于表格的标题Label，因为两个对象的pageNum不一样，所以引擎可以进行不同的处理。

报表格式模板定义完成后，可以将模板文件作为资源独立存放，也可以作为应用程序的内部定义，ActiveX的接口loadTemp可以读入模板文件或模板资源，当读入模板文件时调用loadTemp(String temp)，参数temp指明模板文件的位置，可以是本地也可以是远程，当temp为XML格式时，引擎将temp本身作为模板读入。

外部应用程序使用ActiveX的数据设置接口将报表打印的数据转入引擎，调用方法为:

putData(格式对象名称，数据，行，列)

行与列参数不传时，引擎认为是对单行数据域进行设置

外部应用程序使用ActiveX的打印接口，实现打印,调用方法为:

print(flag)

flag参数用于设置打印时是否显示操作系统的标准打印对话框

打印时ActiveX控件主要进行格式化步骤，如图2所示，包括以下格式化步骤：

a、检测报表打印模板中是否有记录集数据域，或有多个记录集数据域；

b、如果步骤a中无记录集数据域，打印的总页数为模板中其它元素定义的最大页数，如果步骤a中有记录集，则进入步骤c；

c、取记录集数据域关联的报表数据，根据记录集数据域的分页属性计算该记录集数据域的页数；

d、报表打印的总页数为各记录集数据域中页数最大的。

Claims (5)

1.一种基于报表打印模板格式实现的报表打印控件，用以实现报表模板格式与数据分离，其特征在于：由报表打印控件引擎将数据引入模板，并格式化出打印文件。

2.根据权利要求1所述的基于报表打印模板格式实现的报表打印控件，其特征在于：所述报表打印模板格式将报表格式设定为由纸张、字体、线条、矩形、图片、文本标签、单项数据域、表格数据域和记录集数据域组成。

3.根据权利要求1或2所述的基于报表打印模板格式实现的报表打印控件，其特征在于：该报表打印控件基于ActiveX控件技术实现，包括读取报表打印模板接口、报表数据设置接口和打印接口，读取报表打印模板接口方法名为loadTemp，报表数据设置接口方法名为putData，打印接口名为print。

4.根据权利要求1或2所述的基于报表打印模板格式实现的报表打印控件，其特征在于：提供一种报表格式对象中的linkObj属性，用于实现复杂布局的报表打印。

5.根据权利要求1或2所述的基于报表打印模板格式实现的报表打印控件，其特征在于：提供格式化引擎格式化出打印文件，所述格式化引擎，包括以下格式化步骤：

a、检测报表打印模板中是否有记录集数据域，或有多个记录集数据域；

b、如果步骤a中无记录集数据域，打印的总页数为模板中其它元素定义的最大页数，如果步骤a中有记录集，则进入步骤c；

c、取记录集数据域关联的报表数据，根据记录集数据域的分页属性计算该记录集数据域的页数；

d、报表打印的总页数为各记录集数据域中页数最大的。

Images