BOSV6.2开发指南_套打二次开发.pdfVIP

BOS 开发指南_套打二次开发 阅读指引：本文目的在于指导EAS 二次开发人员，正确书写套打功能的集成代码。有 关原理说明，也适合实施人员阅读。理想状态下，套打应该是不需要二次开发再写代码的； 但由于历史原因、或特殊需求，可能需要二次开发。本文所述内容，适合EAS v5.9 、v6.0 ， EAS v5.4 也可参考。 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)