'PyMuPDF Pro'를 활용한 PDF 양식 자동 작성 및 flatten 처리 자동화: 코드 샘플 포함

플래튼(Flatten, 평면화) 왜 중요한가요?

세금 신고서, 계약서, 인사 서류처럼 각종 양식을 자주 다루는 업무를 하다 보면, 반복적인 수작업 입력이 얼마나 번거로운지 잘 아실 겁니다.
이런 작업을 자동화하면 시간을 절약할 수 있고, 입력 오류를 줄이며, 문서 전반에 걸쳐 일관성을 유지할 수 있습니다.

하지만 양식을 한 번 작성한 뒤에도 계속 수정 가능하게 두는 것이 과연 바람직할까요?
많은 업무 흐름에서는 실수로 인한 편집을 방지하고, 데이터 무결성을 유지하며, 서명된 문서를 안전하게 보호하기 위해 양식 필드를 잠그는 작업이 필요합니다.
이때 사용하는 방식이 바로 **플래튼(Flattening, 평면화)**입니다.

PyMuPDF Pro는 PDF 양식을 자동으로 작성하고, 사용 목적에 따라 다양한 방식으로 플래튼 처리를 할 수 있도록 지원합니다.
어떤 방법은 데이터 추출을 위한 메타데이터를 유지하고, 어떤 방법은 줌 배율에 상관없이 문서의 안정적인 표시를 보장합니다.
이 글에서는 그 다양한 방식들을 함께 살펴보겠습니다.

---

왜 PDF 양식 자동화가 필요한가요?

PDF 양식은 다양한 산업과 분야에서 널리 사용되고 있으며, 자동화를 통해 복잡한 프로세스를 간단하게 만들 수 있습니다.
대표적인 활용 사례는 다음과 같습니다:

✅ 업무 자동화 – 정형화된 데이터를 기반으로 대량 문서를 빠르게 채워 넣을 수 있습니다
✅ 전자 서명 및 규정 준수 – 서명 후 문서가 임의로 수정되지 않도록 보호할 수 있습니다
✅ 정부 및 세무 양식 – 표준화된 방식으로 양식을 작성하면서, 필요 시 데이터를 쉽게 내보낼 수 있습니다

양식이 작성된 이후에는 보통 더 이상 사용자가 수정할 필요가 없기 때문에, 다양한 플래튼 기법을 활용해 접근성은 유지하면서도, 데이터는 안정적으로 보존할 수 있도록 해야 합니다.

---

PyMuPDF Pro가 제공하는 기능

PyMuPDF Pro는 PDF 양식을 자동으로 작성하고, 다양한 플래튼 처리 방법을 제공합니다:

✅ 필드를 읽기 전용으로 설정

• 사용자가 편집할 수는 없지만, 프로그래밍 방식으로 필드 데이터를 추출할 수 있습니다 (예: CSV 내보내기)
• 기록 보관이 중요한 업무에 적합한 방식입니다

✅ bake() 함수로 필드 데이터를 페이지 콘텐츠에 포함

• 양식 필드를 고정된 텍스트로 변환하면서도 검색은 그대로 가능
• 확대해도 깨지지 않는 정밀한 표시와 레이아웃 안정성 확보에 유리합니다

✅ PDF를 이미지로 렌더링

• 문서 상호작용을 완전히 차단하고 내용을 고정
• ❌ 다만 이 경우 텍스트 검색 및 추출이 불가능해집니다

각 방식은 목적에 따라 선택해야 합니다.
어떤 방식은 데이터 접근성과 보존에 중점을 두고, 어떤 방식은 문서 안정성과 보안을 우선시합니다.

---

구현 예시: CSV 파일을 이용한 PDF 작성 및 플래튼 처리

• 1단계: CSV 파일 준비

CSV 파일을 사용하면 필드 이름과 값을 구조적으로 관리할 수 있어, 자동화에 매우 유리합니다.

- 예시 form_data.csv:

