검증 목적
문서 변환 검증의 목적은 원본과 결과 파일이 모든 환경에서 완전히 같은 모양으로 보인다고 선언하는 데 있지 않습니다. 본문, 표, 그림, 구역의 구조적 누락을 줄이고, 변경 사항이 기존 문서의 변환 결과를 다시 훼손하지 않는지 확인하는 데 목적이 있습니다.
한글과 워드는 문서 배치 기준이 서로 다르므로 페이지 수와 줄바꿈의 완전한 일치보다 내용과 구조의 보존, 편집 가능성, 주요 레이아웃 정보의 반영 여부를 우선합니다.
검증 단계
| 단계 | 검증 대상 | 주요 항목 |
|---|---|---|
| 1단계 | 입력 파일 | 정상 열림, 형식 판별, 암호·손상 여부 |
| 2단계 | 결과 파일 | 파일 생성, 정상 열림, 문서 오류 여부 |
| 3단계 | 문서 구조 | 구역, 문단, 표, 그림, 머리말·꼬리말 |
| 4단계 | 주요 서식 | 글꼴, 문단, 셀, 테두리, 용지 설정 |
| 5단계 | 화면 표시 | 줄바꿈, 페이지 수, 표 높이, 그림 위치 |
| 6단계 | 회귀 테스트 | 기존 통과 항목의 재발 여부 |
1. 입력 파일 상태 확인
검증에 앞서 원본 파일이 한글 또는 신뢰할 수 있는 열람 프로그램에서 정상적으로 열리는지 확인합니다. 손상된 파일, 암호 설정 문서, 배포용 문서는 일반 문서와 판독 조건이 다를 수 있습니다.
확장자와 실제 저장 형식이 맞는지도 확인합니다. 파일명만 .hwp 또는 .hwpx로 바꾼 문서는 형식 판별 단계에서 별도 확인이 필요합니다.
확인 항목
- HWP·HWPX 형식 판별
- 첫 페이지부터 마지막 페이지까지의 정상 열림
- 암호 및 열람 제한 여부
- 파일 손상 여부
- 확장자와 내부 형식의 일치 여부
2. 결과 파일 생성 및 정상 열림
변환 완료 표시는 결과 파일이 실제로 생성되고 워드에서 정상적으로 열릴 때 의미가 있습니다. 파일 크기가 0이거나 문서 복구 안내가 나타나는 경우에는 변환 성공으로 보지 않습니다.
결과 파일의 첫 페이지와 마지막 페이지, 마지막 문단과 마지막 표를 확인하여 큰 범위의 누락 여부를 함께 점검합니다.
3. 문서 구조 검사
문서 구조 검사는 글자 수만 비교하지 않습니다. 문단, 표, 그림, 구역의 개수와 순서, 각 요소의 연결 관계를 확인합니다.
표 안의 글자는 일반 본문과 분리하여 확인하고, 병합 셀과 표 안의 표는 별도 항목으로 검사합니다. 그림도 파일의 존재 여부뿐 아니라 문서 안의 레이아웃 순서를 함께 확인합니다.
주요 구조 항목
- 구역의 개수와 순서
- 본문 문단의 순서
- 표의 행·열 및 병합 관계
- 표 안의 표
- 그림의 개수와 문서 내 순서
- 머리말·꼬리말
- 각주 및 페이지 나눔
4. 주요 서식 비교
구조가 남아 있어도 주요 서식이 빠지면 편집용 문서의 가치가 낮아집니다. 따라서 문단과 표의 핵심 속성을 항목별로 비교합니다.
용지와 구역
- 용지 크기와 세로·가로 방향
- 상·하·좌·우 여백
- 머리말·꼬리말 위치
- 페이지 번호의 위치와 시작 번호
- 수동 페이지 나눔
문단과 글자
- 문단 정렬
- 왼쪽·오른쪽 여백
- 첫 줄 들여쓰기와 내어쓰기
- 줄 간격과 문단 전후 간격
- 글꼴 이름과 글자 크기
- 굵기, 글자색, 밑줄
표와 셀
- 가로·세로 병합 셀
- 열 너비와 행 높이
- 셀 안쪽 여백
- 가로·세로 정렬
- 바탕색
- 실선·점선·이중선·테두리 없음
그림
- 그림의 존재 여부
- 원본 비율과 표시 크기
- 문서 내 레이아웃 순서
- 표 안 그림의 연결 위치
5. 화면 표시 확인
구조와 속성값이 맞아도 한글과 워드의 문서 배치 차이로 화면 결과는 달라질 수 있습니다. 줄바꿈, 페이지 수, 표 높이, 그림 위치는 실제 프로그램에서 별도로 확인합니다.
화면 비교에서는 모든 페이지를 같은 중요도로 보지 않습니다. 표지, 가로 용지 구역, 대형 표, 병합 셀, 글상자, 마지막 페이지처럼 변형 가능성이 큰 부분을 우선 확인합니다.
화면 확인 항목
- 첫 페이지와 마지막 페이지
- 처음 줄바꿈이 달라지는 문단
- 여러 페이지에 걸친 표
- 구역 전환 전후의 용지 방향
- 고정 레이아웃 그림과 글상자
- 페이지 번호와 목차
- 빈 페이지 발생 여부
6. 회귀 테스트
변환 기능을 수정할 때에는 새 문제가 해결되었는지만 확인하지 않습니다. 이전에 정상 처리되던 문서가 다시 달라지지 않았는지 같은 테스트 문서로 반복 확인합니다.
실패 사례는 재현 가능한 최소 문서로 정리하고, 수정 후 기존 테스트 문서와 함께 다시 변환합니다. 같은 원인의 재발 여부를 지속적으로 확인하기 위한 절차입니다.
회귀 테스트의 기본 순서
- 변형 사례의 위치와 조건을 기록합니다.
- 개인 정보와 불필요한 내용을 제거한 재현 문서를 만듭니다.
- 기대 결과와 실제 결과를 구분하여 기록합니다.
- 변환 기능을 수정합니다.
- 해당 문서와 기존 테스트 문서를 다시 변환합니다.
- 새 변형과 기존 항목의 재발 여부를 확인합니다.
테스트 문서의 구성
테스트 문서는 단순 문서와 복합 문서를 함께 사용합니다. 한 가지 대형 문서만으로는 어느 속성에서 문제가 발생했는지 구분하기 어렵기 때문입니다.
단일 항목 테스트 문서
- 용지 크기와 여백만 다른 문서
- 문단 정렬과 들여쓰기 문서
- 글꼴·굵기·색상 문서
- 병합 셀과 테두리 문서
- 그림 크기와 레이아웃 문서
- 페이지 번호와 페이지 나눔 문서
복합 테스트 문서
- 여러 구역과 용지 방향이 섞인 문서
- 표 안의 표와 그림이 포함된 문서
- 여러 페이지에 걸친 대형 표 문서
- 머리말·꼬리말·페이지 번호가 함께 있는 문서
- 실제 작성 환경에서 수집한 익명화 문서
결과 구분
검증 결과는 단순한 성공·실패만으로 나누기보다 영향 범위에 따라 구분합니다.
| 구분 | 기준 |
|---|---|
| 정상 | 내용과 주요 구조가 보존되고 편집에 지장이 없음 |
| 경미한 차이 | 줄바꿈, 간격, 페이지 수 등 문서 배치 차이가 있으나 내용과 구조는 보존됨 |
| 확인 필요 | 일부 표·그림·기호의 변형으로 수동 확인이 필요함 |
| 처리 제한 | 암호, 손상, 배포 제한 또는 미지원 개체로 정상 변환이 어려움 |
검증 결과의 한계
정해진 테스트 문서의 통과는 모든 실제 문서에서 같은 결과를 보장한다는 뜻이 아닙니다. 문서 작성 방식, 사용 글꼴, 한글과 워드의 판본, 운영체제에 따라 표시 결과가 달라질 수 있습니다.
특히 글상자, 복합 도형, 수식, 전용 글꼴, 외부 연결 개체가 많은 문서는 변환 후 별도 확인이 필요합니다. 최종 제출본은 원본과 결과 파일을 직접 대조해야 합니다.
오류 제보 시 필요한 정보
변환 결과의 개선을 위해서는 문서 전체보다 재현 조건이 중요합니다. 가능한 경우 아래 정보를 함께 기록합니다.
- 원본 형식과 한글 판본
- 결과를 연 워드 판본과 운영체제
- 문제가 나타난 페이지와 항목
- 원본 상태와 변환 상태의 차이
- 사용 글꼴
- 오류 안내 문구
- 개인 정보를 제거한 재현용 문서
원본 문서에 개인정보나 업무상 비공개 내용이 포함되어 있다면 그대로 공유하지 않고, 문제가 발생하는 구조만 남긴 별도 문서를 사용하는 편이 안전합니다.