Skip to content

Latest commit

 

History

History
146 lines (115 loc) · 9.24 KB

File metadata and controls

146 lines (115 loc) · 9.24 KB
date 2026-01-15
description تعلم كيفية عرض التغييرات المتتبعة في مستندات Word وعرض مراجعات ملفات Word باستخدام GroupDocs.Viewer للغة Java. اتبع هذا الدليل خطوة بخطوة للمطورين.
keywords
render tracked changes Word docs GroupDocs Viewer Java
GroupDocs Viewer Java setup
Java document rendering
title عرض التغييرات المتعقبة في مستندات Word باستخدام GroupDocs.Viewer للـ Java
type docs
url /ar/java/advanced-rendering/render-tracked-changes-word-docs-groupdocs-viewer-java/
weight 1

عرض تغييرات التتبع في مستندات Word باستخدام GroupDocs.Viewer للـ Java

إذا كنت بحاجة إلى عرض تغييرات التتبع في Word داخل تطبيق Java الخاص بك، فقد وجدت المكان المناسب. في هذا الدليل سنوضح لك كيفية عرض كل مراجعة، وإدراج، وحذف يظهر في ملف Word، وتحويله إلى HTML نظيف وسهل التنقل. سواء كنت تبني بوابة مراجعة مستندات، أو نظام إدارة قضايا قانونية، أو أي حل يجب أن يعرض مراجعات مستندات Word، فإن هذا البرنامج التعليمي يرافقك خلال العملية بالكامل—من إعداد البيئة إلى العرض النهائي.

عرض تغييرات التتبع في مستندات Word باستخدام GroupDocs.Viewer للـ Java

إجابات سريعة

  • ماذا يعني “عرض تغييرات التتبع في Word”؟ يحول علامات المراجعة في ملف Word إلى تمثيل بصري بصيغة HTML.
  • أي مكتبة تتولى ذلك؟ GroupDocs.Viewer للـ Java.
  • هل أحتاج إلى ترخيص؟ النسخة التجريبية المجانية تكفي للتقييم؛ الترخيص الكامل يزيل جميع القيود.
  • ما نسخة Java المطلوبة؟ Java 8 أو أحدث.
  • هل يمكن تعطيل عرض تغييرات التتبع؟ نعم—قم بتعيين setRenderTrackedChanges(false) في خيارات العرض.

ما هو “عرض تغييرات التتبع في Word”؟

يعني عرض تغييرات التتبع في Word أخذ بيانات المراجعة المخزنة داخل ملف .docx (الإدخالات، الحذف، التعليقات، إلخ) وإنتاج تنسيق قابل للعرض—عادةً HTML—حيث يتم تمييز هذه التغييرات بصريًا. يتيح ذلك للمستخدمين النهائيين رؤية ما تم تعديله بالضبط دون الحاجة إلى فتح Microsoft Word.

لماذا نستخدم GroupDocs.Viewer لعرض مراجعات مستندات Word؟

GroupDocs.Viewer للـ Java ي abstracts التعامل منخفض المستوى مع OpenXML ويقدم لك استدعاء API واحد لتوليد HTML أو PDF أو صور. كما يدعم عرض مراجعات مستندات Word مباشرةً، مع الحفاظ على الأنماط، والموارد المدمجة، وتتبع التغييرات.

المتطلبات المسبقة

  • مكتبة GroupDocs.Viewer للـ Java الإصدار 25.2 أو أحدث.
  • Maven لإدارة التبعيات.
  • بيئة تطوير Java أساسية (IDE، JDK 8+).

إعداد GroupDocs.Viewer للـ Java

تكوين Maven

أضف مستودع GroupDocs والاعتماد إلى ملف 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>

الحصول على الترخيص

ابدأ بالنسخة التجريبية المجانية أو اطلب ترخيص تقييم مؤقت. عندما تكون جاهزًا للإنتاج، اشترِ ترخيصًا كاملًا لفتح جميع الميزات.

