كيفية استخدام GroupDocs Viewer لعرض مستندات المشروع حسب فترات زمنية في Java

في هذا البرنامج التعليمي ستتعلم كيفية create html view mpp باستخدام GroupDocs Viewer for Java، مما يتيح لك عرض أجزاء فقط من ملف Microsoft Project التي تقع ضمن نطاق تاريخ بدء وتاريخ انتهاء محدد. سنستعرض إعداد Maven، الترخيص، واستدعاءات API الدقيقة التي تحتاجها لتضمين عروض خط الزمن مباشرةً في تطبيقاتك.

عرض مستندات المشروع حسب فترات زمنية باستخدام GroupDocs.Viewer for Java

للحصول على معاينة، راجع عرض مستندات المشروع حسب فترات زمنية باستخدام GroupDocs.Viewer for Java.

الإجابات السريعة

  • ما الذي تفعله الميزة؟ تقوم بعرض الجزء فقط من ملف Microsoft Project الذي يقع بين تاريخ بدء وتاريخ انتهاء.
  • ما هو تنسيق الإخراج المستخدم؟ HTML مع موارد مدمجة، مثالي لتكامل الويب.
  • هل أحتاج إلى ترخيص؟ النسخة التجريبية المجانية تعمل للتقييم؛ يلزم ترخيص كامل للإنتاج.
  • هل يمكنني تغيير نطاق التاريخ أثناء التشغيل؟ نعم—قم بتعديل قيم setStartDate و setEndDate في خيارات العرض.
  • هل هذا مدعوم على جميع إصدارات Java؟ يعمل مع Java 8+ طالما تستخدم GroupDocs.Viewer 25.2 أو أحدث.

ما هو create html view mpp؟

create html view mpp هو عملية تحويل ملف Microsoft Project (.mpp أو .mpt) إلى مجموعة من صفحات HTML تمثل الجدول الزمني. يقوم GroupDocs Viewer بإجراء التحويل على جانب الخادم، بحيث يمكنك عرض خط الزمن في أي متصفح دون تثبيت Microsoft Project.

لماذا عرض مستندات المشروع بفترات زمنية؟

يعرض فقط الفاصل الزمني المطلوب يقلل من حجم HTML المُولد، يسرّع تحميل الصفحة، ويسمح لك بالتركيز على مرحلة المشروع المحددة التي تحتاج إلى تحليلها. هذا العرض المستهدف مثالي للوحة التحكم، تقارير الحالة، أو تضمينه في أدوات إدارة المشاريع المخصصة حيث تكون بيانات المشروع الكامل مرهقة.

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

  • GroupDocs.Viewer for Java الإصدار 25.2 أو أعلى.
  • Java Development Kit (JDK) 8 أو أحدث.
  • بيئة تطوير متكاملة (IDE) مثل IntelliJ IDEA أو Eclipse.
  • معرفة أساسية بـ Maven.

إعداد GroupDocs.Viewer for Java

تبعية Maven

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

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

  1. نسخة تجريبية مجانية – قم بتنزيل نسخة تجريبية من GroupDocs’ download page.
  2. ترخيص مؤقت – احصل على ترخيص مؤقت للاختبار الموسع عبر temporary‑license page.
  3. شراء – للاستخدام الإنتاجي غير المحدود، اشترِ ترخيصًا من GroupDocs Purchase Page.

تهيئة المشاهد الأساسي

Viewer هو الفئة الرئيسية في GroupDocs.Viewer for Java التي تقوم بتحميل المستند وتوفر إمكانيات العرض.

import com.groupdocs.viewer.Viewer;

public class ViewerSetup {
    public static void main(String[] args) {
        try (Viewer viewer = new Viewer("path/to/your/document.mpp")) {
            // Your rendering code goes here
        }
    }
}

استرجاع معلومات العرض لملفات المشروع

ProjectManagementViewInfo يوفر بيانات تعريفية حول ملف Microsoft Project، بما في ذلك تاريخ بدء وانتهاء الجدول الزمني العام.

import com.groupdocs.viewer.options.ViewInfoOptions;
import com.groupdocs.viewer.results.ProjectManagementViewInfo;

ViewInfoOptions viewInfoOptions = ViewInfoOptions.forHtmlView();
ProjectManagementViewInfo viewInfo = (ProjectManagementViewInfo) viewer.getViewInfo(viewInfoOptions);

تكوين خيارات عرض HTML (إنشاء HTML من المشروع)

HtmlViewOptions يضبط كيفية قيام GroupDocs بإنشاء HTML، مما يتيح لك تحديد نطاق التاريخ، تضمين الموارد، وتخصيص المظهر.

