안녕하세요.
Python의 pywin32를 이용해 한글 오토메이션으로 제목차례를 자동 생성하는 프로그램을 개발하고 있습니다.
현재는 제목차례를 생성할 때마다 원본 HWP 문서를 다시 열고, 제목차례를 생성한 다음 한글 COM 인스턴스를 종료하고 있습니다.
제목차례에 사용할 스타일이 여러 개일 경우 같은 원본 문서를 반복해서 열게 됩니다. 대용량 문서에서는 이 과정에 시간이 오래 걸리고, COM 인스턴스의 반복 생성 및 종료 과정에서 오류도 발생합니다.
원본 문서를 한 번만 열어 둔 상태에서 여러 스타일의 제목차례를 연속 생성하고, 모든 작업이 끝난 뒤 한글을 한 번만 종료하는 방식으로 변경하고 싶습니다.
구체적으로 아래 사항을 문의드립니다.
1. 문의할 내용
1-1. 원본 문서를 한 번만 열고 반복 처리할 수 있는지
현재는 제목차례 하나를 생성할 때마다 다음 작업을 수행합니다.
-
HwpObjectCOM 인스턴스 생성 -
hwp.Open(source_path, "HWP", "forceopen:true")로 원본 문서 열기 -
MakeContents액션 생성 및 파라미터 설정 -
action.Execute(contents)로 제목차례 생성 -
hwp.Quit()으로 한글 종료
이를 다음과 같이 변경하고 싶습니다.
-
HwpObjectCOM 인스턴스 생성 -
원본 문서를 한 번만 열기
-
첫 번째 스타일의 제목차례 생성
-
두 번째 스타일의 제목차례 생성
-
세 번째 스타일의 제목차례 생성
-
나머지 스타일도 같은 방식으로 연속 생성
-
모든 작업이 끝난 뒤 한글 종료
이러한 방식이 한글 오토메이션에서 지원되는지 궁금합니다.
지원된다면 원본 문서를 다시 열지 않고 MakeContents 액션을 여러 번 실행할 때 주의해야 할 사항이 있는지 알고 싶습니다.
1-2. MakeContents 액션과 파라미터 셋을 재사용할 수 있는지
현재는 제목차례를 생성할 때마다 다음과 같이 액션과 파라미터 셋을 생성합니다.
-
CreateAction("MakeContents") -
CreateParameterSet() -
GetDefault() -
StyleName,Level,OutFileName등 설정 -
Execute()
여러 스타일을 연속 처리할 때 다음 중 어떤 방식이 권장되는지 궁금합니다.
-
A.
HwpObject만 재사용하고 매번 새로운MakeContents액션과 파라미터 셋을 생성하는 방식 -
B.
HwpObject와MakeContents액션을 재사용하고 파라미터 셋만 새로 생성하는 방식 -
C.
HwpObject, 액션, 파라미터 셋을 모두 재사용하면서 필요한 항목만 변경하는 방식
특히 액션을 생성한 후 실행하기 전에 다른 액션을 생성하면 문제가 발생할 수 있다는 안내를 보았습니다. 동일한 액션을 여러 번 실행하는 경우에도 별도의 주의사항이 있는지 궁금합니다.
1-3. 여러 스타일의 결과물을 각각 별도 파일로 저장할 수 있는지
각 스타일의 제목차례는 서로 다른 임시 HWP 파일로 저장하고 싶습니다.
예를 들어 원본 문서 2장.hwp에서 다음과 같은 결과물을 생성하려고 합니다.
-
toc_그림제목.hwp -
toc_표제목.hwp -
toc_사진제목.hwp
현재 코드에서는 MakeContents 파라미터의 OutFileName에 결과 파일 경로를 설정하고 있습니다.
동일한 원본 문서를 계속 열어 둔 상태에서 StyleName과 OutFileName을 변경해 Execute()를 반복 호출하는 방식이 가능한지 궁금합니다.
반복 실행 시 기존 제목차례가 덮어써지거나, 원본 문서의 상태 또는 출력 결과에 영향을 주는 문제는 없는지도 알고 싶습니다.
1-4. 한글을 종료하지 않고 연속 실행할 때의 권장 방식
실제로 제목차례 생성은 성공하지만, 작업 종료 시 hwp.Quit()에서 다음 COM 오류가 발생한 적이 있습니다.
pywintypes.com_error:
(-2147417851, '서버에서 예외 오류가 발생했습니다.', None, None)
HRESULT: 0x80010105
오류 위치: create_one_toc finally / hwp.Quit
MakeContents.Execute()는 True를 반환했고 결과 파일도 정상적으로 생성되었습니다.
이 오류가 반복적인 COM 인스턴스 생성 및 종료와 관련이 있을 가능성이 있는지 궁금합니다.
여러 제목차례를 생성하는 동안 한글을 계속 실행해 두고, 마지막에만 종료하는 방식이 권장되는지도 문의드립니다.
2. 현재 사용 중인 코드
2-1. 제목차례 하나를 생성하는 함수의 핵심 구조
현재 create_one_toc() 함수의 주요 처리 순서는 다음과 같습니다.
def create_one_toc(self, source_path, styles, output_path):
hwp = None
try:
pythoncom.CoInitialize()
# 매번 새로운 COM 인스턴스 생성
hwp = self.create_hwp_instance()
# 매번 원본 문서 열기
result = hwp.Open(
source_path,
"HWP",
"forceopen:true"
)
if result is False:
raise RuntimeError("원본 문서 열기 실패")
# MakeContents 액션 생성
action = hwp.CreateAction("MakeContents")
contents = action.CreateSet()
action.GetDefault(contents)
# 제목차례 설정
contents.SetItem("Make", 33)
contents.SetItem("Level", len(styles))
# 예: "그림제목(2005년)(2장);"
style_text = ";".join(
style_name for style_id, style_name in styles
) + ";"
contents.SetItem("StyleName", style_text)
contents.SetItem("Type", 1)
contents.SetItem("Position", 0)
contents.SetItem("AutoTabRight", 0)
contents.SetItem("OutFileName", output_path)
# 제목차례 생성
result = action.Execute(contents)
if not result:
raise RuntimeError("제목차례 생성 실패")
finally:
if hwp is not None:
hwp.Quit()
※ 실제 프로그램에는 COM 오류 기록, 중지 처리, 결과 파일 확인 등의 코드도 포함되어 있습니다. 위 코드는 현재 처리 구조를 설명하기 위한 핵심 부분입니다.
2-2. 선택 2에서 스타일별로 함수를 반복 호출하는 부분
현재는 각 스타일마다 create_one_toc()를 호출합니다.
for (
keyword_index,
keyword,
style_id,
style_name
) in matched_toc2:
toc_path = os.path.join(
temp_dir,
f"toc2_{keyword_index:04d}_{file_index:04d}.hwp"
)
self.create_one_toc(
source_path,
[(style_id, style_name)],
toc_path
)
이 구조에서는 스타일이 10개라면 create_one_toc()가 10번 호출되며, 함수 내부에서 원본 문서를 10번 열고 닫게 됩니다.
제가 원하는 것은 원본 문서는 한 번만 열고, 각 스타일에 대해 제목차례 생성 작업만 반복하는 구조입니다.
3. 추가 정보 및 요청 사항
-
개발 언어: Python
-
COM 라이브러리:
pywin32 -
사용 객체:
HWPFrame.HwpObject -
실행 환경: Windows
-
입력 파일: HWP 문서
-
제목차례 생성 액션:
MakeContents -
제목차례 실행:
action.Execute(contents) -
주요 설정값:
Make=33,Level,StyleName,Type=1,Position=0,AutoTabRight=0,OutFileName -
출력 방식: 스타일별 제목차례를 별도 HWP 파일로 저장한 뒤, 후속 단계에서 최종 문서에 합침
-
문서 크기: 약 413MB인 대용량 HWP 파일도 처리 대상에 포함됨
가능하다면 다음 내용을 포함한 Python 예제 코드를 부탁드립니다.
-
한글 COM 인스턴스를 한 번 생성하고 원본 문서를 한 번만 여는 코드
-
여러 스타일을 순회하면서 각각 다른
OutFileName으로 제목차례를 생성하는 코드 -
반복 실행 시
MakeContents액션 및 파라미터 셋을 생성·재사용하는 올바른 방식 -
모든 작업이 끝난 뒤 한글을 안전하게 종료하는 코드
-
원본 문서를 다시 열거나 별도 COM 인스턴스를 생성해야 하는 예외적인 경우가 있다면 그 조건
감사합니다.