Livecycle動態(tài)模板開發(fā)手冊

1、編號：V1.0Livecycle動態(tài)模板開發(fā)手冊2015年9月目錄1單證模板設(shè)計(jì)31.1創(chuàng)建表單31.2繪制表單51.2.1控件介紹51.2.2繪制過程111.3綁定數(shù)據(jù)141.4模板測試172數(shù)據(jù)文件生成193IDPDocEngineAgent安裝配置191 單證模板設(shè)計(jì)1.1 創(chuàng)建表單1. 使用LiveCycle Designer工具開發(fā)模板，首先打開工具，出現(xiàn)如下所示的頁面，點(diǎn)擊“新建表單”2. 選擇“使用空白表單”點(diǎn)擊“下一步”。3. 頁面大小可以選擇“默認(rèn)值”，也可以選擇“A4紙”，或者其他的一些頁面方向可以選擇“縱向”，或者是“橫向”，一般都是選擇“縱向”。頁面選擇“1”。點(diǎn)擊“下

2、一步”4. “添加電子表單按鈕”與“添加打印按鈕”可以勾選，也可以不勾選，一般不勾選點(diǎn)擊完成5. 出現(xiàn)如下所示的空白表單表單1（由“主頁面”以及“無標(biāo)題子表單”構(gòu)成的）1.2 繪制表單1.2.1 控件介紹 頁面控件如上圖所示，一個(gè)表單中主要包含兩類頁面元素：1. 主頁面主頁面的名稱通常以英文命名，支持定義多個(gè)主頁面1) 頁面設(shè)置當(dāng)需要使用特殊紙型時(shí)，需要在主頁面內(nèi)進(jìn)行定義。如下圖所示：2) 內(nèi)容區(qū)域設(shè)置每個(gè)主頁面中只能存在一個(gè)內(nèi)容區(qū)域（region-body區(qū)域），每個(gè)主頁面中元素可以按照下圖分5個(gè)區(qū)域放置，除內(nèi)容區(qū)外其他支持的4區(qū)域每個(gè)都對應(yīng)一個(gè)子表單subform，其名稱分別

3、為：region-before，region-after，region-start和region-end，并且只能設(shè)計(jì)為靜態(tài)（引用）元素。主頁面其他4個(gè)區(qū)域不能與內(nèi)容區(qū)域重合。內(nèi)容區(qū)域限定了以該內(nèi)容區(qū)域?yàn)榛A(chǔ)的普通頁面的可繪制范圍，通常我們可以理解為頁邊距。在一般場景下，如果沒有頁頭、頁尾、側(cè)邊文字等需要打印在每一頁上的內(nèi)容，僅繪制內(nèi)容區(qū)域范圍即可。內(nèi)容區(qū)域的大小可以通過內(nèi)容區(qū)域的布局屬性來進(jìn)行設(shè)置，如下圖所示：2. 普通頁面除每頁都需要打印的一些基礎(chǔ)內(nèi)容外，所有在單證中需要顯示的表單元素均需要繪制在普通頁面上。通過點(diǎn)擊頁面并對其對象屬性進(jìn)行設(shè)置可進(jìn)行以下頁面的個(gè)性化設(shè)置：1) 應(yīng)用主頁面在對

4、象->分頁屬性頁面中可以指定該普通頁面應(yīng)用的主頁面名稱，默認(rèn)為接上一子表單，如果該頁面是第一個(gè)頁面則默認(rèn)設(shè)置的主頁面是第一個(gè)主頁面。可通過點(diǎn)擊位置旁的索引按鈕選擇其他主頁面，如下圖所示：2) 頁面基礎(chǔ)屬性設(shè)置一個(gè)普通頁面也可以認(rèn)為是一個(gè)子表單，因此在對象->子表單屬性頁內(nèi)可以對頁面的布局方式、是否允許分頁等屬性進(jìn)行設(shè)置。n 內(nèi)容：設(shè)置該頁面內(nèi)的布局方式：流動 - 該頁面內(nèi)的所有控件從上到下按順序排列，循環(huán)的父頁面必須為流動的。固定 - 該頁面內(nèi)的所有元素均按照繪制時(shí)的位置展示。n 流向：順序排列的方向，目前只支持從上至下排列。n 是否允許在內(nèi)容中分頁：如該頁面內(nèi)的內(nèi)容有可能自動增長

