Kişiselleştirilmiş belgelerin oluşturulmasını otomatikleştirmek – örneğin raporlar, mektuplar ve faturalar – çalışma akışınızın verimliliğini önemli ölçüde arttırabilir. C# Mail Merge ile Aspose.Words for .NET tarafından güçlendirilir, bunu kolaylıkla elde edebilirsiniz. bu kılavuz, verimli ve ölçeklenebilir bir belge üretimi gerçekleştirmek için Plugin’i kullanarak size yol açacaktır. Message C# fonksiyonu kullanılarak raporlama çalışkanızı entegre etmek için donatılmış olacaksınız.

içeriği

Mail Merge Nedir? / Mail Merge Nedir?

Mail Merge, çeşitli kaynaklardan gelen verilerle şablonları nüfuz ederek dinamik olarak belgeleri oluşturmak için güçlü bir metodolojidir. Aspose.Words ile aşağıdaki gibi görevleri otomatik hale getirebilirsiniz:

  • Kişiselleştirilmiş mektuplar ve faturalar oluşturulur.
  • XML, JSON veya veritabanları gibi yapılandırılmış biçimleri kullanarak toplu raporlar oluşturmak, C# ve Aspose.Words** ile **dinamik rapor üretimi sağlar.

Mail Merge için veri kaynakları

Aspose.Words çeşitli veri kaynaklarını destekler, şunları da içerir:

  • Objects: Sınıf örneklerini kullanarak popüler şablonlar.
  • XML: Dinamik alanlar için yapılandırılmış verileri yükleyin.
  • JSON: Modern APIs ile kolayca entegre edilir.
  • CSV: Bulk belge üretimi için tablo verilerini kaldırın.
  • DataTable/DataSet: Veritabanı entegrasyonu için ADO.NET kullanın.

Mail Merge için Şablon Hazırlama

E-posta birleştirme şablonu, uygulama sırasında belirtilen veri kaynağınızdan gelen verilerle nüfuz edilecek birleştirme alanları içeren bir belgedir. şablon DOC veya DOCX biçiminde olabilir ve belirli bir tarz gerektirmez. birleştirme şablonu oluşturmak için bu adımları izleyin:

  • Belgenizi açın veya MS Word’de yeni bir belge oluşturun.
  • Birleşme alanı yerleştirmek istediğiniz yerde kursörü yerleştirin.
  • Giriş menüsünden Kaynak seçeneğini seçin.
  • Feld isimleri listesinden MergeField seçeneğini seçin.
  • Birleşme alanı için bir isim belirleyin Araç adı kutusunda ve OK tıklatın.
  • Belgeyi saklayın

Aşağıdaki ekran görüntüsü bir Örnek Şablon Bu belge.

Mail Merge Template

.NET Mail Merge API - Yükleme

Aspose.Words for .NET çeşitli yöntemlerle yüklenebilir:

C# kullanılarak Word Belgesinde Mail Birleşmeyi gerçekleştirin

Şablonunuz hazır olduğunda, belgeleri oluşturmak için e-posta birleşimini çalıştırabilirsiniz. burada hazırlanmış şablonunuzda e-posta birleşimini gerçekleştirmek için adımlar:

İşte bir kod örneği, bir dizi değer kullanarak C#‘da otomatik raporlama üretimi nasıl gösterilir:

E-posta Birleştikten Sonra Yazı Belgeleri

Execute Mail Merge in C#

C#‘da XML veri kaynağını kullanarak Mail Merge’i gerçekleştirin

XML dosyaları genellikle veri depolamak ve aktarmak için kullanılır. Aspose.Words için .NET, e-posta birleştirme işlemleri için bir veri kaynağı olarak XML’i destekler. DataSet aşağıda örnek XML dosyası bizim kullanım durumumuz için.

<customers>
    <customer Name="John Ben Jan" ID="1" Domain="History" City="Boston"/>
    <customer Name="Lisa Lane" ID="2" Domain="Chemistry" City="LA"/>
    <customer Name="Dagomir Zits" ID="3" Domain="Heraldry" City="Milwaukee"/>
    <customer Name="Sara Careira Santy" ID="4" Domain="IT" City="Miami"/>
</customers>

Aşağıdaki kod örneği, bir XML veri kaynağından verileri alır ve C# kullanılarak e-posta birleşmesini gerçekleştirir.

Aşağıda e-posta birleştirme Tapınağı XML dosyasından gelen verilerle popülasyon yapılacaktır.

Mail Merge Template for XML

Bu görüntü, e-posta birleşmesini gerçekleştirdikten sonra elde edilen sonuçlanan Word belgesinin ilk sayfasını temsil eder.

Execute Mail Merge with XML in C#

Birleşme alanlarının özelleştirilmiş biçimlendirmesi

Aspose.Words .NET için e-posta birleşme sürecinin kontrolünü arttırır. MailMerge.FieldMergingCallback İletişim Mülkiyet, e-posta birleştirme davranışını her bir birleşme alanı karşılaştığı gibi ayarlamayı sağlar. iFieldMergingCallback.FieldMerging İletişim ve iFieldMergingCallback.ImageFieldMerging Bu yöntemler, e-posta birleşme işlemi özelleştirilmesini sağlar.

