계산 필드가 포함된 PDF Forms 채울 수 있는 문서를 사용하면 사용자가 수동으로 계산할 필요가 없습니다. 주문 양식은 품목 항목의 합계를 자동으로 계산합니다. 지출 보고서에는 범주가 요약되어 있습니다. 작업표는 시작 시간과 종료 시간을 기준으로 근무 시간을 계산합니다. 이러한 계산은 모든 수식, 필드 참조 및 조건부 논리 규칙이 양식 디자이너에서 올바르게 설정되고 양식이 사용자에게 배포되기 전에 다양한 입력 값으로 테스트된 경우에만 올바르게 작동합니다.
양식이 유통된 후 발견된 계산 오류는 신뢰 문제를 야기합니다. 오류를 발견한 사용자는 양식 사용을 중단할 수 있습니다. 이를 인지하지 못한 사용자는 다운스트림 시스템에 전파되는 잘못된 데이터를 제출합니다. 배포하기 전에 양식 필드 계산을 검증하면 실제 사용자 데이터가 노출될 때까지 감지되지 않는 수식 오류, 필드 참조 실수 및 극단적인 오류를 포착할 수 있습니다.
WukongPDF의 채울 수 있는 PDF 도구에는 계산 필드 설정 및 검증 기능이 포함되어 있습니다.
PDF 양식 계산 작동 방식
PDF 양식 계산에서는 필드 속성에 포함된 단순화된 JavaScript 구문을 사용합니다. 각 계산된 필드에는 이름으로 다른 필드를 참조하는 수식이 있습니다. 수식은 기본 산술을 수행하고, if-else 문을 사용하여 조건부 논리를 적용하고, 결과를 숫자, 통화, 백분율 또는 날짜로 형식화할 수 있습니다. 사용자가 수식에서 참조하는 필드를 변경하면 PDF 리더는 종속 필드를 자동으로 다시 계산합니다.
다단계 수식에서는 계산 순서가 중요합니다. 필드 C가 필드 B에 종속되고 필드 B가 필드 A에 종속되는 경우 계산은 A를 먼저 처리한 다음 B, C 순으로 처리해야 합니다. PDF 판독기는 필드 종속성을 기반으로 자동으로 계산 순서를 결정하지만 필드 A가 필드 B에 종속되고 필드 B가 필드 A에 종속되는 순환 참조는 오류 또는 무한 루프를 생성합니다. 양식을 배포하기 전에 계산 순서를 확인하여 모든 종속성이 올바르게 해결되었는지 확인해야 합니다.
계산된 각 필드의 방법론적 테스트
특정 입력 값에 대한 예상 출력과 함께 양식의 모든 계산된 필드를 나열하는 테스트 계획을 만듭니다. 수량, 단가 및 라인 총계 필드가 있는 단순 주문 양식의 경우 테스트 계획에서는 수량=5, 단가=10.00, 예상 라인 총계=50.00을 지정합니다. 계획의 각 행을 테스트하고 실제 출력이 예상 출력과 일치하는지 기록합니다.
단일 세트가 아닌 다양한 입력 값을 테스트합니다. 숫자 필드의 경우 0, 일반적인 값, 매우 큰 값으로 테스트하고 필드에 음수가 허용되는 경우 음수 값으로 테스트합니다. 한 자리 입력으로 올바르게 작동하는 수식은 6자리 입력으로 오버플로되거나 예기치 않은 결과가 발생할 수 있습니다. 필드 값으로 나누는 수식은 해당 필드가 0인 경우를 처리해야 합니다.
양식 필드에서 조건부 논리 유효성 검사
많은 양식에는 사용자 선택에 따라 필드를 표시하거나 숨기거나 수정하는 조건부 논리가 포함되어 있습니다. 국가 필드가 미국인 경우 배송 양식에 국내 배송 옵션이 표시되고 그렇지 않으면 해외 옵션이 표시될 수 있습니다. 각 조건 경로는 독립적으로 테스트되어야 합니다. 3개의 조건부 필드가 있고 각각 2개의 가능한 상태가 있는 양식의 경우 테스트할 조합은 8개입니다.
조건 간의 경계를 테스트합니다. 사용자가 조건을 트리거하는 드롭다운의 마지막 옵션을 선택하면 어떻게 되나요? 첫 번째 옵션을 선택하면 어떻게 되나요? 선택한 후 필드를 지우면 어떻게 됩니까? 상태 간 전환은 버그가 가장 자주 숨는 곳입니다. 조건이 충족될 때 올바르게 나타나는 필드는 이후에 조건이 지워지면 사라지지 않을 수 있습니다.
필드 참조 무결성 확인
계산된 필드는 내부 필드 이름으로 다른 필드를 참조하며, 이는 사용자에게 표시되는 레이블과 다를 수 있습니다. 양식에서 이메일 주소라고 표시된 필드의 내부 이름은 Email_Address 또는 email1일 수 있습니다. 계산된 필드가 EmailAddress를 참조하지만 실제 필드 이름이 Email_Address인 경우 계산이 자동으로 중단됩니다. 양식에 오류가 표시되지 않습니다. 계산된 필드에는 단순히 0 또는 공백이 표시됩니다.
각 계산된 필드의 필드 속성을 열고 필드 패널의 실제 필드 이름과 비교하여 모든 필드 참조를 확인합니다. Qty 대 Qtty와 같은 필드 참조의 단일 오타로 인해 해당 전체 필드에 대한 계산이 중단됩니다. 양식 준비 도구의 필드 목록을 사용하면 하나의 보기에서 모든 필드 이름을 확인하고 계산 수식과 상호 참조할 수 있습니다.
| 계산 유형 | 예 | 검증 방법 |
|---|---|---|
| 필드 합계 | 소계 + 세금 = 합계 | 샘플 계산을 수동으로 확인 |
| 조건부 논리 | 확인란 A인 경우 필드 B를 활성화합니다. | 각 조건 경로 테스트 |
| 날짜 계산 | 종료일 = 시작일 + 30일 | 윤년을 포함한 테스트 엣지 날짜 |
여러 PDF 리더에서 양식 테스트
PDF 양식 계산은 PDF 리더의 JavaScript 실행에 의존합니다. 다양한 독자가 다양한 수준의 완성도로 Acrobat JavaScript API를 구현합니다. Adobe Acrobat Reader에서 작동하는 계산은 브라우저 기반 PDF 뷰어, Mac의 미리 보기 또는 모바일 PDF 앱에서 실행되지 않을 수 있습니다. 양식에는 계산을 지원하는 PDF 리더를 지정하는 메모가 포함되어야 합니다.
Adobe Acrobat Reader, Chrome 또는 Edge와 같은 브라우저 기반 뷰어, Mac의 미리보기 등 최소 세 가지 리더에서 양식을 테스트하세요. 각 판독기에 대해 테스트 값을 입력하고 계산이 올바르게 실행되는지 확인합니다. 특정 판독기에서 계산이 작동하지 않는 경우 사용자에게 Acrobat Reader에서 양식을 열도록 지시하는 호환성 참고 사항을 추가할지 아니면 더 광범위하게 지원되는 JavaScript 기능을 사용하도록 계산을 수정할지 결정하십시오.
양식 배포를 위한 검증 체크리스트 생성
계산된 양식을 배포하기 전에 최종 유효성 검사 체크리스트를 실행하세요. 모든 계산된 필드가 최소 세 가지 입력 조합에 대해 올바른 출력을 생성하는지 확인합니다. 수식의 모든 필드 참조가 실제 필드 이름과 일치하는지 확인하세요. 모든 조건부 논리 경로를 테스트합니다. 여러 PDF 리더에서 계산을 확인합니다. 탭 순서가 필드를 논리적 순서로 이동하는지 확인하세요.
어떤 테스트 값이 사용되었는지, 어떤 판독기가 테스트되었는지, 발견 및 해결된 문제를 포함한 검증 결과를 문서화합니다. 유효성 검사 기록은 향후 양식 업데이트와 양식 정확성을 입증해야 하는 규정 준수 요구 사항에 대한 문서 역할을 합니다. 문서화된 결과로 검증을 통과한 양식은 단순히 올바르게 작동한다고 가정한 양식보다 더 많은 자신감을 불러일으킵니다.
배포하기 전에 PDF 양식 계산을 검증하면 양식이 정확하다고 신뢰하는 사용자로부터 자동으로 잘못된 데이터를 생성할 수 있는 오류를 포착합니다. 유효성 검사 프로세스는 양식이 몇 주 동안 배포된 후 데이터 오류를 수정하는 것보다 시간이 덜 걸립니다.
양식 계산에서 부동 소수점 정밀도 처리
PDF 양식 계산에서는 부동 소수점인 JavaScript 숫자 유형을 사용합니다. 0.1과 0.2를 추가하면 0.3이 아닌 0.30000000000000004가 생성될 수 있습니다. 재무 계산의 경우 toFixed()를 사용하여 결과를 반올림합니다. event.value = (field1 + field2).toFixed(2). 이는 소수점 이하 두 자리로 반올림되며 정밀한 놀라움을 방지합니다.
정밀한 엣지 케이스를 생성하는 것으로 알려진 값으로 계산을 테스트합니다. 0.1과 0.2를 더하고 반올림 후 0.3을 확인합니다. 0.1에 3을 곱하고 0.3을 확인합니다. 표준 산술 테스트와 함께 검증 테스트 계획에 이러한 정밀 테스트를 포함합니다.
향후 양식 유지관리자를 위한 계산 논리 문서화
실제로 복잡한 PDF 양식을 상속하는 사람은 계산 논리를 이해해야 합니다. 각 계산된 필드를 수식 및 종속성과 함께 문서화합니다. 필드 이름, 수식 및 종속성을 나열하는 간단한 스프레드시트는 양식 문제 해결 또는 수정을 위한 계산 맵 역할을 합니다.
설명서를 PDF의 숨겨진 페이지나 동반 파일로 포함합니다. 수정이 필요할 때 관리자는 필드 속성의 리버스 엔지니어링 공식보다는 문서를 참고합니다. 이 투자는 원래 작성자가 아닌 사람이 처음으로 양식을 업데이트할 때 보상을 받습니다.
양식 계산 유효성 검사는 데이터 수집에 대한 품질 보증입니다. 배포 전 테스트에 소요되는 시간은 수백 명의 사용자가 계산 오류가 있는 양식을 제출한 후 잘못된 데이터를 수정하는 데 드는 시간 비용을 방지합니다. 검증된 양식은 사용자의 신뢰를 고취하고 정확한 양식 제출에 의존하는 전체 워크플로에서 데이터 무결성을 보호합니다.
실제로 여기에 설명된 유효성 검사 기술은 양식을 만드는 데 사용된 도구에 관계없이 계산이 포함된 모든 PDF 양식에 적용됩니다. 체계적인 테스트, 엣지 케이스 적용 범위, 현장 참조 검증 및 다중 판독기 테스트의 원칙은 보편적입니다. 이를 양식 개발 프로세스에 구축하고 배송되는 모든 양식을 올바르게 계산합니다.
검증 프로세스는 문서화되고 반복 가능해야 합니다. 오늘 유효성 검사를 통과한 양식은 내일도 동일한 유효성 검사를 통과해야 합니다. 문서화된 테스트 계획을 통해 양식을 만든 사람뿐만 아니라 모든 팀 구성원이 양식을 검증할 수 있습니다.
사용자에게 영향을 미치는 양식 계산 오류는 다운스트림 시스템을 통해 파급되는 데이터 품질 문제를 야기합니다. 제출된 양식에 정확하게 합산되지 않은 합계는 회계 불일치가 됩니다. 검증을 통한 예방은 제출 후 수정하는 것보다 훨씬 저렴합니다.
대부분의 도구에서 양식 유효성 검사에 투자한 시간은 제출된 수백 개의 양식에서 잘못된 데이터를 수정하는 데 필요한 시간의 일부에 불과합니다. 배포 전 철저한 검증 통과는 문서 준비에 있어 가장 높은 수익을 내는 품질 보증 활동 중 하나입니다.
검증된 PDF 양식은 사용자의 신뢰를 높여줍니다. 사용자는 계산이 정확하고 일관되게 작동하는 것을 볼 때 양식을 신뢰하고 정확한 데이터를 제출합니다. 일단 확립된 신뢰는 양식을 게시한 조직으로 확장됩니다.