Mail Merge Templat
Adalah umum untuk menggunakan templat gabungan sebagai dokumen dasar untuk operasi mail merge baik jika itu adalah mail merge sederhana atau mail merge dengan wilayah. Mail merge dengan wilayah lebih kuat dan populer daripada mail merge sederhana. mail merge sederhana dianggap sebagai kasus khusus mail merge dengan wilayah di mana wilayah tersebut merupakan keseluruhan dokumen. Semua dijelaskan pada artikel selanjutnya “Jenis Operasi Mail Merge” secara lebih rinci.
Templat memastikan bahwa teks dalam dokumen gabungan keluaran diformat dengan benar, dan operasi mail merge menjamin bahwa teks dari sumber data dimasukkan dengan benar ke dalam templat gabungan.
Aspose.Words menyediakan kemampuan untuk membuat templat mail merge untuk menentukan konten tetap dan kemudian membuat dokumen gabungan menggunakan bidang gabungan. Dengan demikian, templat penggabungan akan memiliki teks yang diperlukan, yang sama di semua dokumen keluaran, dan bidang penggabungan untuk mengisi konten yang berubah. Hasilnya, informasi dari sumber data yang ditentukan akan ditambahkan ke templat gabungan melalui bidang-bidang ini selama pembuatan dokumen gabungan.
Apa itu Templat Mail Merge
Templat mail merge adalah dokumen hasil personalisasi yang berisi data tetap dan bidang gabungan yang Anda inginkan untuk teks variabelnya. Templat gabungan dapat dalam format apa pun yang mendukung bidang, misalnya, DOC, DOCX, DOT, DOTX, RTF. Selain itu, Anda juga dapat menggunakan template mustache yang dijelaskan pada artikel “Sintaks TemplateMustache” secara lebih detail.
Anda dapat membuat templat gabungan untuk menjadi model dokumen baru, dan templat tersebut harus menyertakan teks utama yang harus sama untuk setiap versi dokumen yang digabungkan. Menambahkan bidang gabungan di dalam templat akan mewakili data personalisasi seperti nama atau alamat yang diambil dari sumber data. Operasi mail merge akan secara otomatis menyisipkan data personalisasi dari sumber data Anda ke dokumen templat gabungan Anda.
Selain itu, Anda dapat menambahkan wilayah mail merge di templat Anda dengan menyisipkan dua bidang mail merge untuk menandai awal dan akhir wilayah mail. Artikel selanjutnya “Jenis Operasi Mail Merge” menjelaskannya secara lebih rinci.
Buat Templat Mail Merge
Anda dapat membuat templat dan menambahkan bidang gabungan tertentu ke dalamnya, yang akan diganti dengan nilai dari sumber data baik secara manual, misalnya, menggunakan Microsoft Word, atau secara terprogram menggunakan Aspose.Words. Pada artikel ini, kita akan melihat cara terprogram untuk membuat template.
Gunakan kelas DocumentBuilder untuk membuat templat gabungan yang diperlukan menggunakan Aspose.Words. Anda dapat menyertakan teks, bidang gabungan, dan jeda baris dalam templat tersebut menggunakan metode InsertTextInput, InsetField, dan InsertParagraph.
Contoh kode berikut menunjukkan cara membuat templat mail merge:
Gambar di bawah ini menunjukkan template yang dibuat:
Menyesuaikan Properti Templat Mail Merge
Aspose.Words memungkinkan Anda menyesuaikan templat melalui banyak properti. Kustomisasi template akan dijelaskan di bawah ini melalui contoh penyesuaian beberapa properti gambar dan teks.
Sesuaikan Properti Gambar
Anda dapat menentukan properti gambar menggunakan kelas ImageFieldMergingArgs.
Contoh kode berikut menunjukkan cara menentukan nama file gambar dan ukuran gambar:
Sesuaikan Properti Teks
Anda dapat menggunakan properti Text untuk menyisipkan teks ke dalam dokumen untuk bidang penggabungan saat ini. Selain itu, Anda dapat mengubah pemformatan teks dan paragraf di dalam templat Anda menggunakan kelas Font dan ParagraphFormat. Anda dapat menangani teks yang akan disisipkan sebelum atau sesudah bidang penggabungan dengan menggunakan properti TextBefore dan TextAfter yang disertakan dalam kelas FieldMergeField.
Contoh kode berikut menunjukkan cara menyisipkan Kotak Centang atau HTML selama operasi mail merge:
Anda dapat mengunduh file contoh contoh ini dari Aspose.Words GitHub.
Anda juga dapat memeriksa implementasi kelas HandleMergeField dari Aspose.Words GitHub.
Lihat Juga
- Untuk detail lebih lanjut tentang cara membuat templat di Microsoft Word secara manual, silakan periksa Buat Templat artikel dalam Dokumentasi Microsoft