新浪博客

MailMerge:未合并字段的字段映射和处理

2022-06-13 11:00阅读:
MailMerge:未合并字段的字段映射和处理
Text Control 的MailMergeAPI 将模板中的合并字段与支持的数据源中的列映射。本文解释了结构以及如何处理未合并的字段。
Text Control 的邮件合并API 将MS Word兼容模板中的合并字段与支持的数据源中的数据列(字段)进行映射。在合并过程中,模板中的字段名称与适用层次结构级别中合并数据的列名称进行比较。
下图显示了合并字段名称如何映射到分层数据。
MailMerge:未合并字段的字段映射和处理
company_name直接来自根表,而地址来自子表。可以使用“点符号”访问这些字段。例如,要访问街道,合并字段名称为address.street。
删除空字段
但是,如果在给定的数据源中找不到适当的列名,字段会发生
什么情况?
默认情况下,会删除空字段。可以通过设置RemoveEmpty Fields 属性来控制此行为。
以下示例模板包含3个字段,而第三个字段MERGEFIELD在使用的示例JSON数据源中没有关联的数据字段。
MailMerge:未合并字段的字段映射和处理
在生成的文档中,第三个字段被删除:
MailMerge:未合并字段的字段映射和处理
在以下代码中,创建了MailMerge类的新实例并将RemoveEmptyFields设置为false,因此不会从文档中删除空字段。
MailMerge:未合并字段的字段映射和处理
MailMerge:未合并字段的字段映射和处理
处理空字段
对于每个合并字段,FieldMerged事件可用于将字段映射到另一个数据列或设置自定义文本。以下代码将事件附加到MailMerge实例。RemoveEmptyFields属性必须设置为false才能处理这些空字
MailMerge:未合并字段的字段映射和处理
在事件处理程序中,未映射字段的文本被更改。
MailMerge:未合并字段的字段映射和处理
未处理的字段包含合并过程后的自定义文本。
MailMerge:未合并字段的字段映射和处理
如果不匹配,此事件还可用于添加自定义映射列表或字典,以表示给定数据源中的名称与模板中的合并字段之间的映射。
删除空段落
如果段落仅包含未处理的合并字段并在合并过程中变为空,则结果文档中可能不需要生成的空行。这些空行可以通过设置RemoveEmpty Lines 属性自动删除。
MailMerge:未合并字段的字段映射和处理
公司名称:北京哲想软件有限公司
北京哲想软件官方网站:cogitosoft.com
北京哲想软件微信公众平台账号:cogitosoftware
北京哲想软件微博:哲想软件
北京哲想软件邮箱:sales@ cogitosoft.com
销售(俞先生)联系方式: 86(010)68421378
微信:18610247936 QQ:368531638

我的更多文章

下载客户端阅读体验更佳

APP专享