Bandingkan Dokumen Word di .NET: Penelusuran Revisi vs Mode Sorotan

Pendahuluan

Baik Anda bekerja dengan kontrak, kebijakan internal, spesifikasi teknis, atau salinan pemasaran, pola yang sama tetap: Anda dengan cepat mengumpulkan beberapa versi .docx dan pada suatu saat perlu melihat apa yang benar‑benar berubah di antaranya. Dialog Compare bawaan Word cukup untuk pemeriksaan manual sesekali, namun tidak terlalu membantu ketika perbandingan menjadi bagian dari proses rutin atau harus otomatis 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 untuk dokumen Word:

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

Dalam artikel ini kami akan menelusuri kedua pendekatan dengan contoh C# yang dapat dijalankan, mengeksplorasi kelas WordCompareOptions beserta propertinya, dan membahas kapan masing‑masing mode lebih masuk akal.

Prasyarat

Sebelum Anda memulai:

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

dotnet add package GroupDocs.Comparison

Sebuah berkas lisensi (GroupDocs.Comparison.lic). Tanpa berkas ini perpustakaan berjalan dalam mode evaluasi dengan watermark dan batas ukuran. Anda dapat meminta lisensi sementara untuk pengujian.
Dua file Word untuk dibandingkan — kami akan menyebutnya source.docx dan target.docx. Contoh konten:

`source.docx`	`target.docx`

Metode 1: Perbandingan Jejak Revisi

Kapan gunakan: peninjau 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 (jejak perubahan):

Comparison result in revision (track changes) mode

Apa yang terjadi di balik layar:

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

Karena mode revisi tidak perlu merender ulang konten dokumen — ia hanya menempelkan metadata revisi — biasanya menjadi yang lebih cepat di antara dua mode.

Metode 2: Perbandingan Mode Sorotan

Kapan gunakan: pemangku kepentingan menginginkan dokumen bersih yang jelas menunjukkan apa yang berubah tetapi tidak tertarik mengolah setiap revisi satu per satu. Skenario tipikal adalah manajer yang membuka versi terbaru di Word dan cepat‑cepat meninjau sorotan sisipan serta penghapusan 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 sorotan:

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 lewat WordCompareOptions / CompareOptions dan StyleSettings terkait).
Dokumen siap dibaca atau dicetak tanpa langkah tambahan.
Tidak ada metadata track‑changes yang ditambahkan ke berkas.

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

Menjelajahi WordCompareOptions

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

Di atas 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 singkat 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 sorotan), 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, mengalirkan perbedaan ke sistem peninjauan, atau mengagregasi 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, tetap dapat dibandingkan: kata sandi diberikan lewat 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 lisensi sementara — tidak memerlukan kartu kredit.

Pertanyaan yang Sering Diajukan

Q: Apakah saya memerlukan Microsoft Word atau Office terpasang di server?
A: Tidak. GroupDocs.Comparison adalah perpustakaan .NET mandiri; ia membaca dan menulis berkas DOCX secara langsung.

Q: Bisakah saya membandingkan dokumen dalam format lain selain Word?
A: Ya — perpustakaan ini mendukung PDF, spreadsheet Excel, presentasi, berkas teks biasa, dan banyak lagi. Daftar lengkap ada di dokumentasi.

Q: Apa yang terjadi jika saya tidak mengatur lisensi?
A: Perpustakaan berjalan dalam mode evaluasi. Dokumen output akan berisi watermark dan hanya beberapa halaman pertama yang diproses. Lisensi sementara menghapus batasan ini untuk pengujian.

Q: Bisakah saya menyesuaikan warna sorotan?
A: Warna default cukup untuk kebanyakan kasus. 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 peninjauan yang sudah dipakai tim Anda; mode sorotan memberikan ringkasan visual instan bagi orang yang hanya perlu melihat perubahan. Kelas WordCompareOptions memungkinkan Anda menyesuaikan output — mulai dari deteksi gaya dan atribusi penulis hingga perbandingan bookmark dan properti dokumen.

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

Pendahuluan#

Prasyarat#

Metode 1: Perbandingan Jejak Revisi#

Metode 2: Perbandingan Mode Sorotan#

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#