Un documento compilabile Moduli PDF con campi di calcolo salva l'utente dall'aritmetica manuale. Il modulo d'ordine totalizza automaticamente le voci. La nota spese somma le categorie. La scheda attività calcola le ore lavorate dalle ore di inizio e di fine. Questi calcoli funzionano correttamente solo se ogni formula, riferimento di campo e regola logica condizionale è stata impostata correttamente nella finestra di progettazione del modulo e se è stata testata con un intervallo di valori di input prima che il modulo fosse distribuito agli utenti.
Un errore di calcolo scoperto dopo che un modulo è stato messo in circolazione crea un problema di fiducia. Gli utenti che notano l'errore potrebbero smettere di utilizzare il modulo. Gli utenti che non se ne accorgono inviano dati errati che si propagano nei sistemi a valle. La convalida dei calcoli dei campi del modulo prima della distribuzione rileva errori di formula, errori di riferimento ai campi ed errori limite che altrimenti non verrebbero rilevati finché i dati dell'utente reale non li esporranno.
Gli strumenti PDF compilabili di WukongPDF includono funzionalità di impostazione e convalida del campo di calcolo.
Come funzionano i calcoli del modulo PDF
I calcoli del modulo PDF utilizzano una sintassi JavaScript semplificata incorporata nelle proprietà del campo. Ogni campo calcolato ha una formula che fa riferimento ad altri campi per nome. La formula può eseguire operazioni aritmetiche di base, applicare la logica condizionale con istruzioni if-else e formattare il risultato come numero, valuta, percentuale o data. Quando un utente modifica un campo a cui fa riferimento la formula, il lettore PDF ricalcola automaticamente i campi dipendenti.
L'ordine di calcolo è importante per le formule a più passaggi. Se il Campo C dipende dal Campo B e il Campo B dipende dal Campo A, il calcolo deve elaborare prima A, poi B e infine C. Il lettore PDF determina automaticamente l'ordine di calcolo in base alle dipendenze dei campi, ma i riferimenti circolari in cui il Campo A dipende dal Campo B e il Campo B dipende dal Campo A producono un errore o un ciclo infinito. Prima di distribuire il modulo, è necessario verificare l'ordine di calcolo per garantire che tutte le dipendenze vengano risolte correttamente.
Prova Modifica PDF
Nessuna installazione necessaria. Funziona direttamente nel tuo browser.
Verifica metodica di ogni campo calcolato
Crea un piano di test che elenchi ogni campo calcolato nel modulo insieme al relativo output previsto per valori di input specifici. Per un modulo d'ordine semplice con campi Quantità, Prezzo unitario e Totale riga, il piano di test specifica: Quantità=5, Prezzo unitario=10,00, Totale riga previsto=50,00. Testare ogni riga del piano e registrare se il risultato effettivo corrisponde a quello previsto.
Testare un intervallo di valori di input, non solo un singolo set. Per i campi numerici, testare con zero, con un valore tipico, con un valore molto grande e con un valore negativo se il campo accetta valori negativi. Una formula che funziona correttamente con input a una cifra potrebbe eccedere o produrre risultati imprevisti con input a sei cifre. Una formula che divide per un valore di campo deve gestire il caso in cui quel campo è zero.
Convalida della logica condizionale nei campi del modulo
Molti moduli includono una logica condizionale che mostra, nasconde o modifica i campi in base alle selezioni dell'utente. Un modulo di spedizione potrebbe mostrare le opzioni di spedizione nazionali quando il campo del Paese è Stati Uniti e le opzioni internazionali negli altri casi. Ogni percorso di condizione deve essere testato in modo indipendente. Per un modulo con tre campi condizionali, ciascuno con due possibili stati, ci sono otto combinazioni da testare.
Testare il confine tra le condizioni. Cosa succede quando un utente seleziona l'ultima opzione in un menu a discesa che attiva una condizione? Cosa succede quando selezionano la prima opzione? Cosa succede quando cancellano un campo dopo aver effettuato una selezione? La transizione tra gli stati è il luogo in cui più spesso si nascondono i bug. Un campo che viene visualizzato correttamente quando una condizione viene soddisfatta potrebbe non scomparire quando la condizione viene successivamente cancellata.
Verifica integrità riferimento campo
I campi calcolati fanno riferimento ad altri campi tramite i relativi nomi di campo interni, che potrebbero differire dalle etichette visibili agli utenti. Un campo denominato Indirizzo e-mail nel modulo può avere il nome interno Indirizzo_e-mail o e-mail1. Se un campo calcolato fa riferimento a EmailAddress ma il nome del campo effettivo è Email_Address, il calcolo si interrompe automaticamente. Il modulo non visualizza errori. Il campo calcolato mostra semplicemente zero o vuoto.
Apri le proprietà del campo per ogni campo calcolato e verifica ogni riferimento di campo rispetto ai nomi di campo effettivi nel pannello Campi. Un singolo errore di battitura in un riferimento a un campo, ad esempio Qty vs Qtty, interrompe il calcolo dell'intero campo. Utilizza l'elenco dei campi nello strumento Prepara modulo per visualizzare tutti i nomi dei campi in un'unica visualizzazione e confrontarli con le formule di calcolo.
| Tipo di calcolo | Esempio | Metodo di convalida |
|---|---|---|
| Somma di campi | Subtotale + Tasse = Totale | Verificare manualmente i calcoli di esempio |
| Logica condizionale | Se spunta la casella A, abilita il campo B | Testare ogni percorso di condizione |
| Calcoli della data | Data di fine = Data di inizio + 30 giorni | Testare le date limite compresi gli anni bisestili |
Testare il modulo su più lettori PDF
I calcoli del modulo PDF si basano sull'esecuzione di JavaScript nel lettore PDF. Diversi lettori implementano l'API JavaScript di Acrobat con diversi gradi di completezza. Un calcolo che funziona in Adobe Acrobat Reader potrebbe non essere eseguito in un visualizzatore PDF basato su browser, in Anteprima su Mac o in un'app PDF mobile. Il modulo dovrebbe includere una nota che specifica quali lettori PDF supportano i calcoli.
Prova il modulo in almeno tre lettori: Adobe Acrobat Reader, un visualizzatore basato su browser come Chrome o Edge e Anteprima su Mac. Per ciascun lettore, inserire i valori del test e verificare che i calcoli vengano eseguiti correttamente. Se i calcoli non funzionano in un particolare lettore, decidi se aggiungere una nota di compatibilità che richiede agli utenti di aprire il modulo in Acrobat Reader o di modificare i calcoli per utilizzare funzionalità JavaScript più ampiamente supportate.
Creazione di una lista di controllo di convalida per la distribuzione dei moduli
Prima di distribuire un modulo calcolato, eseguire un elenco di controllo di convalida finale. Verifica che ogni campo calcolato produca l'output corretto per almeno tre combinazioni di input. Conferma che tutti i riferimenti ai campi nelle formule corrispondano ai nomi dei campi effettivi. Testare tutti i percorsi logici condizionali. Verifica i calcoli in più lettori PDF. Verifica che l'ordine di tabulazione si sposti attraverso i campi in una sequenza logica.
Documentare i risultati della convalida, inclusi i valori dei test utilizzati, i lettori testati e gli eventuali problemi rilevati e risolti. Il record di convalida funge da documentazione per futuri aggiornamenti del modulo e per i requisiti di conformità in cui deve essere dimostrata l'accuratezza del modulo. Un modulo che ha superato la convalida con risultati documentati ispira più fiducia di uno che si presumeva semplicemente funzionasse correttamente.
La convalida dei calcoli del modulo PDF prima della distribuzione rileva errori che altrimenti produrrebbero silenziosamente dati errati da utenti che ritengono che il modulo sia accurato. Il processo di convalida richiede meno tempo rispetto alla correzione degli errori nei dati dopo che un modulo è rimasto in circolazione per settimane.
Gestione della precisione in virgola mobile nei calcoli del modulo
I calcoli del modulo PDF utilizzano il tipo di numero JavaScript che è a virgola mobile. La somma di 0,1 e 0,2 può produrre 0,30000000000000004 anziché 0,3. Per i calcoli finanziari, utilizzare toFixed() per arrotondare i risultati: event.value = (field1 + field2).toFixed(2). Questo arrotonda a due cifre decimali ed evita sorprese di precisione.
Calcoli di prova con valori noti per produrre casi limite di precisione. Aggiungi 0,1 e 0,2 e verifica 0,3 dopo l'arrotondamento. Moltiplica 0,1 per 3 e verifica 0,3. Includere questi test di precisione nel piano di test di convalida insieme ai test aritmetici standard.
Documentare la logica di calcolo per i futuri manutentori del modulo
In pratica, chi eredita un modulo PDF complesso deve comprenderne la logica di calcolo. Documenta ogni campo calcolato con la sua formula e le sue dipendenze. Un semplice foglio di calcolo che elenca nomi di campi, formule e dipendenze funge da mappa di calcolo per la risoluzione dei problemi o la modifica del modulo.
Includi la documentazione come pagina nascosta nel PDF o come file complementare. Quando è necessaria una modifica, il manutentore consulta la documentazione anziché le formule di reverse engineering dalle proprietà del campo. Questo investimento viene ripagato la prima volta che qualcuno oltre al creatore originale aggiorna il modulo.
La convalida del calcolo del modulo è una garanzia di qualità per la raccolta dei dati. Il tempo dedicato ai test prima della distribuzione evita il maggiore dispendio di tempo necessario per correggere dati errati dopo che centinaia di utenti hanno inviato moduli con errori di calcolo. Un modulo convalidato ispira fiducia negli utenti e protegge l'integrità dei dati nell'intero flusso di lavoro che dipende dall'invio accurato dei moduli.
In pratica, le tecniche di convalida qui descritte si applicano a qualsiasi modulo PDF con calcoli, indipendentemente dallo strumento utilizzato per creare il modulo. I principi del test sistematico, della copertura dei casi limite, della verifica dei riferimenti sul campo e dei test multi-lettore sono universali. Integrateli nel processo di sviluppo dei moduli e ogni modulo spedito verrà calcolato correttamente.
Il processo di validazione dovrebbe essere documentato e ripetibile. Un modulo che supera la convalida oggi dovrebbe superare la stessa convalida domani. Il piano di test documentato consente a qualsiasi membro del team di convalidare il modulo, non solo alla persona che lo ha creato.
Gli errori di calcolo dei moduli che raggiungono gli utenti creano problemi di qualità dei dati che si propagano nei sistemi a valle. Un totale che non si somma correttamente in un modulo inviato diventa una discrepanza contabile. La prevenzione attraverso la convalida è molto più economica della correzione dopo la sottomissione.
Nella maggior parte degli strumenti, il tempo investito nella convalida dei moduli è una frazione del tempo necessario per correggere dati errati provenienti da centinaia di moduli inviati. Un accurato passaggio di convalida prima della distribuzione è una delle attività di garanzia della qualità più redditizie nella preparazione dei documenti.
I moduli PDF convalidati ispirano fiducia negli utenti. Quando gli utenti vedono che i calcoli funzionano correttamente e in modo coerente, si fidano del modulo e inviano dati accurati. Tale fiducia, una volta stabilita, si estende all’organizzazione che ha pubblicato il modulo.
Prova Modifica PDF
Nessuna installazione necessaria. Funziona direttamente nel tuo browser.