Menghasilkan html dari docx dan merender perubahan yang dilacak dalam Java

Dalam panduan ini Anda akan belajar cara generate html from docx sambil mempertahankan setiap revisi yang dilacak yang muncul dalam file Word sumber. Apakah Anda sedang membangun portal peninjauan kontrak, sistem manajemen kasus hukum, atau UI penyuntingan kolaboratif, merender perubahan yang dilacak sebagai HTML memungkinkan pengguna melihat secara tepat apa yang ditambahkan, dihapus, atau dikomentari—tanpa perlu menginstal Microsoft Word. Tutorial ini memandu Anda melalui konfigurasi Maven, lisensi, dan kode Java lengkap yang diperlukan untuk menghasilkan halaman HTML yang bersih dan dapat dinavigasi.

Render perubahan yang dilacak dalam dokumen Word dengan GroupDocs.Viewer untuk Java

Render Perubahan yang Dilacak dalam Dokumen Word dengan GroupDocs.Viewer untuk Java

Jawaban Cepat

  • Apa arti “render word tracked changes”? Ini mengonversi markup revisi file Word menjadi representasi HTML visual dengan sorotan untuk penyisipan, penghapusan, dan komentar.
  • Perpustakaan mana yang menangani ini? GroupDocs.Viewer untuk Java menyediakan satu API untuk merender HTML, PDF, atau gambar serta menyertakan markup perubahan yang dilacak.
  • Apakah saya memerlukan lisensi? Versi percobaan gratis dapat digunakan untuk evaluasi; lisensi penuh menghapus semua batasan percobaan dan memungkinkan rendering dalam volume tinggi.
  • Versi Java apa yang diperlukan? Java 8 atau yang lebih baru didukung; perpustakaan ini kompatibel dengan Java 11, 17, dan rilis LTS selanjutnya.
  • Bisakah saya menonaktifkan rendering perubahan yang dilacak? Ya—atur setRenderTrackedChanges(false) pada opsi tampilan untuk menghasilkan dokumen bersih tanpa sorotan revisi.

Apa itu render word tracked changes?

Merender perubahan yang dilacak pada Word berarti mengambil data revisi yang disimpan di dalam file .docx (penyisipan, penghapusan, komentar, dll.) dan menghasilkan format yang dapat dilihat—biasanya HTML—di mana perubahan tersebut disorot secara visual. Ini memungkinkan pengguna akhir melihat secara tepat apa yang diubah tanpa membuka Microsoft Word.

Mengapa menggunakan GroupDocs.Viewer untuk melihat revisi dokumen Word?

GroupDocs.Viewer untuk Java menyederhanakan penanganan OpenXML tingkat rendah dan memberi Anda satu panggilan API untuk menghasilkan HTML, PDF, atau gambar. Ia mendukung lebih dari 120 format dan dapat merender dokumen hingga 2 GB tanpa memuat seluruh file ke memori, yang meningkatkan waktu respons dan mengurangi beban server. Perpustakaan ini juga mempertahankan gaya, sumber daya tersemat, dan informasi pelacakan perubahan secara langsung.

Prasyarat

  • GroupDocs.Viewer for Java versi perpustakaan 25.2 atau lebih baru.
  • Maven untuk manajemen dependensi.
  • Lingkungan pengembangan Java (IDE, JDK 8+).
  • Kunci lisensi evaluasi atau produksi (versi percobaan tersedia).

Menyiapkan GroupDocs.Viewer untuk Java

Konfigurasi Maven

Add the GroupDocs repository and dependency to your pom.xml:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

Akuisisi Lisensi

Mulailah dengan versi percobaan gratis atau minta lisensi evaluasi sementara. Ketika Anda siap untuk produksi, beli lisensi penuh untuk membuka semua fitur dan menghapus watermark percobaan.

Inisialisasi Dasar

Kelas Viewer memuat dokumen dan menyediakan kemampuan rendering. Kelas ViewOptions memungkinkan Anda menyesuaikan cara dokumen dirender, termasuk apakah perubahan yang dilacak ditampilkan.

Cara menghasilkan html dari docx dan merender perubahan yang dilacak

Muat file DOCX Anda dengan kelas Viewer, konfigurasikan ViewOptions untuk mengaktifkan rendering perubahan yang dilacak, dan panggil render untuk menghasilkan serangkaian halaman HTML. Seluruh proses hanya memerlukan beberapa baris kode dan secara otomatis menangani gambar tersemat, tabel, serta tata letak kompleks.

Langkah 1: tentukan jalur direktori output

Buat folder tempat halaman HTML yang dirender akan disimpan.

Path outputDirectory = YOUR_OUTPUT_DIRECTORY.resolve("RenderTrackedChanges");

Langkah 2: tentukan format untuk menyimpan setiap halaman

Tetapkan pola penamaan untuk setiap file HTML yang dihasilkan.

Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

