Pemberitahuan otomatis dengan C# Mail Merge♰ Aspose.Words' Mail Merge Plugin

Mengautomatikkan penciptaan dokumen yang disesuaikan – seperti laporan, surat, dan invois – dapat meningkatkan efisiensi dalam aliran kerja Anda. Dengan C# Mail Merge yang didorong oleh Aspose.Words untuk .NET, Anda dapat mencapai hal ini dengan lancar. Panduan ini akan berjalan melalui Anda menggunakan Plugin Aspose-Word Mail merge untuk melakukan pengeluaran dokumen secara efektif dan scalable di dalam aplikasi .Net Anda – tanpa kebutuhan untuk MS Word atau Office Interop.

Kandungan

• Apa itu Mail Merge?
• Sumber Data untuk Mail Merge
• Menyiapkan Mail Merge Template
• Memulai dengan Aspose.Words untuk .NET
• Performa Mail Menggabungkan dengan Data Sampel
• Email digabungkan dengan data XML
• Custom Merge Field Formatting
• Mail bergabung dengan daerah
• Memasuki Mail Merge
• Kesimpulan

Apa itu Mail Merge?

Mail Merge adalah metodologi yang kuat untuk menghasilkan dokumen secara dinamis dengan populasi template dengan data dari berbagai sumber. Aspose.Words, Anda dapat mengautomatikkan tugas seperti:

• Menghasilkan surat dan invois yang disesuaikan.
• Mencipta laporan bulk menggunakan format terstruktur seperti XML, JSON, atau basis data, memungkinkan generasi laporan dinamis dengan C# dan Aspose.Words.

Sumber data untuk Mail Merge

Aspose.Words mendukung berbagai sumber data, termasuk:

• Objects: Templat populer menggunakan instans kelas.
• XML: Mengisi data terstruktur untuk medan dinamis.
• JSON: Mudah diintegrasikan dengan API modern.
• CSV: Menghapus data tabel untuk generasi dokumen bulk.
• DataTable/DataSet: Gunakan ADO.NET untuk integrasi database.

Persiapan Templat untuk Mail Merge

Templat penggabungan email adalah dokumen yang mengandung medan penggabungan yang akan dikumpulkan dengan data dari sumber data Anda yang ditentukan selama pelaksanaan. Templat dapat dalam format DOC atau DOCX dan tidak memerlukan gaya tertentu. Ikuti langkah-langkah ini untuk membuat templat penggabungan email:

• Buka dokumen Anda atau buat yang baru dalam MS Word.
• Letakkan kursor di mana Anda ingin memasukkan medan penggabungan.
• Dari menu Masukkan, pilih opsi Tempat.
• Dari daftar Nama lapangan , pilih MergeField .
• Tentukan nama untuk medan penggabungan di kotak Nama lapangan dan klik OK.
• Simpan dokumen tersebut.

Gambar layar berikut ini menggambarkan sebuah sampel template dokumen tersebut.

.NET Mail Merge API - Pemasangan

Anda dapat menginstal Aspose.Words untuk .NET melalui berbagai metode:

• Mengunduh DLL
• Menggunakan NuGet Package Manager

Performa Mail Merge dalam Word Document menggunakan C#

Setelah template Anda siap, Anda dapat melakukan penggabungan email untuk menghasilkan dokumen. berikut adalah langkah-langkah untuk melakukan penggabungan email pada template yang siap Anda:

• Mengisi template dokumen dengan menggunakan Dokumen Kelas yang
• Menetapkan pilihan penggabungan email yang diperlukan, seperti: Dokumentasi.MailMerge.TrimWhitespaces.
• Melakukan penggabungan email dengan menggunakan Pendaftaran.Pendaftaran (Pendaftaran) Metode, melewati sumber data sebagai parameter.
• Menyelamatkan dokumen yang dihasilkan menggunakan Pengelolaan ( String ) Metode yang

Berikut adalah sampel kode yang menunjukkan bagaimana untuk menghasilkan laporan otomatis dalam C# menggunakan berbagai nilai:

Dokumen Word setelah Mail Merge

Performa Mail Merge menggunakan XML Data Source dalam C#

File XML biasanya digunakan untuk menyimpan dan memindahkan data. Aspose.Words untuk .NET mendukung XML sebagai sumber data untuk operasi penggabungan email. DataSatu di bawah ini adalah sampel file XML untuk kasus penggunaan kami.

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

