Mail Merge Шаблон из синтаксиса Mustache

Aspose.Words позволяет создавать шаблоны с синтаксисом mustache в дополнение к знакомым шаблонам. A Mustache - это альтернативный вариант синтаксиса шаблона, который состоит из имен тегов, заключенных в объект model, содержащий данные для шаблона, и поддерживается им.

Синтаксис Mustache - это единственный вариант, который можно использовать с шаблонами, не содержащими полей, такими как шаблоны HTML и TXT. В шаблонах Word у вас есть два варианта: либо использовать поля, либо синтаксис Mustache.

Синтаксис Mustache поддерживает тег foreach, который является альтернативой использованию Mail Merge с регионами. Таким образом, преимущество заключается в том, что вы можете использовать синтаксис mustache, если по какой-либо причине вы не можете или просто не хотите использовать поля слияния и области объединения.

Вы также можете объединить поля Mail Merge с некоторыми дополнительными полями, используя тег foreach, как показано на рисунке ниже.

Создайте шаблон Mustache

Первый важный момент, который следует прояснить, заключается в том, что Mustache не является механизмом создания шаблонов. Mustache - это другой вариант синтаксиса, который доступен для любого шаблона в формат загрузки, поддерживаемого Aspose.Words. Таким образом, вы можете создать такой шаблон как программно, так и через интерфейс, вам просто нужно включить определенный синтаксис и соответствовать спецификации Mustache.

Давайте предположим, что вам нужно отправить одно и то же электронное письмо 50 получателям, чтобы персонализировать приветствие, указав их соответствующие имена. Вы могли бы заменить имя получателя каким-либо заполнителем следующим образом:

Dear {{FirstName}}

I hereby…

Вопрос здесь: как вы можете создать 50 электронных писем из одного шаблона Mustache? Чтобы ответить на этот вопрос, вам нужно выполнить Mail Merge с регионами, чтобы заполнить фигурные скобки для заполнителей в шаблоне фактическими данными и сгенерировать выходной документ.

Как вы заметили из приведенного выше примера, в Mustache вам нужно использовать фигурные скобки для заполнителей, которые выглядят как mustache, когда вы поворачиваете фигурные скобки на 90 градусов по часовой стрелке.

Работа с синтаксисом Mustache

Mustache представлен в виде логического порядка, поскольку в нем отсутствуют какие-либо конкретные инструкции потока управления, такие как циклы for и условия if и else. Но вы можете использовать списки обработки тегов раздела и лямбда-выражения для выполнения условной оценки и циклирования. Таким образом, чтобы включить синтаксис Mustache в операцию Mail Merge, вам нужно будет использовать свойство UseNonMergeFields и установить его значение равным True.

В следующем примере кода показано, как заменить теги Mustache конкретными данными:

Вы можете заметить разницу между документами перед выполнением Mail Merge с регионами и применением свойства UseNonMergeFields:

Раздел начинается с запятой и заканчивается косой чертой. То есть {{#foreach list}} начинает раздел “для каждого”, а {{/foreach list}} завершает его.

И после применения Mail Merge к регионам:

Используйте поля IF, чтобы сделать Mail Merge интеллектуальным

Aspose.Words позволяет использовать Mail Merge поля и Mustache теги с инструкцией IF. Поля IF можно использовать в любом документе Mail Merge для устранения нежелательных пробелов и запятых, если поле пустое.

Формула поля IF приведена ниже:

{ IF [Condition] [Display Result 1] [Display Result 2] }

Здесь условием может быть либо поле слияния, либо тег Mustache.

Например, вы можете использовать поля IF, если вам нужно вставить “его”, “ее”, “он” или “она” в зависимости от пола следующим образом:

{ IF { MERGEFIELD Gender } = “MALE” " истинный текст" “ложный текст” }

{ IF “{{ GENDER }}” = “MALE” " истинный текст" “ложный текст” }

В следующем примере кода показано, как выполнить операцию Mail Merge с тегами Mustache и полями IF:

Вы можете заметить разницу между документами до применения свойства UseNonMergeFields:

И после применения свойства UseNonMergeFields: