
Az űrlapmezők az ügyféladatok kezelésének egyik szerves részét képezik, és egyszerűvé válik az PDF Acro űrlapok terjesztése a felhasználókkal, így azok kitölthetik az űrlapokat az általuk választott adatokkal, és visszaküldhetik azokat. Tudjuk, hogy sokféle űrlapmező használható, de ezek közül nagyon gyakori a TextBox, CheckBox, RadioButton és ComboBox. Tehát, miután az adatokat kitöltötte az Acro űrlapokon, elemezzük az űrlapmezőket a háttérirodában, hogy adatokat nyerjünk ki belőlük, és mentsük őket FDF-be, XML-ba vagy közvetlenül adatbázisokba.
Bár minden művelet, beleértve a PDF űrlapkészítést, űrlapmezők hozzáadását, űrlapmezők frissítését, manuálisan is elvégezhető, hatalmas dokumentumhalmaz kezelésekor a kézi művelet nem tűnik kivitelezhetőnek, mert időigényes és az adatok kézi kezelése miatt hibás. Tehát az automatikus rutinok programozási nyelven keresztül életképes megoldást jelenthetnek. Ezért egy program létrehozásakor lehetőséget kapunk arra, hogy vagy egy helyszíni megoldást/API-t használjunk, amely segíthet az összes követelmény teljesítésében, vagy felhőalapú REST API-kat használunk az űrlapmezők elemzéséhez.
REST API előnyei
A RESTful API-k ugrást kapnak itt, mert nem kell manuálisan nyomon követni az összes API-verziót. Ezenkívül nem kell frissítenie a rendszert az API-verziókkal, és nem kell aggódnia az API-k kompatibilitási problémái miatt bizonyos programozási nyelvekkel stb. Ezért bemutatjuk az Aspose.PDF Cloud SDK for Java-t, amely lehetővé teszi PDF-dokumentumok létrehozását, kezelését, valamint más támogatott fájlformátumokká való átalakítását. A Java SDK-t az Aspose.PDF Cloud REST API-kra fejlesztették ki, amelyek könnyen elérhetők cURL-parancsokkal, az SDK-kat pedig azért fejlesztették ki, hogy megkönnyítsék ügyfeleink egy adott programozási nyelv használatát.
Ebben a blogban megvilágítjuk a különböző űrlapmezők elemzését:
- TextBox mezők olvasása, hozzáadása vagy frissítése
- A jelölőnégyzet űrlapmezőinek elemzése
- RadioButton mezők hozzáadása vagy frissítése
- A ComboBox űrlapmezők kezelése
TextBox mezők olvasása, hozzáadása vagy frissítése
Az API három módot kínál a TextBox mezőkkel kapcsolatos információk olvasására.
| API | Típus | Leírás | Swagger Link |
| ——————————————— | ———– | ——————————————— | ——————————- |
| /pdf/{név}/fields/textbox | GET | Dokumentum szövegdoboz mezőinek olvasása | GetDocumentTextBoxFields |
| /pdf/{név}/oldal/{oldalszám}/fields/textbox | GET | Olvassa el a dokumentum szövegdoboz-mezőit egy adott oldalhoz | GetPageTextBoxFields |
| /pdf/{név}/fields/textbox/{mezőnév} | GET | A dokumentum szövegdoboz-mezőinek olvasása mezőnév szerint | GetTextBoxField |
cURL parancs a TextBox mezők olvasásához
Mivel a fájlok a személyes felhőtárhelyen vannak tárolva, ezért először létre kell hoznia egy JWT hitelesítési tokent, amelyhez szükség van az Ön személyre szabott ügyfél-azonosítójára és ügyféltitkaira.
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>"
A fenti példában használt FormDataTextBox.pdf minta.
Jáva
// A teljes példákért és adatfájlokért látogasson el a https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-java oldalra.
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";
// hozzon létre egy PdfAPi objektumot
com.aspose.asposecloudpdf.api.PdfApi pdf = new com.aspose.asposecloudpdf.api.PdfApi(clientSecret,clientID);
// Olvassa el a dokumentum szövegdoboz-mezőit
TextBoxFieldsResponse response = pdf.getDocumentTextBoxFields("FormDataTextBox.pdf",null, null);
// nyomtassa ki a letöltött mezők adatait
System.out.println(response.getFields());
}
}
A jelölőnégyzet űrlapmezőinek elemzése
A jelölőnégyzetek kezelésekor az API lehetőséget biztosít a CheckBox értékek olvasására, új jelölőnégyzet hozzáadására vagy a PDF űrlapon lévő meglévő jelölőnégyzethez tartozó tulajdonságok frissítésére.
- GetDocumentCheckBoxFields - Read document checkbox fields
- GetPageCheckBoxFields - Read specific page checkbox fields
- GetCheckBoxField - Read document checkbox field by name
cURL parancs az 1. oldalon lévő jelölőnégyzet olvasásához
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 parancs a jelölőnégyzet frissítéséhez az 1. oldalon
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 kérése
https://api.aspose.cloud/v3.0/pdf/FormDataTextBox.pdf/fields/checkbox/Check%20Box1
Jáva
// A teljes példákért és adatfájlokért látogasson el a https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-java oldalra.
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 {
// hozzon létre egy PdfAPi objektumot
com.aspose.asposecloudpdf.api.PdfApi pdf = new com.aspose.asposecloudpdf.api.PdfApi(clientSecret,clientID);
// Hozzon létre CheckBox példányt
CheckBoxField updatedCheckBox = new CheckBoxField();
updatedCheckBox.partialName("Check Box1");
updatedCheckBox.height(12.0);
updatedCheckBox.width(12.0);
// állítsa be a jelölőnégyzet stílusát gyémántként
updatedCheckBox.style(com.aspose.asposecloudpdf.model.BoxStyle.DIAMOND);
updatedCheckBox.activeState("On");
// engedélyezze a jelölőnégyzet értékét
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);
// adja meg az oldalindex részleteit
updatedCheckBox.pageIndex(1);
// állítsa be a CheckBox szegélystílus részleteit
Border border = new Border();
border.width(1);
border.style(com.aspose.asposecloudpdf.model.BorderStyle.SOLID);
border.effect(com.aspose.asposecloudpdf.model.BorderEffect.NONE);
// Színes objektum szegélyhez
Color color = new Color();
color.setR(120);
color.setG(220);
color.setB(10);
// állítsa be a jelölőnégyzet keretének színét
border.color(color);
// hívja meg a módszert a jelölőnégyzet frissítéséhez az 1. oldalon
CheckBoxFieldResponse response = pdf.putCheckBoxField("FormDataTextBox.pdf", "Check Box1", updatedCheckBox,null,null);
// válasz állapotkód nyomtatása
System.out.print(response.getStatus());
}
}
A parancs/kód végrehajtása után az 1. jelölőnégyzet mezőhöz tartozó tulajdonságok frissítésre kerülnek az alábbi képen látható módon.