Sampel kode berikut mengambil data dari sumber data XML dan melakukan penggabungan email menggunakan C#.

Di bawah ini adalah mail merge. Templat yang akan dikumpulkan dengan data dari file XML.

Gambar ini mewakili halaman pertama dokumen Word yang dihasilkan yang diperoleh setelah melakukan penggabungan email.

Mengatur Fields yang disesuaikan

Aspose.Words untuk .NET memberikan kontrol yang lebih baik atas proses penggabungan email. Hal yang dapat dilakukan di MailMerge.FieldMergingCallback Properti memungkinkan Anda untuk mengkonfigurasi perilaku penggabungan email saat setiap medan penggaba ditemui. IFieldMergingCallback.FieldMerging dan IFieldMergingCallback.ImageFieldMerging Metode ini memungkinkan penyesuaian operasi penggabungan email.

Di bawah ini adalah sampel kode yang menunjukkan bagaimana untuk menerapkan pemformatan tersuai selama penggabungan email melalui sampel contoh yang disediakan:

Berikut ini dilaksanakan kelas HandleMergeFieldAlternatingRows.

Mail Merge dengan Regions menggunakan C#

Dalam beberapa kasus, Anda mungkin perlu mendokumentasikan dan mengulangi wilayah tertentu di dalam dokumen Word. Untuk skenario seperti itu, gunakan mail merger dengan wilayah.Untuk membuat wilayah, ketahui kedua permulaan dan akhir wilayah; mail Merger kemudian akan mengulang wilayah ini untuk setiap catatan dalam sumber data. Contoh template di bawah ini berisi dua wilayah—Perintah dan PerintahDetail—menggunakan medan mergers «TableStart:Order», «JadualAkhir:Orders»,» dan «Pakaian Akih:Rincian».

Berikut adalah sampel kode yang menjalankan penggabungan email berdasarkan wilayah untuk yang disebutkan sebelumnya Templat.

Metode berikut menggambarkan bagaimana membaca data dari database.

Memasuki postingan yang terpisah

Seringkali, data dari sumber terstruktur dalam format relatif. Contohnya, “Perintah” mungkin memiliki hubungan satu-ke-banyak dengan “OrderDetails”, yang menyimpan rekaman item di dalam perintah. Dalam skenario seperti itu, gunakan gabungan postingan. Di bawah ini adalah sampel Templat invois Ini cocok dengan skenario ini.

Berikut adalah sumber data XML untuk contoh penggabungan email kami.

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

File yang sesuai OrderSchema.xsd untuk XML ini adalah:

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

Sampel kode berikut mengeksekusi penggabungan email dengan menggunakan C#.

Dokumen Word setelah Mail Merge

Di bawah ini adalah halaman pertama dari dokumen Word yang dihasilkan yang diperoleh setelah melakukan penggabungan email.

Kesimpulan

Aspose.Words untuk .NET adalah API gabungan email yang komprehensif yang menyediakan fitur standar dan diperpanjang yang cocok untuk aplikasi .Net. Dengan hanya beberapa baris kode, Anda dapat mengembangkan laporan sederhana atau rumit dari berbagai sumber data dengan mudah. DokumentasiUntuk memulai dengan Aspose.Words untuk .NET, menjelajahi yang tersedia Panduan Pengembang dan sampel kode pada GitHub. Plugin Aspose juga menawarkan fungsi lanjutan untuk generasi laporan.

Cobalah Aspose.Words untuk .NET untuk Gratis

Anda dapat mendapatkan lisensi sementara gratis untuk mencoba Aspose.Words untuk .NET tanpa batasan. Dapatkan lisensi sementara Anda sekarang.

More in this category

• Konversi Word DOC/DOCX ke PDF dalam C# .NET dan Aspose.Words' Document Converter Plugin
• Hasilkan Barcode di Dokumen Word (.NET, C#) | Baca Barcode dari Word (.NET)
• Mengekstrak Gambar dari Dokumen Word dalam C# Pemrosesan Gambar otomatis
• Temukan dan menggantikan teks dalam dokumen Word menggunakan C# dan Automatic Word Editing
• Mencipta dokumen Word yang disesuaikan menggunakan C# .NET Aspose.Words Mail Merge Plugin