تحليل حقول نموذج TextBox وCheckBox وRadioButton في PDF باستخدام REST API

تُعد حقول النماذج أحد المكونات الأساسية عند التعامل مع بيانات العملاء، ويصبح من السهل توزيع نماذج PDF Acro على المستخدمين حتى يتمكنوا من ملء النماذج بالبيانات التي يختارونها وإرسالها مرة أخرى. نحن على دراية بإمكانية استخدام مجموعة متنوعة من حقول النماذج، ولكن من بين كل هذه الحقول، تعد TextBox وCheckBox وRadioButton وComboBoxes شائعة جدًا. لذا، بمجرد ملء البيانات في نماذج Acro، نقوم بتحليل حقول النماذج في المكتب الخلفي لاستخراج البيانات منها وحفظها في FDF أو XML أو مباشرة في قواعد البيانات.

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

فوائد واجهة برمجة التطبيقات REST

تحصل واجهات برمجة التطبيقات RESTful على قفزة هنا لأنك لست بحاجة إلى تتبع جميع إصدارات واجهة برمجة التطبيقات يدويًا. أيضًا، لست بحاجة إلى تحديث نظامك بإصدارات واجهة برمجة التطبيقات ولا داعي للقلق بشأن مشكلات توافق واجهات برمجة التطبيقات مع لغة برمجة معينة، وما إلى ذلك. لذلك، نقدم Aspose.PDF Cloud SDK for Java التي توفر الإمكانيات لإنشاء مستندات PDF ومعالجتها وتحويلها إلى تنسيقات ملفات مدعومة أخرى. تم تطوير Java SDK على رأس واجهات برمجة تطبيقات Aspose.PDF Cloud REST والتي يمكن الوصول إليها بسهولة باستخدام أوامر cURL وتم تطوير SDKs لتسهيل استخدام عملائنا للغة برمجة معينة.

في هذه المدونة، سنلقي الضوء على كيفية تحليل حقول النماذج المختلفة:

• قراءة أو إضافة أو تحديث حقول مربع النص
• تحليل حقول نموذج CheckBox
• إضافة أو تحديث حقول RadioButton
• التعامل مع حقول نموذج ComboBox

قراءة أو إضافة أو تحديث حقول مربع النص

توفر واجهة برمجة التطبيقات (API) ثلاث طرق لقراءة المعلومات المرتبطة بحقول TextBox.

| API | النوع | الوصف | رابط Swagger |

| ——————————————– | ———– | ——————————————– | —————————— |

| /pdf/{name}/fields/textbox | GET | قراءة حقول مربع النص في المستند | GetDocumentTextBoxFields |

| /pdf/{name}/page/{pageNumber}/fields/textbox | GET | قراءة حقول مربع نص المستند لصفحة معينة | GetPageTextBoxFields |

| /pdf/{name}/fields/textbox/{fieldName} | GET | قراءة حقول مربع النص في المستند حسب اسم الحقل | GetTextBoxField |

أمر cURL لقراءة حقول TextBox

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

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=xxxx&client_secret=xxxx" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
copy

curl -X GET "https://api.aspose.cloud/v3.0/pdf/FormDataTextBox.pdf/fields/textbox" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
copy

العينة FormDataTextBox.pdf المستخدمة في المثال أعلاه.

جافا

// للحصول على أمثلة كاملة وملفات البيانات، يرجى الانتقال إلى https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-java
const string clientID = "xxxxxx-1c8e-4ea4-a948-3857547232fa";
const string clientSecret = "xxxxxx613237f013e329cdf5694cc96a";

import com.aspose.asposecloudpdf.ApiException;
import com.aspose.asposecloudpdf.api.PdfApi;
import com.aspose.asposecloudpdf.examples.Common;
import com.aspose.asposecloudpdf.model.FieldResponse;

public class GetFieldTestExample {

