Elenchi i campi PDF: nomi, tipi e valori correnti

Questa capacità legge tale struttura e restituisce un inventario chiaro di tutti i campi, inclusi nome completo, tipo riconosciuto e valore corrente. Gestisce i comuni controlli AcroForm usati in domande, questionari, approvazioni e documenti di registrazione. L’elaborazione è deterministica e locale: non effettua richieste di rete, non formula ipotesi tramite modelli e non produce risultati casuali. Se il file non è un PDF, è danneggiato o non contiene campi, la richiesta restituisce un errore di input esplicito invece di un risultato vuoto che potrebbe sembrare valido.

Esamini la struttura reale del modulo PDF

I moduli PDF interattivi memorizzano i controlli separatamente dalle parole e dalle linee disegnate sulle pagine. Un campo può chiamarsi internamente customer.address.postcode anche se la pagina mostra soltanto l’etichetta «Codice postale». Questa capacità segue il catalogo del documento fino al dizionario AcroForm, percorre l’albero dei campi, applica le proprietà ereditate e restituisce i campi terminali nell’ordine del documento. Ogni risultato contiene il nome completo, un tipo normalizzato e il valore salvato nel PDF. Caselle di testo, caselle di spunta, gruppi radio, menu a discesa, liste di opzioni, pulsanti e firme vengono distinti tramite il tipo e i flag definiti nel documento. I nomi gerarchici sono uniti con punti, così controlli simili in sezioni diverse restano inequivocabili. L’output diventa quindi un inventario dello schema leggibile da una macchina, non una semplice estrazione del testo visibile. Una casella senza valore attivo viene indicata come false e un campo firma vuoto viene riconosciuto senza fingere che la firma esista.

Invii il documento e interpreti la risposta

Invii il PDF nel parametro pdf come base64 semplice oppure come URL dati application/pdf codificato in base64. Il parser verifica prima la codifica e l’intestazione PDF, quindi legge gli oggetti indiretti necessari a trovare il catalogo e l’albero dei campi. La risposta include fields, una matrice di record, e count, il numero dei campi restituiti. I tipi usano nomi pratici quali TextField, CheckBox, RadioGroup, Dropdown, OptionList, PushButton e Signature. I valori correnti mantengono stringhe e matrici quando il PDF li memorizza così, mentre lo stato di una casella viene restituito come booleano. I controlli testuali vuoti usano una stringa vuota e si distinguono dai campi assenti. Non confonda l’etichetta stampata accanto al controllo con il nome del campo: soltanto la definizione interna determina il nome restituito. L’assenza di campi genera intenzionalmente un errore, aiutando l’automazione a rilevare un PDF appiattito, una scansione o un allegato errato. La dimensione accettata è limitata per mantenere prevedibile l’analisi.

Usi l’inventario in sicurezza nei flussi documentali

Un inventario dei campi è un utile primo passo prima di compilare, convalidare, migrare o controllare moduli PDF. Un sistema di onboarding può confrontare i nomi restituiti con le chiavi del database prima di compilare un modello. Un controllo qualità può verificare che una versione aggiornata conservi i campi obbligatori e che i tipi non siano cambiati. Una migrazione d’archivio può registrare i valori incorporati in ciascun documento interattivo prima di appiattirlo. Poiché l’algoritmo non contatta servizi esterni e non deduce valori dall’aspetto della pagina, richieste con byte identici producono lo stesso JSON. Questa prevedibilità è importante per test e verifiche. Si tratta però di un lettore di strutture AcroForm, non di riconoscimento ottico: la scansione di un modulo cartaceo contiene pixel ma nessun campo interattivo e genera quindi l’errore previsto. La capacità non modifica, appiattisce, firma, decifra né ripara documenti. I file cifrati o con oggetti illeggibili devono essere preparati prima dell’invio con uno strumento PDF adeguato.