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

개발 가이드

개요

한컴 통합문서뷰어

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

한컴 통합문서뷰어 예제

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

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

한컴 계정

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

한컴싸인

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

한글 오토메이션

## **1. 제외된 API**

### Description

웹한글 기안기는 서버에서 동작하는 방식으로 변경됨에 따라 기술적 제약으로 일부 API 사용이 제한됩니다.
- 개인 정보 보호 관련 API
- 문서 비교, 버전 비교 관련 API
- Automation 관련 API
- 로컬 파일 접근 API



## **2. 사용법이 변경된 API**

### Description

웹한글 기안기는 기존 한글 컨트롤(ActiveX 기반)에서 구조가 변경됨에 따라 일부 API의 동작 방식도 변경되었습니다.
| 구분 | 내용 | 
| --- | --- |
| Point를 인자로 받는 API | · 함수 사용법 : Pointer를 인자로 받는 방식 → 객체 return · 기존에 있던 대체 API는 유지 &nbsp;&nbsp;&nbsp;&nbsp;- ___BySet으로 Pointer를 사용할 수 없는 언어에서 set을 인자로 넣는 대체 API는 유지 · 예) GetSelectedPos, GetSelectedPosSet |
| Server에 접근이 필요한 API | · CallBack 함수를 등록해야 하는 API &nbsp;&nbsp;&nbsp;&nbsp;- 비동기 방식 &nbsp;&nbsp;&nbsp;&nbsp;- 예) GetTextFile, Open, OpenDocument, Insert, InsertDocument · Download를 사용하는 API &nbsp;&nbsp;&nbsp;&nbsp;- Download.js 사용 &nbsp;&nbsp;&nbsp;&nbsp;- 예) Save, SaveAs, SaveDocument, CreatePageImage |
| 파일에 접근하는 API | · JavaScript에서는 보안상의 이유로 Local File을 읽을 수 없음 · Upload한 파일 읽기 &nbsp;&nbsp;&nbsp;&nbsp;- html form의 file input을 이용하여 upload한 파일을 읽음 · 예) Open, OpenDocument, Insert, InsertDocument, InsertPicture, InsertBackgroundPicture |
| HwpCtrl Event | · 함수 사용법 &nbsp;&nbsp;&nbsp;&nbsp;- HwpCtrl Event를 등록하기 위해 기존에 사용하던 문법은 Internet Explorer에서 ActiveX의 이벤트 등록을 위한 것이므로 범용적으로 사용할 수 없음 &nbsp;&nbsp;&nbsp;&nbsp;- addEventListener 함수를 통해 CallBack 함수를 등록하는 방식으로 변경 · addEventListener API 추가 | 

### Pointer를 인자로 받는 API

> **GetSelectedPos**
```js
var pos = HwpCtrl.GetSelectedPos();
console.log(pos.slist + ' ' + pos.spara + ' ' + pos.spos);
console.log(pos.elist + ' ' + pos.epara + ' ' + pos.epos);
```

> **GetSelectedPosBySet**
```js
var sSet = HwpCtrl.CreateSet('ListParaPos');
var eSet = HwpCtrl.CreateSet('ListParaPos');
var posSet = HwpCtrl.GetSelectedPosBySet(sSet , eSet); 
```
 

### Server에 접근이 필요한 API

> **Open** 
> CallBack 함수를 등록해야 하는 API

```js
<input type="button" id="open" value="열기"/>

HwpCtrl.Open($("input[name=openFile]")[0].files[0], "", "", function() { 
 HwpCtrl.MoveToField('이름1', true, true, true);
});

* input을 통해서 upload하거나 미리 서버에 올라와 있는 파일만 접근 가능
* Open이후 동작은 callback 함수를 통해 가능
```

> **GetTextFile** 
> CallBack 함수를 등록해야 하는 API

```js
var text = '';
HwpCtrl.GetTextFile("HWP", "", function(data) { 
 text = data;
});

* GetTextFile 이후 동작은 callback 함수를 통해 가능
```

> **SaveAs** 
> Download를 사용하는 API

```js
HwpCtrl.SaveAs("test.hwp", "Hwp", "");

* 파일 이름만 지정 가능
* 항상 Download 폴더에 저장
```
 

### 파일에 접근하는 API

> **InsertPicture** 

```js
<input type="button" id="open" value="열기"/>
 var url = URL.createObjectURL($("input[name=imageFile]")[0].files[0]);

HwpCtrl.InsertPicture(url, true, 0, false, false, 0, 0, 0);

* input을 통해서 upload하거나 미리 서버에 올라와 있는 파일만 접근 가능
```
 

### HwpCtrl Event

> **OnMouseLButtonDown Event 추가** 

```js
function HwpCtrl_OnMouseLButtonDown(x,y) { 
 console.log(x + ', ' + y);
}

HwpCtrl.addEventListener(0, HwpCtrl_OnMouseLButtonDown);
```

> **addEventListener** 

```js
addEventListener(eventType, callback);

EventType
 1) HWPCTRLEVENT_ONMOUSELBBOTTONDOWN = 0;
 2) HWPCTRLEVENT_ONMOUSELBBOTTONUP = 1;
 3) HWPCTRLEVENT_ONSCROLL = 2;
 4) HWPCTRLEVENT_NOTIFYMESSAGE = 3;
```

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

URI의 구성

변환 쌍 및 모듈명과 변환 API

매개 변수

응답 형식

응답 코드

문서 변환 API

file_path

ext_to

error code

HTML 문서 뷰어 API

릴리즈 노트

docsconverter

공통 가이드 

한컴 OAuth 로그인 

디자인 리소스 

hancomaccount

Webhook

hancomsign-api

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

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

Properties

Methods

Action

CtrlCode

ParameterSet

ParameterArray

HwpCtrl

webhwp

한컴디벨로퍼

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

웹한글 기안기

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

PDF 다운로드

웹한글 기안기 예제