LFW打印模板技術(shù)紅皮書(shū)_V63

1、 LFWV63查詢(xún)模板技術(shù)紅皮書(shū)LFWV63查詢(xún)模板技術(shù)紅皮書(shū) UAP中心 編著目錄第一章前言21.1 前言3第二章打印模板開(kāi)發(fā)42.1打印模板開(kāi)發(fā)的組成部分簡(jiǎn)介52.2打印模板開(kāi)發(fā)配置過(guò)程52.2.1 打印模板設(shè)計(jì)5第一章 前言UAP 技術(shù)紅皮書(shū)系列 第20 / 19頁(yè)本章內(nèi)容概要：l 前言1.1 前言打印模板功能比較描述簡(jiǎn)單，概括說(shuō)就是用戶(hù)設(shè)計(jì)模板，然后合并模板輸出打印客戶(hù)端的數(shù)據(jù)。V63版本對(duì)打印模板做了一些調(diào)整，加入了系統(tǒng)打印模板。打印模板中總體分為系統(tǒng)打印模板和個(gè)性化打印模板，系統(tǒng)打印模板需要預(yù)置但不可以分配，個(gè)性化打印模板可分配。相比較于V61版本，一個(gè)節(jié)點(diǎn)下最多存在一個(gè)系統(tǒng)打印模

2、板(除該功能節(jié)點(diǎn)下可以配置模板分配節(jié)點(diǎn)，允許配置系統(tǒng)打印模板)。 和其它打印方式不一樣的地方，通過(guò)安裝OBA插件，在Word中添加“用友UAP模板”設(shè)計(jì)器，設(shè)計(jì)Word模板并將其余XML數(shù)據(jù)源合并生成一個(gè)新的Word文檔，并通過(guò)其它插件(阮航)打開(kāi) 。注：打印模板如果需要安裝OBA插件進(jìn)行模板設(shè)計(jì)時(shí)，只能安裝office2007進(jìn)行安裝OBA插件第二章 打印模板開(kāi)發(fā)本章內(nèi)容概要：l 打印模板開(kāi)發(fā)的組成部分簡(jiǎn)介l 打印模板開(kāi)發(fā)配置過(guò)程2.1 打印模板開(kāi)發(fā)的組成部分簡(jiǎn)介打印模板應(yīng)用首先需要了解的是哪些地方需要使用到打印模板打印模板分為系統(tǒng)打印模板和個(gè)性化打印模板，打印條件都來(lái)自于系統(tǒng)打印模板，個(gè)性

3、化打印模板可以分配不用用戶(hù)、角色和組織，并且在使用系統(tǒng)打印模板和個(gè)性化打印模板的時(shí)候，都需要設(shè)計(jì)上傳Word模板：Word模板可以分為離線設(shè)計(jì)和在線設(shè)計(jì)模式：1、 離線Word模板設(shè)計(jì)離線Word模板設(shè)計(jì)大致可以分為以下幾個(gè)步驟： 模板打印條件的編輯 模板打印條件的導(dǎo)出 新增Word模板，設(shè)計(jì)Word模板 上傳Word模板2、 在線Word模板設(shè)計(jì)在線Word模板設(shè)計(jì)大致可以分為以下幾個(gè)步驟： 模板打印條件的編輯 打開(kāi)在線Word模板設(shè)計(jì) 保存Word模板設(shè)計(jì)模板打印的主要為三大模塊： 設(shè)計(jì)完成的Word模板 數(shù)據(jù)源 合并模板與數(shù)據(jù)，輸出結(jié)果2.2 打印模板開(kāi)發(fā)配置過(guò)程2.2.1 打印模板設(shè)計(jì)

