Aggiungere un campo firma a un PDF

Se un bordo qualsiasi esce dalla pagina, rifiuta il posizionamento con una spiegazione precisa di quale limite è stato superato, prima che Lei sprechi un'operazione di firma su un campo che nessuno vedrà mai.

Perché il posizionamento dei campi firma fallisce in produzione

E ogni team che automatizza la firma dei documenti finisce per pubblicare un bug di impaginazione — un modello di contratto si ricompone, una pagina scansionata arriva in A4 invece che in Letter, una coordinata calcolata per una pagina verticale atterra su una orizzontale, e il campo firma finisce fuori dalla pagina visibile. In alcuni strumenti la firma viene comunque applicata, quindi il documento risulta firmato nella dashboard ma non mostra nulla nella pagina che una persona apre. Una chiamata di validazione sostituisce l'incidente a valle.

Coordinate, unità e cosa ottiene

Tutti i valori sono punti PDF — settantadue per pollice — con l'origine nell'angolo in basso a sinistra della pagina, x che cresce verso destra e y verso l'alto, esattamente il sistema di coordinate che le annotazioni dei campi firma PDF usano nativamente.

In caso di successo, la risposta restituisce il rettangolo normalizzato, indica i quattro limiti assoluti, il margine residuo su ogni lato della pagina, il punto centrale, un quadrante leggibile come bottom-left, l'area del campo in punti quadrati e la percentuale di pagina che copre, oltre a una descrizione di una riga che può riversare direttamente in un log o in una traccia di audit.

In caso di fallimento, il messaggio di errore riporta i numeri incriminati: quale coordinata è scesa sotto lo zero o quale bordo calcolato ha superato quale dimensione della pagina. L'aritmetica è pura geometria di rettangoli con valori arrotondati a sei decimali, quindi la stessa richiesta produce sempre un output identico byte per byte su qualsiasi macchina.

Dove si inserisce in una pipeline di firma

Lo usi come cancello prima di qualsiasi operazione che scriva un campo firma: i costruttori di modelli convalidano ogni campo al salvataggio del modello, i lavori di firma in batch convalidano documento per documento appena prima dell'apposizione, e le pipeline di ingestione convalidano quando si sospetta una discrepanza di formato pagina tra il modello e il file in arrivo.

Poiché la capacità è geometria pura senza I/O su file, è abbastanza veloce da girare su ogni documento di un batch senza pensarci due volte, e abbastanza deterministica perché il suo output possa essere conservato come prova di un posizionamento verificato.