Aspose.Word企业案例：Charity Auction Organizer 使用 Aspose.Words 开发自定义邮件合并引擎

关于Charity Auction Organizer

CharityAuctionOrganizer.com 提供了一个平台，允许非营利组织进行筹款拍卖。这包括生成大量支持现场活动的文件，包括拍卖目录、投标人声明、捐赠者收据和邮寄标签。

以前，这些文档生成为基于固定模板的 PDF。用户希望能够自定义这些表单的外观，并且随着时间的推移添加大量特定选项以设置字体、颜色和更改对齐方式以及包含的内容。

然而，组合的数量是无穷无尽的，简单地添加越来越多的选项永远不会为用户提供他们想要的所有灵活性。

Aspose.Words for Java 最新下载

要求

需要的是一种让非技术用户使用他们已经熟悉的工具设计文档的方法，该工具提供丰富的格式和布局选项。然后可以将这些文档作为模板上传，这些模板填充了我们数据库中托管的内容。

最强大和最常用的选项是 Microsoft Word。我们需要一种方法来获取用户提供的 Word 文档并在服务器端执行合并，生成文件供用户下载。

解决方案

Aspose.Words提供了用于访问和生成 Word 文档的灵活 API，并支持针对自定义数据源调用本机 Word 邮件合并功能。

我们的第一个原型实现了 IMailMergeDataSource 接口，以将数据库中的数据输入邮件合并过程。这种技术运行良好，并且针对Aspose.Words API的代码非常少。

但是，它有一个主要缺点：它要求用户使用 Microsoft Word 邮件合并字段来实现模板。虽然邮件合并字段适用于邮件标签等简单文档，但对于更复杂的结构，它们很快就会变得不可用。

例如，一个简单的条件块如下所示：

这种语法对于我们的客户来说太复杂了，无法维护，而且很容易出现格式错误。

此外，Word 邮件合并支持并通过 IMailMergeDataSource 公开的数据模型也不容易支持分层数据。我们有很多嵌套数据结构的案例，它们不容易映射到 Word 的邮件合并区域概念。

增强的邮件合并

相反，我们需要一个更灵活的解决方案。Aspose Words 生成的邮件合并语法已经支持一些扩展：使用 mustache 模板语法处理简单字段值的能力。我们需要扩展这个概念来处理更高级的流控制原语。

因此，我们没有使用内置的邮件合并功能，而是通过 Aspose API 实现了一个自定义合并引擎，该引擎使用在文档的正常流程中作为文本编写的控制原语。

使用新语法的等效条件块很简单：

所有文本都只需输入，根本不需要插入合并字段。
除了使用 mustache 模板语法评估表达式之外，还实现了几个控制块：

• {% foreach %} 用于迭代一组记录
• {% row %} 用于在表中为集合的每个成员创建行
• {% sum %} 通过对集合求值来计算总数

特别是，{% row %} 原语可以很容易地生成目录，其中每一行都由数据源中的不同记录填充。这是许多类型文档的非常常见的要求。

将这些概念放在一起会产生如下所示的模板：

并产生如下输出：

Aspose Words API 使得迭代文档结构和操作树节点变得非常容易。

甚至像在文档中插入图像这样的操作也需要很少的代码来实现。

技术细节

合并引擎的第一遍需要将文档结构转换为规范形式，其中分布在多个“运行”节点上的控制节点被折叠成单个运行。

模板的第二遍通过克隆规范模板然后查找控制块运行来工作。然后使用数据模型中的记录对这些进行评估。

对于重复控制块，这需要克隆文档的任意部分，递归地评估其中的任何控制块，并将最终内容插入回文档中。

Aspose.Words 可以非常直接地对文档执行这些转换，并在模板中找到的各种类型的内容之间提供一致的导航模型。

---

欢迎下载|体验更多Aspose产品 加入Aspose技术交流群（761297826）