[[217561]]

在很多業(yè)務(wù)場(chǎng)景中需要在word文檔中嵌入報(bào)表。比如下圖這個(gè)報(bào)告：

這是一個(gè)某大學(xué)年度畢業(yè)生就業(yè)報(bào)告，其中表格和統(tǒng)計(jì)圖的數(shù)據(jù)來(lái)自數(shù)據(jù)庫(kù)，如果通過(guò)報(bào)表工具，制作這樣的表格和統(tǒng)計(jì)圖是輕而易舉的事情，但如果要把這些報(bào)表和統(tǒng)計(jì)圖做到word報(bào)告里就麻煩很多。以往有兩個(gè)辦法：一個(gè)是每次做好報(bào)表和統(tǒng)計(jì)圖之后，導(dǎo)出為word，再手工復(fù)制粘貼到word報(bào)告中；第二個(gè)是把整個(gè)報(bào)告都做成一個(gè)報(bào)表模板，然后再一起導(dǎo)出為word。 方法一，純手工操作效率低；方法二，報(bào)表工具排版能力有限，生成的word版面效果不夠***。

那么，還有什么好辦法呢？

通常這類(lèi)報(bào)告都有規(guī)定的模板樣式，只是要定期替換里面的個(gè)別信息，比如上圖所示的文檔編號(hào)，報(bào)告時(shí)間，標(biāo)題里的年度，圖片，每個(gè)章節(jié)下的報(bào)表和統(tǒng)計(jì)圖，這些信息是動(dòng)態(tài)變化的，而其他文字描述部分以及整體樣式都是固定不變的。所以，如果能把報(bào)表嵌入word文檔做成流水線(xiàn)式的自動(dòng)化過(guò)程，那就是一件兩全其美，事半功倍的事情。

潤(rùn)乾報(bào)表就提供了把報(bào)表嵌入word的功能，實(shí)現(xiàn)步驟如下：

1、制作word模板，將需要插入內(nèi)容的位置設(shè)置好書(shū)簽

比如我們開(kāi)篇看到的大學(xué)畢業(yè)生就業(yè)報(bào)告，我們可以先做成如上圖所示的word模板，圖示綠色線(xiàn)框位置就是需要定期更新的部分，預(yù)先在這些位置插入書(shū)簽（比如書(shū)簽名為：編號(hào)，時(shí)間，logo，年度，報(bào)表，統(tǒng)計(jì)圖），以此標(biāo)記要插入到word的內(nèi)容對(duì)應(yīng)插入到什么位置。

2、制作報(bào)表，這一步就不詳述了。

3、調(diào)用潤(rùn)乾報(bào)表的raqsoft.report.view.oxml.word.DocxChanger里的方法，將圖片，文本，報(bào)表等內(nèi)容插入到指定書(shū)簽位置，生成新的word報(bào)告。

 eg：

 //設(shè)置報(bào)表授權(quán)文件 
 
File flic = new File(“c:/tmp/report5.lic”); 
 
FileInputStream lis = new FileInputStream(flic); 
 
Sequence.readLicense( Sequence.P_RPT, lis); 
 
File f = new File(“E:/test.docx”);               // 模板文件 
 
File of = new File(“D:/out.docx”);             // 輸出文件 
 
 … … 
 
FileOutputStream fos = new FileOutputStream(of); 
 
 DocxChanger dc = new DocxChanger(f, fos); //實(shí)例化DocxChanger 
 
//在書(shū)簽“編號(hào)”，“時(shí)間”，“年度”處插入文字 
 
dc.insertText(“編號(hào)“, “12345678”); 
 
dc.insertText(“時(shí)間“, “20170730”); 
 
dc.insertText(“年度“, “2017”); 
 
 //在書(shū)簽“logo”處插入圖片文件 
 
File f1 = new File(“d:/logo.png”); 
 
dc.insertImage(“logo”, f1); 
 
//在書(shū)簽“報(bào)表”，“統(tǒng)計(jì)圖”處插入報(bào)表和統(tǒng)計(jì)圖 
 
File f2 = new File(“d:/畢業(yè)去向.rpx”); 
 
FileInputStream fis =new FileInputStream(f2); 
 
IReport report = ReportUtils.read(fis); 
 
 fis.close(); 
 
Context context = new Context(); 
 
……  
 
Engine engine = new Engine((ReportDefine) report, context); 
 
report = engine.calc(); 
 
dc.insertReport(“報(bào)表“, report);                 
 
File f3 = new File(“d:/留學(xué).rpx”); 
 
FileInputStream fis2 =new FileInputStream(f3); 
 
IReport report2 = ReportUtils.read(fis2); 
 
 fis2.close(); 
 
Context context2 = new Context(); 
 
……  
 
Engine engine2 = new Engine((ReportDefine) report2, context2); 
 
report2 = engine2.calc(); 
 
dc.insertReport(“統(tǒng)計(jì)圖“, report2);                          
 
//執(zhí)行所有修改動(dòng)作，然后關(guān)閉輸出文件流 
 
dc.execute(); 
 
fos.close();  

至此，word報(bào)告就自動(dòng)生成了，以后每次只要執(zhí)行一遍這段程序就行了，是不是方便了不少？

不過(guò)，這個(gè)辦法還有個(gè)缺點(diǎn)，當(dāng)插入內(nèi)容變化時(shí)，我們就需要修改java代碼，而改了代碼之后又得重編譯部署，難以做到熱切換。這個(gè)辦法還是不夠方便。

