Un document à remplir PDF Forms avec des champs de calcul évite à l'utilisateur l'arithmétique manuelle. Le formulaire de commande totalise automatiquement les postes. La note de frais résume les catégories. La feuille de temps calcule les heures travaillées à partir des heures de début et de fin. Ces calculs ne fonctionnent correctement que si chaque formule, référence de champ et règle logique conditionnelle a été correctement configurée dans le concepteur de formulaire et si elles ont été testées avec une plage de valeurs d'entrée avant que le formulaire ne soit distribué aux utilisateurs.
Une erreur de calcul découverte après la mise en circulation d'un formulaire crée un problème de confiance. Les utilisateurs qui remarquent l'erreur peuvent cesser d'utiliser le formulaire. Les utilisateurs qui ne le remarquent pas soumettent des données incorrectes qui se propagent dans les systèmes en aval. La validation des calculs des champs de formulaire avant la distribution détecte les erreurs de formule, les erreurs de référence de champ et les échecs extrêmes qui autrement ne seraient pas détectés jusqu'à ce que les données utilisateur réelles les exposent.
Les outils Fillable PDF de WukongPDF incluent des fonctionnalités de configuration et de validation des champs de calcul.
Comment fonctionnent les calculs du formulaire PDF
Les calculs du formulaire PDF utilisent une syntaxe JavaScript simplifiée intégrée dans les propriétés du champ. Chaque champ calculé possède une formule qui fait référence à d'autres champs par leur nom. La formule peut effectuer des opérations arithmétiques de base, appliquer une logique conditionnelle avec des instructions if-else et formater le résultat sous forme de nombre, de devise, de pourcentage ou de date. Lorsqu'un utilisateur modifie un champ auquel la formule fait référence, le lecteur PDF recalcule automatiquement les champs dépendants.
L'ordre de calcul est important pour les formules à plusieurs étapes. Si le champ C dépend du champ B et que le champ B dépend du champ A, le calcul doit d'abord traiter A, puis B, puis C. Le lecteur PDF détermine automatiquement l'ordre de calcul en fonction des dépendances du champ, mais les références circulaires où le champ A dépend du champ B et le champ B dépend du champ A produisent une erreur ou une boucle infinie. Avant de distribuer le formulaire, l'ordre de calcul doit être vérifié pour garantir que toutes les dépendances sont correctement résolues.
Essayez de modifier le PDF
Aucune installation nécessaire. Fonctionne directement dans votre navigateur.
Tester méthodiquement chaque champ calculé
Créez un plan de test qui répertorie chaque champ calculé du formulaire ainsi que sa sortie attendue pour des valeurs d'entrée spécifiques. Pour un formulaire de commande simple avec des champs Quantité, Prix unitaire et Total de ligne, le plan de test spécifie : Quantité=5, Prix unitaire=10,00, Total de ligne attendu=50,00. Testez chaque ligne du plan et enregistrez si le résultat réel correspond au résultat attendu.
Testez une plage de valeurs d’entrée, pas seulement un seul ensemble. Pour les champs numériques, testez avec zéro, avec une valeur typique, avec une très grande valeur et avec une valeur négative si le champ accepte des négatifs. Une formule qui fonctionne correctement avec des entrées à un chiffre peut déborder ou produire des résultats inattendus avec des entrées à six chiffres. Une formule qui divise par une valeur de champ doit gérer le cas où ce champ est nul.
Validation de la logique conditionnelle dans les champs de formulaire
De nombreux formulaires incluent une logique conditionnelle qui affiche, masque ou modifie les champs en fonction des sélections de l'utilisateur. Un formulaire d'expédition peut afficher les options d'expédition nationales lorsque le champ du pays est États-Unis et les options internationales dans le cas contraire. Chaque chemin de condition doit être testé indépendamment. Pour un formulaire comportant trois champs conditionnels, chacun avec deux états possibles, cela fait huit combinaisons à tester.
Testez la frontière entre les conditions. Que se passe-t-il lorsqu'un utilisateur sélectionne la dernière option dans une liste déroulante qui déclenche une condition ? Que se passe-t-il lorsqu’ils sélectionnent la première option ? Que se passe-t-il lorsqu'ils effacent un champ après avoir effectué une sélection ? La transition entre les états est l’endroit où les bugs se cachent le plus souvent. Un champ qui apparaît correctement lorsqu'une condition est remplie peut ne pas disparaître lorsque la condition est ensuite effacée.
Vérification de l'intégrité de la référence du champ
Les champs calculés font référence à d'autres champs par leurs noms de champ internes, qui peuvent différer des étiquettes visibles par les utilisateurs. Un champ intitulé Adresse e-mail sur le formulaire peut avoir le nom interne Email_Address ou email1. Si un champ calculé fait référence à EmailAddress mais que le nom réel du champ est Email_Address, le calcul s'interrompt silencieusement. Le formulaire n'affiche aucune erreur. Le champ calculé affiche simplement zéro ou vide.
Ouvrez les propriétés de champ pour chaque champ calculé et vérifiez chaque référence de champ par rapport aux noms de champ réels dans le panneau Champs. Une seule faute de frappe dans une référence de champ, telle que Qté vs Qté, interrompt le calcul pour l'ensemble de ce champ. Utilisez la liste des champs dans l'outil Préparer le formulaire pour voir tous les noms de champs dans une seule vue et les comparer aux formules de calcul.
| Type de calcul | Exemple | Méthode de validation |
|---|---|---|
| Somme des champs | Sous-total + Taxe = Total | Vérifier manuellement des exemples de calculs |
| Logique conditionnelle | Si la case A est cochée, alors activez le champ B | Testez chaque chemin de condition |
| Calculs de dates | Date de fin = Date de début + 30 jours | Testez les dates limites, y compris les années bissextiles |
Test du formulaire dans plusieurs lecteurs PDF
Les calculs du formulaire PDF reposent sur l'exécution de JavaScript dans le lecteur PDF. Différents lecteurs implémentent l'API JavaScript d'Acrobat avec différents degrés d'exhaustivité. Un calcul qui fonctionne dans Adobe Acrobat Reader peut ne pas s'exécuter dans une visionneuse PDF basée sur un navigateur, dans Aperçu sur Mac ou dans une application PDF mobile. Le formulaire doit inclure une note précisant quels lecteurs PDF prennent en charge les calculs.
Testez le formulaire sur au moins trois lecteurs : Adobe Acrobat Reader, une visionneuse basée sur un navigateur comme Chrome ou Edge, et Aperçu sur Mac. Pour chaque lecteur, remplissez les valeurs de test et confirmez que les calculs s'exécutent correctement. Si les calculs ne fonctionnent pas dans un lecteur particulier, décidez s'il convient d'ajouter une note de compatibilité demandant aux utilisateurs d'ouvrir le formulaire dans Acrobat Reader ou de modifier les calculs pour utiliser des fonctionnalités JavaScript plus largement prises en charge.
Création d'une liste de contrôle de validation pour la distribution de formulaire
Avant de distribuer un formulaire calculé, parcourez une liste de contrôle de validation finale. Vérifiez que chaque champ calculé produit la sortie correcte pour au moins trois combinaisons d'entrée. Confirmez que toutes les références de champ dans les formules correspondent aux noms de champ réels. Testez tous les chemins logiques conditionnels. Vérifiez les calculs dans plusieurs lecteurs PDF. Vérifiez que l'ordre de tabulation se déplace dans les champs dans une séquence logique.
Documentez les résultats de validation, y compris les valeurs de test utilisées, les lecteurs testés et tous les problèmes trouvés et résolus. Le dossier de validation sert de documentation pour les futures mises à jour du formulaire et pour les exigences de conformité où l'exactitude du formulaire doit être démontrée. Un formulaire qui a réussi la validation avec des résultats documentés inspire plus de confiance qu'un formulaire qui était simplement supposé fonctionner correctement.
La validation des calculs du formulaire PDF avant la distribution détecte les erreurs qui autrement produiraient silencieusement des données incorrectes de la part des utilisateurs qui font confiance à l'exactitude du formulaire. Le processus de validation prend moins de temps que la correction des erreurs de données après qu'un formulaire ait été en circulation pendant des semaines.
Gestion de la précision à virgule flottante dans les calculs de formulaire
Les calculs du formulaire PDF utilisent le type JavaScript Number qui est à virgule flottante. L'ajout de 0,1 et 0,2 peut produire 0,30000000000000004 au lieu de 0,3. Pour les calculs financiers, utilisez toFixed() pour arrondir les résultats : event.value = (field1 + field2).toFixed(2). Cela arrondit à deux décimales et évite les surprises de précision.
Testez les calculs avec des valeurs connues pour produire des cas extrêmes de précision. Ajoutez 0,1 et 0,2 et vérifiez 0,3 après arrondi. Multipliez 0,1 par 3 et vérifiez 0,3. Incluez ces tests de précision dans le plan de tests de validation aux côtés des tests arithmétiques standard.
Documenter la logique de calcul pour les futurs responsables de formulaires
En pratique, la personne qui hérite d’un formulaire PDF complexe doit comprendre la logique de calcul. Documentez chaque champ calculé avec sa formule et ses dépendances. Une simple feuille de calcul répertoriant les noms de champs, les formules et les dépendances sert de carte de calcul pour dépanner ou modifier le formulaire.
Incluez la documentation sous forme de page masquée dans le PDF ou sous forme de fichier compagnon. Lorsqu'une modification est nécessaire, le responsable consulte la documentation plutôt que de procéder à une ingénierie inverse des formules à partir des propriétés du champ. Cet investissement est rentabilisé la première fois qu'une personne autre que le créateur d'origine met à jour le formulaire.
La validation du calcul du formulaire est une assurance qualité pour la collecte de données. Le temps passé aux tests avant la distribution évite le temps plus long nécessaire à la correction des mauvaises données après que des centaines d'utilisateurs ont soumis des formulaires comportant des erreurs de calcul. Un formulaire validé inspire confiance à l'utilisateur et protège l'intégrité des données tout au long du flux de travail qui dépend de la soumission précise du formulaire.
En pratique, les techniques de validation décrites ici s'appliquent à tout formulaire PDF comportant des calculs, quel que soit l'outil utilisé pour créer le formulaire. Les principes des tests systématiques, de la couverture des cas extrêmes, de la vérification des références sur le terrain et des tests multi-lecteurs sont universels. Intégrez-les dans le processus de développement de formulaires et chaque formulaire expédié sera calculé correctement.
Le processus de validation doit être documenté et reproductible. Un formulaire qui passe la validation aujourd'hui devrait passer la même validation demain. Le plan de test documenté permet à n'importe quel membre de l'équipe de valider le formulaire, et pas seulement à la personne qui l'a créé.
Les erreurs de calcul des formulaires qui atteignent les utilisateurs créent des problèmes de qualité des données qui se répercutent sur les systèmes en aval. Un total qui ne correspond pas correctement dans un formulaire soumis devient un écart comptable. La prévention par la validation est bien moins coûteuse que la correction après soumission.
Dans la plupart des outils, le temps investi dans la validation des formulaires ne représente qu'une fraction du temps nécessaire pour corriger les mauvaises données provenant de centaines de formulaires soumis. Une validation approfondie avant la distribution est l’une des activités d’assurance qualité les plus rentables dans la préparation de documents.
Les formulaires PDF validés inspirent confiance aux utilisateurs. Lorsque les utilisateurs constatent que les calculs fonctionnent correctement et de manière cohérente, ils font confiance au formulaire et soumettent des données précises. Cette confiance, une fois établie, s'étend à l'organisation qui a publié le formulaire.
Essayez de modifier le PDF
Aucune installation nécessaire. Fonctionne directement dans votre navigateur.