ForHosting KIT · المستندات وملفات PDF

حوّل حقول نموذج PDF إلى محتوى صفحة ثابت

الاسم Ada (Countess) Lovelace المكتوب في حقل نصي بالصفحة 1 وخانة مؤشَّرة في الصفحة 2 يصبحان محتوى ثابتًا، ويؤكد التقرير تسطيح الاثنين. ولا يبقى في النموذج أي حقل نشط يمكن لأحد تعديله. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

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

ما الذي يتغير عند تسطيح نموذج معبأ

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

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

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

كيفية إعداد الصفحات وقيم الحقول بصورة صحيحة

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

وتكون القيم سلاسل نصية لأن التسطيح يعتمد القيمة المعروضة؛ فمثلاً يمكن أن تستخدم خانة محددة القيمة “Yes”، بينما يستخدم حقل الاختيار التسمية المحددة. يجب أن يشير كل حقل إلى صفحة موجودة، وأن يكون العرض والارتفاع أكبر من صفر. كما يجب أن تكون جميع الإحداثيات والأبعاد أرقاماً منتهية.

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

استخدام التقرير ضمن مسار مستندات موثوق

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

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

حالات الاستخدام

إنهاء طلب جرى اعتماده

ادمجوا قيم مقدم الطلب في محتوى الصفحات بعد المراجعة، واحفظوا تقرير الحقول مع سجل الطلب.

تثبيت النماذج قبل الطباعة

أزيلوا الاعتماد على عناصر التحكم التفاعلية لتمثيل القيم بواسطة عمليات رسم حتمية على الصفحة.

الأسئلة الشائعة

ماذا يحدث إذا لم يحتو النموذج على حقول؟

يفشل الطلب بخطأ إدخال غير صالح يوضح أن نموذج PDF لا يحتوي على حقول. ولا يُبلغ أبداً عن تسطيح نموذج فارغ بنجاح.

ما أنواع الحقول المدعومة؟

تُدعم حقول النص وخانات الاختيار وأزرار الاختيار والاختيارات والتوقيعات. وتُعامل السلسلة المقدمة على أنها القيمة المعروضة.

هل تحلل هذه الإمكانية ملف PDF ثنائياً مباشرة؟

لا. فهي تحول محتوى الصفحات والقيم المحللة مسبقاً بصورة حتمية. ينبغي للمسار الثنائي التحليل قبل هذه الخطوة والتسلسل بعدها.

هل تُفسد الأقواس أو الرموز الأخرى في الاسم الصفحة؟

لا. تُحمى الحروف التي لها معنى خاص داخل ملف PDF عند كتابتها، فيظهر اسم مثل Ada (Countess) Lovelace تمامًا كما أُدخل. كما تُحصر كل قيمة داخل مستطيل حقلها فلا تتجاوز إلى بقية الصفحة.

هل يمكنني معرفة الحقول التي جرى تسطيحها؟

نعم. تحصل على تقرير حقلًا بحقل بترتيب إدخالك، يضم الاسم والصفحة والنوع والقيمة، فتسجل بدقة ما تغيّر بدل أن تفترض أن كل حقل عولج.

أدوات ذات صلة

للمطوّرين — الوصول عبر API

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

الـEndpoint

POSThttps://api.kit.forhosting.com/pdf/flatten-form

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/pdf/flatten-form \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pages":[{"number":1,"content":"q 1 0 0 1 0 0 cm Q"}],"fields":[{"name":"full_name","page":1,"type":"text","value":"Ada Lovelace","x":72,"y":680,"width":220,"height":18}]}'

const res = await fetch("https://api.kit.forhosting.com/pdf/flatten-form", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pages": [
      {
        "number": 1,
        "content": "q 1 0 0 1 0 0 cm Q"
      }
    ],
    "fields": [
      {
        "name": "full_name",
        "page": 1,
        "type": "text",
        "value": "Ada Lovelace",
        "x": 72,
        "y": 680,
        "width": 220,
        "height": 18
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/flatten-form",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "pages": [
        {
            "number": 1,
            "content": "q 1 0 0 1 0 0 cm Q"
        }
    ],
    "fields": [
        {
            "name": "full_name",
            "page": 1,
            "type": "text",
            "value": "Ada Lovelace",
            "x": 72,
            "y": 680,
            "width": 220,
            "height": 18
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/flatten-form", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"pages":[{"number":1,"content":"q 1 0 0 1 0 0 cm Q"}],"fields":[{"name":"full_name","page":1,"type":"text","value":"Ada Lovelace","x":72,"y":680,"width":220,"height":18}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"pages":[{"number":1,"content":"q 1 0 0 1 0 0 cm Q"}],"fields":[{"name":"full_name","page":1,"type":"text","value":"Ada Lovelace","x":72,"y":680,"width":220,"height":18}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/flatten-form", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "pages": [
    {
      "number": 1,
      "content": "q 1 0 0 1 0 0 cm Q"
    }
  ],
  "fields": [
    {
      "name": "full_name",
      "page": 1,
      "type": "text",
      "value": "Ada Lovelace",
      "x": 72,
      "y": 680,
      "width": 220,
      "height": 18
    }
  ]
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.flatten_form",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

`max_mb`	25
`max_pages`	200

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

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

استخدام التقرير ضمن مسار مستندات موثوق

ولأن الخوارزمية لا تستخدم الشبكة أو اختيارات عشوائية أو الساعة أو حالة مشتركة قابلة للتغيير، فإن الإدخال نفسه ينتج دائماً JSON نفسه.

حالات التكامل

التحقق من مسار مستندات آلي

قارنوا flattened_count وflattened_fields بالمخطط المتوقع قبل التسلسل أو التسليم أو الأرشفة.

أسئلة تقنية

ما تكلفة هذه الإمكانية؟

تكلف كل عملية طلب إلى API مبلغ $0.002. ويستخدم التنفيذ داخل المتصفح التحويل الحتمي نفسه.

هل تحدد النتيجة الحقول التي جرى تسطيحها؟

نعم. يعرض flattened_fields اسم كل حقل وصفحته ونوعه وقيمته، بينما يقدم flattened_count العدد الإجمالي.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا

ما الذي يتغير عند تسطيح نموذج معبأ

كيفية إعداد الصفحات وقيم الحقول بصورة صحيحة

استخدام التقرير ضمن مسار مستندات موثوق

حالات الاستخدام

إنهاء طلب جرى اعتماده

تثبيت النماذج قبل الطباعة

الأسئلة الشائعة

أدوات ذات صلة

للمطوّرين — الوصول عبر API

الـEndpoint

استدعِ الخدمة من بيئتك

مثال على الطلب

مثال على الاستجابة

الأسعار

الحدود

الأخطاء

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

استخدام التقرير ضمن مسار مستندات موثوق

حالات التكامل

التحقق من مسار مستندات آلي

أسئلة تقنية

شكرًا