合并字段

转换器支持 CKEditor 5 合并字段功能。合并字段允许用户在 HTML 文档中创建模板字段，在导出到 Word 的情况下，可以将其转换为 Word 合并字段或使用提供的数据填充。

合并字段可以通过 config.merge_fields 配置选项进行配置。 在 API 文档中阅读有关此配置选项的信息.

# Word 合并字段

Word 合并字段使您可以轻松地定制和个性化您的文档，通过动态包含来自数据源的变量数据（如姓名、地址、日期和其他唯一详细信息）。

此功能对于创建定制的通信至关重要，无论是信件、电子邮件、标签、信封还是目录。通过将您的文档链接到各种数据源（如 Excel 电子表格、Access 数据库和 Outlook 联系人），合并字段会提取您需要的精确信息，确保您的文档始终最新且准确。它们可以通过自动化个性化详细信息的包含来节省您的时间，无需手动更新和重复数据输入，让您专注于更重要的任务。

# 转换为 Word 合并字段

如果合并字段配置不包含 data 属性，转换器将保留生成 .DOCX 文件中的所有合并字段。

将包含合并字段的 HTML 转换为 Word 文档的示例

{
 "config": {
  "merge_fields": {
   "prefix": "{",
   "suffix": "}"
  }
 }
}

<p> Hello {NAME}! </p>

Word 合并字段用于创建表单信函、邮寄标签和其他针对每个收件人个性化的文档。要了解有关在 Word 中使用合并字段的更多信息，请参阅 Microsoft 关于 邮件合并 的文章。

# Word 限制

一些合并字段名称可能包含 Word 不允许的字符。由于此限制，在导入数据源时，Word 会对其进行修改，并在邮件合并期间提示您删除或重命名不兼容的字段。

假设我们将包含合并字段的 HTML 转换为 Word 文档

{
 "config": {
  "merge_fields": {
   "prefix": "{",
   "suffix": "}"
  }
 }
}

<p> Hello {FIRST.NAME} {LAST.NAME}! </p>

. 字符在 Word 合并字段数据源中不允许。当您尝试使用包含该字符的数据集执行邮件合并时，Word 会显示此对话框

要避免此问题，请确保合并字段名称不包含 Word 不允许的字符。目前，合并字段名称中不允许以下字符：.、-、空格、以数字开头的合并字段（例如 {1st_name}）。

# 使用合并字段插入数据

如果合并字段配置包含 data 属性，转换器将插入与数据内部的键关联的值，这些键也放置在 HTML 内部。请注意，合并字段不能在 HTML 属性或标记内的任何其他部分使用。它们也不能在 style 标签的开始和结束标签之间使用。

如果提供的数据为空或缺少某些字段的值，则没有数据的合并字段将被转换为纯文本。

提供的数据可以是 HTML 和纯文本格式。这是一个例子

{
 "config": {
  "merge_fields": {
   "prefix": "{",
   "suffix": "}",
   "data": {
    "FIRST_NAME": "John",
    "LAST_NAME": "<i>Doe</i>"
   }
  }
 }
}

<p> Hello {FIRST_NAME} {LAST_NAME}! </p>