تتبع عملية تصدير ملف PDF فاشلة من ONLYOFFICE إلى مصدرها

احفظ المستند الأصلي أولاً، ثم حدد ما إذا كان الخطأ يحدث أثناء تحويل ملف PDF في برنامج ONLYOFFICE أو أثناء التنزيل النهائي من المتصفح. إذا أبلغ المحرر عن خطأ في التحويل، فتحقق من سجلات خادم المستندات وتأكد من قدرة الخادم على الوصول إلى الملف الأصلي. أما إذا نجح التحويل ولكن المتصفح يعرض رسالة "فشل التنزيل"، فتحقق من حالة التنزيل في المتصفح، وأذونات الموقع، ومساحة القرص المتاحة.

سيناريو توضيحي: تخيل أن جوردان، وهو مسؤول نظام يستخدم محرر ONLYOFFICE Docs مُستضافًا ذاتيًا، يختار "ملف" > "تنزيل كملف PDF" لتقرير مشروع. يعرض المحرر رسالة خطأ ولا يظهر ملف PDF. هذا مثال افتراضي، وليس حادثة مُختبرة؛ إذ يمكن أن تظهر نفس الأعراض في مراحل مختلفة، لذا فإن الفحوصات أدناه تتبع النقطة التي تتوقف عندها العملية.

1. احمِ المصدر وأعد إنتاج العطل مرة واحدة

قبل البدء في استكشاف الأخطاء وإصلاحها، استخدم زر الحفظ أو Ctrl+S لحفظ التعديلات الحالية. في محرر المستندات عبر الإنترنت، يُوثّق برنامج ONLYOFFICE مسار تصدير ملفات PDF كالتالي: ملف > تنزيل باسم > PDF. قد يقوم المحرر أولاً بإعداد ملف PDF ثم إرساله إلى المتصفح، لذا فإن فشل التنزيل من المتصفح لا يعني بالضرورة فشل عملية التحويل نفسها.

استخدم التقرير نفسه لإجراء محاولة إعادة تحميل واحدة مُتحكَّم بها. لاحظ ما إذا كان المُحرِّر يعرض مربع حوار خطأ، وما إذا كان المُتصفِّح يُنشئ سجلًا لفشل التنزيل، وما إذا كانت المشكلة تؤثر على هذا الملف فقط أم على جميع الملفات. تجنَّب النقر على "تصدير" بشكل مُتكرِّر: فالعمليات المُكرَّرة تُصعِّب مُطابقة الطابع الزمني مع سجل الخادم المُناسب.

2. إذا أظهر المتصفح فشل تنزيل ملف PDF

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

في حالة جوردان الافتراضية، قد يشير الخطأ إلى المتصفح عندما يُنهي المحرر إعداد ملف PDF، لكن قائمة التنزيل تُظهر خطأً في الشبكة أو في الأذونات. كحل بديل عملي، استخدم "ملف > طباعة" واختر وجهة "حفظ كملف PDF" في المتصفح أو نظام التشغيل، إن وُجدت. تحقق من الصفحات والخطوط والروابط الناتجة، لأن مخرجات الطباعة قد تختلف عن تصدير ملف PDF مباشرةً من المحرر. هذا الحل لا يُصلح خطأ التحويل من جانب الخادم.

3. في حالة فشل التحويل أو استرجاع المصدر

في حالة التثبيت الذاتي، اطلب من مسؤول النظام فحص سجلات خادم المستندات عند إعادة المحاولة. تُوثّق ONLYOFFICE سجلات Linux في المسار المحدد /var/log/onlyoffice/documentserver؛ أما في حالة Docker، فتتوفر السجلات داخل الحاوية في نفس المسار، ويمكن أيضًا فحص مخرجات Docker باستخدام الأمر المناسب docker logs <container>. يختلف المكون الدقيق ونص السجل باختلاف التثبيت والإصدار. ابحث عن أخطاء التحويل، أو انتهاء المهلة، أو الطلبات الفاشلة، أو رموز حالة HTTP، أو أخطاء DNS والاتصال. لا تنشر سطور السجل كاملةً علنًا إذا كانت تحتوي على عناوين URL خاصة، أو رموز وصول، أو أسماء مستخدمين، أو أسماء مستندات.

