pdf ფორმის გადახედვა

ფორმის ველები ერთ-ერთი განუყოფელი კომპონენტია მომხმარებელთა მონაცემებთან ურთიერთობისას და ადვილი ხდება PDF აკრო ფორმების გავრცელება მომხმარებლებთან, რათა მათ შეძლონ ფორმების შევსება მათი არჩევანის მონაცემებით და უკან გაგზავნა. ჩვენთვის ცნობილია, რომ სხვადასხვა ფორმის ველების გამოყენება შესაძლებელია, მაგრამ მათ შორის ძალიან გავრცელებულია TextBox, CheckBox, RadioButton და Comboboxes. ასე რომ, როდესაც მონაცემები შევსებულია Acro ფორმებში, ჩვენ ვაანალიზებთ ფორმის ველებს უკანა ოფისში, რომ ამოვიღოთ მონაცემები მათგან და შევინახოთ ისინი FDF, XML ან პირდაპირ მონაცემთა ბაზაში.

მიუხედავად იმისა, რომ ყველა ოპერაცია, მათ შორის PDF ფორმების შექმნა, ფორმის ველების დამატება, ფორმის ველების განახლების აქტივობა შეიძლება შესრულდეს ხელით, როდესაც საქმე გვაქვს დოკუმენტების უზარმაზარ კომპლექტთან, ხელით ოპერაცია შეუძლებელი ჩანს, რადგან შრომატევადი და შეცდომის მიდრეკილებაა მონაცემთა ხელით დამუშავების გამო. ასე რომ, პროგრამირების ენის მეშვეობით ავტომატური რუტინები შეიძლება იყოს სიცოცხლისუნარიანი გამოსავალი. ამიტომ, პროგრამის შექმნისას, ჩვენ ვიღებთ შესაძლებლობას გამოვიყენოთ შიდა გადაწყვეტა/API, რომელიც დაგვეხმარება ყველა მოთხოვნის შესრულებაში, ან გამოვიყენოთ ღრუბელში განთავსებული REST API-ები ფორმის ველების გასაანალიზებლად.

REST API უპირატესობები

RESTful API-ები აქ ნახტომს იღებენ, რადგან არ გჭირდებათ ხელით თვალყური ადევნოთ API-ს ყველა ვერსიას. ასევე, თქვენ არ გჭირდებათ თქვენი სისტემის განახლება API ვერსიებით და არ გჭირდებათ ფიქრი API-ების თავსებადობის საკითხებზე გარკვეულ პროგრამირების ენასთან და ა.შ. ამიტომ, ჩვენ წარმოგიდგენთ Aspose.PDF Cloud SDK for Java, რომელიც უზრუნველყოფს PDF დოკუმენტების შექმნას, მანიპულირებას და გარდაქმნას PDF დოკუმენტების სხვა მხარდაჭერილ ფორმატებში. Java SDK შემუშავებულია Aspose.PDF Cloud REST API-ების თავზე, რომლებზეც ადვილად წვდომა შეიძლება cURL ბრძანებების გამოყენებით, ხოლო SDK-ები შემუშავებულია იმისათვის, რომ ხელი შეუწყოს ჩვენს მომხმარებლებს კონკრეტული პროგრამირების ენის გამოყენებით.

ამ ბლოგში ჩვენ ვაპირებთ ნათელს მოვფენთ, თუ როგორ გავაანალიზოთ სხვადასხვა ფორმის ველები:

წაიკითხეთ, დაამატეთ ან განაახლეთ TextBox ველები

API გთავაზობთ TextBox ველებთან დაკავშირებული ინფორმაციის წაკითხვის სამ გზას.

| API | ტიპი | აღწერა | Swagger Link |

| ——————————————- | ———– | ——————————————- | —————————— |

| /pdf/{name}/fields/textbox | მიიღეთ | დოკუმენტის TextBox ველების წაკითხვა | GetDocumentTextBoxFields |

| /pdf/{name}/page/{pageNumber}/fields/textbox | მიიღეთ | წაიკითხეთ დოკუმენტის TextBox ველები მოცემული გვერდისთვის | GetPageTextBoxFields |

| /pdf/{name}/fields/textbox/{fieldName} | მიიღეთ | დოკუმენტის TextBox ველების წაკითხვა ველის სახელით | GetTextBoxField |

cURL ბრძანება TextBox ველების წასაკითხად

ვინაიდან ფაილები ინახება თქვენს პირად ღრუბლოვან საცავში, ამიტომ ჯერ უნდა შექმნათ JWT ავთენტიფიკაციის ჟეტონი, რომელიც მოითხოვს თქვენს პერსონალიზებულ Client ID-ს და Client Secret-ს.

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"

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

ზემოთ მოცემულ მაგალითში გამოყენებული ნიმუში 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);
    // წაიკითხეთ დოკუმენტის TextBox ველები
    TextBoxFieldsResponse response = pdf.getDocumentTextBoxFields("FormDataTextBox.pdf",null, null);
    // ამობეჭდეთ დეტალები მოტანილი ველების შესახებ
    System.out.println(response.getFields());
    }
}

CheckBox ფორმის ველების გაანალიზება

CheckBox-ებთან ურთიერთობისას, API ასევე უზრუნველყოფს CheckBox-ის მნიშვნელობების წაკითხვის, ახალი ჩამრთველის დამატებას ან არსებული ჩანიშვნის ველთან დაკავშირებული თვისებების განახლებას PDF ფორმაში.

cURL ბრძანება 1 გვერდზე CheckBox-ის წასაკითხად

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>"

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\"}"

მოითხოვეთ URL

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

ჯავა

// სრული მაგალითებისა და მონაცემთა ფაილებისთვის გთხოვთ ეწვიოთ 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);
    // დააყენეთ ჩამრთველის სტილი, როგორც Diamond
    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());
    }
}

მას შემდეგ, რაც ბრძანება/კოდი შესრულდება, ველთან დაკავშირებული თვისებები განახლდება, როგორც ეს ნაჩვენებია ქვემოთ მოცემულ სურათზე.

განახლებული ველის გადახედვა

სურათი 1:- განახლებული ჩამრთველი 1-ის გადახედვა cURL ბრძანების გამოყენებით

დაამატეთ ან განაახლეთ RadioButton ველები

TextBox და CheckBox ველების მსგავსად, Cloud SDK ასევე იძლევა PDF დოკუმენტებზე RadioButton ველების წაკითხვისა და განახლების შესაძლებლობებს.

cURL ბრძანება PDF დოკუმენტზე RadioButton ველების წასაკითხად

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

მოითხოვეთ URL

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

ComboBox ფორმის ველების მანიპულირება

გაითვალისწინეთ, რომ ComboBox მანიპულირება ძალიან მოსახერხებელი ხდება Aspose.PDF Cloud SDK Java-სთვის. თქვენ გაქვთ შესაძლებლობა წაიკითხოთ დოკუმენტში არსებული ComboBox ველები, დაამატოთ ახალი ComboBox ველი ან განაახლოთ არსებული ComboBox.

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>"

მოითხოვეთ URL

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

დასკვნა

როგორც ზემოთ სტატიაშია ახსნილი, ფორმის ველების დამუშავება საკმაოდ მარტივი გახდა Cloud API-ების დახმარებით. შეგიძლიათ განიხილოთ დაკავშირებული ბლოგის გავლა Form Parser | ფორმის ამომცნობი | PDF შევსება | ფორმის დამუშავების ავტომატიზაცია REST Web API-ით.