	public static void main(String[] args) throws ApiException {
		String name = "PdfWithAcroForm.pdf";
    // إنشاء مثيل لكائن PdfAPi
    com.aspose.asposecloudpdf.api.PdfApi pdf = new com.aspose.asposecloudpdf.api.PdfApi(clientSecret,clientID);
    // قراءة حقول مربع النص في المستند
    TextBoxFieldsResponse response = pdf.getDocumentTextBoxFields("FormDataTextBox.pdf",null, null);
    // طباعة التفاصيل المتعلقة بالحقول التي تم جلبها
    System.out.println(response.getFields());
    }
}
copy

تحليل حقول نموذج CheckBox

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

• الحصول على حقول مربع الاختيار للمستند - Read document checkbox fields
• الحصول على حقول مربع اختيار الصفحة - Read specific page checkbox fields
• الحصول على حقل مربع الاختيار - Read document checkbox field by name

أمر cURL لقراءة CheckBox في الصفحة 1

curl -X GET "https://api.aspose.cloud/v3.0/pdf/FormDataTextBox.pdf/page/1/fields/checkbox" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
copy

أمر CURL لتحديث CheckBox على الصفحة 1

curl -X PUT "https://api.aspose.cloud/v3.0/pdf/FormDataTextBox.pdf/fields/checkbox/Check%20Box1" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>" \
-H "Content-Type: application/json" \
-d "{ \"Links\": [ { \"Href\": \"string\", \"Rel\": \"string\", \"Type\": \"string\", \"Title\": \"string\" } ], \"PartialName\": \"Aspose CheckBox\", \"FullName\": \"Aspose CheckBox\", \"Rect\": { \"LLX\": 88.3573, \"LLY\": 687.617, \"URX\": 97.0198, \"URY\": 695.413 }, \"Value\": \"null\", \"PageIndex\": 1, \"Height\": 12, \"Width\": 12, \"ZIndex\": 0, \"IsGroup\": false, \"IsSharedField\": true, \"Flags\": [ \"Default\" ], \"Color\": { \"A\": 0, \"R\": 150, \"G\": 120, \"B\": 0 }, \"Contents\": \"Field Updated\", \"Margin\": { \"Left\": 0, \"Right\": 0, \"Top\": 0, \"Bottom\": 0 }, \"Highlighting\": \"None\", \"HorizontalAlignment\": \"Left\", \"VerticalAlignment\": \"Center\", \"Border\": { \"Width\": 1, \"EffectIntensity\": 1, \"Style\": \"Solid\", \"Effect\": \"None\", \"Dash\": { \"On\": 1, \"Off\": 2 }, \"Color\": { \"A\": 255, \"R\": 120, \"G\": 120, \"B\": 0 } }, \"AllowedStates\": [ \"Yes\",\"Off\" ], \"Style\": \"Circle\", \"ActiveState\": \"On\", \"Checked\": true, \"ExportValue\": \"Yes\"}"
copy

طلب عنوان URL

https://api.aspose.cloud/v3.0/pdf/FormDataTextBox.pdf/fields/checkbox/Check%20Box1
copy

جافا

// للحصول على أمثلة كاملة وملفات البيانات، يرجى الانتقال إلى https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-java
const string clientID = "xxxxxx-1c8e-4ea4-a948-3857547232fa";
const string clientSecret = "xxxxxx613237f013e329cdf5694cc96a";

import com.aspose.asposecloudpdf.model.Rectangle;
import com.aspose.asposecloudpdf.model.CheckBoxField;
import com.aspose.asposecloudpdf.model.Border;
import com.aspose.asposecloudpdf.model.Color;
import com.aspose.asposecloudpdf.model.CheckBoxFieldResponse;

public class UpdateCheckBoxFieldExample {

	public static void main(String[] args) throws ApiException {
    
    // إنشاء مثيل لكائن PdfAPi
    com.aspose.asposecloudpdf.api.PdfApi pdf = new com.aspose.asposecloudpdf.api.PdfApi(clientSecret,clientID);
    // إنشاء مثيل CheckBox
    CheckBoxField updatedCheckBox = new CheckBoxField();
    updatedCheckBox.partialName("Check Box1");
    updatedCheckBox.height(12.0);
    updatedCheckBox.width(12.0);
    // تعيين نمط مربع الاختيار على شكل ماسي
    updatedCheckBox.style(com.aspose.asposecloudpdf.model.BoxStyle.DIAMOND);
    updatedCheckBox.activeState("On");
    // تمكين قيمة مربع الاختيار
    updatedCheckBox.checked(true);

    Rectangle rect = new Rectangle();
    rect.setLLX(88.3573);
    rect.setLLY(687.617);
    rect.setURX(97.0198);
    rect.setURY(695.413);
    updatedCheckBox.rect(rect);
    // تحديد تفاصيل فهرس الصفحة
    updatedCheckBox.pageIndex(1);

    // تعيين تفاصيل نمط حدود مربع الاختيار
    Border border = new Border();
    border.width(1);
    border.style(com.aspose.asposecloudpdf.model.BorderStyle.SOLID);
    border.effect(com.aspose.asposecloudpdf.model.BorderEffect.NONE);
    // كائن ملون للحدود
    Color color = new Color();
    color.setR(120);
    color.setG(220);
    color.setB(10);
    // تعيين لون حدود مربع الاختيار
    border.color(color);
    // طريقة الاتصال لتحديث حقل مربع الاختيار في الصفحة 1
    CheckBoxFieldResponse response =  pdf.putCheckBoxField("FormDataTextBox.pdf", "Check Box1", updatedCheckBox,null,null);
    // طباعة رمز حالة الاستجابة
    System.out.print(response.getStatus());
    }
}
copy

بمجرد تنفيذ الأمر/الكود، يتم تحديث الخصائص المرتبطة بحقل مربع الاختيار 1 كما هو موضح في الصورة أدناه.

إضافة أو تحديث حقول RadioButton

على غرار حقول TextBox وCheckBox، توفر Cloud SDK أيضًا الإمكانيات اللازمة لقراءة حقول RadioButton وتحديثها في مستندات PDF.

أمر cURL لقراءة حقول RadioButton في مستند PDF

curl -X GET "https://api.aspose.cloud/v3.0/pdf/FormDataTextBox.pdf/fields/radiobutton" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
copy

طلب عنوان URL

https://api.aspose.cloud/v3.0/pdf/FormDataTextBox.pdf/fields/radiobutton
copy

التعامل مع حقول نموذج ComboBox

لاحظ أن معالجة ComboBox تصبح مفيدة للغاية بمساعدة Aspose.PDF Cloud SDK for Java. يمكنك الحصول على خيار قراءة حقول ComboBox الموجودة في المستند، أو إضافة حقل ComboBox جديد أو تحديث ComboBox موجود.

• الحصول على حقول مربع التحرير والسرد للمستند - Read document combobox fields
• الحصول على حقول مربعات التحرير والسرد للصفحة - Read particular page combobox fields
• الحصول على حقل ComboBox - Read document combobox field by name
• حقول PostComboBox - Add ComboBox field to document
• ضع حقل ComboBox - Replace document combobox field

أمر cURL لقراءة جميع حقول ComboBox

curl -X GET "https://api.aspose.cloud/v3.0/pdf/FormDataTextBox.pdf/fields/combobox" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
copy

طلب عنوان URL

https://api.aspose.cloud/v3.0/pdf/FormDataTextBox.pdf/fields/combobox
copy

خاتمة

كما هو موضح في المقالة أعلاه، أصبحت معالجة حقول النماذج سهلة للغاية بمساعدة واجهات برمجة التطبيقات السحابية. يمكنك التفكير في الاطلاع على مدونة ذات صلة محلل النماذج | أداة التعرف على النماذج | ملء ملفات PDF | أتمتة معالجة النماذج باستخدام واجهة برمجة تطبيقات REST Web API.