Template

네이버 클라우드 플랫폼 콘솔의 CLOVA OCR > Domain에서는 판독 영역을 직접 지정하여 인식값 추출 후 테스트 및 결과 전송이 가능한 템플릿 빌더를 지원하는 Template 도메인을 생성하고 관리할 수 있습니다. 여기에서는 Template 타입의 도메인을 생성하여 사용하는 방법을 설명합니다. 도메인 목록을 확인, 삭제, 복사하는 방법과 API Gateway와 연동하는 자세한 방법은 Domain을 참고해 주십시오.

도메인 생성

서비스 타입이 Template인 도메인을 생성하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 Services > AI Services > CLOVA OCR 메뉴를 차례대로 클릭해 주십시오.
2. Domain 메뉴를 클릭해 주십시오.
3. [도메인 생성] 버튼을 클릭한 다음 [General/Template] 버튼을 클릭해 주십시오.
4. 도메인 생성 팝업 창이 나타나면 필요한 정보를 입력해 주십시오.
   • 도메인 이름: 국문, 영문 대·소문자, 중문, 일문, 숫자, 특수문자 전각/반각( & 。_ - × 々)을 사용하여 1~50자 사이로 입력 후 중복 여부 확인을 위해 [체크] 버튼 클릭
   • 도메인 코드: 영문 대·소문자, 특수문자(.?&。_-×々)를 사용하여 공백을 제외하고 1~50자 사이로 입력 후 중복 여부 확인을 위해 [체크] 버튼 클릭
   • 지원 언어: 도메인에서 지원하는 언어의 종류를 클릭하여 선택
   • 서비스 타입: 템플릿을 클릭하여 선택
   • 인식 모델: 도메인에 적용할 인식 모델을 클릭하여 선택
   • 서비스 플랜: 도메인에 적용할 서비스 플랜을 클릭하여 선택
5. [도메인 생성] 버튼을 클릭해 주십시오.

템플릿 빌더 실행

Template 도메인을 생성하면 템플릿 빌더를 실행할 수 있습니다. 템플릿 빌더는 이미지, 문서에서 텍스트를 추출하기 위한 템플릿을 작성하고 테스트할 수 있는 웹 콘솔로서 Template OCR에 필요한 다양한 기능을 제공합니다. 템플릿 빌더는 다음과 같은 기능 메뉴로 구성되어 있습니다.

• 템플릿 생성: 대표 템플릿 생성, 분석 대상이 되는 템플릿별 대표 샘플 목록 관리
• 테스트 및 분석: 판독 영역이 설정된 템플릿/모델에 대한 테스트 및 결과 확인, 서비스 플랜별 OCR 통계 데이터 조회
• 콤포넌트: 특화된 단어 및 유사어를 용어사전에 등록하여 템플릿에 적용, 용어사전 관리
• 설정: 도메인 정보 확인, 외부 연동 설정, 검증 연동 설정, 권한 관리 설정
• 배포 관리: 템플릿 베타 배포, 서비스 배포

템플릿 생성

템플릿 생성에서는 대표 템플릿을 생성하고, 분석 대상이 되는 템플릿별 대표 샘플 목록을 관리할 수 있습니다.

템플릿 목록

대표 템플릿을 생성하고 샘플을 추가하여 관리하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 Services > AI Services > CLOVA OCR 메뉴를 차례대로 클릭해 주십시오.
2. Domain 메뉴를 클릭해 주십시오.
3. Template 도메인의 [템플릿 빌더] 버튼을 클릭해 주십시오.
4. 템플릿 생성의 템플릿 목록 메뉴를 클릭해 주십시오.
5. [템플릿 생성] 버튼을 클릭해 주십시오.
6. 템플릿 기본 정보에서 템플릿 이름을 입력한 다음 [확인] 버튼을 클릭해 주십시오.
   • 템플릿 명: 국문, 영문 대·소문자, 중문, 일문, 숫자, 특수 문자 전각/반각( ? & 。_ - × 々)을 사용하여 1~30자 사이로 입력
   • 인식 모델: 선택한 Template Domain에 적용된 인식 모델 종류 확인
7. [확인] 버튼을 클릭해 주십시오.
8. 대표 샘플 설정에서 인식 성능 향상을 위한 이미지 샘플을 업로드해 주십시오.
   • 이미지 파일 업로드 조건
     • 파일 크기: 20MB 이하
     • 파일 형식: jpg, png, pdf, tiff
     • 파일 해상도: A4 150dpi 이상, 최소 해상도 10px 이상 ~ 장축 기준 1960px 이하 권장
     참고

     API를 통해 입력되는 이미지는 왜곡 및 손상이 적은 최소 150dpi 이상의 고품질을 권장합니다.