التهيئة الأساسية

استورد الفئات المطلوبة في كود Java الخاص بك وحضر مسارات الملفات للإدخال والإخراج.

كيفية عرض تغييرات التتبع في مستندات Word

فيما يلي دليل خطوة بخطوة يعكس الكود الدقيق الذي ستحتاجه. تم الحفاظ على كتل الكود دون تعديل من البرنامج التعليمي الأصلي.

الخطوة 1: تعريف مسار دليل الإخراج

أنشئ مجلدًا سيتم حفظ صفحات HTML المولدة فيه.

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

الخطوة 2: تحديد الصيغة لحفظ كل صفحة

عيّن نمط تسمية لكل ملف HTML يتم إنشاؤه.

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

الخطوة 3: تكوين خيارات العرض

فعّل الموارد المدمجة وشغّل عرض تغييرات التتبع.

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

الخطوة 4: إنشاء كائن Viewer وإجراء العرض

حمّل مستند Word الذي يحتوي على تغييرات التتبع وولّد مخرجات HTML.

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

المشكلات الشائعة والحلول

  • مسارات الملفات غير صحيحة – تأكد من أن YOUR_OUTPUT_DIRECTORY و YOUR_DOCUMENT_DIRECTORY يشيران إلى مجلدات موجودة.
  • صيغة المستند غير مدعومة – تأكد من أن الملف هو .docx أو .doc يدعمه GroupDocs.Viewer.
  • الترخيص مفقود – بدون ترخيص صالح قد تقتصر قدرات المكتبة على العرض.

التطبيقات العملية

  1. أنظمة مراجعة المستندات – إظهار للمراجعين ما تم إضافته أو إزالته بالضبط.
  2. إدارة القضايا القانونية – تمييز التعديلات في العقود أو المرافعات.
  3. التعاون الأكاديمي – تصور مساهمات مؤلفين متعددين.

اعتبارات الأداء

  • عالج عددًا محدودًا من المستندات في وقت واحد للحفاظ على استهلاك الذاكرة منخفضًا.
  • استخدم هياكل دليلية فعّالة لتقليل عبء الإدخال/الإخراج.
  • حافظ على تحديث المكتبة؛ الإصدارات الأحدث تحتوي على تحسينات أداء.

الخلاصة

الآن لديك طريقة كاملة وجاهزة للإنتاج لعرض تغييرات التتبع في Word ولعرض مراجعات مستندات Word باستخدام GroupDocs.Viewer للـ Java. دمج هذه الخطوات في تطبيقك سيوفر للمستخدمين تجربة مراجعة مستندات قوية وتفاعلية.

قسم الأسئلة المتكررة

  1. ما هي أقل نسخة Java مطلوبة؟
    يُنصح عادةً بـ Java 8 أو أحدث لضمان التوافق مع المكتبات الحديثة مثل GroupDocs.Viewer.
  2. هل يمكنني عرض المستندات بدون تغييرات التتبع؟
    نعم، ما عليك سوى تعطيل setRenderTrackedChanges(true) في خيارات التكوين.
  3. كيف يمكنني التعامل مع المستندات الكبيرة بكفاءة؟
    فكر في تقسيم الملفات الكبيرة إلى أقسام أصغر أو استخدم تقنيات الترقيم لتقليل استهلاك الموارد.
  4. ما هي خيارات الترخيص لـ GroupDocs.Viewer؟
    يمكنك البدء بنسخة تجريبية مجانية، أو الحصول على ترخيص تقييم مؤقت، أو شراء ترخيص كامل وفقًا لاحتياجات مشروعك.
  5. هل هناك دعم متاح إذا واجهت مشاكل؟
    نعم، يمكنك الوصول إلى الدعم عبر منتدى GroupDocs والموارد الرسمية للتوثيق.

الموارد


آخر تحديث: 2026-01-15
تم الاختبار مع: GroupDocs.Viewer للـ Java 25.2
المؤلف: GroupDocs