4、總體來(lái)說(shuō)，打印模板開(kāi)發(fā)配置過(guò)程有3大模塊2.2.1.1打印模板設(shè)計(jì)態(tài)打印模板設(shè)計(jì)可以分離線設(shè)計(jì)和在線設(shè)計(jì)，但是這個(gè)是在編輯好打印條件的前提下，首先要了解打印條件的開(kāi)發(fā)配置過(guò)程 編輯打印條件注：這個(gè)功能只針對(duì)于系統(tǒng)打印模板，因?yàn)閭€(gè)性化模板不存在編輯打印條件功能，個(gè)性化模板和系統(tǒng)打印模板公用一條打印條件，因此在使用個(gè)性化模板導(dǎo)出條件時(shí)，會(huì)先檢查是否預(yù)置了系統(tǒng)打印模板。通過(guò)選擇元數(shù)據(jù)主體，然后通過(guò)展開(kāi)元數(shù)據(jù)，選擇需要的條件至右側(cè)的條件列表中：根據(jù)所選元數(shù)據(jù)，解析元數(shù)據(jù)，獲取屬性列表：如元數(shù)據(jù)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() /獲取元數(shù)據(jù)元素然后將展開(kāi)的元數(shù)據(jù)寫(xiě)入左側(cè)的Dataset，通過(guò)綁定一個(gè)樹(shù)，然后展開(kāi)。在右側(cè)選擇的打印條件中，需要注意的是：如果針對(duì)哪個(gè)字段打印圖片、條形碼、二維碼時(shí)，需要選擇該該字段，然后“數(shù)據(jù)屬性解鎖”，就可以將該字段的數(shù)據(jù)類(lèi)型設(shè)置成可選擇狀態(tài)，選擇圖片數(shù)據(jù)類(lèi)型，然后在參照編碼中選擇具體的圖片類(lèi)型(包括一般圖片、二

6、維碼、條形碼)選擇具體圖片類(lèi)型，然后點(diǎn)擊“確定”保存打印條件。然后是模板的設(shè)計(jì)開(kāi)發(fā)過(guò)程 離線設(shè)計(jì)根據(jù)設(shè)計(jì)好的條件導(dǎo)出文件，生成XML文件，因?yàn)閭€(gè)性化模板和系統(tǒng)打印模板都是公用一套打印模板條件，因此對(duì)于是個(gè)性化模板的時(shí)候，需要去尋找系統(tǒng)打印模板，然后再去獲取打印條件，在uap.lfw.imp.print.base.CpPrintWordOperatorManager中添加方法onImportXml()方法導(dǎo)出XML文件，如：在nc.uap.ctrl.tpl.print.impl.CpPrintXmlServiceImpl中實(shí)現(xiàn)方法importXml(String pk_template)輸出xm

7、l文件的代碼：通過(guò)拼寫(xiě)成xml文件結(jié)構(gòu)生成xml文件，保存在本地一個(gè)_xml文件，即可然后在本地新建一個(gè)word文檔，將生成的_xml文件導(dǎo)入到word文檔中點(diǎn)擊“打開(kāi)”，word將_xml文件作為元數(shù)據(jù)生成下面右側(cè)的模板設(shè)計(jì)結(jié)構(gòu)然后可以根據(jù)右側(cè)的模板進(jìn)行設(shè)計(jì)保存word文件，離線設(shè)計(jì)過(guò)程完成，然后就是將設(shè)計(jì)好的模板上傳到服務(wù)器上供下載或打印使用。在nc.uap.ctrl.tpl.print.CpPrintInitCtrl中添加方法onWordUpload(MouseEvent mouseEvent)模板上傳：在uap.lfw.imp.print.base.CpPrintWordOperato

8、rManager中添加方法onWordUpload()具體實(shí)現(xiàn)過(guò)程：其中，在url中的參數(shù)filepk是針對(duì)當(dāng)前模板中是否存在已經(jīng)上傳的模板文件，如果存在，上傳模板只是更新文件內(nèi)容；不存在，則是新增一行保存文件。通過(guò)file.jsp打開(kāi)url請(qǐng)求服務(wù)，打開(kāi)文件選擇彈出框選擇文件，點(diǎn)擊“保存”，將文件上傳到服務(wù)器上保存，并調(diào)用參數(shù)中設(shè)置的extendclass=“nc.uap.ctrl.tpl.print.WordUploadExtender”將上傳文件的文件pk_file回寫(xiě)到當(dāng)前上傳文件模板的pk_file文件，更新當(dāng)前選擇打印模板，并且修改文件的保存狀態(tài)。 在線設(shè)計(jì)打印條件和離線設(shè)計(jì)一樣，

