Ana içeriğe geç
Blog · Belge otomasyonu

Mail birleştirme için Mustache şablonu nasıl oluşturulur?

18 Ekim 2022 · Mustache sözdizimini kullanarak bir posta birleştirme Word şablonu oluşturun. Belge oluşturma otomasyonu için dinamik tablolar içeren belgeler oluşturmayı öğrenin.

Posta birleştirme nedir?

Posta birleştirme, bir veri kaynağından veri okuma ve başka bir belgedeki karşılık gelen değişkenleri değiştirme yöntemidir. Genellikle iki dosya gerektirir: biri birleştirme alanlarını (eklenecek veriler için değişkeni) saklamak için; diğeri ise hem değişken verilerin biçimlendirilmesine ilişkin talimatları hem de posta birleştirmenin her sonucunda aynı olacak bilgileri içerir.

Örneğin, veriler bir veritabanından, JSON'dan, CSV'den, Excel elektronik tablolarından, Google Sheets'ten veya diğer yapılandırılmış veri biçimlerinden okunur ve e-postalar, faturalar veya dinamik verinin doldurulmasını gerektiren diğer belgeler için mevcut bir belge şablonuna eklenir. Şablonlar genellikle Word belgeleri, PDF'ler, e-postalar, form mektupları vb. olabilir.

Mustache sözdizimi kullanarak şablon nasıl oluşturulur?

Mustache ile Word şablonları oluşturmak, temel kodlar hakkında biraz bilgi gerektirir. Mustache bir şablonlama sözdizimi olmasa da, posta birleştirme için kullanılabilecek gelişmiş şablonlar oluşturmada değerli olabilir. Mustache sözdiziminin nasıl harika şablonlar oluşturmamıza yardımcı olabileceğini anlamak için aşağıdaki örneğe bakalım.

Yukarıdaki fatura şablonunda, her şeyin Mustache sözdizimi kullanılarak tasarlandığını görebilirsiniz. Bu Word şablonu, dinamik başlıklar, gövde, altbilgi ve hatta şablon içindeki tabloları tasarlamak için Mustache'ı kullanır.

Her bir sözdiziminin dinamik fatura oluşturmak için veri doldurmaya nasıl yardımcı olduğuna bakalım.

Başlık

{} - Başlığın başlangıcını işaretler. Başlık bölgesinin içine eklenecek sözdizimi: {{/foreach header}} - Başlığı kapatır.

Vücut - Zorunlu

{} - Belge gövdesindeki içeriğin başlangıcını işaretler. {{/foreach body}} - Belge gövdesinin sonunu işaretler.

Altbilgi

{} - Belge altbilgisinin başlangıcını ayarlar. Sözdizimi altbilgi bölgesinin içine eklenmelidir. {{/foreach footer}} - Belge altbilgisinin sonunu ayarlar.

Yukarıdaki örnek fatura için verileri JSON formatında Mustache şablonuna iletebilirsiniz. Aşağıda, yukarıdaki şablon için belge oluşturmaya yönelik örnek veriler yer almaktadır.

{ "Belgeler": [ { "başlık": { "belgeTürü": "Orijinal Kopya" }, "gövde": { "Sütun1": "Miktar", "Sütun2": "Açıklama", "Sütun3": "Birim Fiyat", "Sütun4": "Toplam", "Fatura": { "numara": 14957, "tarih": "25-02-2022", "talimatlar": "Talimat Faturası 1", "ara toplam": 200150, "vergi": "%18", "son ödeme tarihi": "25-03-2022", "kargo": "200" }, "Fatura Yetkilisi": { "telefon": "989797", "faks": "998463", "e-posta": "doc1@email.com", "web": "www.doc1.com", "adres": { "şirket": "Kuruluş 1", "sokak": "Sokak 1", "şehir": "Şehir 1", "posta kodu": "123456" } }, "Alıcı": { "isim": "alıcı 1", "adres": { "sokak": "testveien 3", "şehir": "Şehir 1", "posta kodu": "0555", "ülke": "Ülke 1" } }, "Ürün": [ { "miktar": 1, "açıklama": "ürün 1", "birim fiyat": 45, "toplam fiyat": 867 }, { "miktar": 2, "açıklama": "ürün 2", "birim fiyat": 123, "toplam fiyat": 3464 }, { "miktar": 3, "açıklama": "ürün 3", "birimfiyat": 323, "toplamfiyat": 6564 } ] }, "altbilgi": { "telefon": "telefon123", "faks": "faks123", "e-posta": "123@mail.com", "web": "www.123.com" }

} ] }

Şablonlardaki IF ifadeleri

Microsoft Word, IF ifadesiyle birlikte posta birleştirme alanları ve Mustache etiketlerini kullanmanıza olanak tanır. Bunlar, koşullu değerler içeren belgeler oluştururken kullanışlıdır. IF birleştirme alanı, bir koşul karşılanmadığında veya bir değer boş olduğunda istenmeyen boşlukların oluşmasını önler.

{ EĞER [Koşul] [Görüntülenen Değer 1] [Görüntülenen Değer 2] }

Örneğin

Belgelerinizi tamamlayın.

API ile ürününüze entegre edin, kod yazmadan otomatikleştirin veya tarayıcınızdaki ücretsiz araçları kullanın. Başlamak için kredi kartına gerek yok.

Tek bir aramayla başlayıncurl -X POST https://api.pdf4me.com/v1/ConvertToPdf

Ücretsiz erişim · Kredi kartı gerekmez