عندما تُشير السجلات أو واجهة برمجة التطبيقات (API) إلى وجود مشكلة في تنزيل المصدر، تحقق من قدرة خادم المستندات على الوصول إلى عنوان URL الخاص بالمستند المصدر من نطاق شبكته. يمكن للمسؤول اختبار عنوان URL المُصرّح به من الخادم أو الحاوية، والتحقق من نظام أسماء النطاقات (DNS)، والتوجيه، وقواعد جدار الحماية، وإعدادات الوكيل، وشهادات TLS، واستجابة تطبيق التخزين. قد يظل عنوان URL الذي يُفتح في متصفح سطح المكتب غير قابل للوصول من خادم المستندات. في المقابل، إذا تم تنزيل المصدر بنجاح ولكن فشلت عملية التحويل، فابحث عن خطأ المُحوّل بدلاً من تغيير الوصول إلى الشبكة.

بالنسبة لعمليات التحويل القائمة على واجهة برمجة التطبيقات (API)، استخدم رمز الخطأ المُعاد لتحديد المشكلة بدقة. يُعرّف ONLYOFFICE خطأ التحويل -4بأنه خطأ في تنزيل ملف الإدخال، -2أو انتهاء مهلة زمنية، -3أو خطأ في التحويل نفسه، أو -8رمز مميز غير صالح. هذه الرموز خاصة باستجابة واجهة برمجة تطبيقات التحويل؛ ولا تُثبت رسالة "فشل التنزيل" العامة في المحرر، بحد ذاتها، أن عملية تحويل ملف PDF قد أعادت أحد هذه الرموز.

4. تحقق من الوصول والأذونات والحجم فقط عندما تشير الأدلة إلى ذلك

إذا فشلت الملفات المخزنة في منصة متصلة واحدة فقط، فتحقق من عنوان خادم المستندات الخاص بالموصل وإعدادات الوصول الداخلية. يجب أن تتمكن خدمة التحرير من استرداد الملف من نظام التخزين الخاص بها. تشير وثائق استكشاف الأخطاء وإصلاحها في ONLYOFFICE إلى أن رسالة "فشل التنزيل" أثناء تحميل المحرر تعني عدم قدرة خدمة التحرير على الوصول إلى عنوان URL الخاص بالملف. يُفيد هذا التوجيه عندما يتعذر فتح التقرير أو تحميله؛ أما إذا فُتح المحرر بشكل طبيعي وفشل تصدير ملف PDF فقط، فافحص مرحلة التصدير أو التنزيل أولًا.

إذا أبلغت واجهة برمجة التطبيقات (API) عن رمز غير صالح، فقارن إعدادات سر JWT، والرأس، والرمز المميز على كلا الجانبين. لا تُعطّل JWT كحل سريع. إذا أشارت واجهة برمجة التطبيقات إلى حد أقصى لحجم الملف، فقارن الملف بالحدود المُحددة في إعدادات النشر. قد يتطلب الملف الكبير أو المصدر غير المدعوم/التالف حلاً مختلفًا؛ تغيير المتصفح أو الشبكة لن يُصلح حد التحويل أو المستند التالف.

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

تحقق من النتيجة

• تأكد من وجود الملف الذي تم تنزيله، وأن حجمه غير صفري، وأنه يفتح في قارئ ملفات PDF.
• تحقق من الصفحتين الأولى والأخيرة، وعدد الصفحات، وبعض الخطوط أو الصور الرئيسية مقارنةً بالمصدر.
• أعد عملية التصدير مرة أخرى بعد تطبيق الإصلاح المناسب. إذا استمرت المشكلة، فسجل الوقت، وإصدار ONLYOFFICE Docs، ومرحلة التصدير، ورمز الخطأ المخفي أو مقتطف من السجل.

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