use_non_merge_fields property

MailMergeOptions.use_non_merge_fields property

When True, specifies that in addition to MERGEFIELD fields, mail merge is performed into some other types of fields and also into “{{fieldName}}” tags.

@property
def use_non_merge_fields(self) -> bool:
    ...

@use_non_merge_fields.setter
def use_non_merge_fields(self, value: bool):
    ...

Remarks

Normally, mail merge is only performed into MERGEFIELD fields, but several customers had their reporting built using other fields and had many documents created this way. To simplify migration (and because this approach was independently used by several customers) the ability to mail merge into other fields was introduced.

When MailMergeOptions.use_non_merge_fields is set to True, Aspose.Words will perform mail merge into the following fields:

MERGEFIELD FieldName

MACROBUTTON NOMACRO FieldName

IF 0 = 0 “{FieldName}” ""

Also, when MailMergeOptions.use_non_merge_fields is set to True, Aspose.Words will perform mail merge into text tags “{{fieldName}}”. These are not fields, but just text tags.

See Also

MailMergeOptions.unconditional_merge_fields_and_regions property MailMergeOptions.use_whole_paragraph_as_region property