How-to3 دقيقة قراءة

تصدير جدول فارغ (204): ملف PDF غالباً بلا أعمدة

يعيد PDF إلى Excel وPDF إلى CSV الاستجابة 204 حين لا تُكتشف كتل جداول، وهذا مقصود لا عطل. شغّل OCR على المسحات أولاً، والملفات النثرية تبقى فارغة.

By the PDF123 team · Updated 2026-10-02
تصدير جدول فارغ (204): ملف PDF غالباً بلا أعمدة

إن انتهى PDF إلى Excel أو PDF إلى CSV بالاستجابة HTTP 204 No Content بلا جسم تنزيل، فالمستخرِج وجد صفر كتل جداول. وهذه الحالة مقصودة: ترفض API اختراع جدول بيانات فارغ حين لا ترى استدلالات التخطيط أي أعمدة.

ما يبحث عنه المستخرِج

تتشارك الأداتان الخط نفسه. يشغّل الخادم pdftotext -layout ويقسّم الصفحات عند حدود تغذية النموذج، ويجمّع الأسطر التي تبدو كتل أعمدة. ويُعدّ السطر جدولياً عندما يحوي مسافتين متتاليتين على الأقل، وهما فجوات الأعمدة في وضع layout. ولا يُحتفظ بالكتلة إلا إن حملت سطرين جدوليين على الأقل؛ فيُطرح السطر المنفرد ذو المسافات كي لا تصير العناوين «جداول» من صف واحد.

ويُخرج PDF إلى CSV (POST /api/v1/convert/pdf/csv) ملف CSV لكل جدول مكتشف، مسمّى برقم الصفحة والجدول، أو ملف ZIP عند تعددها. ويكتب PDF إلى Excel (POST /api/v1/convert/pdf/xlsx) مصنفاً واحداً بورقة لكل جدول مكتشف.

وحين تكون تلك القائمة فارغة، يعيد كلاهما Output::no_content() مُقابَلاً بالحالة 204. واستجابة 200 بملف .xlsx فارغ أسهل في القراءة الخاطئة كنجاح؛ أما 204 فتعني «لا شيء للتصدير».

أسباب شائعة للحالة 204

  • ملف PDF نثري فقط: نص سردي بلا محاذاة أعمدة واضحة. استخدم PDF إلى نص أو PDF إلى Markdown بدلاً منه.
  • صفحات ممسوحة بلا طبقة نصية: فيكون ناتج pdftotext فارغاً، فلا تظهر جداول. شغّل OCR أولاً، وهو يعيد نص Markdown هنا، ثم أعد المحاولة فقط إن كانت الكلمات تشكّل أعمدة فعلاً.
  • جداول مرسومة كخطوط أو كصور فقط: الشبكات البصرية بلا نص خلايا قابل للاستخراج لن تصير أوراقاً.
  • تخطيطات مجلات فوضوية متعددة الأعمدة: قد تخطئ الاستدلالات كتلاً يسمّيها الإنسان «جدولاً»، أو تدمج ترتيب القراءة دمجاً سيئاً.
  • «جداول» من صف واحد: السطر المنفرد ذو المسافات لا يصير كتلة أبداً؛ تحتاج سطرين جدوليين على الأقل.

وتحتاج الملفات المشفّرة فكّ قفل مصرّحاً به قبل الاستخراج. وأصلح الملف التالف بـ الإصلاح إن عجز Get Info أو التصدير عن فتحه.

ما ليست عليه الحالة 204

الحالة 204 ليست عطلاً في النقل، ولا مهلة، ولا «نسي الخادم المرفق». تعامل معها كقرار ناجح: لا كتل جداول. وإعادة المحاولة بالملف نفسه من دون تغيير طبقة النص أو التخطيط ستعيد 204 مرة أخرى. وينبغي للسكربتات أن تتفرّع على رمز الحالة لا على اسم ملف فارغ.

وMarkdown الناتج من OCR استخراج نص للوكلاء، لا جدول بيانات. وإن لصقت ناتج OCR في ملف .md واحتجت أعمدة لاحقاً، فما زلت تحتاج تخطيطاً يراه pdftotext -layout أو الإنسان كفجوات؛ وإعادة تصدير ملف المسح نفسه بلا طبقة نصية ستظل تعيد 204.

ما تفعله بعد ذلك

  1. افتح ملف PDF وتأكّد أنك تستطيع تحديد نص الخلايا. وإن لم تستطع، فشغّل OCR ثم قرّر إن كان النص المستعاد عمودياً بما يكفي لهذه الاستدلالات.
  2. فضّل PDF إلى Excel حين تتوقع عدة جداول بورقة لكل واحد، وPDF إلى CSV لملف مسطّح واحد أو لأرشيف ZIP من ملفات CSV.
  3. وإن كانت الصفحة نثرية، فبدّل الأداة؛ فتصدير الجداول سيظل يعيد 204.
  4. ولمعالجة الحالة في وكيل أو خط معالجة، اربط 204 بـ «لا جداول مكتشفة»، لا بحلقة إعادة محاولة عامة.
  5. وإن احتجت الكلمات وحدها، فتوقّف عند PDF إلى نص أو PDF إلى Markdown؛ ففرض شكل جدول بيانات على نثر سيظل يعيد 204.

ولا حساب مطلوب في مسار المتصفح. ولنفس النقاط عبر HTTP: المطوّرون. وأرسل Idempotency-Key عند إعادات المحاولة إن كان عميلك قد يرسل POST مرتين (Idempotency-Key).

Open tool
Process in the browser — no watermark, files removed after the job.
Open tool