본문 바로가기
아래아한글 자동화/python+hwp 중급

[python+hwp] 생각보다 hwp 업무자동화가 어렵다면...

by 일코 2023. 2. 1.
반응형

한컴오피스 업무자동화 튜토리얼을
블로그와 유튜브에 몇 년간 작성해 오면서
받았던 모든 피드백 중에

"감사하다"는 의견을 제외하면
"너무 어렵다"는 말씀이 가장 많습니다.

저도 이게 큰 고민거리인데요..
제 설명이 미흡한 탓이라는 생각이 드니까
반성도 많이 하게 되고요.

제 기준에서 '의외로 쉽고, 이해하면 간단하기도 하다.'는 막연한 느낌은
아마 제가 입문자들의 레벨을 벌써 잊어버렸기 때문일 것입니다.

 

아마도 제가 "한/글 업무자동화"를 쉽다고 생각하는 첫 번째 이유는,
당장 방법이 생각나지 않거나, 막히더라도
어떤 과정으로 해답을 찾아가야 하는지 알기 때문인 것 같습니다.

 

그래서 이번 포스팅에서는

일반적으로 활용할 수 있는 한/글 업무자동화 코드작성 과정
의식의 흐름대로 한 번 쭉 써내려가 보려고 합니다.

1. 저는 대부분의 경우 가장 먼저 HwpCtrl API 문서를 열어봅니다.

HwpCtrl API.hwp 파일은 대부분
"손으로는 실행할 수 없는" 명령어를 설명하고 있습니다.
예를 들면 특정 위치로 커서를 옮긴다든지, 컨트롤을 순회한다든지
특정 문자열을 파이썬으로 가져온다든지 하는..
일반인에겐 조금 생소한 명령어들 말이죠.

우리가 아무리 아래아한글 고수라고 하더라도
HwpCtrl API.hwp 에서 어떤 기능을 제공하는지
그 내용을 짐작조차 할 수 없거든요.
어떤 기능이 있고 없는지 알 수 없으니
업무자동화가 막연하게 느껴지는 게 당연할 것 같습니다.

그래서 제가 드리는 첫 번째 조언은
HwpCtrl API.hwp 파일을 꼭 한 번은 일독해 주시기를 바랍니다.
전부 외우거나 방법까지 읽을 필요도 없고
그냥 "어떤 기능을 제공하고 있구나" 하는 정도만 훑어보면 됩니다.

그런데 여기서 기능들만 가지고서는
일련의 업무를 자동화하기에는 부족할 때가 대부분입니다.
가장 핵심이 되는 기능들임에는 분명하지만
디테일한 작업들이 빠져 있거든요.
예를 들면,
복사붙여넣기, 줄바꿈 넣기라든지,
아니면 특정 문자열을 선택하고 삭제하거나 
표 맨 아래에 열을 추가하는 등의 작업 말이죠.
그래서 큰 틀을 HwpCtrl API로 잡고 나면
곧바로 2번 과정으로 넘어갑니다.

 

2. 디테일은 Action Table 문서를 참고해서 채웁니다.

서식변경이나 소소한 수정, 삭제 등은
Action Table을 참고하면 거의 모두 해결됩니다.
그리고 Action Table의 명령어 중
추가로 파라미터를 삽입하지 않아도 되는 한줄 명령어,
즉, Run 액션들은 제 블로그에도 정리해 두었습니다.

hwp의 한줄 명령어(Run액션) 전체목록 및 실행화면 (tistory.com)

 

hwp의 한줄 명령어(Run액션) 전체목록 및 실행화면

국내 유일의 파이썬+한컴오피스 업무자동화 입문강의 움짤로 빠르게 배우는 파이썬-아래아한글 자동화 레시피 - 인프런 | 강의 파이썬으로 아래아한글을 다루는 짧은 예제코드들을 소개하고,

martinii.fun

Action Table까지 읽어봤는데도
해결방안이 보이지 않으면

그냥 저한테 문의메일(martinii.fun@지메일.com)을 보내주시는 게
가장 좋은 방법이라고 생각합니다.
왜냐면 99% 삽질을 하시게 될 거거든요.
그럼에도 스스로 해결방법을 찾겠다고 하신다면..

그럼 세 번째 과정으로 넘어갑니다.

 

3. 이제 스크립트매크로 녹화를 해봅니다.

파라미터셋을 찾아가며 삽질하는 수고를 덜 수 있는
가장 좋은 방법은 역시 스크립트매크로 녹화입니다.
스크립트매크로 녹화를 통해 코드를 알아내셨다면,
파이썬 문법에 맞게 변환해주는 과정이 필요합니다.
아래 포스팅을 참고해주시기 바랍니다.

