اعرض حقول نموذج PDF وأسماءها وأنواعها وقيمها الحالية

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

افحص البنية الحقيقية الكامنة خلف نموذج PDF

تخزّن نماذج PDF التفاعلية عناصر التحكم بصورة منفصلة عن الكلمات والخطوط المرسومة على كل صفحة. فقد يحمل الحقل اسماً داخلياً مثل customer.address.postcode مع أن الصفحة لا تعرض سوى تسمية «الرمز البريدي». تتبع هذه الإمكانية فهرس المستند حتى قاموس AcroForm، ثم تجتاز شجرة الحقول وتطبّق الخصائص الموروثة وتعيد الحقول النهائية بترتيبها في المستند. تتضمن كل نتيجة الاسم الكامل والنوع الموحّد والقيمة المخزنة حالياً في PDF. ويجري التمييز بين حقول النص ومربعات الاختيار ومجموعات أزرار الاختيار والقوائم المنسدلة وقوائم الخيارات والأزرار وحقول التوقيع اعتماداً على نوع الحقل وعلاماته المحددة في المستند. تُربط الأسماء الهرمية بنقاط كي تظل عناصر التحكم المتشابهة في الأقسام المختلفة واضحة من دون التباس. لذلك تصلح النتيجة لتكون قائمة مخطط قابلة للمعالجة آلياً، لا مجرد استخراج للنص الظاهر. يظهر مربع الاختيار غير النشط بالقيمة false، ويُعرّف حقل التوقيع غير الموقّع من دون الادعاء بوجود توقيع.

أرسل المستند واقرأ الاستجابة بصورة صحيحة

أرسل ملف PDF في المعلمة pdf كنص base64 مجرد أو كرابط بيانات application/pdf مشفّر بصيغة base64. يتحقق المحلل أولاً من الترميز وترويسة PDF، ثم يقرأ الكائنات غير المباشرة اللازمة للعثور على الفهرس وشجرة الحقول. تشمل الاستجابة fields، وهي مصفوفة من السجلات، وcount الذي يبين عدد الحقول المعادة. تستخدم الأنواع أسماء عملية مثل TextField وCheckBox وRadioGroup وDropdown وOptionList وPushButton وSignature. تحافظ القيم الحالية على السلاسل والمصفوفات عندما يخزنها PDF بهذه الصورة، بينما تعاد حالة مربع الاختيار كقيمة منطقية. تستخدم عناصر النص الفارغة سلسلة فارغة، مما يسهّل تمييزها عن الحقول غير الموجودة. لا تخلط بين التسمية المطبوعة بجوار عنصر التحكم واسمه الداخلي؛ فتعريف النموذج وحده يحدد الاسم المعاد. تُرجع الإمكانية خطأً مقصوداً عند غياب الحقول، كي تكتشف الأتمتة ملفاً مسطحاً أو نموذجاً ممسوحاً ضوئياً أو مرفقاً خاطئاً. كما أن حجم الإدخال محدود لضمان معالجة متوقعة.

استخدم قائمة الحقول بأمان في مسارات المستندات

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