9. 업로드한 이미지 샘플이 나타나면 문서의 제목 영역을 지정해 주십시오.
   
   • 제목 영역 지정: 대표 샘플 이미지 업로드 후 영역 지정 사각형을 드래그하여 설정
     • 이미 지정된 영역을 클릭하면 영역 지정 사각형이 활성화되고, 클릭 시 영역 지정 취소
     • 이미 지정된 영역을 클릭하면 영역 지정 사각형이 활성화되고, 점선을 마우스로 드래그하면 영역이 재설정되며 클릭 시 재설정한 영역이 저장
10. 대표 샘플명에 문서의 템플릿 분류에 사용될 샘플 이름을 국문, 영문 대·소문자, 중문, 일문, 숫자, 특수 문자 전각/반각( ? & 。_ - × 々)을 사용하여 1~30자 사이로 입력한 다음 [확인] 버튼을 클릭해 주십시오.
    
    • [확인] 버튼 클릭 시 저장 및 유사어 등록 알림창 확인 가능
    • [확인] 버튼 클릭 후에도 대표 샘플명은 [수정] 버튼을 클릭하여 수정 가능
    • [유사어 관리] 버튼: 클릭 시 대표 샘플명과 비슷하게 인식되는 단어를 등록하여 분류 성능 향상 가능하며 복수의 유사어를 입력하는 경우 쉼표로 구분하여 입력
      
      • <예시> 지방세고지서, 지방세, 지방세 고지서
      • 유사어 관리의 대표 샘플명은 변경할 수 없으며 유사어 등록 및 수정만 가능