4. 문서여백을 파이썬으로 바꿀 수 있을까? (tistory.com)

 

4. 문서여백을 파이썬으로 바꿀 수 있을까?

안녕하세요? 한/글 자동화 응용편에 보시면, 한/글에서 녹화한 스크립트 매크로와 API매뉴얼의 기본적인 액션 생성 방법 두 가지 문법을 보여드렸습니다. [파이썬-아래아한글] API매뉴얼과 스크립

martinii.fun

이제 1~3번 과정에서 알아낸 명령어를 조합해서
업무자동화 프로그램을 조립하시면 됩니다.

다시 한 번 말씀드리지만,
여기까지 읽어봤는데도 해결되지 않는 작업이라면
고민하지 마시고 저한테 문의메일을 보내주세요.

이 과정 이후에도 빈 칸이 남아 있거나,
보다 고급의 업무자동화 프로그램을 만드시는 거라면
아마 대부분 파이썬 문법과 모듈로 해결해야 하는 부분일 것 같습니다.

참고로 제 블로그에도
300여개 이상의
한/글 업무자동화 포스팅이 쌓여 있는데요.


글이 많아지다 보니 관련 포스팅을 찾기가 어려워졌습니다.
관련포스팅을 찾는 두 가지 팁을 알려드리고 마치겠습니다.

검색버튼을 활용하기

제 블로그에 들어오시면 상단 우측에 돋보기 버튼이 있습니다.
여길 클릭하셔서 특정 주제를 입력하시면
관련 포스팅이 필터링되어 나타납니다.

 

태그를 통해 필터링하기

블로그 우측 사이드바의 태그나, 상단의 태그메뉴를 선택해서
관련 태그를 클릭한 후 포스팅을 찾으면 수월합니다.

이 포스팅이 여러분께 도움이 되었기를 바랍니다.

 

마치며

1. pyhwpx 관련 무료이북을 공개하고 있습니다.

https://wikidocs.net/book/8956

 

pyhwpx Cookbook : hwp 행정업무 자동화

pyhwpx 공식문서 : [https://martiniifun.github.io/pyhwpx/api](https://martiniifun.github.io/pyhwpx/api.h…

wikidocs.net

 

2. pyhwpx 관련 기능 설명을 모아둔 API문서입니다. (보완중)

https://martiniifun.github.io/pyhwpx/

 

pyhwpx

pyhwpx Python으로 만든 HWP 원격조작 및 자동화를 위한 모듈입니다. 2025년 4월 27일 2025년 3월 26일 ilco GitHub

martiniifun.github.io

 

3. 몇 개 플랫폼에 동영상 강의를 공개해 두었습니다.

 

① 인프런 강의

pyhwpx를 공개하기 전의 한글오토메이션API 강의입니다. 파이썬 문법에 아주 익숙하신 분들께는 추천합니다.

https://inf.run/ChCF

 

움짤로 빠르게 배우는 파이썬-아래아한글 자동화 레시피 - 인프런 | 강의

파이썬으로 아래아한글을 다루는 짧은 예제코드들을 소개하고, 중간중간의 결과를 GIF로 보여드립니다. 동영상 강의가 아니지만 오히려 빠르게 배울 수 있고, 따라하기도 쉽습니다., - 강의 소개

www.inflearn.com

 

② 구름에듀 강의

pyhwpx를 막 공개했을 때의 40시간 분량의 업무자동화 강의입니다. 대부분 아래아한글과 엑셀을 다룹니다.

https://edu.goorm.io/lecture/43213/기초부터-차근차근-배우는-파이썬-업무-자동화

 

기초부터 차근차근 배우는 파이썬 업무 자동화 - 구름EDU

파이썬으로 엑셀, 아래아한글 프로그램 등을 원격으로 다루고, 내 업무 프로세스를 자동화해봅니다.

edu.goorm.io

 

③ 클래스101 강의

클래스101을 구독하시는 분들은 가볍게 들어보실 수 있는 6강 10시간 분량의 pyhwpx 단축강의입니다.
핵심을 잡기에 좋습니다.

https://101.gg/3G3IF6Z

 

CLASS101+ | 세상의 모든 클래스를 하나의 구독으로

5300개 이상의 클래스로 일러스트, 공예, 코딩, 부업, 주식까지 세상의 모든 분야를 배워보세요.

class101.net

 

 

 

그럼 아래아한글 업무자동화로
일과 중에 여러분만의 시간을 충분히 지켜내시길 기원하겠습니다.

행복한 하루 되세요!

 

반응형

댓글