链接：https://pan.baidu.com/s/1oj6D4LT9YMSydyD6vh_9Hw 

提取码：a7bx 

 

1 相关概念

1.1 打印

1.1.1 套打

EAS中的套打，并不仅仅是指在印刷好的票据、单据上打印内容的。更为全面而准确的定义，应该是指：自定义格式的票据、单据、报表等数据的打印。其中，自定义格式是指用户可以自己制作模板。由于名称的沿袭，一直采用套打一词。

 

1.1.2 序时簿打印

ListUI中表格控件的打印，通常也称为序时簿打印。它是将表格中的数据直接打印输出。有些业务场景，菜单中会同时出现打印与套打，请注意区别。序时簿打印不在本文讨论范围内，有关内容可参考框架及KDTable控件的说明。

 

1.2 套打管理中的文件

现将EAS系统平台——套打——套打管理中出现各种文件介绍如下。

 

1.2.1 KDF（kdrs-form）

KDF系列的Form格式，是传统的套打模板格式，对应*.kdrs-form的模板文件。不推荐使用（模板由新的格式——R1代替，老用户已存在的KDF模板可继续执行），以后将不再提供技术支持。

 

1.2.2 ReportOne（r1-print）

ReportOne系列的打印格式，是新的（用于取代KDF格式的）套打模板格式，对应*.r1-print的模板文件。以下或简称为R1。另有文档介绍模板规则。

 

1.2.3 套打元数据

*.bos-query。业务集成时定义了一些字段名称，供模板设计时绑定用，和BOS的元数据Query没有必然的关系（视集成代码，可能会对应一个Query，也可能完全没有关系）。如果使用R1模板，允许没有套打元数据，因为在模板设计器中可以直接引用BOS的Query。（请注意，直接引用Query的情况，只是模板中有一个引用信息，未必执行时就查询该Query，仍然要视集成代码而定。参考集成开发的说明。）

 

1.2.4 套打动态查询

*.note-dynquery。是在EAS执行期在套打管理中提供的对BOS Query的增量修改，可作为R1套打模板的元数据。（与直接引用Query相同，执行时依赖于集成代码是否做了实现。）

 

1.3 代码相关概念

1.3.1 KDNoteHelper

com.kingdee.bos.ctrl.report.forapp.kdnote.client.KDNoteHelper类提供了统一的套打调用API。

1.3.2 数据提供者

套打控件只识别取数接口（现在也提供查询Query的缺省实现DefaultNoteDataProvider，且推荐使用），具体的取数实现都是各业务集成时各自实现。对于实现取数接口的、给套打执行时提供数据的类，称之为DataProvider——数据提供者。

 

2 集成开发

2.1 套打调用

业务开发中，通常界面上会有[打印]/[打印预览]按钮，在框架的EditUI类中，会有actionPrint_actionPerformed或actionPrintPreview_actionPerformed方法与之对应，套打的调用代码写在这样的方法或类似的方法(ListUI可能不同)中。请注意，在ListUI中，我们还提供了对表格控件的打印，通常称之为序时簿打印，请注意区别。

以下接口都是KDNoteHelper类的。

2.1.1 打印

API：

public void print(String templateType, Object dataProvider, Component owner, boolean isShowPrinterDialog)