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": "[email protected]", "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": "[email protected]", "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