创建用于文档生成的高级模板

使用邮件合并生成文档的方法是，从数据源读取数据，并将数据替换模板文档中相应的变量。这通常需要两个文件：一个是用于存储合并字段（即要插入的数据变量）的模板文件；另一个文件包含格式化变量数据的指令以及在邮件合并的每个结果中都相同的信息。

可以使用多种语法创建模板。PDF4me 支持 Word、HTML 和 PDF 模板，用于生成文档。借助全新的报表引擎，您可以使用简单的语法结构，以 Word 格式设计高级模板，用于生成发票、收据、合同、报价单或任何个性化文档。如需详细了解，请点击链接访问我们的文档。

您可以使用以下语法手动创建合并字段或令牌。

<<[字段名]>>

您还可以添加条件表达式来评估条件结果，并根据评估结果添加特定的数据选项。下面我们简要看一下如何使用这些选项来设计用于生成文档的 Word 模板。

条件表达式

PDF4me 中的“生成文档”操作允许您使用条件表达式将数据填充到模板中。根据条件的状态，可以向文档添加动态数据。您甚至可以组合使用多个表达式，在填充特定数据之前满足多个条件。

如果 else 条件语法

文档中如何使用 if-else 条件语句的基本语法 -

<<如果 [条件1]>> 添加第一条数据 <<否则如果 [条件2]>> 添加第二条数据 <<否则>> 添加第三条数据 <</if>>

您还可以应用更高级的条件语句。阅读更多关于条件语句的内容。

模板格式设置

在生成文档时，您可能需要对动态生成的结果（例如表达式的计算结果）应用格式。使用 PDF4me，您可以轻松地对条件或表达式的结果应用格式。

应用格式化的基本语法 -

<<[token]:"format">>

例如-

发票日期：<<[invoiceDate]:"dd.MM.yyyy">>

要了解所有格式化功能，请阅读更多关于 Word 模板格式化的内容

模板中的表格

表格是大多数文档中非常常见的组成部分。它们有助于有效地展示数据，便于比较、参考或计算。PDF4me 文档生成器可以根据数据有效地将表格插入文档中。

让我们来看一些创建表格语法的示例。

我们可以创建一个产品清单来了解这一点。

第 1 列：<<foreach [product in products]>><<[product.productName]>> 第 2 列：<<[product.manufactured]:"yyyy.MM.dd">> 第 3 列：<<[product.price]>><</foreach>>

关于各种表结构的更多信息，请参阅表相关的文档。

在模板中添加图片

PDF4me 还允许您在文档中插入图像。图像的语法可以在模板的设计阶段添加。

可以通过两种方式添加图片。

使用公共图像 URL

<<图片 [imageUrl]>>

数据可以通过以下几种方式分别传递给上述语法 -

使用图像的 Base64 字符串

<<image [imageBase64]>>

请阅读文档，了解如何在 Word 模板中添加图片，并附有示例-

在模板中插入HTML代码片段

现在您还可以直接向模板添加 HTML 代码段和格式，用于填充数据。您可以使用以下语法插入 HTML 代码。

<<[token] -html>>

如需查看示例，请阅读有关在 Word 模板中插入 HTML 的文档。

示例模板

让我们来看一个简单的示例。以下是示例 Word 模板和数据，供您快速测试生成文档操作。您可以下载 Word 模板，并使用模板中的 JSON 数据进行测试。

样本数据

{ "VendorName": "PDF4me", "VendorCity": "苏黎世", "VendorCountry": "瑞士", "VendorZip": "8630", "VendorContact": "123456", "InvoiceDate": "2022年8月22日", "CustomerName": "John Doe", "CustomerCity": "Start City", "CustomerCountry": "美国", "CustomerZip": "3214", "products": [ { "prodctName": "PDF Converter", "value": 2000, "expires": "2025年8月1日" }, { "productName": "PDF API", "value": 1250, "expires": "2029年2月18日" }, { "productName": "PDF Editor", "value": 1999, "expires": "2027年12月12日" } } ], "comment":"本文档由计算机生成，无需签名。", }