Τα πεδία φόρμας είναι ένα από τα αναπόσπαστα στοιχεία όταν ασχολούμαστε με δεδομένα πελατών και γίνεται εύκολη η διανομή των φορμών PDF Acro στους χρήστες, ώστε να μπορούν να συμπληρώσουν τις φόρμες με δεδομένα της επιλογής τους και να τα στείλουν πίσω. Γνωρίζουμε ότι μπορούν να χρησιμοποιηθούν διάφορα πεδία φόρμας, αλλά μεταξύ όλων αυτών, τα TextBox, CheckBox, RadioButton και ComboBox είναι πολύ συνηθισμένα. Έτσι, όταν τα δεδομένα έχουν συμπληρωθεί σε φόρμες Acro, αναλύουμε τα πεδία φόρμας στο back office για να εξαγάγουμε δεδομένα από αυτά και να τα αποθηκεύουμε σε FDF, XML ή απευθείας σε βάσεις δεδομένων.
Αν και όλες οι λειτουργίες, συμπεριλαμβανομένης της δημιουργίας φορμών PDF, της προσθήκης πεδίων φόρμας, της δραστηριότητας ενημέρωσης πεδίων φόρμας μπορούν να εκτελεστούν χειροκίνητα, όταν πρόκειται για ένα τεράστιο σύνολο εγγράφων, η χειροκίνητη λειτουργία δεν φαίνεται να είναι εφικτή επειδή είναι χρονοβόρα και επιρρεπής σε σφάλματα λόγω χειροκίνητου χειρισμού δεδομένων. Έτσι, οι αυτόματες ρουτίνες μέσω της γλώσσας προγραμματισμού μπορούν να είναι μια βιώσιμη λύση. Επομένως, κατά τη δημιουργία ενός προγράμματος, έχουμε την επιλογή είτε να χρησιμοποιήσουμε μια εσωτερική λύση/API που μπορεί να μας βοηθήσει να εκπληρώσουμε όλες τις απαιτήσεις είτε να χρησιμοποιήσουμε API REST που φιλοξενούνται στο cloud για να αναλύσουμε τα πεδία της φόρμας.
Οφέλη REST API
Τα RESTful API κάνουν ένα άλμα εδώ επειδή δεν χρειάζεται να παρακολουθείτε χειροκίνητα όλες τις εκδόσεις API. Επίσης, δεν χρειάζεται να διατηρείτε το σύστημά σας ενημερωμένο με εκδόσεις API και δεν χρειάζεται να ανησυχείτε για ζητήματα συμβατότητας των API με μια συγκεκριμένη γλώσσα προγραμματισμού κ.λπ. Επομένως, παρουσιάζουμε το Aspose.PDF Cloud SDK για Java που παρέχει τις δυνατότητες δημιουργίας, χειρισμού καθώς και μετατροπής εγγράφων PDF σε άλλες υποστηριζόμενες μορφές αρχείων. Το Java SDK έχει αναπτυχθεί πάνω από τα API Aspose.PDF Cloud REST στα οποία είναι εύκολα προσβάσιμο χρησιμοποιώντας εντολές cURL και τα SDK έχουν αναπτυχθεί για να διευκολύνουν τους πελάτες μας χρησιμοποιώντας μια συγκεκριμένη γλώσσα προγραμματισμού.
Σε αυτό το ιστολόγιο, θα ρίξουμε λίγο φως στον τρόπο ανάλυσης διαφορετικών πεδίων φόρμας:
- Διαβάστε, προσθέστε ή ενημερώστε τα πεδία TextBox
- Ανάλυση πεδίων φόρμας πλαισίου ελέγχου
- Προσθήκη ή ενημέρωση πεδίων RadioButton
- Χειριστείτε τα πεδία φόρμας ComboBox
Διαβάστε, προσθέστε ή ενημερώστε τα πεδία TextBox
Το API προσφέρει τρεις τρόπους ανάγνωσης πληροφοριών που σχετίζονται με πεδία TextBox.
| API | Τύπος | Περιγραφή | Swagger Link |
| ——————————————– | ———– | ——————————————— | ——————————- |
| /pdf/{name}/fields/textbox | ΠΑΡΕ | Ανάγνωση πεδίων TextBox εγγράφου | GetDocumentTextBoxFields |
| /pdf/{name}/page/{pageNumber}/fields/textbox | ΠΑΡΕ | Διαβάστε τα πεδία του πλαισίου κειμένου εγγράφου για μια δεδομένη σελίδα | GetPageTextBoxFields |
| /pdf/{name}/fields/textbox/{fieldName} | ΠΑΡΕ | Ανάγνωση πεδίων TextBox εγγράφου με όνομα πεδίου | GetTextBoxField |
Εντολή cURL για ανάγνωση πεδίων TextBox
Δεδομένου ότι τα αρχεία αποθηκεύονται στον προσωπικό σας χώρο αποθήκευσης cloud, πρέπει πρώτα να δημιουργήσετε ένα διακριτικό ελέγχου ταυτότητας 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());
}
}
Ανάλυση πεδίων φόρμας πλαισίου ελέγχου
Όταν αντιμετωπίζετε πλαίσια ελέγχου, το API παρέχει επίσης τις δυνατότητες ανάγνωσης των τιμών του πλαισίου ελέγχου, προσθήκης νέου πλαισίου ελέγχου ή ενημέρωσης των ιδιοτήτων που σχετίζονται με ένα υπάρχον πλαίσιο ελέγχου σε φόρμα PDF.
- GetDocumentCheckBoxFields - Read document checkbox fields
- Πεδία GetPageCheckBox - 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>"
Εντολή CURL για ενημέρωση του πλαισίου ελέγχου στη Σελίδα 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);
// Δημιουργία παρουσίας πλαισίου ελέγχου
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);
// ορίστε το χρώμα περιγράμματος του πλαισίου ελέγχου
border.color(color);
// μέθοδος κλήσης για ενημέρωση πεδίου πλαισίου ελέγχου στη σελίδα 1
CheckBoxFieldResponse response = pdf.putCheckBoxField("FormDataTextBox.pdf", "Check Box1", updatedCheckBox,null,null);
// εκτύπωση κωδικού κατάστασης απόκρισης
System.out.print(response.getStatus());
}
}
Μόλις εκτελεστεί η εντολή/κώδικας, οι ιδιότητες που σχετίζονται με το πεδίο ελέγχου 1 ενημερώνονται όπως φαίνεται στην παρακάτω εικόνα.
Εικόνα 1: - Προεπισκόπηση του ενημερωμένου πλαισίου ελέγχου 1 χρησιμοποιώντας την εντολή cURL
Προσθήκη ή ενημέρωση πεδίων 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>"
Αίτημα URL
https://api.aspose.cloud/v3.0/pdf/FormDataTextBox.pdf/fields/radiobutton
Χειριστείτε τα πεδία φόρμας ComboBox
Παρατηρήστε ότι ο χειρισμός ComboBox γίνεται πολύ εύχρηστος με τη βοήθεια του Aspose.PDF Cloud SDK για Java. Έχετε την επιλογή να διαβάσετε τα υπάρχοντα πεδία ComboBox στο έγγραφο, να προσθέσετε ένα νέο πεδίο ComboBox ή να ενημερώσετε ένα υπάρχον ComboBox.
- Πεδία GetDocumentComboBox - Read document combobox fields
- Πεδία GetPageComboBox - Read particular page combobox fields
- GetComboBoxField - Read document combobox field by name
- Πεδία PostComboBox - 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>"
Αίτημα URL
https://api.aspose.cloud/v3.0/pdf/FormDataTextBox.pdf/fields/combobox
Σύναψη
Όπως εξηγείται στο παραπάνω άρθρο, η επεξεργασία των πεδίων φόρμας έχει γίνει αρκετά εύκολη με τη βοήθεια των Cloud API. Μπορείτε να εξετάσετε το ενδεχόμενο να περάσετε από ένα σχετικό ιστολόγιο Form Parser | Form Recognizer | Συμπλήρωση PDF | Αυτοματοποιήστε την επεξεργασία φόρμας με το REST Web API.