11. 판독 필드 지정에서 판독을 원하는 개별 필드를 지정하여 설정해 주십시오.
    • 필드 추가를 클릭한 경우
      • 판독 영역 지정: 신규 필드 지정 사각형이 표시되면 사각형의 크기를 조절하여 설정
        
        • 이미 지정된 영역을 클릭하면 영역 지정 사각형이 활성화되고, 클릭 시 영역 지정 취소
        • 이미 지정된 영역을 클릭하면 영역 지정 사각형이 활성화되고, 점선을 마우스로 드래그하면 영역이 재설정되며 클릭 시 재설정한 영역이 저장
        • 클릭 시 해당 필드 이름(원래 이름_#), 설정 값이 복사되며 기존 필드 하단에 필드 지정 박스가 신규 생성
        • 필드 박스의 [삭제] 버튼 클릭 시 필드 삭제 가능
    • 멀티 박스(Premium 전용)를 클릭한 경우
      
      • 은행 계좌 번호나 휴대 전화 번호처럼 입력 칸이 나뉘어져 있을 경우 멀티 박스 지정을 통해 개별 박스 안의 글자 인식 및 추출이 가능
      • 멀티 박스 테두리 바깥쪽으로 필드 영역 설정 시 추출을 원하는 박스 속 글자만 인식(멀티 박스 테두리 미인식)
      • 판독 영역 지정: 신규 필드 지정 사각형이 표시되면 사각형의 크기를 조절하여 설정
        • 이미 지정된 영역을 클릭하면 영역 지정 사각형이 활성화되고, 클릭 시 영역 지정 취소
        • 이미 지정된 영역을 클릭하면 영역 지정 사각형이 활성화되고, 점선을 마우스로 드래그하면 영역이 재설정되며 클릭 시 재설정한 영역이 저장
        • 클릭 시 해당 필드 이름(원래 이름_#), 설정 값이 복사되며 기존 필드 하단에 필드 지정 박스가 신규 생성
        • 필드 박스의 [삭제] 버튼 클릭 시 필드 삭제 가능
    • 체크 박스(Premium 전용)를 클릭한 경우
      
      • 선택 상자나 라디오 버튼과 같은 체크 박스 내에 V, X, O, · 등 비정형 캐릭터가 인식되면 True, 인식되지 않으면 False 값을 리턴
      • 설문지, 상품 가입 서류 등 다양한 형태의 문서에서 OCR을 통한 체크 마크 인식 가능
      • 체크 박스 지정 시 입력 칸 테두리가 보이도록 필드를 설정하여 설정하고, 지정된 영역 안에 다른 글자나 도형 없이 체크 박스만 인식되도록 지정해야 하며 멀티 박스 테두리와 필드 영역 박스가 최대한 일치하도록 설정
      • 체크 박스 영역 밖의 비정형 캐릭터인 경우, 지워졌거나 흐릿한 비정형 캐릭터인 경우, 수정하여 동일 박스에 비정형 캐릭터가 중복 기입된 경우, 체크 박스 내에 고객이 체크할 수 있도록 비정형 캐릭터와 가이드 문자가 이미 기입되어 있는 경우 정상 인식이 되지 않을 수 있음
      • 판독 영역 지정: 신규 필드 지정 사각형이 표시되면 사각형의 크기를 조절하여 설정
        • 이미 지정된 영역을 클릭하면 영역 지정 사각형이 활성화되고, 클릭 시 영역 지정 취소
        • 이미 지정된 영역을 클릭하면 영역 지정 사각형이 활성화되고, 점선을 마우스로 드래그하면 영역이 재설정되며 클릭 시 재설정한 영역이 저장
        • 클릭 시 해당 필드 이름(원래 이름_#), 설정 값이 복사되며 기존 필드 하단에 필드 지정 박스가 신규 생성
        • 필드 박스의 [삭제] 버튼 클릭 시 필드 삭제 가능
    • 미인식: 필요한 경우 판독 범위로 설정한 필드 영역에서 글자 입력 및 수기 작성 영역 외 특정 영역을 미인식으로 지정 가능
      • 필드 추가를 클릭하여 기존 필드 내에 미인식으로 처리할 영역을 지정하는 방법
        • 미인식으로 설정한 영역 내 텍스트는 추출되지 않음
      • 일반 필드(Value type All) 설정 시 지원하는 Masking 기능을 사용하는 방법
        • 멀티 박스, 체크 박스, Value type Numeric의 경우 미지원
        • 필드 내 작성 방법 안내 문구가 배경 글자로 기입되어 있을 경우 가이드 문구(배경 글자)나 워터마크 미인식 등은 미지원
12. 추가한 필드의 이름을 입력하고 관련 옵션을 설정해 주십시오.
    • 필드 이름 입력: 필드 이름에 국문, 영문 대·소문자, 중문, 일문, 숫자, 특수 문자 전각/반각( ? & 。_ - × 々)을 사용하여 입력
      • 필드 이름은 해당 필드에서 자유롭게 수정 가능
    • 필드 설정: 클릭
      • Value type과 용어 설정: 개별 필드로 필드나 멀티 박스를 클릭한 경우
        • Value type: AII 선택 시 텍스트와 숫자 혼합, Numeric 선택 시 숫자만 인식하도록 지정할 수 있으므로 필드에 입력될 값의 형태를 미리 지정하여 특정 값만 추출 가능
        • 용어 등록: 도메인 특화 단어 및 유사어가 담긴 용어사전을 등록할 수 있습니다. 사전을 등록하는 경우 해당 사전에 포함된 대표어만 인식되며 유사어가 식별될 경우 대표어로 치환되어 표기됩니다. 대표/유사어 외 다른 단어가 인식될 경우 실패 처리됩니다.
      • 체크 박스 인식 결과 문자 변환 설정: 개별 필드로 체크 박스를 선택한 경우
        • 체크 박스의 True(Y), False(N) 리턴값을 특정 문자로 치환하여 출력
          
13. 필요한 경우 추가한 필드들의 정렬을 설정하거나 필드 판독 결과 결합을 설정해 주십시오.
    • 필드 정렬: Shift 키를 누른 상태에서 마우스를 드래그하여 정렬할 필드를 선택한 다음 필드 정렬의 왼쪽 맞춤이나 위쪽 맞춤을 클릭
      
    • 판독 결과 결합: 개별 필드의 OCR 추출값을 결합하여 새로운 값을 출력하려면 [판독 결과 결합] 버튼 클릭
      • 결합할 필드와 출력 순서에 따라 가공된 OCR 결과 값 추출 가능
      • 고정 TEXT 입력 시 ‘각 필드 별 출력 값+고정 TEXT’가 함께 노출
14. [저장] 버튼을 클릭해 주십시오.
15. 템플릿 목록에서 필요한 관리를 진행해 주십시오.
    
    • 대표 샘플 이미지 변경: 대표 샘플 목록에서 대표 샘플 수정의 [수정] 버튼 클릭
      • 대표 샘플 이미지 변경 시 기존에 저장되어 있던 내용 모두 삭제
    • 템플릿 삭제: 대표 샘플 목록에서 삭제할 템플릿 클릭 후 [삭제] 버튼 클릭
    • 템플릿 검증: 보유 중인 자체 검증 서버를 연동하여 템플릿별 검증을 진행하려면 대표 샘플 목록에서 검증 기능의 [등록] 버튼 클릭

샘플 목록

템플릿별로 등록한 대표 이미지 샘플 정보를 확인하고 다운로드할 수 있습니다. 샘플 목록을 확인하고 다운로드하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 Services > AI Services > CLOVA OCR 메뉴를 차례대로 클릭해 주십시오.
2. Domain 메뉴를 클릭해 주십시오.
3. Template 도메인의 [템플릿 빌더] 버튼을 클릭해 주십시오.
4. 템플릿 생성의 샘플 목록 메뉴를 클릭해 주십시오.
5. 샘플 목록이 나타나면 정보를 확인하고 필요한 경우 이미지 샘플을 다운로드해 주십시오.
   • 업로드한 대표 샘플 이미지 확인: 개별 샘플 번호 클릭
   • 업로드한 대표 샘플 이미미 다운로드: 샘플 목록의 다운로드에서 클릭

테스트 및 분석

테스트 및 분석에서는 텍스트 추출을 원하는 이미지 파일을 업로드한 후 판독 결과를 테스트하거나 다운로드할 수 있습니다. 또한 서비스 플랜의 일별 API 호출 수, 템플릿별 외부 검증 결과, 인식 결과에 대한 통계 데이터 확인도 가능합니다.

테스트

텍스트 추출을 원하는 이미지 파일을 업로드한 후 판독 결과를 테스트하거나 다운로드하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 Services > AI Services > CLOVA OCR 메뉴를 차례대로 클릭해 주십시오.
2. Domain 메뉴를 클릭해 주십시오.
3. Template 도메인의 [템플릿 빌더] 버튼을 클릭해 주십시오.
4. 테스트 및 분석의 테스트 메뉴를 클릭해 주십시오.
5. 테스트 조건에서 테스트할 조건을 베타와 템플릿 판독 가운데 클릭하여 선택해 주십시오.
   • 베타: 서비스 배포와 동일한 환경에서 템플릿 자동 분류, 판독 영역 테스트. 베타 배포 후 베타 테스트 및 서비스 배포 가능
   • 템플릿 판독: 판독 영역이 설정된 템플릿, 모델에 대한 테스트
6. 테스트 데이터에 테스트할 데이터를 업로드해 주십시오.
7. 테스트 결과에서 결과를 확인해 주십시오.
   
   • 테스트 결과 확인: 판독 결과를 표로 제공
   • 테스트 결과 다운로드: csv와 json 가운데 클릭하여 선택 후 [다운로드] 버튼 클릭

통합 지표

서비스 플랜의 일별 API 호출 수, 템플릿별 외부 검증 결과, 인식 결과에 대한 통계 데이터를 확인하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 Services > AI Services > CLOVA OCR 메뉴를 차례대로 클릭해 주십시오.
2. Domain 메뉴를 클릭해 주십시오.
3. Template 도메인의 [템플릿 빌더] 버튼을 클릭해 주십시오.
4. 테스트 및 분석의 통합 지표 메뉴를 클릭해 주십시오.
5. 조회할 기간과 템플릿을 설정해 주십시오.
   • 조회 기간: 최대 90일까지 설정 가능
6. 조회 결과를 확인해 주십시오.
   • API 호출 수: 사용 중인 서비스 플랜이 설정된 기간 동안 호출된 API 건수
   • 검증 결과 : 템플릿별 외부 검증 결과 및 해당 도메인의 검증 횟수. 검증 결과 그래프 마우스 오버 시 VALID, UNCHECKED, ERROR, INVALID 횟수 표시
   • 템플릿 인식 실패 수: 템플릿이 매칭되지 않아 인식 결과가 없을 경우 템플릿 인식 실패로 카운트하고 설정된 기간 동안의 건수 표시
7. 조회 결과를 xls 파일로 다운로드하려면 [통합 지표 다운로드] 버튼을 클릭해 주십시오.

컴포넌트

컴포넌트에서는 용어사전에 도메인에 특화된 단어 및 유사어를 등록하여 템플릿에 적용할 수 있습니다. 특정 필드에 해당 사전의 단어만 인식하도록 지정하거나 등록된 유사어들이 인식될 경우 대표어로 치환한 결과값을 노출하게 됩니다. 용어사전을 설정하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 Services > AI Services > CLOVA OCR 메뉴를 차례대로 클릭해 주십시오.
2. Domain 메뉴를 클릭해 주십시오.
3. Template 도메인의 [템플릿 빌더] 버튼을 클릭해 주십시오.
4. 컴포넌트의 용어사전 메뉴를 클릭해 주십시오.
5. [용어사전 생성] 버튼을 클릭해 주십시오.
6. 사전 생성 및 수정 팝업 창이 나타나면 필요한 정보를 입력해 주십시오.
   
   • 사전 이름: 중복되지 않는 고유한 사전 이름 입력
   • 대표어: 사전을 구성하는 대표어 입력
   • 유사어: 입력한 대표어의 동의어 또는 유사어 입력. 복수의 유사어를 입력하는 경우 쉼표(,)로 구분 <예시> 지방세고지서, 지방세, 지방세 고지서
7. [확인] 버튼을 클릭해 주십시오.

설정

설정에서는 도메인 정보를 확인하거나 외부 연동, 권한 관리 등의 옵션을 설정할 수 있습니다. 확인 및 설정 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 Services > AI Services > CLOVA OCR 메뉴를 차례대로 클릭해 주십시오.
2. Domain 메뉴를 클릭해 주십시오.
3. Template 도메인의 [템플릿 빌더] 버튼을 클릭해 주십시오.
4. [설정] 버튼을 클릭해 주십시오.
   
5. 원하는 탭 메뉴를 클릭하여 필요한 내용을 확인하거나 설정해 주십시오.
   • 도메인 정보 탭 메뉴 클릭 시: 도메인 및 템플릿 정보 확인
   • 외부 연동 탭 메뉴 클릭 시: API Gateway 연동 설정
     • 자세한 사용 방법은 Domain 참고
   • 검증 연동 탭 메뉴 클릭 시: [생성] 버튼을 클릭하여 OCR 결과를 전송할 주소를 직접 설정하고 관리
     
     • ${결과 전송 이름} 형식으로 이름 입력
     • URL 필드에 https:// 로 시작하는 URL 입력
   • 권한 관리 탭 메뉴 클릭 시: 새로운 관리자를 추가하고 권한을 부여
     • [URL 생성] 버튼 클릭 시 Invite URL 생성되며 URL을 통해 권한 부여 가능
     • [삭제] 버튼 클릭 시 Invite URL 삭제

배포 관리

베타 배포는 모델에 반영되는 최종 저장 기능으로 템플릿에 적용한 샘플, 판독 영역 및 용어사전 등을 학습할 수 있습니다. 베타 배포 후 베타 테스트 및 서비스 배포가 가능합니다. 배포 관리를 하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 Services > AI Services > CLOVA OCR 메뉴를 차례대로 클릭해 주십시오.
2. Domain 메뉴를 클릭해 주십시오.
3. Template 도메인의 [템플릿 빌더] 버튼을 클릭해 주십시오.
4. [배포 관리] 버튼을 클릭해 주십시오.
   
5. 템플릿 목록이 나타나면 현재 배포 상태에서 각 템플릿의 최신 상태를 확인해 주십시오.
6. 배포할 템플릿을 클릭하여 선택한 다음 [베타 배포] 버튼을 클릭해 주십시오.
   • 베타 배포 완료 후 테스트 메뉴에서 베타 테스트 가능
   • 테스트 메뉴에서 판독 결과 테스트 후 수정한 정보는 새로운 베타 배포를 통해 적용
7. 베타 테스트가 완료된 최신 베타 배포 템플릿을 서비스 배포하기 위해 [서비스 배포] 버튼을 클릭해 주십시오.

API Gateway 연동

Template OCR의 Invoke URL 설정을 위해 API Gateway를 연동하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 Services > AI Services > CLOVA OCR 메뉴를 차례대로 클릭해 주십시오.
2. Domain 메뉴를 클릭해 주십시오.
3. Template 도메인의 [템플릿 빌더] 버튼을 클릭해 주십시오.
4. API Gateway 연동 탭 메뉴를 클릭한 다음 [연동] 버튼을 클릭해 주십시오.
5. API Gateway 연동 팝업 창이 나타나면 필요한 정보를 설정해 주십시오.
   • 자세한 연동 방법은 Domain의 API Gateway 연동 참고

API 호출

Template OCR의 Invoke URL 설정을 완료한 후 CLOVA OCR에서 제공하는 API를 호출하여 이미지를 입력하고 인식값을 반환받을 수 있습니다. API를 호출하는 방법은 다음 가이드를 참고해 주십시오.

• CLOVA OCR API 가이드
• Template OCR API 호출 예제