9、選擇一個(gè)打印模板，點(diǎn)擊“模板”中的打印模板在線設(shè)計(jì)：在nc.uap.ctrl.tpl.print.CpPrintInitCtrl中條件方法onLineTemplate(MouseEvent mouseEvent)實(shí)現(xiàn)方式在uap.lfw.imp.print.base.PrintOnLineDesignManager添加方法onlineDesigner()具體實(shí)現(xiàn)打印模板在線設(shè)計(jì)過(guò)程通過(guò)word.jsp打開(kāi)url請(qǐng)求響應(yīng)，觸發(fā)action，具體實(shí)現(xiàn)；在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)具體實(shí)現(xiàn)word在線設(shè)計(jì)過(guò)程如果選擇的打印模板中未上傳模板文件，則新增一個(gè)空的word模板；反之，則使用已上傳的word模板打開(kāi)，并且在打開(kāi)word模板文件之前，先獲取打印條件并將與獲取的word模板文件合并生成一個(gè)新的Word文檔，然后通過(guò)officeControl控件打開(kāi)，然后就可以在線設(shè)計(jì)模板。注：設(shè)計(jì)模板方式選擇word中“用友UAP模板” 可以選擇“控件”中文本 選

11、擇右側(cè)模板設(shè)計(jì)中的一個(gè)字段，進(jìn)行綁定2.2.1.2數(shù)據(jù)源根據(jù)客戶(hù)端展現(xiàn)信息，搜集可使用的數(shù)據(jù)，為打印提供詳細(xì)數(shù)據(jù)信息，在抽象類(lèi)nc.uap.ctrl.tpl.print.init.PrintAbstractService中實(shí)現(xiàn)了接口nc.uap.ctrl.tpl.print.init. ICpFreeFormTemplatePrintService和接口nc.uap.ctrl.tpl.print.init. ICPPrintExtendService，其中PrintAbstractService實(shí)現(xiàn)了兩個(gè)接口，并且在該抽象類(lèi)中設(shè)置了一些屬性，需要在繼承該類(lèi)時(shí)設(shè)置，如屬性datasetList為

12、當(dāng)前單據(jù)中所有主dataset列表，在調(diào)用打印之前需要設(shè)置該屬性，才能通過(guò)當(dāng)前單據(jù)獲取到客戶(hù)端詳細(xì)數(shù)據(jù)，如nc.uap.ctrl.tpl.print.init.DefaultPrintService中，它繼承了PrintAbsractService屬性flowhistoryPk為單據(jù)ID，設(shè)置該單據(jù)ID，可以獲取單據(jù)的歷史流程信息然后根據(jù)模板設(shè)置中是否流程實(shí)體來(lái)判斷打印流程歷史信息。屬性winId為當(dāng)前單據(jù)模板ID屬性nodeId為當(dāng)前單據(jù)模板的節(jié)點(diǎn)編碼根據(jù)winId和nodeId可以獲取到個(gè)性化模板，如果不存在個(gè)性話模板的話，則獲取當(dāng)前模板，具體實(shí)現(xiàn)：通過(guò)比較當(dāng)前模板ID和設(shè)置winId，判斷是前臺(tái)打印還是后臺(tái)打印，如果是后臺(tái)打印的話，需要獲取到個(gè)性化模板(特別是針對(duì)于自定義項(xiàng)，設(shè)置了不同類(lèi)型，只能通過(guò)個(gè)行化模板才能字段最后類(lèi)型)。2.2.1.3打印模板運(yùn)行態(tài)打印運(yùn)行態(tài)，主要通過(guò)界面按鈕點(diǎn)擊“打印”，然后打印服務(wù)，如：可以調(diào)用默認(rèn)打印服務(wù)，設(shè)置當(dāng)前dataset列表和當(dāng)前單據(jù)ID，實(shí)現(xiàn)打印，然后調(diào)用打印接口，具體實(shí)現(xiàn)在nc.uap.ctrl.tpl.print.,imp