LFW打印模板技術紅皮書_V63

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

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

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

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

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

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

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

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

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

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