5、并發(fā)生換頁，需要勾選該復(fù)選框，否則會導(dǎo)致?lián)Q頁失敗不能正常顯示。 基礎(chǔ)控件以下所有的基礎(chǔ)控件均可以通過在工作區(qū)域右側(cè)的對象庫中找到對應(yīng)的控件，并通過左鍵點(diǎn)擊拖拽的方式將其加入到當(dāng)前工作面板內(nèi)。1. 子頁面通常所有控件都需要繪制在子頁面內(nèi)（頂層的子頁面是普通頁），子頁面中也可以再包含多個(gè)子頁面。如下圖所示紅色圈出的均為子頁面：子頁面為重復(fù)打印的最小單位，具體設(shè)置參見2.3數(shù)據(jù)綁定部分。2. 表格對于需要循環(huán)打印的表格類的內(nèi)容，通常使用表格控件來繪制?？稍趯ο髱熘姓业奖砀窨丶献е凉ぷ鲄^(qū)域后自動彈出下圖的設(shè)置界面：n 列數(shù)：根據(jù)實(shí)際需要打印的列數(shù)進(jìn)行設(shè)置n 表體行數(shù)：如為動態(tài)表格設(shè)置

6、一行，如靜態(tài)表格則根據(jù)實(shí)際需要的行數(shù)進(jìn)行設(shè)定n 表頭行：通常勾選n 表尾行：根據(jù)實(shí)際需要決定是否勾選自動創(chuàng)建完成的表格如下圖所示：此時(shí)表頭和表體均為靜態(tài)文本，如需要展示動態(tài)域，可以點(diǎn)擊對象庫中的文本域控件，將其拖拽至表體的控件中，表體則會自動變更為控件域并自動調(diào)整控件大小。如下圖所示： 需要注意的是：表頭和表體的名稱需要設(shè)置為英文名稱。3. 其他控件目前可支持的包括：n 靜態(tài)文本n 文本域n 圖像n 直線通過從對象庫中將其拖拽至工作區(qū)域中并調(diào)整大小完成繪制工作，點(diǎn)擊控件可在右側(cè)對象頁簽進(jìn)行屬性設(shè)置，或在布局頁簽對字體、位置等進(jìn)行設(shè)置。1.2.2 繪制過程1. 按照需求開始制作表單1) 制作表單

7、的時(shí)候，首先需要分析一下制作表單的頁面需要分為幾部分，則需要添加幾個(gè)子表單，表單制作頁面都是由一個(gè)個(gè)的子表單組成的。2) 如上圖所示，整個(gè)頁面分為11部分，Header，BOTTOM以及中間的一些表單3) 在表單里面可以加入文本，文本域，點(diǎn)擊菜單欄中的“窗口”，選擇對象庫，可以添加需要在子表單中要繪制的對象4) 遇到動態(tài)循環(huán)的時(shí)候，如圖所示的R2為一個(gè)動態(tài)循環(huán)，以表格的形式繪制； 將表體部分綁定到循環(huán)字段（詳見2.3綁定數(shù)據(jù)）5) 保存表單，點(diǎn)擊菜單欄中的文件另存為另存的時(shí)候保存類型選擇Adobe XML表單（*.xdp），要以這種格式在系統(tǒng)中發(fā)布1.3 綁定數(shù)據(jù)為了能夠在模板中對應(yīng)的位置顯示

8、所需要的數(shù)據(jù)內(nèi)容，需要按照下述步驟將XML數(shù)據(jù)和控件進(jìn)行綁定：1. 在數(shù)據(jù)視圖頁簽內(nèi)點(diǎn)擊右鍵，選擇創(chuàng)建數(shù)據(jù)視圖2. 出現(xiàn)如下所示的頁面，選擇“示例XML數(shù)據(jù)”，點(diǎn)擊“下一步”，3. 選擇要綁定數(shù)據(jù)的xml數(shù)據(jù)下一步即完成了XML數(shù)據(jù)結(jié)構(gòu)到模板的數(shù)據(jù)連接創(chuàng)建。4. 在數(shù)據(jù)視圖中可看到導(dǎo)入的XML結(jié)構(gòu)，但是此時(shí)還沒有將具體的XML節(jié)點(diǎn)和表單控件對應(yīng)上。5. 在數(shù)據(jù)視圖界面中，可以通過下述兩種方式將XML數(shù)據(jù)字段和表單控件進(jìn)行對應(yīng)。例如：姓名的文本域要與V17綁定， A: 可以把V17通過鼠標(biāo)左鍵直接拖到文本域里 B: 也可以在右側(cè)欄中，對象綁定默認(rèn)綁定的后面框中選擇需要綁定的域6. 對于需要循環(huán)的