Aşağıda, e-posta birleştirme sırasında özelleştirilmiş biçimlendirme nasıl uygulanacağını gösteren bir kod örneği sağlanan örnek şablonu aracılığıyla:

Aşağıda HandleMergeFieldAlternatingRows sınıfı uygulanır.

Mail Birleşme Bölgeler ile C# kullanarak

Bazı durumlarda, kelime belgesinde belirli bir bölgeyi nüfuz etmeniz ve tekrarlamanız gerekebilir. Bu tür senaryolar için, bölgelerle e-posta birleşmesini kullanın. Bölge oluşturmak için hem bölgenin başlangıcını hem de sonunu belirtin; posta birleştirme daha sonra veri kaynağındaki her kayıt için bu bölgesi tekrarlayacaktır. Aşağıdaki şablon örneği, “TableStart:OrderDetails” alanlarını kullanarak iki bölüm içerir.

Mail Merge Template with Regions

İşte yukarıda bahsedilen bölgelere göre e-posta birleşmesini gerçekleştiren bir kod örneği Tapınağı.

Aşağıdaki yöntemler, bir verilerin bir veritabanından nasıl okunabileceğini gösterir.

NESTED MAIL MERGE İÇİN TIKLAYIN

Çoğu zaman, kaynaktan gelen veriler ilişkisel biçimlerde yapılandırılır. Örneğin, “Hesaplar” bir sipariş içindeki öğelerin kayıtlarını tutan “Kayıt Detayları” ile bir-birinden bir ilişkiye sahip olabilir. Fatura Şablonu Bu senaryo çok iyi uyuyor.

Mail Merge Template with Regions

Aşağıda, kaydedilen e-posta birleştirme örneğimiz için bir XML veri kaynağıdır.

<?xml version="1.0" encoding ="utf-8"?>
<Orders xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="OrdersSchema.xsd">
    <Order>
        <Number>23</Number>
        <Address>Nelson Street</Address>
        <Suburb>Howick</Suburb>
        <City>Auckland</City>
        <Phonenumber>543 1234</Phonenumber>
        <Date>03/01/2010</Date>
        <Total>14.00</Total>
        <Item>
            <Name>BBQ Chicken Pizza</Name>
            <Price>6.00</Price>
            <Quantity>1</Quantity>
            <ItemTotal>6.00</ItemTotal>
        </Item>
        <Item>
            <Name>1.5 Litre Coke</Name>
            <Price>4.00</Price>
            <Quantity>2</Quantity>
            <ItemTotal>8.00</ItemTotal>
        </Item>
    </Order>
    <Order>
        <Number>10</Number>
        <Address>Parkville Avenue</Address>
        <Suburb>Pakuranga</Suburb>
        <City>Auckland</City>
        <Phonenumber>548 7342</Phonenumber>
        <Date>05/03/2010</Date>
        <Total>6.00</Total>
        <Item>
            <Name>Hawaiian Pizza</Name>
            <Price>4.00</Price>
            <Quantity>1</Quantity>
            <ItemTotal>4.00</ItemTotal>
        </Item>
        <Item>
            <Name>Fries</Name>
            <Price>1.00</Price>
            <Quantity>2</Quantity>
            <ItemTotal>2.00</ItemTotal>
        </Item>
    </Order>
</Orders>

Bu XML için OrderSchema.xsd dosyası şunlardır:

<?xml version="1.0" encoding ="utf-8"?>
<xs:schema id="OrdersSchema" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="Orders">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="Order">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="Number"/>
                            <xs:element name="Address"/>
                            <xs:element name="Suburb"/>
                            <xs:element name="City"/>
                            <xs:element name="Phonenumber"/>
                            <xs:element name="Date"/>
                            <xs:element name="Total"/>
                            <xs:element name="Item">
                                <xs:complexType>
                                    <xs:sequence>
                                        <xs:element name="Name"/>
                                        <xs:element name="Price"/>
                                        <xs:element name="Quantity"/>
                                        <xs:element name="ItemTotal"/>
                                    </xs:sequence>
                                </xs:complexType>
                            </xs:element>
                        </xs:sequence>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

Aşağıdaki kod örneği, C# kullanılarak nakit e-posta birleşimini gerçekleştirir.

E-posta Birleştikten Sonra Yazı Belgeleri

Aşağıda, kaydedilen e-posta birleşimini gerçekleştirdikten sonra elde edilen sonuçlanan Word belgesinin ilk sayfasını görüyoruz.

Word Document after Mail Merge

Sonuç

Aspose.Words için .NET hem standart hem de genişletilmiş özellikler sağlayan kapsamlı bir e-posta birleştirme API. sadece birkaç kod çizgisi ile, çeşitli veri kaynaklarından basit veya karmaşık raporlar geliştirebilirsiniz. .NET otomatik rapor oluşturma en iyi uygulamaları hakkında rehberlik için, lütfen Dokümanlık.NET için Aspose.Words ile başlamak için, mevcut olanı keşfedin Geliştirici Rehberi Örnek kodu üzerinde GitHub. Aspose Plugin ayrıca rapor oluşturma için gelişmiş fonksiyonlar sunar.

Aspose.Words için .NET için Ücretsiz

Sınırlamalar olmadan .NET için Aspose.Words denemek için ücretsiz bir geçici lisans elde edebilirsiniz. Şimdi geçici lisansınızı alın.

More in this category