נתח את שדות הטופס של PDF TextBox, CheckBox, RadioButton עם REST API

שדות טפסים הם אחד המרכיבים האינטגרליים בעת התמודדות עם נתוני לקוחות וקל להפיץ את טפסי PDF Acro עם המשתמשים כך שיוכלו למלא את הטפסים בנתונים לפי בחירתם ולשלוח אותם בחזרה. אנו מכירים שניתן להשתמש במגוון שדות טופס אך בין כל אלה, TextBox, CheckBox, RadioButton ו-ComboBoxes נפוצים מאוד. לכן, לאחר מילוי הנתונים בטפסי Acro, אנו מנתחים את שדות הטפסים ב-Back Office כדי לחלץ מהם נתונים ולשמור אותם ב-FDF, XML, או ישירות בבסיסי נתונים.

למרות שכל הפעולות כולל יצירת טפסים PDF, הוספת שדות טפסים, פעילות עדכון שדות טפסים יכולות להתבצע באופן ידני, כאשר מתמודדים עם סט עצום של מסמכים, נראה שהפעולה הידנית אינה ריאלית מכיוון שהיא גוזלת זמן רב ונוטה לשגיאות עקב טיפול ידני בנתונים. אז שגרות אוטומטיות באמצעות שפת תכנות יכולות להיות פתרון בר-קיימא. לכן, בעת יצירת תוכנית, אנו מקבלים אפשרות להשתמש בפתרון / API מקומי שיכול לעזור לנו להשיג את כל הדרישות או להשתמש בממשקי REST מתארחים בענן כדי לנתח את שדות הטופס.

יתרונות REST API

ממשקי ה-API של RESTful מקבלים כאן קפיצת מדרגה מכיוון שאינך צריך לעקוב באופן ידני אחר כל גרסאות ה-API. כמו כן, אינך צריך לעדכן את המערכת שלך עם גרסאות API ולא צריך לדאוג לגבי בעיות תאימות של ממשקי ה-API עם שפת תכנות מסוימת וכו’. לכן, אנו מציגים את Aspose.PDF Cloud SDK for Java המספק את היכולות ליצור, לתפעל כמו גם להפוך מסמכי PDF לפורמטים נתמכים אחרים של קבצים. Java SDK פותח על גבי Aspose.PDF Cloud REST APIs שניתן לגשת אליהם בקלות באמצעות פקודות cURL וה-SDKs פותחו כדי להקל על הלקוחות שלנו להשתמש בשפת תכנות מסוימת.

בבלוג זה, אנו הולכים לשפוך מעט אור כיצד לנתח שדות טופס שונים:

• קרא, הוסף או עדכן שדות TextBox
• נתח שדות טופס של תיבת סימון
• הוסף או עדכן שדות RadioButton
• מניפולציה של שדות טופס ComboBox

קרא, הוסף או עדכן שדות TextBox

ה-API מציע שלוש דרכים לקרוא מידע המשויך לשדות TextBox.

| API | הקלד | תיאור | קישור סווגר |

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

| /pdf/{name}/fields/textbox | קבל | קרא שדות תיבת טקסט של מסמך | GetDocumentTextBoxFields |

| /pdf/{name}/page/{pageNumber}/fields/textbox | קבל | קרא שדות תיבת טקסט של מסמך עבור דף נתון | GetPageTextBoxFields |

| /pdf/{name}/fields/textbox/{fieldName} | קבל | קרא שדות מסמך TextBox לפי שם שדה | 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 בשימוש בדוגמה לעיל.

Java

// לדוגמאות מלאות וקבצי נתונים, נא עבור אל 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, ה-API מספק גם את היכולות לקרוא ערכי CheckBox, להוסיף תיבת סימון חדשה או לעדכן את המאפיינים המשויכים לתיבת סימון קיימת בטופס PDF.

• GetDocumentCheckBoxFields - Read document checkbox fields
• GetPageCheckBoxFields - Read specific page checkbox fields
• GetCheckBoxField - Read document checkbox field by name

פקודת cURL לקריאת תיבת סימון בעמוד 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

בקש כתובת אתר

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

Java

// לדוגמאות מלאות וקבצי נתונים, נא עבור אל 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);

    // הגדר את פרטי סגנון הגבול של CheckBox
    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);
    // הגדר את צבע הגבול של CheckBox
    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

בקש כתובת אתר

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

מניפולציה של שדות טופס ComboBox

שימו לב שהמניפולציה של ComboBox הופכת שימושית מאוד בעזרת Aspose.PDF Cloud SDK עבור Java. אתה מקבל את האפשרות לקרוא שדות ComboBox קיימים במסמך, להוסיף שדה ComboBox חדש או לעדכן ComboBox קיים.

• GetDocumentComboBoxFields - Read document combobox fields
• GetPageComboBoxFields - Read particular page combobox fields
• GetComboBoxField - Read document combobox field by name
• PostComboBoxFields - Add ComboBox field to document
• PutComboBoxField - 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

בקש כתובת אתר

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

מַסְקָנָה

כפי שהוסבר במאמר למעלה, עיבוד שדות הטופס הפך לקל למדי בעזרת ממשקי Cloud API. אתה יכול לשקול לעבור על בלוג קשור Form Parser | מזהה טפסים | מילוי PDF | אוטומציה של עיבוד טפסים עם REST Web API.