9、子表單，可通過下述步驟進(jìn)行綁定：a) 在層次界面選擇要循環(huán)的子表單b) 在其對象->綁定->默認(rèn)綁定位置選擇需要綁定的XML字段。需要注意的是該XML字段在導(dǎo)入的XML結(jié)構(gòu)中必須至少重復(fù)一次。c) 勾選為每個(gè)數(shù)據(jù)項(xiàng)木重復(fù)行如下圖所示：1.4 模板測試1. 數(shù)據(jù)綁定完成后，把制作的表單另存為Adobe 動態(tài) XML表單（*.pdf）2. 使用Adobe Acrobat 9 Pro 工具打開生成的pdf，3. 選擇上面的表單，管理表單數(shù)據(jù)導(dǎo)入數(shù)據(jù)，選擇綁定的xml4. 可按照需求的要求正常展示動態(tài)模板的樣式即可。2 數(shù)據(jù)文件生成一般由輸出數(shù)據(jù)系統(tǒng)生成。如果手工測試，可按照接口文件編寫。

10、3 IDPDocEngineAgent安裝配置1 停止IDG；#cd /root/IDG#./ stopIDG.sh2 將提供的介質(zhì)中的IDPDocEngineAgent-0.0.1-SNAPSHOT.jar文件拷貝到安裝IDG時(shí)對應(yīng)的agent_java目錄;#cp IDPDocEngineAgent-0.0.1-SNAPSHOT.jar $IDGHOME/agent_java/3 將提供的介質(zhì)中的/lib文件夾中的全部目錄放置到安裝IDG時(shí)對應(yīng)的customjavalib目錄，同名的文件選擇覆蓋;4 將提供的介質(zhì)中的/DocEngine文件夾放置到安裝IDG時(shí)對應(yīng)的agent_config

11、目錄；5 修改安裝IDG時(shí)對應(yīng)的agent_config/DocEngine/fop-config.xml文件，將其中的<font metrics-url="file:/home/indigo/IDG/DocEngine/simkai.xml" kerning="yes" embed-url="file:/home/indigo/IDG/DocEngine/font/simkai.ttf">中的以file:/開頭的文件路徑修改為安裝IDG目錄中的實(shí)際的文件路徑6 在IDG的configure.xml文件中配置如下內(nèi)容（其中

12、紅色的字體需要根據(jù)實(shí)際的目錄和文件修改）：<?xml version="1.0" encoding="UTF-8" standalone="no"?><root><modules><module name="watchfolder本標(biāo)簽不修改，含義是定義掃描的數(shù)據(jù)目錄"><directory name="dir1"><path>/home/indigo/data</path掃描數(shù)據(jù)的路徑，數(shù)據(jù)文件放在這里><

13、;filetype>*</filetype支持的被掃描的數(shù)據(jù)文件的類型><checkjob>no</checkjob取默認(rèn)值，不需要修改><defaultjob>test默認(rèn)缺省的任務(wù)的名稱</defaultjob></directory></module></modules><jobs><job name="test任務(wù)名稱"><tasks><task name="customagent"> <ex

14、ecname>IDGDocEngineAgent</execnameTask任務(wù)的執(zhí)行程序名稱><parameter name="outFile">/home/indigo/test/IDPDocEngine/()out.pdf</parameter電子保單輸出文件名稱><parameter name="logFile">/home/indigo/test/IDPDocEngine/log日志文件及目錄名稱.log</parameter><parameter n

15、ame="templateFile">/home/indigo/test/IDPDocEngine/().xdp.fo引擎模板文件命名稱</parameter><parameter name="outType">application/pdf</parameter輸出電子保單文件類型><parameter name="templateType">FOForm</parameter引擎模板文件類型><parameter name="c

16、onfigFile">/home/indigo/IDG/agent_config/DocEngine/fop引擎字體支持的配置文件-config.xml</parameter><parameter name="deleteInFile">false處理結(jié)束后是否刪除輸入的數(shù)據(jù)文件</parameter><parameter name="onlyInput">true配置為True后僅僅從命令行讀取模板參數(shù)信息</parameter><parameter name="retry">0失敗重試次數(shù)</parameter><command>JAVAAGENT (execname) -inFile (source) -outFile (outFile) -templateFile (templateFile) -logFile (inne