為此，潤(rùn)乾報(bào)表還提供了外部配置的方法來(lái)實(shí)現(xiàn)word報(bào)表，可以預(yù)先編輯一個(gè)xml文件，在里面寫(xiě)個(gè)需要替代的書(shū)簽等內(nèi)容，然后程序會(huì)讀取這個(gè)配置文件生成相應(yīng)的word文檔。

這樣，當(dāng)插入內(nèi)容變化的時(shí)候，只要修改xml配置信息即可，而不用修改代碼再編譯了。我們一起來(lái)看一下：

1、編輯配置文件xml

該文件中可配置多個(gè)書(shū)簽和插入對(duì)象，當(dāng)對(duì)象來(lái)源于內(nèi)存時(shí)，可配置成map，通過(guò)key從內(nèi)存中取值，key值可以是IReport、byte[]、Image、String，值的類(lèi)型程序會(huì)自動(dòng)判斷。

<?xml version=”1.0″ encoding=”UTF-8″ standalone=”yes”?> 
 
<!– file表示模板docx文件名，可配置絕對(duì)路徑或相對(duì)路徑(web端配置時(shí)相對(duì)于raqsoftConfig.xml中的reportFileHome) –> 
 
<docx file=”D:/test.doc”> 
 
<!– name表示docx書(shū)簽，為空則不會(huì)插入。 file表示圖片文件名，可配置絕對(duì)路徑或相對(duì)路徑(web端配置時(shí)相對(duì)于raqsoftConfig.xml中的reportFileHome) –> 
 
<bookmark name=”logo” type=”image” file=”D:/logo.png”/> 
 
<!– name表示docx書(shū)簽， text要插入的文本文字 –> 
 
<bookmark name=”編號(hào)” type=”text” text=”12345678 “/> 
 
<bookmark name=”時(shí)間” type=”text” text=”20170730“/> 
 
<bookmark name=”年度” type=”text” text=”2017 “/> 
 
<!– key表示給定map中的key（未填時(shí)跟name相同，對(duì)應(yīng)的value只能是IReport、byte[]、Image、String） –> 
 
<bookmark name=”統(tǒng)計(jì)圖” type=”map” key=”f”/> 
 
<!– reportFile表示報(bào)表模板文件名，可配置絕對(duì)路徑或相對(duì)路徑(web端配置時(shí)相對(duì)于raqsoftConfig.xml中的reportFileHome)–> 
 
<bookmark name=”報(bào)表” type=”report” reportFile=”D:/畢業(yè)去向.rpx”> 
 
<!– value表示報(bào)表參數(shù)值(串) –> 
 
         <reportParam name=”arg1″ type=”value” value=”設(shè)定參數(shù)1″/> 
 
<!– type為map時(shí)會(huì)從內(nèi)存中根據(jù)name讀取key，key未填寫(xiě)時(shí)跟name相同,key=””時(shí)會(huì)取map中key為空的值–> 
 
<reportParam name=”arg2″ type=”map”/>        
 
</bookmark> 
 
</docx> 

注：在web應(yīng)用中，如果web.xml里配置了reportServlet，那么程序會(huì)自動(dòng)加載raqsoftconfig.xml，讀取該文件里配置的reportFileHome，數(shù)據(jù)源信息，授權(quán)文件等信息。

2、根據(jù)配置信息生成Word文檔

try { 
 
 File of = new File(“D:/out.docx”);// 輸出文件 
 
 …… 
 
FileOutputStream fos = new FileOutputStream(of); 
 
 //加載xml,batch.xml內(nèi)容如上一小節(jié)所示 
 
        String xmlConfig = DocxChanger.xmlFile2String(“D:/batch.xml”); 
 
         //當(dāng)插入的對(duì)象來(lái)自?xún)?nèi)存，比如IReport對(duì)象 
 
         File f4 = new File(“d:/留學(xué).rpx”); 
 
         FileInputStream fis = new FileInputStream(f4); 
 
         IReport report = ReportUtils.read(fis); 
 
fis.close(); 
 
Context context = new Context(); 
 
Engine engine = new Engine((ReportDefine) report, context); 
 
report = engine.calc(); 
 
//當(dāng)對(duì)象來(lái)源于內(nèi)存時(shí)，可配置成map 
 
HashMap map = new HashMap(); 
 
       map.put(“f”, report);   //設(shè)置xml中key為f的值 
 
       map.put(“arg2”, “2014-12-15 12:00:23”);//當(dāng)插入對(duì)象來(lái)自?xún)?nèi)存，比如String，設(shè)置xml中key為arg2的值      
 
DocxChanger.insert(map, xmlConfig, fos); 
 
        fos.close(); 
 
       } catch (Throwable x) { 
 
      x.printStackTrace(); 
 
      } 

說(shuō)了這么多，大家肯定會(huì)覺(jué)得理想很豐滿(mǎn)，現(xiàn)實(shí)很骨感，這個(gè)功能是很***，確實(shí)可以幫我解決這些個(gè)棘手的問(wèn)題，但是都知道報(bào)表工具價(jià)格昂貴，再加上這樣小奢的功能，豈不是貴上加貴，為此特意買(mǎi)一套昂貴的報(bào)表工具，似乎就不劃算了，而開(kāi)源報(bào)表里面又沒(méi)有這個(gè)功能。但是你不知道的是，現(xiàn)在報(bào)表工具已經(jīng)低端化了，潤(rùn)乾率先開(kāi)始了2.8萬(wàn)元/10套的低價(jià)報(bào)表了，恰巧這個(gè)功能里面有，恰巧你還看到了。