Mail Merge İşlem Türleri
Mail Merge ‘in ana fikri, şablonunuza ve veri kaynağınızdan getirilen verilere dayalı olarak otomatik olarak bir belge veya birden çok belge oluşturmaktır. Aspose.Words iki farklı türde Mail Merge işlemi gerçekleştirmenizi sağlar: bölgelerle basit Mail Merge ve Mail Merge.
Simple Mail Merge kullanmanın en yaygın örneği, farklı istemciler için adlarını belgenin başına ekleyerek bir belge göndermek istediğiniz zamandır. Bunu yapmak için şablonunuzda First Name ve Last Name gibi birleştirme alanları oluşturmanız ve ardından bunları veri kaynağınızdaki verilerle doldurmanız gerekir. Mail Merge ‘yi bölgelerle kullanmanın en yaygın örneği, her sipariş içindeki tüm öğelerin listesini içeren belirli siparişleri içeren bir belge göndermek istediğiniz zamandır. Bunu yapmak için, öğeler için gerekli tüm verilerle doldurmak için şablonunuzun içinde birleştirme bölgeleri oluşturmanız gerekir – her sipariş için kendi bölgeniz.
Her iki birleştirme işlemi arasındaki temel fark, basit Mail Merge ‘ın (bölgeler olmadan) her veri kaynağı kaydı başına belgenin tamamını yinelemesi, bölgelerle Mail Merge ise kayıt başına yalnızca belirlenmiş bölgeleri yinelemesidir. Basit bir Mail Merge işlemi, tek bölgenin tüm belge olduğu bölgelerle belirli bir birleştirme durumu olarak düşünebilirsiniz.
Basit Mail Merge İşlem
Şablonunuzun içindeki Mail Merge alanlarını veri kaynağınızdan gerekli verilerle doldurmak için basit bir Mail Merge kullanılır (tek tablo gösterimi). Yani Microsoft Word ‘daki klasik Mail Merge ‘e benzer.
Şablonunuza bir veya daha fazla birleştirme alanı ekleyebilir ve ardından basit Mail Merge işlemini gerçekleştirebilirsiniz. Şablonunuzda herhangi bir birleştirme bölgesi yoksa bunu kullanmanız önerilir.
Bu türü kullanmanın temel sınırlaması, veri kaynağındaki her kayıt için tüm belge içeriğinin tekrarlanacağıdır.
Basit Bir Mail Merge İşlemi Nasıl Yürütülür
Şablonunuz hazır olduğunda, basit Mail Merge işlemini gerçekleştirmeye başlayabilirsiniz. Aspose.Words, veri kaynağı olarak çeşitli veri nesnelerini kabul eden farklı Execute methods kullanarak basit bir Mail Merge işlemi gerçekleştirmenize olanak tanır.
Aşağıdaki kod örneği, Execute yönteminden birini kullanarak basit bir Mail Merge işleminin nasıl yürütüleceğini gösterir:
Basit mail merge çalıştırmadan önce belge arasındaki farkı fark edebilirsiniz:
Ve basit çalıştırdıktan sonra mail merge:
Birden Çok Birleştirilmiş Belge Nasıl Oluşturulur
Aspose.Words’da, standart Mail Merge işlemi yalnızca tek bir belgeyi veri kaynağınızdaki içerikle doldurur. Bu nedenle, çıktı olarak birden çok birleştirilmiş belge oluşturmak için Mail Merge işlemini birden çok kez yürütmeniz gerekecektir.
Aşağıdaki kod örneği, Mail Merge işlemi sırasında birden çok birleştirilmiş belgenin nasıl oluşturulacağını gösterir:
Mail Merge bölgelerle
Verilerinizle kolayca doldurabileceğiniz özel alanlara sahip olmak için şablonunuzda farklı bölgeler oluşturabilirsiniz. Şablonunuzda bu bölgeleri belirterek belgelerinizin dinamik olarak büyümesini sağlamak için tablolar, yinelenen veriler içeren satırlar eklemek istiyorsanız bölgelerle Mail Merge öğesini kullanın.
Bölgeleri birleştirmenin yanı sıra iç içe geçmiş (alt) bölgeler oluşturabilirsiniz. Bu türü kullanmanın temel avantajı, bir belgenin içindeki parçaları dinamik olarak artırmaktır. Bir sonraki makalede daha fazla ayrıntıya bakın “Bölgelerle İç içe Mail Merge”.
Bölgelerle Mail Merge Nasıl Yürütülür
Mail Merge bölgesi, bir belgenin içinde başlangıç noktası ve bitiş noktası olan belirli bir bölümdür. Her iki nokta da “TableStart:XXX” ve “TableEnd:XXX” belirli adlara sahip Mail Merge alanlar olarak temsil edilir. Mail Merge bölgesinde bulunan tüm içerikler, veri kaynağındaki her kayıt için otomatik olarak tekrarlanacaktır.
Aspose.Words, veri kaynağı olarak çeşitli veri nesnelerini kabul eden farklı Execute methods kullanan bölgelerle Mail Merge yürütmenize olanak tanır.
İlk adım olarak, daha sonra ExecuteWithRegions yöntemine bir giriş parametresi olarak iletmek için DataSet ‘i oluşturmamız gerekiyor:
Aşağıdaki kod örneği, ExecuteWithRegions(DataSet) yöntemini kullanarak bölgelerle Mail Merge’in nasıl çalıştırılacağını gösterir:
Bölgelerle Mail Merge çalıştırmadan önce belge arasındaki farkı fark edebilirsiniz:
Ve Mail Merge ‘ı bölgelerle çalıştırdıktan sonra:
Mail Merge ‘ın Bölgelerle Sınırlamaları
Bölgelerle Mail Merge gerçekleştirirken göz önünde bulundurmanız gereken bazı önemli noktalar vardır:
- Başlangıç noktasının TableStart:Orders ve bitiş noktasının TableEnd:Orders her ikisinin de aynı satırda veya hücrede olması gerekir. Örneğin, bir tablonun hücresinde birleştirme bölgesi başlatırsanız, birleştirme bölgesini ilk hücreyle aynı satırda sonlandırmanız gerekir.
- Birleştirme alanı adı, DataTable öğenizdeki sütunun adıyla eşleşmelidir. Eşlenen alanları belirtmediğiniz sürece, bölgeleri olan Mail Merge, sütunun adından farklı bir ada sahip herhangi bir birleştirme alanı için başarılı olmaz.
Bu kurallardan biri ihlal edilirse, beklenmeyen sonuçlar alırsınız veya bir istisna atılabilir.