import com.groupdocs.viewer.options.HtmlViewOptions;

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
viewOptions.getProjectManagementOptions().setStartDate(viewInfo.getStartDate());
viewOptions.getProjectManagementOptions().setEndDate(viewInfo.getEndDate());

تنفيذ عملية العرض

viewer.render ينفّذ التحويل بناءً على الخيارات المقدمة ويكتب ملفات HTML الناتجة إلى المجلد المستهدف.

viewer.view(viewOptions);

المشكلات الشائعة & استكشاف الأخطاء

  • مسارات ملفات غير صحيحة – تحقق مرة أخرى من وجود كل من ملف .mpp المصدر ومجلد الإخراج.
  • نوع ملف غير مدعوم – تأكد من أن المستند بتنسيق مشروع مدعوم (مثل .mpp، .mpt).
  • أخطاء الترخيص – قد تفرض الترخيص التجريبي حدودًا على العرض؛ انتقل إلى ترخيص كامل للاستخدام غير المحدود.

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

  1. تحليل خط الزمن للمشروع – إظهار أصحاب المصلحة فقط للمرحلة الحالية.
  2. تقارير آلية – إنشاء تقارير HTML محددة بالوقت لتحديثات الحالة الأسبوعية.
  3. التكامل مع لوحات التحكم – تضمين الصفحات المعروضة في أدوات ذكاء الأعمال أو البوابات المخصصة.
  4. الأرشفة – حفظ لقطة صديقة للويب لجدول المشروع للرجوع إليها مستقبلاً.

نصائح الأداء

  • استخدم خيار الموارد المدمجة للحفاظ على كل صفحة HTML مستقلة، مما يقلل طلبات HTTP.
  • للمشاريع الكبيرة جدًا، فكر في العرض على أجزاء تاريخية أصغر للحفاظ على انخفاض استهلاك الذاكرة. يمكن أن يقلل عرض شريحة سنة واحدة حجم HTML بنسبة تصل إلى 80 % مقارنةً بتصدير المشروع بالكامل، مما يقلل زمن التحميل من عدة ثوانٍ إلى أقل من ثانية على الخوادم النموذجية.
  • قم بتنظيف الملفات المؤقتة بعد تقديمها لتجنب امتلاء القرص.

الخلاصة

أنت الآن تعرف كيفية استخدام GroupDocs Viewer لعرض مستندات المشروع ضمن فترة زمنية محددة وإنشاء HTML من بيانات المشروع في Java. هذه القدرة تبسط تصورات الخط الزمني، تحسن كفاءة إعداد التقارير، وتندمج بسلاسة مع تطبيقات الويب الحديثة.

الخطوات التالية

  • استكشف ميزات Viewer الإضافية مثل وضع العلامات المائية، حماية كلمة المرور، أو تنسيق CSS مخصص.
  • اجمع هذه العملية مع واجهة برمجة تطبيقات REST لتقديم عروض خط الزمن عند الطلب.

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

س: ما هي صيغ الملفات التي يدعمها GroupDocs.Viewer؟
ج: يدعم GroupDocs.Viewer أكثر من 100 صيغة إدخال، بما في ذلك PDF، DOCX، XLSX، PPTX، وملفات Microsoft Project، مما يتيح تصورًا عالميًا للوثائق.

س: كيف أبدأ باستخدام نسخة تجريبية مجانية من GroupDocs.Viewer؟
ج: يمكنك تنزيل النسخة التجريبية من GroupDocs Viewer Java download page.

س: هل يمكنني عرض المستندات دون تضمين الموارد؟
ج: نعم، يمكنك اختيار خيار عرض HTML مختلف يشير إلى موارد خارجية بدلاً من تضمينها.

س: ماذا لو كان مستندي كبيرًا جدًا للعرض؟
ج: فكر في تقسيم المستند إلى أقسام أصغر أو عرض نطاق التاريخ المطلوب فقط، كما هو موضح أعلاه.

س: كيف أتعامل مع أخطاء العرض؟
ج: تحقق من جميع إعدادات التكوين، تأكد من أن لديك ترخيصًا صالحًا، واستشر وثائق GroupDocs للحصول على رموز الأخطاء التفصيلية.

الموارد

آخر تحديث: 2026-09-25
تم الاختبار مع: GroupDocs.Viewer 25.2 for Java
المؤلف: GroupDocs

import java.nio.file.Path;

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY", "RenderProjectTimeInterval");
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_MPP")) {
    // Continue with rendering steps
}

دروس ذات صلة