다양한 유형의 파일을 원하는 형식으로 변환하는 솔루션입니다. 신속하고 편리하게 높은 품질의 문서 변환 서비스를 만들어 보세요.

개발 가이드

개요

한컴 통합문서뷰어

한컴 통합문서뷰어의 API를 직접 호출하여 결과를 확인해 보세요.

한컴 통합문서뷰어 예제

개발자와 의견을 나누고 문제를 해결하거나 제품을 구매하여 활용해 보세요!

한컴 로그인은 한글과컴퓨터 서비스에서 제공하는 OAuth2.0 기반의 간편 로그인 기능입니다.

한컴 계정

한컴싸인에서 제공하는 Webhook/API 사용 방법에 대한 가이드입니다. Webhook/API를 통해 한컴싸인을 쉽고 빠르게 연동하여 사용할 수 있습니다.

한컴싸인

OLE Automation을 통해 한글 프로그램을 자동화하는 방법에 대한 가이드입니다. 외부 클라이언트에서 OLE(COM) Object를 이용하여 한글 기능을 실행하거나 문서를 제어할 수 있습니다.

한글 오토메이션

## **1. 서버 구성**
### Description 

웹한글 기안기는 서버 기반의 제품으로 **다양한 서버 환경을 제공**하므로 기존 시스템 또는 관련 시스템과 쉽게 연동할 수 있습니다.
데스크톱용 한글과 복사/붙이기 호환성을 최대한 보장하기 위해 클라이언트에서는 최신 업데이트(2018년 7월 이후)가 적용된 2018 버전 이상의 한글 프로그램을 사용할 것을 권장합니다. 
클라이언트에 한글이 설치되어 있지 않더라도 웹한글 기안기 사용하는 데 문제가 없습니다.

### 서버 구성

웹한글 기안기는 다양한 사용자 환경에서 빠른 작동을 위해 가볍고, 단순화된 구조를 갖추고 있습니다. 특히, Non DB 방식으로 웹서버를 구성하고, DB는 요구 사항에 맞게 사용자 지정할 수 있습니다. 또한, 필터 서버를 통해 원활한 문서 변환을 지원하고 외부 서버와 통신이 가능한 구조를 제공합니다.

| 구분 | 내용 | 
| --- | --- |
| 필터 서버 | · 문서 열기, 저장을 위한 문서 변환 필터 · 외부 서버와 통신 가능한 구조 |
| 웹한글 기안기 서버 | · 웹한글 기안기 클라이언트 서비스 관리 |
| 스토리지(별도) | · 문서 저장 공간 | 



![Alt 스크립트 실행 후{{w:700px, h:370px}}](/images/webhwp/webhwp_server_diagram.png)


### 권장사항


| 구분 | 내용 | 
| -- | -- |
| 서버 구성 | · 웹 서버 1식, 필터 서버 1식(문서 변환용) |
| 웹 서버 | · 지원 운영 체제: Linux 계열(Cent OS 최신 버전에 최적화) &nbsp;&nbsp;&nbsp;&nbsp;* 타 운영 체제 지원 필요 시 별도 검토 필요 |
| 필터 서버 | · RHEL 7.2 / CentOS 7.2 이상 지원 |
| 설치 필요 프로그램/리소스 | · 웹 서버: Tomcat 7 버전 이상 · Java: 1.7 버전 이상 · 웹한글 기안기 모듈 | 

&nbsp;&nbsp;\* 한컴오피스 2018 이상 사용 시 최적의 호환성 지원



## **2. 구조**

### Description
기존 한글 컨트롤(ActiveX 기반) 대비 구조 변화

