Tips & Tricks

Как проверить вычисления полей формы PDF перед распространением формы

Заполняемый документ PDF Forms с полями вычислений избавляет пользователя от необходимости выполнять арифметические операции вручную. Форма заказа автоматически суммирует позиции. Отчет о расходах суммирует категории. В табеле учета рабочего времени рассчитываются отработанные часы с момента начала и окончания. Эти вычисления работают правильно только в том случае, если каждая формула, ссылка на поле и правило условной логики были правильно настроены в конструкторе форм и были протестированы с диапазоном входных значений перед распространением формы среди пользователей.

Ошибка расчета, обнаруженная после того, как форма находится в обращении, создает проблему доверия. Пользователи, заметившие ошибку, могут прекратить использование формы. Пользователи, которые этого не замечают, отправляют неверные данные, которые передаются в последующие системы. Проверка вычислений полей формы перед распространением выявляет ошибки формул, ошибки ссылок на поля и крайние сбои, которые в противном случае остались бы незамеченными до тех пор, пока их не обнаружат реальные пользовательские данные.

Инструменты Fillable PDF WukongPDF включают в себя настройку полей вычислений и функции проверки.

How to Validate PDF Form Field Calculations Before Distributing the Form

Как работают расчеты PDF-форм

В расчетах форм PDF используется упрощенный синтаксис JavaScript, встроенный в свойства поля. Каждое вычисляемое поле имеет формулу, которая ссылается на другие поля по имени. Формула может выполнять базовые арифметические действия, применять условную логику с операторами if-else и форматировать результат как число, денежную единицу, процент или дату. Когда пользователь изменяет любое поле, на которое ссылается формула, программа чтения PDF-файлов автоматически пересчитывает зависимые поля.

Порядок расчета имеет значение для многошаговых формул. Если поле C зависит от поля B, а поле B зависит от поля A, сначала необходимо обработать A, затем B, затем C. Средство чтения PDF автоматически определяет порядок вычислений на основе зависимостей полей, но циклические ссылки, где поле A зависит от поля B, а поле B зависит от поля A, приводят к ошибке или бесконечному циклу. Перед распространением формы необходимо проверить порядок вычислений, чтобы убедиться, что все зависимости разрешаются правильно.

WukongPDF

Попробуйте редактировать PDF

Никакой установки не требуется. Работает прямо в вашем браузере.

Начать →

Методическая проверка каждого вычисляемого поля

Создайте план тестирования, в котором перечислены все вычисляемые поля в форме, а также ожидаемые выходные данные для конкретных входных значений. Для простой формы заказа с полями «Количество», «Цена за единицу» и «Итог по строке» в плане тестирования указано: Количество = 5, Цена за единицу = 10,00, ожидаемая общая сумма строки = 50,00. Проверьте каждую строку плана и запишите, соответствует ли фактический результат ожидаемому результату.

Протестируйте диапазон входных значений, а не только один набор. Для числовых полей проверяйте с нулем, с типичным значением, с очень большим значением и с отрицательным значением, если поле принимает отрицательные значения. Формула, которая правильно работает с однозначными входными данными, может переполниться или дать неожиданные результаты при шестизначных входных данных. Формула деления на значение поля должна обрабатывать случай, когда это поле равно нулю.

Проверка условной логики в полях формы

Многие формы включают условную логику, которая показывает, скрывает или изменяет поля в зависимости от выбора пользователя. В форме доставки могут отображаться варианты доставки внутри страны, если в поле страны указана США, и варианты международной доставки в противном случае. Каждый путь условия должен тестироваться независимо. Для формы с тремя условными полями, каждое из которых имеет два возможных состояния, это восемь комбинаций для проверки.

Проверьте границу между условиями. Что происходит, когда пользователь выбирает последний вариант в раскрывающемся списке, который запускает условие? Что произойдет, если они выберут первый вариант? Что происходит, когда они очищают поле после выбора? При переходе между состояниями чаще всего прячутся ошибки. Поле, которое правильно отображается при выполнении условия, может не исчезнуть при последующей очистке условия.

Проверка целостности ссылки на поле

Вычисляемые поля ссылаются на другие поля по их внутренним именам, которые могут отличаться от меток, видимых пользователям. Поле с надписью «Адрес электронной почты» в форме может иметь внутреннее имя Email_Address или email1. Если вычисляемое поле ссылается на EmailAddress, но фактическое имя поля — Email_Address, вычисление прерывается автоматически. Форма не отображает ошибок. Вычисляемое поле просто показывает ноль или пустое значение.

Откройте свойства поля для каждого вычисляемого поля и сверьте каждую ссылку на поле с фактическими именами полей на панели «Поля». Одна опечатка в ссылке на поле, например Qty vs Qtty, нарушает расчет для всего поля. Используйте список полей в инструменте «Подготовка формы», чтобы просмотреть все имена полей в одном представлении и сопоставить их с формулами расчета.

Тип расчетаПримерМетод проверки
Сумма полейПромежуточный итог + Налог = ИтогоВручную проверьте примеры расчетов
Условная логикаЕсли флажок А, то включить поле БПроверьте каждый путь условия
Расчеты датДата окончания = дата начала + 30 дней.Даты края теста, включая високосные годы

Тестирование формы в нескольких программах чтения PDF

