🐍 엑셀 데이터를 자동으로 한글(HWP) 문서에 입력하는 파이썬 코드! | 업무자동화 꿀팁

업무에서 반복적으로 엑셀 데이터를 한글 문서에 입력해야 하는 상황, 다들 한 번쯤 겪어보셨을 겁니다. 특히 참석자 명단, 일정표, 행사계획서 등을 만들 때 매번 복사-붙여넣기를 반복한다면 시간도 오래 걸리고, 실수도 발생하기 쉽죠.

이번 글에서는 엑셀(.xlsx) 파일에서 데이터를 읽어와 한글(.hwp) 문서의 텍스트 필드에 자동으로 입력하는 파이썬 코드를 소개합니다. 이 자동화 작업을 통해 업무 효율을 극대화하고, 반복 업무에 들이는 시간을 획기적으로 줄일 수 있습니다.

✅ 사용하는 모듈

이 자동화 스크립트는 다음과 같은 파이썬 모듈을 사용합니다.

pandas: 엑셀 파일(.xlsx) 데이터를 불러오고, 행과 열을 쉽게 처리할 수 있는 데이터 분석용 라이브러리입니다.
pyhwpx: HWP 문서에 접근하고, 텍스트 필드에 자동으로 값을 입력할 수 있도록 도와주는 모듈입니다. HWP 프로그램이 백그라운드에서 실행되어야 하며, 설치가 되어 있어야 정상 작동합니다.

📂 1. 엑셀 데이터 준비하기

먼저, 한글 문서에 삽입할 정보를 담은 엑셀 파일을 준비합니다. 예시는 아래와 같이 4개의 열을 포함하고 있어요.

일시	장소	참석인원	연락처
2025-04-01	시청 대회의실	30명	010-1234-5678

이 파일의 경로는 C:\Users\user\Desktop\test\xls_hwp.xlsx 라고 가정하겠습니다.

엑셀 데이터에서 이름(칼럼, column) 정의를 통해 해당 이름 영역(셀 영역)의 데이터를 참조할수 있다.

셀 영역을 범위로 잡고 [수식] → [이름 정의] (또는 단축키 Ctrl +F3를 통해 이름관리자를 실행) 눌러서 이름을 정의한다.

🧑‍💻 2. 파이썬 코드로 자동 입력하기

이제 아래와 같은 파이썬 코드를 작성해보세요.

import pandas as pd
from pyhwpx import Hwp

# 1. 엑셀 데이터 불러오기
file = "C:\\Users\\user\\Desktop\\test\\xls_hwp.xlsx"
df = pd.read_excel(file)  # columns: 일시, 장소, 참석인원, 연락처

# 엑셀에서 첫 번째 행 데이터 추출
date = df.loc[0, '일시']
location = df.loc[0, '장소']
participant = df.loc[0, '참석인원']
number = df.loc[0, '연락처']

# 2. 한글 실행 및 문서 열기
hwp = Hwp()
hwp.open("c:\\Users\\USER\\Desktop\\test\\xls_hw.hwp")  # 미리 필드 설정된 한글 파일

# 3. 필드에 값 입력
hwp.put_field_text("일시", date)
hwp.put_field_text("장소", location)
hwp.put_field_text("참석인원", participant)
hwp.put_field_text("연락처", number)

📝 한글 문서 설정 방법

put_field_text("필드이름", 값) 메서드는 한글 문서에 설정된 텍스트 필드에 값을 입력하는 방식입니다.
따라서 미리 한글 문서에서 아래와 같이 "필드 삽입"을 해두셔야 합니다.

한글 프로그램에서 문서를 열고,
입력 > 개체 > 필드입력(Ctrl+K, E)를 선택해 "일시", "장소", "참석인원", "연락처" 필드를 만들어주세요.
저장 후 위 파이썬 코드에서 해당 문서를 열어 자동입력하면 됩니다.

∴ 표 안에 데이터를 넣는 경우에는

[표/셀 속성] > [셀 탭] > [필드 이름] 에 해당되는 필드값을 넣어도 된다.

단 필드값은 엑셀에서 정의된 이름 내용과 동일해야 함.!!

📌 관련 포스팅 보기

👉 HWP 텍스트 입력과 필드 채우기 방법 (한글 자동화 실전편)

💡 실행화면

엑셀파일에서 이름 정의하고 한글 문서에서도 필드를 지정하면, 한글 문서에 필드에 맞게 엑셀 데이터 값이 들어간다

🚀 자동화로 얻는 효율

이 자동화 스크립트를 활용하면 다음과 같은 업무에 큰 도움이 됩니다:

정기 회의 참석자 정보 자동입력
행사 운영 계획서 자동 완성
대량의 명단 정보를 빠르게 입력

특히 매주 반복되는 보고서나 회의록 작성을 자동화하면 연간 수십 시간의 업무 시간을 절약할 수 있습니다.

📌 마무리

해당 자동화는 엑셀 형식만 맞춰주면 누구나 쉽게 활용 가능합니다.
추가로 여러 행을 반복적으로 한글 문서에 입력해야 할 경우, for 반복문으로 확장할 수도 있죠.

이제 반복되는 입력 작업에서 벗어나세요. 자동화는 한 번 익히면, 매번 효율을 가져다줍니다!
궁금한 점이 있다면 댓글로 남겨주세요. 😊