field_name,value Name,John Doe Date,01/06/2025 Address,123 Elm Street Consent,Yes Choice,Option A

 

• 2단계: PDF 처리 자동화

이 스크립트는 모든 페이지를 순차적으로 탐색하며, CSV 데이터로 양식 필드를 채운 뒤, 적절한 방식으로 **플래튼 처리(평면화)**를 적용합니다.

import pymupdf 
import csv
 
# Load the PDF
doc = pymupdf.open("fillable_form.pdf")
 
# Read data from CSV into a Python dictionary
data = {}
with open("form_data.csv", newline='', encoding='utf-8') as csvfile:
    reader = csv.DictReader(csvfile)
    for row in reader:
        data[row["field_name"]] = row["value"]
 
# Iterate over all pages and process fields
for page in doc:  
    for field in page.widgets():  
        if field.field_name in data:
            value = data[field.field_name]
            
            # Handling checkboxes
            if field.field_type == pymupdf. PDF_WIDGET_TYPE_CHECKBOX:
                if value == field.on_state():
                    field.field_value = value
                else:
                    field.field_value = False 
  
            # Handling radio buttons
            elif field.field_type == pymupdf. PDF_WIDGET_TYPE_RADIOBUTTON:
                if value == field.on_state():
                    field.field_value = value  
            
            # Handling other fields types
            else:
                field.field_value = value  
 
# Choose the appropriate flattening method:
 
# Option 1: Set fields to read-only
for page in doc:
    for field in page.widgets():
        field.flags |= pymupdf. PDF_FIELD_IS_READ_ONLY  
 
# Option 2: Flatten using bake(): convert fields to searchable text
doc.bake()
 
# Save the modified PDF
doc.save("flattened_form.pdf")
 
# Option 3: Flatten by converting all pages to images
 
# Open a new empty PDF to receive the page images
imaged = pymupdf.open()
 
# Render each page into an image 
for page in doc:  
    width, height = page.rect.br
 
    # Make output page with same size
    img_page = imaged.new_page(width=width, height=height)
 
    # Render input page with desired resolution
    pix = page.get_pixmap(dpi=300)
 
    # Insert image into output page
    img_page.insert_image(page.rect, pixmap=pix)
 
# Save imaged PDF making sure to compress the images
imaged.save("imaged_form.pdf", deflate=True) 

 

적절한 플래튼 방식 선택하기

그렇다면 어떤 방식을 선택해야 할까요?

✔ 나중에 필드 데이터를 추출할 계획이 있다면?
→ 필드를 **읽기 전용(read-only)**으로 설정해 접근 가능하도록 유지하세요.

✔ 인터랙티브 요소는 제거하되, 확대해도 레이아웃이 깨지지 않길 원한다면?
→ bake() 함수를 사용해 필드를 페이지에 삽입하면서 검색 가능하게 유지하세요.

✔ 프로그래밍 방식의 수정조차 완전히 막고 싶다면?
→ 문서를 정적인 이미지로 변환하세요. 이 경우 검색 및 텍스트 추출도 불가능해집니다.

---

결론

PyMuPDF Pro를 활용하면 PDF 양식 작성과 플래튼 작업을 빠르고 효율적이며 유연하게 자동화할 수 있습니다.
이 도구를 통해 다음과 같은 작업이 가능합니다:

✅ CSV 파일을 이용해 양식을 동적으로 채우기
✅ 접근성, 보안, 정밀도에 맞는 플래튼 방식 선택
✅ bake()를 활용해 검색 가능성과 문서 안정성 유지

계약서 보안, 세무 문서 처리, 인사 양식 자동화 등 어떤 목적이든,
이 접근 방식은 문서 관리 효율을 높이는 동시에 데이터 접근성과 보존 방식에 대한 제어력을 유지해 줍니다.

---

직접 해보고 싶으신가요?
여러분만의 PDF와 CSV 파일을 준비해 바로 자동화를 시작해보세요!