Bandingkan Dokumen Word di .NET: Revision‑Track vs Mode Sorotan

Pendahuluan

Apakah Anda bekerja dengan kontrak, kebijakan internal, spesifikasi teknis, atau salinan pemasaran, pola tetap sama: Anda dengan cepat mengumpulkan beberapa versi .docx dan pada suatu saat perlu melihat apa yang tepat berubah di antara mereka. Dialog Compare bawaan Word cukup untuk pemeriksaan manual sesekali, tetapi tidak banyak membantu ketika perbandingan menjadi bagian dari proses reguler atau harus diotomatisasi di sisi server.

GroupDocs.Comparison for .NET memungkinkan Anda menjalankan perbandingan tersebut dari kode dan menghasilkan hasil dalam format yang disukai peninjau Anda. Perpustakaan ini mendukung dua mode output perbandingan untuk dokumen Word:

Revision mode — perbedaan ditulis sebagai markup revisi Word (track‑changes). Reviewer membuka file, melihat kontrol Review → Accept / Reject yang familiar, dan memproses perubahan satu per satu.
Highlight mode — teks yang disisipkan, dihapus, dan diubah ditampilkan dengan sorotan warna langsung di badan dokumen, sehingga perbedaan terlihat sekilas saat Anda membaca teks akhir.

Dalam artikel ini kami akan membahas kedua pendekatan dengan contoh C# yang berfungsi, menjelajahi kelas WordCompareOptions dan propertinya, serta mendiskusikan kapan setiap mode lebih masuk akal.

Prasyarat

.NET 6.0 atau lebih baru.
GroupDocs.Comparison for .NET — instal melalui NuGet:

dotnet add package GroupDocs.Comparison

File license (GroupDocs.Comparison.lic). Tanpa itu library berjalan dalam mode evaluasi dengan watermark dan batas ukuran. Anda dapat meminta temporary license untuk pengujian.
Dua file Word untuk dibandingkan — kami akan menyebutnya source.docx dan target.docx. Contoh konten:

`source.docx`	`target.docx`

Metode 1: Perbandingan Revision‑Track

Kapan digunakan: reviewer perlu menerima atau menolak setiap perubahan secara individual di Microsoft Word menggunakan alat Review → Accept / Reject bawaan — misalnya, selama negosiasi kontrak atau siklus persetujuan kebijakan.

using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;

using (var comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");

    var options = new WordCompareOptions
    {
        DetectStyleChanges = true,
        DisplayMode = WordCompareOptions.ComparisonDisplayMode.Revisions
    };

    comparer.Compare("result_revision.docx", options);
}

Dokumen hasil dalam mode revisi (track changes):

Comparison result in revision (track changes) mode

Apa yang terjadi di balik layar:

ComparisonDisplayMode.Revisions memberi tahu mesin untuk menghasilkan markup track‑changes Word asli.
DetectStyleChanges = true membuat perbandingan menangkap perbedaan format (tebal, ukuran font, warna) bersama dengan edit teks.
File output terbuka di Microsoft Word dengan panel Review siap — setiap penyisipan, penghapusan, dan penyesuaian gaya terdaftar dan dapat diterima atau ditolak.

Karena mode revisi tidak perlu merender ulang konten dokumen — ia hanya menambahkan metadata revisi — biasanya lebih cepat dibandingkan dua mode.

Metode 2: Perbandingan Highlight‑Mode

Kapan digunakan: pemangku kepentingan menginginkan dokumen bersih yang jelas menunjukkan apa yang berubah tetapi tidak tertarik mengerjakan setiap revisi. Skenario tipikal adalah manajer yang membuka versi terbaru di Word dan cepat memindai penyisipan serta penghapusan yang disorot untuk memahami dampak pembaruan.

using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;

using (var comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");

    var options = new WordCompareOptions
    {
        DetectStyleChanges = true,
        DisplayMode = WordCompareOptions.ComparisonDisplayMode.Highlight
    };

    comparer.Compare("result_highlighted.docx", options);
}

Dokumen hasil dalam mode highlight:

Apa yang terjadi di balik layar:

ComparisonDisplayMode.Highlight menampilkan perbedaan sebagai sorotan warna inline — merah untuk penghapusan, hijau untuk penyisipan, biru untuk perubahan gaya (warna default yang dapat disesuaikan melalui WordCompareOptions / CompareOptions dan StyleSettings terkait).
Dokumen siap dibaca atau dicetak tanpa langkah tambahan.
Tidak ada metadata track‑changes yang ditambahkan ke file.

Mode highlight melakukan lebih banyak pekerjaan secara internal karena harus memodifikasi konten dokumen sebenarnya dan menerapkan format. Untuk file besar Anda mungkin melihat perbedaan kinerja yang signifikan dibandingkan mode revisi.

Menjelajahi WordCompareOptions

