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.

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 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.

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.

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 ö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:

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

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.

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

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:

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