---
title: "Mail Merge Mustache Sözdiziminden Şablon"
---


Aspose.Words, bilinen şablonlara ek olarak mustache sözdizimine sahip şablonlar oluşturmanıza olanak tanır. Mustache, şablonun verilerini içeren bir model nesnesi tarafından çevrelenen ve desteklenen etiket adlarından oluşan şablon sözdiziminin alternatif bir çeşididir.

Mustache sözdizimi, HTML ve TXT şablonlar gibi alanlar içermeyen şablonlarla kullanılacak tek seçenektir. Word şablonlarla, alanları veya Mustache sözdizimini kullanmak için iki seçeneğiniz vardır.

Mustache sözdizimi, Mail Merge'ı bölgelerle kullanmak için bir alternatif olan *foreach* etiketini destekler. Bu nedenle, herhangi bir nedenle birleştirme alanlarını ve birleştirme bölgelerini kullanamıyorsanız veya kullanmak istemiyorsanız mustache sözdizimini kullanabilmenizin yararı budur.

Aşağıdaki resimde gösterildiği gibi *foreach* etiketini kullanarak Mail Merge alanlarını bazı ek alanlarla da birleştirebilirsiniz.

<img src="mustache-syntax.png" alt="mustache_syntax_aspose_words_java" style="width:800px"/>

## Mustache Şablonu Oluşturma

Açıklığa kavuşturulması gereken ilk önemli nokta, Mustache 'nin şablonlayıcı bir motor olmamasıdır. Mustache, Aspose.Words tarafından desteklenen bir [load format](https://reference.aspose.com/words/java/com.aspose.words/loadformat/) içindeki herhangi bir şablon için kullanılabilen başka bir sözdizimi varyantıdır. Bu nedenle, böyle bir şablonu hem programlı olarak hem de bir arayüz aracılığıyla oluşturabilirsiniz, yalnızca belirli sözdizimini eklemeniz ve Mustache belirtimine uymanız yeterlidir.

Selamlamayı karşılık gelen adlarıyla kişiselleştirmek için aynı e-postayı 50 alıcıya göndermeniz gerektiğini varsayalım. Alıcının adını aşağıdaki gibi bir yer tutucuyla değiştirebilirsiniz:

> Dear {{FirstName}}
>
> I hereby...

Buradaki soru: 1 tek Mustache şablondan 50 e-postayı nasıl oluşturabilirsiniz? Bunu yanıtlamak için, şablondaki yer tutucuların küme parantezlerini gerçek verilerle dolduracak ve bir çıktı belgesi oluşturacak bölgelere sahip bir Mail Merge gerçekleştirmeniz gerekir.

<img src="mustache-template.png" alt="mustache_template_aspose_words_java" style="width:650px"/>

{{% alert color="primary" %}}

Yukarıdaki örnekte fark ettiğiniz gibi, Mustache 'de, küme ayraçlarını saat yönünde 90 derece döndürdüğünüzde mustache gibi görünen yer tutucular için küme ayraçları kullanmanız gerekir.

{{% /alert %}}

## Mustache Sözdizimi ile çalışın

Mustache, *for* döngüler ve *if* ve *else* koşullar gibi belirli kontrol akış ifadelerinden yoksun olduğu için mantıksız bir düzen olarak temsil edilir. Ancak koşullu değerlendirme ve döngü elde etmek için bölüm etiketleri işleme listelerini ve lambdaları kullanabilirsiniz. Bu nedenle, Mustache sözdizimini Mail Merge işlemine dahil etmek için [UseNonMergeFields](https://reference.aspose.com/words/java/com.aspose.words/mailmerge/#getUseNonMergeFields) özelliğini kullanmanız ve değerini *True* olarak ayarlamanız gerekir.

Aşağıdaki kod örneği, Mustache etiketlerinin belirli verilerle nasıl değiştirileceğini gösterir:

{{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-mail_merge-MailMergeUsingMustacheTemplateSyntax-MustacheSyntaxUsingDataTable.java" >}}

**UseNonMergeFields** özelliğini uygulamakla birlikte Mail Merge ile bölgeleri çalıştırmadan önce belge arasındaki farkı fark edebilirsiniz:

<img src="mustache-syntax-1.png" alt="mustache_syntax_aspose_words_java" style="width:400px"/>

{{% alert color="primary" %}}

Bir bölüm bir pound ile başlar ve bir eğik çizgi ile biter. Yani, `{{#foreach list}}` bir "foreach" bölümünü başlatırken `{{/foreach list}}` onu sonlandırır.

{{% /alert %}}

Ve Mail Merge 'ı bölgelerle uyguladıktan sonra:

<img src="mustache-syntax-2.png" alt="mustache_syntax_result_aspose_words_java" style="width:300px"/>

## Mail Merge Değerini Akıllı Hale Getirmek için `IF` Alanlarını Kullanın

Aspose.Words Mail Merge alanlarını ve Mustache etiketlerini `IF` ifadesiyle kullanmanıza izin verir. `IF` alanları, bir alan boşsa istenmeyen boşlukları ve virgülleri bastırmak için herhangi bir Mail Merge belgesinde kullanılabilir.

`IF` alan formülü aşağıda gösterilmiştir:

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

Burada Koşul, birleştirme alanı veya Mustache etiketi olabilir.

Örneğin, cinsiyete bağlı olarak "onun", "onun", "o" veya "o" eklemeniz gerekiyorsa `IF` alanlarını aşağıdaki gibi kullanabilirsiniz:

**{ IF { MERGEFIELD Gender } = "MALE" " doğru metin " " yanlış metin" }**

**{ IF "{{ GENDER }}" = "MALE" " doğru metin " " yanlış metin" }**

Aşağıdaki kod örneği, Mustache etiketleri ve `IF` alanlarıyla Mail Merge işleminin nasıl gerçekleştirileceğini gösterir:

{{< gist "aspose-words-gists" "827e71ccc0b8516a3cfe247b86ce6d4e" "Examples-src-main-java-com-aspose-words-examples-mail_merge-MailMergeUsingMustacheTemplateSyntax-UseOfIfElseMustacheSyntax.java" >}}

**UseNonMergeFields** özelliğini uygulamadan önce belge arasındaki farkı fark edebilirsiniz:

<img src="mustache-if-field-1.png" alt="mustache_if_field_aspose_words_java" style="width:800px"/>

Ve **UseNonMergeFields** özelliğini uyguladıktan sonra:

<img src="mustache-if-field-2.png" alt="mustache_if_field_2_aspose_words_java" style="width:800px"/>