LFW打印模板技术红皮书_V63

1、 LFWV63查询模板技术红皮书LFWV63查询模板技术红皮书 UAP中心 编著目录第一章前言21.1 前言3第二章打印模板开发42.1打印模板开发的组成部分简介52.2打印模板开发配置过程52.2.1 打印模板设计5第一章 前言UAP 技术红皮书系列 第20 / 19页本章内容概要：l 前言1.1 前言打印模板功能比较描述简单，概括说就是用户设计模板，然后合并模板输出打印客户端的数据。V63版本对打印模板做了一些调整，加入了系统打印模板。打印模板中总体分为系统打印模板和个性化打印模板，系统打印模板需要预置但不可以分配，个性化打印模板可分配。相比较于V61版本，一个节点下最多存在一个系统打印模

2、板(除该功能节点下可以配置模板分配节点，允许配置系统打印模板)。 和其它打印方式不一样的地方，通过安装OBA插件，在Word中添加“用友UAP模板”设计器，设计Word模板并将其余XML数据源合并生成一个新的Word文档，并通过其它插件(阮航)打开 。注：打印模板如果需要安装OBA插件进行模板设计时，只能安装office2007进行安装OBA插件第二章 打印模板开发本章内容概要：l 打印模板开发的组成部分简介l 打印模板开发配置过程2.1 打印模板开发的组成部分简介打印模板应用首先需要了解的是哪些地方需要使用到打印模板打印模板分为系统打印模板和个性化打印模板，打印条件都来自于系统打印模板，个性

3、化打印模板可以分配不用用户、角色和组织，并且在使用系统打印模板和个性化打印模板的时候，都需要设计上传Word模板：Word模板可以分为离线设计和在线设计模式：1、 离线Word模板设计离线Word模板设计大致可以分为以下几个步骤： 模板打印条件的编辑 模板打印条件的导出 新增Word模板，设计Word模板 上传Word模板2、 在线Word模板设计在线Word模板设计大致可以分为以下几个步骤： 模板打印条件的编辑 打开在线Word模板设计 保存Word模板设计模板打印的主要为三大模块： 设计完成的Word模板 数据源 合并模板与数据，输出结果2.2 打印模板开发配置过程2.2.1 打印模板设计

4、总体来说，打印模板开发配置过程有3大模块2.2.1.1打印模板设计态打印模板设计可以分离线设计和在线设计，但是这个是在编辑好打印条件的前提下，首先要了解打印条件的开发配置过程 编辑打印条件注：这个功能只针对于系统打印模板，因为个性化模板不存在编辑打印条件功能，个性化模板和系统打印模板公用一条打印条件，因此在使用个性化模板导出条件时，会先检查是否预置了系统打印模板。通过选择元数据主体，然后通过展开元数据，选择需要的条件至右侧的条件列表中：根据所选元数据，解析元数据，获取属性列表：如元数据ID为beanId； IBusinessEntity bean = (IBusinessEntity) mdq

5、ry.getBeanByID(beanId)；List attrList = bean.getAttributes()；Iterator it = attrList.iterator()；while(it.hasNext()IAttribute attr = it.next() /获取元数据元素然后将展开的元数据写入左侧的Dataset，通过绑定一个树，然后展开。在右侧选择的打印条件中，需要注意的是：如果针对哪个字段打印图片、条形码、二维码时，需要选择该该字段，然后“数据属性解锁”，就可以将该字段的数据类型设置成可选择状态，选择图片数据类型，然后在参照编码中选择具体的图片类型(包括一般图片、二

6、维码、条形码)选择具体图片类型，然后点击“确定”保存打印条件。然后是模板的设计开发过程 离线设计根据设计好的条件导出文件，生成XML文件，因为个性化模板和系统打印模板都是公用一套打印模板条件，因此对于是个性化模板的时候，需要去寻找系统打印模板，然后再去获取打印条件，在uap.lfw.imp.print.base.CpPrintWordOperatorManager中添加方法onImportXml()方法导出XML文件，如：在nc.uap.ctrl.tpl.print.impl.CpPrintXmlServiceImpl中实现方法importXml(String pk_template)输出xm

7、l文件的代码：通过拼写成xml文件结构生成xml文件，保存在本地一个_xml文件，即可然后在本地新建一个word文档，将生成的_xml文件导入到word文档中点击“打开”，word将_xml文件作为元数据生成下面右侧的模板设计结构然后可以根据右侧的模板进行设计保存word文件，离线设计过程完成，然后就是将设计好的模板上传到服务器上供下载或打印使用。在nc.uap.ctrl.tpl.print.CpPrintInitCtrl中添加方法onWordUpload(MouseEvent mouseEvent)模板上传：在uap.lfw.imp.print.base.CpPrintWordOperato

8、rManager中添加方法onWordUpload()具体实现过程：其中，在url中的参数filepk是针对当前模板中是否存在已经上传的模板文件，如果存在，上传模板只是更新文件内容；不存在，则是新增一行保存文件。通过file.jsp打开url请求服务，打开文件选择弹出框选择文件，点击“保存”，将文件上传到服务器上保存，并调用参数中设置的extendclass=“nc.uap.ctrl.tpl.print.WordUploadExtender”将上传文件的文件pk_file回写到当前上传文件模板的pk_file文件，更新当前选择打印模板，并且修改文件的保存状态。 在线设计打印条件和离线设计一样，

9、选择一个打印模板，点击“模板”中的打印模板在线设计：在nc.uap.ctrl.tpl.print.CpPrintInitCtrl中条件方法onLineTemplate(MouseEvent mouseEvent)实现方式在uap.lfw.imp.print.base.PrintOnLineDesignManager添加方法onlineDesigner()具体实现打印模板在线设计过程通过word.jsp打开url请求响应，触发action，具体实现；在nc.uap.ctrl.tpl.print.action.OnlineWordAction中方法down(Param(name=“id”) Str

10、ing id)：在uap.lfw.imp.print.base.CpPrintTemplateManager中方法onlineDesignTemplateMerger(String id，outputStream out)具体实现word在线设计过程如果选择的打印模板中未上传模板文件，则新增一个空的word模板；反之，则使用已上传的word模板打开，并且在打开word模板文件之前，先获取打印条件并将与获取的word模板文件合并生成一个新的Word文档，然后通过officeControl控件打开，然后就可以在线设计模板。注：设计模板方式选择word中“用友UAP模板” 可以选择“控件”中文本 选

11、择右侧模板设计中的一个字段，进行绑定2.2.1.2数据源根据客户端展现信息，搜集可使用的数据，为打印提供详细数据信息，在抽象类nc.uap.ctrl.tpl.print.init.PrintAbstractService中实现了接口nc.uap.ctrl.tpl.print.init. ICpFreeFormTemplatePrintService和接口nc.uap.ctrl.tpl.print.init. ICPPrintExtendService，其中PrintAbstractService实现了两个接口，并且在该抽象类中设置了一些属性，需要在继承该类时设置，如属性datasetList为

12、当前单据中所有主dataset列表，在调用打印之前需要设置该属性，才能通过当前单据获取到客户端详细数据，如nc.uap.ctrl.tpl.print.init.DefaultPrintService中，它继承了PrintAbsractService属性flowhistoryPk为单据ID，设置该单据ID，可以获取单据的历史流程信息然后根据模板设置中是否流程实体来判断打印流程历史信息。属性winId为当前单据模板ID属性nodeId为当前单据模板的节点编码根据winId和nodeId可以获取到个性化模板，如果不存在个性话模板的话，则获取当前模板，具体实现：通过比较当前模板ID和设置winId，判断是前台打印还是后台打印，如果是后台打印的话，需要获取到个性化模板(特别是针对于自定义项，设置了不同类型，只能通过个行化模板才能字段最后类型)。2.2.1.3打印模板运行态打印运行态，主要通过界面按钮点击“打印”，然后打印服务，如：可以调用默认打印服务，设置当前dataset列表和当前单据ID，实现打印，然后调用打印接口，具体实现在nc.uap.ctrl.tpl.print.,imp