在 Aspose.Words for Java 中使用 XML 數據
Aspose.Words for Java 中使用 XML 資料的簡介
在本指南中,我們將探討如何使用 Aspose.Words for Java 處理 XML 資料。您將學習如何執行郵件合併操作(包括巢狀郵件合併),以及如何使用帶有 DataSet 的 Mustache 語法。我們將提供逐步說明和原始程式碼範例來幫助您入門。
先決條件
在開始之前,請確保您已滿足以下先決條件:
- Aspose.Words for Java 已安裝。
- 客戶、訂單和供應商的範例 XML 資料檔。
- 郵件合併目標的範例 Word 文件。
使用 XML 資料的郵件合併
1. 基本郵件合併
若要使用 XML 資料執行基本郵件合併,請依照下列步驟操作:
DataSet customersDs = new DataSet();
customersDs.readXml("Your Directory Path" + "Mail merge data - Customers.xml");
Document doc = new Document("Your Directory Path" + "Mail merge destinations - Registration complete.docx");
doc.getMailMerge().execute(customersDs.getTables().get("Customer"));
doc.save("Your Directory Path" + "BasicMailMerge.docx");
2. 巢狀郵件合併
對於巢狀郵件合併,請使用以下程式碼:
DataSet pizzaDs = new DataSet();
pizzaDs.readXml("Your Directory Path" + "Mail merge data - Orders.xml");
Document doc = new Document("Your Directory Path" + "Mail merge destinations - Invoice.docx");
doc.getMailMerge().setTrimWhitespaces(false);
doc.getMailMerge().executeWithRegions(pizzaDs);
doc.save("Your Directory Path" + "NestedMailMerge.docx");
使用 DataSet 的 Mustache 語法
若要將 Mustache 語法與 DataSet 結合使用,請依照下列步驟操作:
DataSet ds = new DataSet();
ds.readXml("Your Directory Path" + "Mail merge data - Vendors.xml");
Document doc = new Document("Your Directory Path" + "Mail merge destinations - Vendor.docx");
doc.getMailMerge().setUseNonMergeFields(true);
doc.getMailMerge().executeWithRegions(ds);
doc.save("Your Directory Path" + "MustacheSyntaxUsingDataSet.docx");
結論
在本綜合指南中,我們探討如何透過 Aspose.Words for Java 有效地使用 XML 資料。您已經學習如何執行各種郵件合併操作,包括基本郵件合併、巢狀郵件合併以及如何將 Mustache 語法與 DataSet 結合使用。這些技術使您能夠輕鬆地實現文件的自動化生成和客製化。
常見問題解答
我該如何準備用於郵件合併的 XML 資料?
確保您的 XML 資料遵循所需的結構,並定義表格和關係,如提供的範例所示。
我可以自訂郵件合併值的修剪行為嗎?
是的,你可以使用以下方法控制郵件合併期間是否修剪前導和尾隨空格 doc。getMailMerge().setTrimWhitespaces(false).
Mustache 語法是什麼?什麼時候該使用它?
Mustache 語法可讓您以更靈活的方式格式化郵件合併欄位。使用 doc.getMailMerge().setUseNonMergeFields(true) 啟用 Mustache 語法。