[[217561]]

在很多業(yè)務場景中需要在word文檔中嵌入報表。比如下圖這個報告：

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

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

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

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

1、制作word模板，將需要插入內容的位置設置好書簽

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

2、制作報表，這一步就不詳述了。

3、調用潤乾報表的raqsoft.report.view.oxml.word.DocxChanger里的方法，將圖片，文本，報表等內容插入到指定書簽位置，生成新的word報告。

 eg：

 //設置報表授權文件 
 
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); //實例化DocxChanger 
 
//在書簽“編號”，“時間”，“年度”處插入文字 
 
dc.insertText(“編號“, “12345678”); 
 
dc.insertText(“時間“, “20170730”); 
 
dc.insertText(“年度“, “2017”); 
 
 //在書簽“logo”處插入圖片文件 
 
File f1 = new File(“d:/logo.png”); 
 
dc.insertImage(“logo”, f1); 
 
//在書簽“報表”，“統(tǒng)計圖”處插入報表和統(tǒng)計圖 
 
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(“報表“, report);                 
 
File f3 = new File(“d:/留學.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)計圖“, report2);                          
 
//執(zhí)行所有修改動作，然后關閉輸出文件流 
 
dc.execute(); 
 
fos.close();  

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

不過，這個辦法還有個缺點，當插入內容變化時，我們就需要修改java代碼，而改了代碼之后又得重編譯部署，難以做到熱切換。這個辦法還是不夠方便。

為此，潤乾報表還提供了外部配置的方法來實現(xiàn)word報表，可以預先編輯一個xml文件，在里面寫個需要替代的書簽等內容，然后程序會讀取這個配置文件生成相應的word文檔。

這樣，當插入內容變化的時候，只要修改xml配置信息即可，而不用修改代碼再編譯了。我們一起來看一下：

1、編輯配置文件xml

該文件中可配置多個書簽和插入對象，當對象來源于內存時，可配置成map，通過key從內存中取值，key值可以是IReport、byte[]、Image、String，值的類型程序會自動判斷。

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

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

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

try { 
 
 File of = new File(“D:/out.docx”);// 輸出文件 
 
 …… 
 
FileOutputStream fos = new FileOutputStream(of); 
 
 //加載xml,batch.xml內容如上一小節(jié)所示 
 
        String xmlConfig = DocxChanger.xmlFile2String(“D:/batch.xml”); 
 
         //當插入的對象來自內存，比如IReport對象 
 
         File f4 = new File(“d:/留學.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(); 
 
//當對象來源于內存時，可配置成map 
 
HashMap map = new HashMap(); 
 
       map.put(“f”, report);   //設置xml中key為f的值 
 
       map.put(“arg2”, “2014-12-15 12:00:23”);//當插入對象來自內存，比如String，設置xml中key為arg2的值      
 
DocxChanger.insert(map, xmlConfig, fos); 
 
        fos.close(); 
 
       } catch (Throwable x) { 
 
      x.printStackTrace(); 
 
      } 

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