Расчеты PDF-форм основаны на выполнении JavaScript в программе чтения PDF-файлов. Разные читатели реализуют API Acrobat JavaScript с разной степенью полноты. Расчет, который работает в Adobe Acrobat Reader, может не выполняться в средстве просмотра PDF-файлов в браузере, в программе «Просмотр» на Mac или в мобильном приложении PDF. Форма должна включать примечание, указывающее, какие программы чтения PDF поддерживают расчеты.

Проверьте форму как минимум в трех программах чтения: Adobe Acrobat Reader, браузерной программе просмотра, такой как Chrome или Edge, и Preview на Mac. Для каждого считывателя введите тестовые значения и убедитесь, что расчеты выполняются правильно. Если расчеты не работают в конкретном приложении Reader, решите, добавить ли примечание о совместимости, инструктирующее пользователей открывать форму в Acrobat Reader, или изменить расчеты для использования более широко поддерживаемых функций JavaScript.

Создание контрольного списка проверки для распространения форм

Прежде чем распространять расчетную форму, выполните окончательный контрольный список проверки. Убедитесь, что каждое вычисляемое поле дает правильный результат как минимум для трех входных комбинаций. Убедитесь, что все ссылки на поля в формулах соответствуют фактическим именам полей. Проверьте все условные логические пути. Проверьте расчеты в нескольких программах чтения PDF. Убедитесь, что порядок табуляции перемещается по полям в логической последовательности.

Задокументируйте результаты проверки, в том числе, какие тестовые значения использовались, какие считыватели были протестированы, а также любые обнаруженные и решенные проблемы. Запись о проверке служит документацией для будущих обновлений форм и требований соответствия, где необходимо продемонстрировать точность формы. Форма, прошедшая проверку с задокументированными результатами, внушает больше доверия, чем форма, которая просто предполагалась правильно работающей.

Проверка расчетов формы PDF перед распространением выявляет ошибки, которые в противном случае могли бы незаметно предоставить неправильные данные от пользователей, которые уверены в точности формы. Процесс проверки занимает меньше времени, чем исправление ошибок в данных после того, как форма находилась в обращении в течение нескольких недель.

Обработка точности чисел с плавающей запятой в вычислениях форм

В расчетах PDF-форм используется числовой тип JavaScript с плавающей запятой. Сложение 0,1 и 0,2 может дать 0,30000000000000004, а не 0,3. Для финансовых расчетов используйте toFixed() для округления результатов: event.value = (field1 + field2).toFixed(2). Это округляет до двух десятичных знаков и позволяет избежать сюрпризов с точностью.

Тестовые расчеты со значениями, которые, как известно, приводят к точным крайним случаям. Сложите 0,1 и 0,2 и после округления проверьте 0,3. Умножьте 0,1 на 3 и проверьте 0,3. Включите эти тесты на точность в план проверочных испытаний наряду со стандартными арифметическими тестами.

Документирование логики вычислений для будущих специалистов по обслуживанию форм

На практике человеку, унаследовавшему сложную форму PDF, необходимо понимать логику вычислений. Документируйте каждое вычисляемое поле с его формулой и зависимостями. Простая электронная таблица со списком имен полей, формул и зависимостей служит картой вычислений для устранения неполадок или изменения формы.

Включите документацию в виде скрытой страницы в PDF-файл или в виде сопутствующего файла. При необходимости внесения изменений специалист по сопровождению обращается к документации, а не занимается обратным проектированием формул на основе свойств полей. Эти инвестиции окупятся, когда кто-то, кроме первоначального создателя, впервые обновит форму.

Проверка формы расчета — это гарантия качества сбора данных. Время, затрачиваемое на тестирование перед распространением, предотвращает увеличение временных затрат на исправление неверных данных после того, как сотни пользователей отправили формы с ошибками в расчетах. Проверенная форма внушает доверие пользователей и защищает целостность данных на протяжении всего рабочего процесса, который зависит от точности отправки форм.

На практике описанные здесь методы проверки применимы к любой PDF-форме с расчетами, независимо от инструмента, использованного для создания формы. Принципы систематического тестирования, охвата крайних случаев, проверки ссылок на местах и тестирования с участием нескольких читателей универсальны. Включите их в процесс разработки форм, и каждая поставляемая форма будет рассчитываться правильно.

Процесс валидации должен быть документирован и повторяем. Форма, которая проходит проверку сегодня, должна пройти такую же проверку и завтра. Документированный план тестирования позволяет любому члену команды проверить форму, а не только тому, кто ее создал.

Ошибки расчета форм, которые доходят до пользователей, создают проблемы с качеством данных, которые распространяются на последующие системы. Сумма, которая неправильно складывается в поданной форме, становится бухгалтерским расхождением. Предотвращение путем проверки обходится гораздо дешевле, чем исправление после подачи.

В большинстве инструментов время, затрачиваемое на проверку формы, составляет лишь часть времени, необходимого для исправления неверных данных из сотен отправленных форм. Тщательная проверка перед распространением является одним из самых прибыльных мероприятий по обеспечению качества при подготовке документов.

Проверенные PDF-формы вызывают доверие пользователей. Когда пользователи видят, что расчеты работают правильно и последовательно, они доверяют форме и отправляют точные данные. Это доверие, однажды установленное, распространяется на организацию, опубликовавшую форму.

WukongPDF

Попробуйте редактировать PDF

Никакой установки не требуется. Работает прямо в вашем браузере.

Начать →