關於格式複雜的Docx套版列印

2013-06-25

記得前幾天在網路上閒逛時看到了這兩篇文章 (再探文件套表 - Word套表與轉存PDF、關於Docx套版列印功能程式)，正巧這問題幾個月前剛好處理過，而且需求更加的機車棘手，所以趁著還有記憶時趕緊記錄一下。

故事是這樣的，原本客戶都是利用Word來製作了一份排版的漂漂亮亮的報告，但這流程就快被我們開發中的線上報告系統給取代掉了。由於這份報告有固定的區塊，但區塊裡的內容就會依情況由客戶自由發揮了，並且內容不單單只有純文字，還會需要格式設定，如字型顏色、粗斜體和自由插入表格等等的編排。

當然，線上製作這塊好解決，放個WYSIWYG編輯器就能搞定了，問題在於客戶要的是產生出來提供列印的PDF要跟他之前美美的Word格式一模一樣。(一模一樣~ 一模一樣~~ 一模一樣~~~~)

聽到這需求心裡的第一個反應是當初答應沒問題可以做的業務是哪個傢伙 XD

好家在的是這個專案是用ASP.NET開發的。

由於變更的部份會包含格式，所以單純地用文字取代的方式無法滿足需求，經過了一段時間的研究，發現了這個可以直接將Html轉為OpenXML格式的元件 - Html to OpenXml

1. 先安裝Open XML SDK 2.0，再將HtmlToOpenXml.dll放進專案裡。

2. 定位的部份，因為要直接餵進OpenXML的Element物件，所以並不能單純的用文字取代的方式來做，需要使用RTF控制項。

開發人員頁籤得先到選項中開啟

再來設定控制項的標籤名字好方便搜尋。

3. 程式碼的部份如下

public static void GenHtml2DocxFromTemplate(string templateFilePath, Dictionary<string, string> values)
		
{
		
    using (WordprocessingDocument package = WordprocessingDocument.Open(templateFilePath, true))
		
    {
		
        MainDocumentPart mainPart = getMainDocumentPart(package);
		
  
		
        HtmlConverter converter = new HtmlConverter(mainPart);
		
  
		
        foreach (string tag in values.Keys)
		
        {
		
            SdtElement block = findBlockByTag(package, tag);
		
  
		
            if (block != null)
		
            {
		
                appendHtmlContent(block, converter, values[tag]);
		
            }
		
        }
		
        mainPart.Document.Save();
		
    }
		
}
		
  
		
private static MainDocumentPart getMainDocumentPart(WordprocessingDocument package)
		
{
		
    MainDocumentPart mainPart = package.MainDocumentPart;
		
    if (mainPart == null)
		
    {
		
        mainPart = package.AddMainDocumentPart();
		
        new Document(new Body()).Save(mainPart);
		
    }
		
    return mainPart;
		
}
		
  
		
private static SdtElement findBlockByTag(WordprocessingDocument package, string tag)
		
{
		
    Tag elementTag = package.MainDocumentPart.Document.Descendants<Tag>()
		
        .Where(
		
            element => element.Val == tag
		
        ).SingleOrDefault();
		
  
		
    if (elementTag == null) return null;
		
  
		
    return elementTag.Parent.Parent as SdtElement;
		
}
		
  
		
private static void appendHtmlContent(SdtElement block, HtmlConverter converter, string html)
		
{
		
    clearContent(block);
		
  
		
    var paragraphs = converter.Parse(html);
		
  
		
    foreach (var paragraph in paragraphs)
		
    {
		
        getSdtContent(block).Append(paragraph);
		
    }
		
}
		
  
		
private static void clearContent(SdtElement block)
		
{
		
    getSdtContent(block).RemoveAllChildren();
		
}
		
  
		
private static OpenXmlElement getSdtContent(SdtElement block)
		
{
		
    OpenXmlElement oxElement = block.Elements()
		
        .Where(elememt => elememt.LocalName == "sdtContent").SingleOrDefault();
		
  
		
    if (oxElement != null && oxElement.FirstChild is TableCell)
		
        return oxElement.FirstChild;
		
    return oxElement;
		
}

4. 最後就能得到以下的結果

完美!!!

這種做法不僅可以先利用Word做好範本的排版，也能透過HTML WYSIWYG編輯器再做第二層的排版，自由度大增。另外再透過Word另存PDF的功能，便能直接做出可媲美Word功能的線上報告產生器。

點部落的標籤: Word ,套版 ,Open Xml

回首頁