Langkah 3: konfigurasikan opsi tampilan

Aktifkan sumber daya tersemat dan nyalakan rendering perubahan yang dilacak.

ViewOptions memungkinkan Anda menyesuaikan pipeline rendering; kelas ini menyediakan properti seperti setRenderTrackedChanges dan setRenderEmbeddedResources. Secara default, gambar tersemat disimpan bersama file HTML, memastikan tampilan web yang berfungsi penuh.

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
viewOptions.getWordProcessingOptions().setRenderTrackedChanges(true);

Langkah 4: buat instance viewer dan render

Kelas Viewer adalah komponen inti GroupDocs.Viewer yang memuat dokumen dan merendernya ke format yang diinginkan.

try (Viewer viewer = new Viewer(YOUR_DOCUMENT_DIRECTORY.resolve("SAMPLE_DOCX_WITH_TRACKED_CHANGES"))) {
    viewer.view(viewOptions);
}

Cara merender perubahan dalam dokumen Word – jebakan umum

Jika Anda melewatkan langkah penting, output mungkin kehilangan revisi atau gagal memuat sumber daya. Masalah yang paling sering terjadi adalah jalur file yang salah, format dokumen yang tidak didukung, dan lisensi yang hilang. Pastikan Anda mengarahkan ke direktori yang ada, menggunakan file .docx/.doc yang didukung, dan menyediakan kunci lisensi yang valid sebelum memanggil render.

  • Jalur file tidak tepat – Periksa kembali bahwa YOUR_OUTPUT_DIRECTORY dan YOUR_DOCUMENT_DIRECTORY mengarah ke folder yang ada.
  • Format dokumen tidak didukung – Pastikan file tersebut adalah .docx atau .doc yang didukung oleh GroupDocs.Viewer.
  • Lisensi hilang – Tanpa lisensi yang valid, perpustakaan dapat membatasi kemampuan rendering atau menyematkan watermark percobaan.

Aplikasi Praktis

  1. Sistem peninjauan dokumen – Tampilkan kepada peninjau secara tepat apa yang ditambahkan atau dihapus, dengan sorotan inline.
  2. Manajemen kasus hukum – Sorot amandemen dalam kontrak atau gugatan untuk jejak audit yang mudah.
  3. Kolaborasi akademik – Visualisasikan kontribusi dari banyak penulis dalam satu tampilan HTML yang dapat dicari.

Pertimbangan Kinerja

  • Proses sejumlah dokumen secara bersamaan secara terbatas untuk menjaga penggunaan memori tetap rendah.
  • Gunakan struktur direktori yang efisien untuk mengurangi beban I/O.
  • Pertahankan perpustakaan tetap terbaru; rilis yang lebih baru mengandung optimasi kinerja yang dapat merender dokumen 500 halaman dalam kurang dari 5 detik pada server tipikal.

Kesimpulan

Anda kini memiliki metode lengkap yang siap produksi untuk generate html from docx dan render word tracked changes menggunakan GroupDocs.Viewer untuk Java. Integrasikan langkah-langkah ini ke dalam aplikasi Anda, dan Anda akan memberikan pengguna pengalaman peninjauan dokumen yang kuat dan interaktif yang berfungsi di semua peramban dan perangkat tanpa memerlukan Microsoft Office.

Pertanyaan yang Sering Diajukan

Q: Apa versi minimum Java yang diperlukan?
A: Java 8 atau yang lebih baru disarankan; perpustakaan ini juga kompatibel dengan Java 11, 17, dan rilis LTS yang lebih baru.

Q: Bisakah saya merender dokumen tanpa perubahan yang dilacak?
A: Ya, atur setRenderTrackedChanges(false) dalam ViewOptions untuk menghasilkan HTML bersih tanpa sorotan revisi.

Q: Bagaimana cara menangani dokumen besar secara efisien?
A: Bagi file besar menjadi bagian‑bagian, gunakan opsi paginasi, dan pertahankan perpustakaan tetap terbarui—Versi 25.2 memproses dokumen 500 halaman dalam kurang dari 5 detik pada perangkat keras standar.

Q: Apa opsi lisensi untuk GroupDocs.Viewer?
A: Mulailah dengan versi percobaan gratis, dapatkan lisensi evaluasi sementara, atau beli lisensi komersial penuh yang menghapus semua batasan dan menyediakan dukungan prioritas.

Q: Apakah dukungan tersedia jika saya mengalami masalah?
A: Ya, Anda dapat memperoleh bantuan melalui forum GroupDocs, dokumentasi resmi, dan tiket dukungan langsung untuk pelanggan berlisensi.


Terakhir Diperbarui: 2026-09-25
Diuji Dengan: GroupDocs.Viewer for Java 25.2
Penulis: GroupDocs

Sumber Daya

Tutorial Terkait