### 구조 비교
| 웹한글 기안기 | 한글 컨트롤(ActiveX) | 
| -- | -- |
| 1) IFrame 외부(JavaScript) &nbsp;&nbsp;&nbsp;&nbsp;- WebHwpCtrl API | 1) 인터페이스 &nbsp;&nbsp;&nbsp;&nbsp;- HwpCtrl &nbsp;&nbsp;&nbsp;&nbsp;- HwpAction &nbsp;&nbsp;&nbsp;&nbsp;- HwpParameterSet &nbsp;&nbsp;&nbsp;&nbsp;- HwpParameterArray &nbsp;&nbsp;&nbsp;&nbsp;- HwpCtrlCode &nbsp;&nbsp;&nbsp;&nbsp;- HwpMenu |
| 2) IFrame 내부(require js 기반 모듈화) &nbsp;&nbsp;&nbsp;&nbsp;- HwpCtrl Impl &nbsp;&nbsp;&nbsp;&nbsp;- HwpCtrl Object (HwpAction, HwpParameterSet, HwpCtrlCode...) &nbsp;&nbsp;&nbsp;&nbsp;- 웹한글 엔진 &nbsp;&nbsp;&nbsp;&nbsp;- uiFramework | 2) 구현부 &nbsp;&nbsp;&nbsp;&nbsp;- CHwpCtrlCtrl &nbsp;&nbsp;&nbsp;&nbsp;- CDHwpAction &nbsp;&nbsp;&nbsp;&nbsp;- CDHwpParameterSet &nbsp;&nbsp;&nbsp;&nbsp;- CDHwpParameterArray &nbsp;&nbsp;&nbsp;&nbsp;- CDHwpMenu |



## **3. 호출 구조**

### Description
&nbsp;&nbsp;기존 한글 컨트롤(ActiveX 기반) 대비 구조 변화

### 호출 구조 - 웹한글 기안기
```js
1) 외부에서 함수 호출
 var testAction = HwpCtrl.CreateAction("CharShape");
 //구현부 함수 호출
 HwpCtrl.protetype.CreateAction = function(aidStr) { 
 return this.impl.CreateAction(aidStr);
 }

2) API 실행
 HwpCtrlImpl.CreateAction = function(aidStr) { 
 return new HwpAction(aidStr);
 };

Action 객체

1) 외부에서 함수 호출(API 실행)
 testAction.Run();
 HwpAction.prototype.Run = function() { 
 ..... 
 };
```

### ※ 호출 구조 비교 – 한글 컨트롤(ActiveX)
```js
1) 외부 인터페이스를 통해 호출
 var testAction = HwpCtrl.CreateAction("CharShape");

2) 래퍼 클래스를 통해서 호출된 인터페이스의 ID로 Dispatch 메시지 발생
 LPDISPATCH CreateAction(long bShow) {
 .....
 InvokeHelper (0x11, DISPATCH_METHOD, VTVT_DISPATCH, (void*) & result, parms, actid);
 return result;
}

3) Dispatch Map에 해당 ID가 있다면 ID와 일치하는 API 함수 호출
 BEGIN_DISPATCH_MAP(..)
 .....
 DISP_FUNCTION_ID(CHwpCtrlCtrl, "CreateAction", 1 7, CreateAction, VT_DISPATCH, VTS_BSTR)
 .....
 END_DISPATCH_MAP()

4) API가 실행
 LPDISPATCH CHwpCtrlCtrl::CreateAction(LPCTSTR actidstr) { 
 .....
 }
```



## **4. 지원되는 파일 형식**

### Description
&nbsp;&nbsp;웹한글 기안기는 기존 한글 파일 형식인 HWP뿐만 아니라 KS 표준 및 국제 표준 파일 형식인 ODF, 기록물 이관을 위한 PDF, 공문서 유통을 위한 파일 형식 등을 지원합니다.

### 지원 포맷 
- HWP 
- HWPX 
- HWPML(HML) 
- ODF(ODT) 
- PDF 
- XML(공문서 유통용)

구성/구조/지원되는 파일 형식

URI의 구성

변환 쌍 및 모듈명과 변환 API

매개 변수

응답 형식

응답 코드

문서 변환 API

file_path

ext_to

error code

HTML 문서 뷰어 API

릴리즈 노트

docsconverter

공통 가이드 

한컴 OAuth 로그인 

디자인 리소스 

hancomaccount

Webhook

hancomsign-api

한글 컨트롤(ActiveX 기반) 대비 API 변경 사항

웹한글 기안기 API 기본 사용법

Properties

Methods

Action

CtrlCode

ParameterSet

ParameterArray

HwpCtrl

webhwp

한컴디벨로퍼

데스크톱에 한컴오피스 한글을 설치하지 않아도 웹 브라우저에 접속하여 한글 프로그램을 사용할 수 있습니다. 전자 결재를 상신하거나 양식 문서 또는 각종 보고서를 작성하는 시스템과 연동하여 활용해 보세요.

웹한글 기안기

웹한글 기안기의 API 예제를 직접 작성하여 결과를 확인해 보세요. 활용 가능한 API 정보는 문서 > 개발 가이드 →를 통해 확인할 수 있습니다.

PDF 다운로드

웹한글 기안기 예제