Kedua contoh di atas menggunakan WordCompareOptions — kelas yang mewarisi pengaturan umum dari CompareOptions dan menambahkan properti khusus untuk dokumen Word. Melalui tipe ini Anda mengontrol mode tampilan (DisplayMode), apakah melacak perubahan gaya (DetectStyleChanges), nama penulis yang muncul pada revisi (RevisionAuthorName), cara penanganan jeda baris, bookmark, dll.

Selain itu, CompareOptions dasar mengekspos gaya untuk item yang disisipkan, dihapus, dan diubah (InsertedItemStyle, DeletedItemStyle, ChangedItemStyle), sehingga Anda dapat menyesuaikan warna dan format sorotan bila diperlukan.

Berikut contoh kecil mengonfigurasi opsi untuk pemeriksaan teks‑saja dalam mode revisi:

var options = new WordCompareOptions
{
    DisplayMode = WordCompareOptions.ComparisonDisplayMode.Revisions,
    DetectStyleChanges = false,
    RevisionAuthorName = "QA Bot",
    CompareBookmarks = true
};

Mendapatkan Perubahan Secara Programatik

Terlepas dari mode output yang Anda pilih (revisi atau highlight), Anda selalu dapat memperoleh daftar terstruktur perbedaan yang terdeteksi melalui API umum Comparer.GetChanges. Metode ini bekerja untuk Word dan semua format lain yang didukung.

using (var comparer = new Comparer("source.docx"))
{
    comparer.Add("target.docx");

    comparer.Compare("result_revision.docx");

    var changes = comparer.GetChanges(); // returns ChangeInfo[]
}

Ini berguna ketika Anda perlu memproses perubahan dalam alur kerja Anda sendiri — misalnya, untuk membuat laporan HTML khusus, memasukkan perbedaan ke sistem review, atau mengumpulkan statistik tentang edit. Lihat referensi API resmi untuk detail lebih lanjut: Comparer.GetChanges.

Bekerja dengan Dokumen yang Dilindungi Kata Sandi

Jika dokumen dilindungi dengan kata sandi, mereka masih dapat dibandingkan: kata sandi diteruskan melalui LoadOptions saat membuat Comparer. Pendekatan ini bekerja sama untuk Word, PDF, dan format lain yang didukung.

using GroupDocs.Comparison;
using GroupDocs.Comparison.Options;

using (var comparer = new Comparer("source_protected.docx",
    new LoadOptions { Password = "secret" }))
{
    comparer.Add("target_protected.docx");

    var options = new WordCompareOptions
    {
        DisplayMode = WordCompareOptions.ComparisonDisplayMode.Revisions
    };

    comparer.Compare("result_protected.docx", options);
}

Dapatkan Versi Percobaan Gratis

Anda dapat mengunduh GroupDocs.Comparison for .NET dari halaman rilis resmi. Untuk pengujian tanpa batas, minta temporary license — tidak memerlukan kartu kredit.

Pertanyaan yang Sering Diajukan

T: Apakah saya perlu menginstal Microsoft Word atau Office di server?
J: Tidak. GroupDocs.Comparison adalah pustaka .NET mandiri; ia membaca dan menulis file DOCX secara sendiri.

T: Bisakah saya membandingkan dokumen dalam format lain selain Word?
J: Ya — pustaka mendukung PDF, spreadsheet Excel, presentasi, file teks biasa, dan banyak lagi. Daftar lengkap ada di documentation.

T: Apa yang terjadi jika saya tidak mengatur lisensi?
J: Pustaka berjalan dalam mode evaluasi. Dokumen output akan berisi watermark dan hanya beberapa halaman pertama yang diproses. temporary license menghapus pembatasan ini untuk pengujian.

T: Bisakah saya menyesuaikan warna highlight?
J: Warna default bekerja untuk kebanyakan kasus penggunaan. Untuk kontrol styling lanjutan, periksa properti StyleSettings pada CompareOptions.

Kesimpulan

GroupDocs.Comparison for .NET memberi Anda dua cara bersih untuk membandingkan dokumen Word dari kode. Mode revisi terhubung langsung ke alur kerja review yang sudah digunakan tim Anda; mode highlight memberikan ringkasan visual instan bagi orang yang hanya perlu melihat perubahan. Kelas WordCompareOptions memungkinkan Anda menyesuaikan output — dari deteksi gaya dan atribusi penulis hingga perbandingan bookmark dan properti dokumen.

Pilih mode yang sesuai dengan skenario Anda, atau hasilkan keduanya dan biarkan setiap audiens memilih tampilan yang mereka sukai.

Pendahuluan#

Prasyarat#

Metode 1: Perbandingan Revision‑Track#

Metode 2: Perbandingan Highlight‑Mode#

Menjelajahi WordCompareOptions#

Mendapatkan Perubahan Secara Programatik#

Bekerja dengan Dokumen yang Dilindungi Kata Sandi#

Dapatkan Versi Percobaan Gratis#

Pertanyaan yang Sering Diajukan#

Kesimpulan#

Sumber Daya Tambahan#