Dokument PDF Forms z polami obliczeniowymi, który można wypełnić, oszczędza użytkownikowi konieczności ręcznej arytmetyki. Formularz zamówienia automatycznie sumuje pozycje pojedyncze. Raport z wydatków sumuje kategorie. Karta czasu pracy oblicza przepracowane godziny od czasu rozpoczęcia i zakończenia. Obliczenia te działają poprawnie tylko wtedy, gdy każda formuła, odwołanie do pola i reguła logiki warunkowej zostały poprawnie skonfigurowane w projektancie formularzy i zostały przetestowane z zakresem wartości wejściowych przed udostępnieniem formularza użytkownikom.
Błąd obliczeniowy wykryty po opublikowaniu formularza powoduje problem z zaufaniem. Użytkownicy, którzy zauważą błąd, mogą zaprzestać korzystania z formularza. Użytkownicy, którzy tego nie zauważają, przesyłają nieprawidłowe dane, które rozprzestrzeniają się do dalszych systemów. Sprawdzanie poprawności obliczeń pól formularza przed dystrybucją wyłapuje błędy w formułach, błędy w odniesieniach do pól i błędy w przypadku skrajnych przypadków, które w przeciwnym razie pozostałyby niewykryte, dopóki nie ujawnią ich rzeczywiste dane użytkownika.
Narzędzia Fillable PDF WukongPDF obejmują konfigurowanie pól obliczeniowych i funkcje sprawdzania poprawności.
Jak działają obliczenia w formularzu PDF
Obliczenia w formacie PDF wykorzystują uproszczoną składnię JavaScript osadzoną we właściwościach pola. Każde pole obliczeniowe ma formułę, która odwołuje się do innych pól według nazwy. Formuła może wykonywać podstawowe działania arytmetyczne, stosować logikę warunkową z instrukcjami if-else i formatować wynik jako liczbę, walutę, wartość procentową lub datę. Gdy użytkownik zmieni dowolne pole, do którego odwołuje się formuła, czytnik plików PDF automatycznie przelicza zależne pola.
Kolejność obliczeń ma znaczenie w przypadku formuł wieloetapowych. Jeśli pole C zależy od pola B, a pole B zależy od pola A, obliczenie musi najpierw przetworzyć A, następnie B, a następnie C. Czytnik plików PDF automatycznie określa kolejność obliczeń na podstawie zależności pól, ale odniesienia cykliczne, w których pole A zależy od pola B, a pole B zależy od pola A, powodują błąd lub nieskończoną pętlę. Przed dystrybucją formularza należy zweryfikować kolejność obliczeń, aby upewnić się, że wszystkie zależności zostały poprawnie rozwiązane.
Wypróbuj opcję Edytuj plik PDF
Nie wymaga instalacji. Działa bezpośrednio w Twojej przeglądarce.
Metodyczne testowanie każdego pola obliczeniowego
Utwórz plan testów zawierający listę wszystkich obliczonych pól w formularzu wraz z oczekiwanymi wynikami dla określonych wartości wejściowych. W przypadku prostego formularza zamówienia z polami Ilość, Cena jednostkowa i Suma wiersza plan testu określa: Ilość = 5, Cena jednostkowa = 10,00, oczekiwana suma wiersza = 50,00. Przetestuj każdy wiersz planu i zapisz, czy rzeczywisty wynik odpowiada oczekiwanemu wynikowi.
Przetestuj zakres wartości wejściowych, a nie tylko pojedynczy zestaw. W przypadku pól numerycznych przeprowadź test z zerem, z typową wartością, z bardzo dużą wartością i z wartością ujemną, jeśli pole akceptuje wartości ujemne. Formuła, która działa poprawnie w przypadku danych jednocyfrowych, może się przepełnić lub dawać nieoczekiwane wyniki w przypadku danych sześciocyfrowych. Formuła dzieląca przez wartość pola musi obsługiwać przypadek, gdy pole to ma wartość zero.
Weryfikacja logiki warunkowej w polach formularza
Wiele formularzy zawiera logikę warunkową, która pokazuje, ukrywa lub modyfikuje pola w oparciu o wybory użytkownika. Formularz wysyłki może wyświetlać opcje wysyłki krajowej, jeśli pole kraju to Stany Zjednoczone, lub opcje międzynarodowe w przeciwnym razie. Każda ścieżka warunku musi być testowana niezależnie. W przypadku formularza z trzema polami warunkowymi, każde z dwoma możliwymi stanami, oznacza to osiem kombinacji do przetestowania.
Przetestuj granicę między warunkami. Co się stanie, gdy użytkownik wybierze ostatnią opcję z menu rozwijanego, która wyzwala warunek? Co się stanie, gdy wybiorą pierwszą opcję? Co się stanie, gdy wyczyszczą pole po dokonaniu wyboru? Przejście między stanami to miejsce, w którym najczęściej ukrywają się błędy. Pole, które pojawia się poprawnie, gdy warunek jest spełniony, może nie zniknąć, gdy warunek zostanie później usunięty.
Sprawdzanie integralności odniesienia pola
Pola obliczone odwołują się do innych pól poprzez wewnętrzne nazwy pól, które mogą różnić się od etykiet widocznych dla użytkowników. Pole o nazwie Adres e-mail w formularzu może mieć nazwę wewnętrzną Email_Address lub email1. Jeśli pole obliczeniowe odwołuje się do adresu e-mail, ale rzeczywista nazwa pola to Email_Address, obliczenia zostaną przerwane w trybie cichym. Formularz nie wyświetla żadnego błędu. Obliczone pole po prostu pokazuje zero lub puste miejsce.
Otwórz właściwości pola dla każdego pola obliczeniowego i sprawdź każde odwołanie do pola z rzeczywistymi nazwami pól w panelu Pola. Pojedyncza literówka w odwołaniu do pola, na przykład Qty vs Qtty, powoduje przerwanie obliczeń dla całego pola. Użyj listy pól w narzędziu Przygotuj formularz, aby zobaczyć wszystkie nazwy pól w jednym widoku i powiązać je z formułami obliczeniowymi.
| Typ obliczenia | Przykład | Metoda walidacji |
|---|---|---|
| Suma pól | Suma częściowa + podatek = Razem | Ręcznie sprawdź przykładowe obliczenia |
| Logika warunkowa | Jeśli pole wyboru A, włącz pole B | Przetestuj każdą ścieżkę warunku |
| Obliczenia dat | Data zakończenia = data rozpoczęcia + 30 dni | Daty krawędzi testu, w tym lata przestępne |
Testowanie formularza w wielu czytnikach PDF
Obliczenia w formacie PDF opierają się na wykonaniu JavaScript w czytniku PDF. Różni czytelnicy implementują interfejs API Acrobat JavaScript z różnym stopniem kompletności. Obliczenia działające w programie Adobe Acrobat Reader mogą nie zostać wykonane w przeglądarce plików PDF w przeglądarce, w aplikacji Preview na komputerze Mac ani w mobilnej aplikacji PDF. W formularzu należy umieścić adnotację określającą, które czytniki PDF obsługują obliczenia.
Przetestuj formularz w co najmniej trzech czytnikach: Adobe Acrobat Reader, przeglądarce opartej na przeglądarce, takiej jak Chrome lub Edge, oraz Preview na komputerze Mac. Dla każdego czytnika należy wpisać wartości testowe i potwierdzić, że obliczenia zostały wykonane prawidłowo. Jeśli obliczenia nie działają w konkretnym czytniku, zdecyduj, czy dodać notatkę o kompatybilności, instruującą użytkowników, aby otworzyli formularz w programie Acrobat Reader, czy też zmodyfikować obliczenia, aby korzystać z szerzej obsługiwanych funkcji JavaScript.
Tworzenie listy kontrolnej walidacji do dystrybucji formularzy
Przed rozesłaniem obliczonego formularza przejrzyj końcową listę kontrolną weryfikacji. Sprawdź, czy każde obliczone pole daje prawidłowe dane wyjściowe dla co najmniej trzech kombinacji wejściowych. Upewnij się, że wszystkie odniesienia do pól w formułach są zgodne z rzeczywistymi nazwami pól. Przetestuj wszystkie ścieżki logiki warunkowej. Sprawdź obliczenia w wielu czytnikach PDF. Sprawdź, czy kolejność tabulacji przechodzi przez pola w logicznej kolejności.
Dokumentuj wyniki walidacji, w tym użyte wartości testowe, które czytniki zostały przetestowane oraz wszelkie znalezione i rozwiązane problemy. Zapis walidacji służy jako dokumentacja przyszłych aktualizacji formularzy i wymogów zgodności, w przypadku których należy wykazać dokładność formularza. Formularz, który przeszedł weryfikację z udokumentowanymi wynikami, budzi większe zaufanie niż formularz, w przypadku którego po prostu założono, że działa prawidłowo.
Sprawdzanie poprawności obliczeń formularza PDF przed dystrybucją wychwytuje błędy, które w przeciwnym razie po cichu wygenerowałyby nieprawidłowe dane od użytkowników, którzy ufają, że formularz jest dokładny. Proces sprawdzania poprawności zajmuje mniej czasu niż poprawianie błędów w danych po tygodniowym obiegu formularza.
Obsługa precyzji zmiennoprzecinkowej w obliczeniach formularzy
Obliczenia w formacie PDF wykorzystują typ JavaScript Number, który jest zmiennoprzecinkowy. Dodanie 0,1 i 0,2 może dać 0,30000000000000004 zamiast 0,3. Do obliczeń finansowych użyj toFixed() do zaokrąglenia wyników: event.value = (pole1 + pole2).toFixed(2). Zaokrągla to do dwóch miejsc po przecinku i pozwala uniknąć niespodzianek związanych z precyzją.
Obliczenia testowe z wartościami znanymi z tworzenia precyzyjnych przypadków brzegowych. Dodaj 0,1 i 0,2 i po zaokrągleniu zweryfikuj 0,3. Pomnóż 0,1 przez 3 i sprawdź 0,3. Uwzględnij te testy precyzji w planie testów walidacyjnych obok standardowych testów arytmetycznych.
Dokumentowanie logiki obliczeń dla przyszłych opiekunów formularzy
W praktyce osoba dziedzicząca złożony formularz PDF musi zrozumieć logikę obliczeń. Udokumentuj każde obliczone pole wraz z jego formułą i zależnościami. Prosty arkusz kalkulacyjny zawierający nazwy pól, formuły i zależności służy jako mapa obliczeniowa do rozwiązywania problemów lub modyfikowania formularza.
Dołącz dokumentację jako ukrytą stronę do pliku PDF lub jako plik towarzyszący. Gdy konieczna jest modyfikacja, opiekun konsultuje się z dokumentacją, zamiast odtwarzać formuły z właściwości pola. Inwestycja ta zwraca się już przy pierwszej aktualizacji formularza przez kogoś poza oryginalnym twórcą.
Walidacja obliczeń formularza zapewnia jakość gromadzenia danych. Czas spędzony na testowaniu przed dystrybucją zapobiega większym kosztom poprawiania błędnych danych po przesłaniu przez setki użytkowników formularzy zawierających błędy w obliczeniach. Zweryfikowany formularz budzi zaufanie użytkowników i chroni integralność danych w całym przepływie pracy, który zależy od dokładnego przesłania formularzy.
W praktyce opisane tutaj techniki walidacji dotyczą dowolnego formularza PDF z obliczeniami, niezależnie od narzędzia użytego do utworzenia formularza. Zasady systematycznego testowania, pokrywania przypadków brzegowych, weryfikacji referencji w terenie i testowania wielu czytników są uniwersalne. Wbuduj je w proces opracowywania formularzy i w każdy formularz, który statki będą poprawnie obliczać.
Proces walidacji powinien być udokumentowany i powtarzalny. Formularz, który dzisiaj przejdzie weryfikację, powinien przejść tę samą weryfikację jutro. Udokumentowany plan testów umożliwia sprawdzenie poprawności formularza każdemu członkowi zespołu, a nie tylko osobie, która go utworzyła.
Błędy w obliczeniach formularzy, które docierają do użytkowników, powodują problemy z jakością danych, które odbijają się na dalszych systemach. Suma, która nie zostanie poprawnie zsumowana w przesłanym formularzu, staje się rozbieżnością księgową. Zapobieganie poprzez walidację jest znacznie tańsze niż korygowanie po złożeniu wniosku.
W przypadku większości narzędzi czas poświęcony na sprawdzanie poprawności formularzy to ułamek czasu potrzebnego na poprawienie błędnych danych z setek przesłanych formularzy. Dokładne przejście walidacyjne przed dystrybucją jest jednym z działań zapewniających najwyższą stopę zwrotu w zakresie przygotowywania dokumentów.
Sprawdzone formularze PDF budzą zaufanie użytkowników. Gdy użytkownicy widzą, że obliczenia działają prawidłowo i spójnie, ufają formularzowi i przesyłają dokładne dane. Po ustanowieniu zaufanie to rozciąga się na organizację, która opublikowała formularz.
Wypróbuj opcję Edytuj plik PDF
Nie wymaga instalacji. Działa bezpośrednio w Twojej przeglądarce.