- kép: – A frissített 1. jelölőnégyzet előnézete a cURL paranccsal
RadioButton mezők hozzáadása vagy frissítése
A TextBox és CheckBox mezőkhöz hasonlóan a Cloud SDK is lehetőséget biztosít a PDF dokumentumok RadioButton mezőinek olvasására és frissítésére.
cURL parancs a RadioButton mezők olvasásához PDF-dokumentumban
curl -X GET "https://api.aspose.cloud/v3.0/pdf/FormDataTextBox.pdf/fields/radiobutton" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
URL kérése
https://api.aspose.cloud/v3.0/pdf/FormDataTextBox.pdf/fields/radiobutton
A ComboBox űrlapmezők kezelése
Figyelje meg, hogy a ComboBox manipuláció nagyon hasznossá válik az Aspose.PDF Cloud SDK for Java segítségével. Lehetőség van a dokumentumban lévő meglévő ComboBox mezők olvasására, új ComboBox mező hozzáadására vagy egy meglévő ComboBox frissítésére.
- 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 parancs az összes ComboBox mező beolvasásához
curl -X GET "https://api.aspose.cloud/v3.0/pdf/FormDataTextBox.pdf/fields/combobox" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
URL kérése
https://api.aspose.cloud/v3.0/pdf/FormDataTextBox.pdf/fields/combobox
Következtetés
A fenti cikkben leírtak szerint az űrlapmezők feldolgozása meglehetősen egyszerűvé vált a felhő API-k segítségével. Érdemes lehet egy kapcsolódó blogon [Form Parser | Űrlapfelismerő | PDF kitöltés | Automatizálja az űrlapfeldolgozást a REST Web API segítségével 17.