개요

OCR(Optical Character Recognition:광학 문자 인식) 기반 문서 인식, 데이터 캡처 소프트웨어 솔루션 기업 Abbyy에서 제공하는 상용 Abbyy 엔진이 탑재된 OCR 서버(Ochestrator)를 이용해 대상 이미지를 문자 또는 표로 읽어 들일 수 있습니다. 또한 OCR 서버를 통하여 이미지에 있는 문자와 테이블을 텍스트, 배열의 형태로 반환하는 등의 동작을 수행합니다. Abbyy 라이브러리는 OCR 서버를 이용하여 동작하는 방식으로 디자이너에 계정 로그인이 되어 있어야 사용할 수 있습니다.

Abbyy 라이브러리에서 사용할 수 있는 기능은 다음과 같습니다.

OCR을 이용하여 이미지 정보를 추출: GetImageText, GetImageTextInfo, GetImageTable, GetImageFieldData, GetPDFFieldData, GetTextOnFile, GetTextInfoOnFile, GetTableOnFile
OCR을 이용하여 이미지에서 추출된 정보를 기반한 마우스 동작: TextClick, TextDoubleClick, TextRightClick, TextHover

Abbyy 라이브러리에 대한 샘플을 디자이너 혹은 윈도우 탐색기를 이용하여 참조할 수 있습니다.

• 디자이너 경로: 메뉴 > 도움말 > 샘플 > Sample > Abbyy

• 윈도우 탐색기 경로: C:\Users\user\AppData\Roaming\Brity RPA Designer\samples\Abbyy

[Abbyy 샘플 프로젝트명과 관련 라이브러리]

• Abbyy_Mouse: TextClick, TextDoubleClick, TextHover, TextRightClick

• Get Text: GetImageTable, GetImageTextInfo, GetImageText, GetImageFieldData, GetTableOnfile, GetTextInfoOnFile, GetTextOnFile

Abbyy 라이브러리 설치하기

Abbyy 라이브러리 설치는 5. Add-In 라이브러리 설치하기 페이지를 참고 하십시요.

설치 전 BrityRPA Designer와 Bot을 모두 종료합니다.

공통 속성

IMAGE

캡처한 이미지의 정보(크기/위치)가 표시됩니다.

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
Image	이미지	Y	-	Y	캡처한 이미지가 조회됩니다
Bounds	문자열	N	-	Y	사용자가 지정한 대상 UI 객체의 위치 및 크기가 화면 기준 좌표로 나타납니다.(단위: 픽셀) X: 가로 Y:세로 W: 너비 H: 높이 예시> '0,0,,100,100' 변수로 지정할 수도 있습니다.

OCR

OCR과 관련된 설정을 입력할 수 있습니다.

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
PDFPage	숫자	Y	-	Y	읽고자 하는 PDF 내 이미지 번호를 지정합니다. 0 이하 혹은 전체 페이지 수를 벗어난 값은 무시됩니다.
FilePath	문자	Y	-	N	OCR을 수행할 PDF 파일의 경로를 입력합니다.
Template	콤보박스	N	-	Y	OCR 포털에서 생성한 Template의 유형을 선택합니다. 콤보박스에서 'Auto'를 선택하면 OCR 포털에 등록된 템플릿을 자동으로 선택해줍니다.
Language	콤보박스	N	-	Y	읽고자하는 문서의 언어를 지정합니다. - ALL : 언어를 자동 판별하는 기능이지만 언어를 지정하면 더욱 성능이 향상됩니다. - Korean(Hangul) - English
Scale(%)	숫자	Y	-	Y	OCR 수행 시 원본 이미지 크기를 조정할 비율(%)을 입력합니다.
Target Text	문자	Y		N	검색하여 클릭할 텍스트를 입력합니다.
GrayFilter	토글버튼	N	-	Y	True일 경우 흑백 이미지를 사용 시 변환하여 줍니다. False일 경우 사용하지 않습니다.(흑백 이외의 컬러)
ThresholdFilter	토글버튼	N	-	Y	True일 경우 흑백 이미지를 사용 시 변환하여 줍니다. False일 경우 사용하지 않습니다. GrayFilter와 반드시 함께 사용됩니다.

MORE OPTION

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
Timeout(Sec)	숫자	Y	sec	Y	이벤트가 완료될 때까지 기다릴 시간을 입력합니다. (초)
Drawbounds	토글버튼	N	-	Y	인식 대상 영역을 그릴지 지정합니다.
On Error	콤보박스	N	-	N	오류 발생 시 처리 방법을 선택합니다. - Ignore: 해당 오류를 무시하고 진행합니다. - Retry: 해당 액티비티를 1회 재시도합니다. - Goto: 해당 엑티비티가 실패한 경우 지정한 엑티비티로 이동하여 시나리오를 수행합니다. - Event: 프로젝트에 작성된 이벤트를 호출합니다.

DESCRIPTION

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
Description	문자	N	-	N	해당 액티비티 카드에 대한 설명을 추가합니다. Description이 입력되면 플로차트의 해당 액티비티 설명에 표시되고, Description이 없는 경우에는 대푯값이 해당 액티비티 설명에 표시됩니다.

GetImageText

개요

이미지에 나타난 문자를 인식하여 텍스트로 변환합니다.

사용 절차

OCR 서버를 이용하여 동작하는 방식으로 디자이너에 계정 로그인이 되어 있어야 사용할 수 있습니다.

액티비티 카드의 No Target을 더블클릭하세요.
텍스트를 추출할 대상 이미지의 범위를 지정하세요.
[Output] Output에 지정한 이미지의 영역에서 추출한 텍스트를 저장하기 위한 변수를 입력하세요.
그 외 속성에 원하는 값을 지정하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Output	string	-	OCR을 이용하여 추출한 텍스트를 반환합니다.	'I'm Feeling Lucky'

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Search Bounds	문자	N	-	N	이미지를 검색할 화면상의 영역 정보(x, y, width, height)를 입력합니다. 해당 액티비티 카드의 'No Target'을 클릭하여 지정한 영역은 자동으로 입력됩니다.
Y	IMAGE	Image	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	IMAGE	Bounds	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	Scale	-	-	-	Abbyy 라이브러리의 공통 속성입니다.

활용 예시

웹페이지를 열고, 이미지에 나타난 문자를 읽어와 메시지 박스로 출력한 후 브라우저를 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Abbyy > Get Text > P_GetImageText_Test

사용된 변수

openBrowser = 실행한 브라우저를 지정할 변수
waitImage : 대상 이미지가 나타났는지 검사한 결과값을 저장할 변수
getText : 추출한 텍스트를 저장한 변수

사용된 속성

[Output] Output = this.getText
Search Bounds = '232,320,1290,193'

OCR 샘플 이미지를 기준의 Text 결과값

INVOICE

Date : 2019.12.03 SAMSUNG SDS CORP.

Request Number: #100000

연관/유사 액티비티

GetImageTextInfo, GetImageTable

GetImageTextInfo

개요

지정된 이미지에서 문자를 인식해 이미지 정보(높이, 너비 등)와 텍스트를 반환합니다.

사용 절차

OCR 서버를 이용하여 동작하는 방식으로 디자이너에 계정 로그인이 되어 있어야 사용할 수 있습니다.

액티비티 카드의 No Target을 더블클릭하세요.
텍스트를 추출할 대상 이미지의 범위를 지정하세요.
[Output] Output에 지정한 이미지의 영역에서 가져온 이미지 정보를 저장하기 위한 변수를 입력하세요.
그 외 속성에 원하는 값을 지정하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Output	object	-	OCR을 이용하여 이미지 정보(텍스트, 위치, 높이, 너비)를 반환합니다.	Bounds(551,119,269,89)-Text(Google) Bounds(571,323,75,15)-Text(Google 검색) Result.RectList[0].Text > 'Google' Result.RectList[0].XPos > 551 Result.RectList[0].YPos > 119 Result.RectList[0].Width > 75 Result.RectList[0].Height > 15

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Search Bounds	문자	N	-	N	이미지를 검색할 화면상의 영역 정보(x, y, width, height)를 입력합니다. 해당 액티비티 카드의 'No Target'을 클릭하여 지정한 영역은 자동으로 입력됩니다.
Y	IMAGE	Image	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	IMAGE	Bounds	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	Scale	-	-	-	Abbyy 라이브러리의 공통 속성입니다.

활용 예시

구글 웹페이지(http://www.google.com)를 열고, 이미지에 나타난 문자를 읽어와 이미지 정보와 함께 메시지 박스에 출력한 후 브라우저를 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Abbyy > Get Text > P_GetImageTextInfo_Test

사용된 변수

openBrowser = 실행한 브라우저를 지정할 변수
waitImage = 대상 이미지가 나타났는지 검사한 결과값을 저장할 변수
getText = 추출한 텍스트를 저장한 변수
getImageTextInfo = OCR을 실행하여 가져온 이미지 정보를 저장한 변수
getPoint = 이미지 영역을 지정한 변수

사용된 속성

[Output] Output = this.getImageTextInfo
Search Bounds = this.getPoint

연관/유사 액티비티

GetImageText , GetImageTable

GetImageTable

개요

지정된 이미지에서 테이블(표)을 인식해 테이블에 포함된 텍스트를 읽어오는 기능을 합니다.

사용 절차

OCR 서버를 이용하여 동작하는 방식으로 디자이너에 계정 로그인이 되어 있어야 사용할 수 있습니다.

액티비티 카드의 No Target을 더블클릭하세요.
텍스트를 추출할 대상 이미지의 범위를 지정하세요.
[Output] Output에 이미지의 테이블 영역에서 가져온 정보를 저장하기 위한 변수를 입력하세요.
그 외 속성에 원하는 값을 지정하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Output	2차원배열	string	OCR을 이용하여 가져온 테이블 내 텍스트를 2차원 배열로 반환합니다.	0: A \| B \| C 1: 1 \| 2 \| 3 2: 4 \| 5 \| 6

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Search Bounds	문자	N	-	N	이미지를 검색할 화면상의 영역 정보(x, y, width, height)를 입력합니다. 해당 액티비티 카드의 'No Target'을 클릭하여 지정한 영역은 자동으로 입력됩니다.
Y	IMAGE	Image	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	IMAGE	Bounds	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	Scale	-	-	-	Abbyy 라이브러리의 공통 속성입니다.

활용 예시

OpenBrowser 액티비티로 웹페이지를 열고, GetImageTable 액티비티로 웹페이지의 테이블에 포함된 텍스트를 조회합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Abbyy > Get Text > P_GetImageTable_Test

사용된 변수

openBrowser = 실행한 브라우저를 지정할 변수
waitImage = 대상 이미지가 나타났는지 검사한 결과값을 저장할 변수
getTable = 테이블에서 추출한 텍스트를 지정한 변수
getPoint = 이미지 영역을 지정한 변수

사용된 속성

[Output] Output = this.getTable
Search Bounds = '5,79,719,90'

연관/유사 액티비티

GetImageText , GetImageTextInfo

GetTextOnFile

개요

특정 이미지 파일의 텍스트를 인식하여 문자열로 읽어옵니다.

사용 절차

OCR 서버를 이용하여 동작하는 방식으로 디자이너에 계정 로그인이 되어 있어야 사용할 수 있습니다.

[Output] Output에 OCR을 통해 추출한 파일의 텍스트를 저장할 변수를 입력하세요.
FilePath에 텍스트를 추출할 파일의 경로와 파일명을 입력하세요.
그 외 속성에 원하는 값을 지정하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Output	string	-	OCR을 이용하여 추출한 텍스트를 반환합니다.	'INVOICE'

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
Y	OCR	Scale	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	FilePath	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	GrayFilter	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	ThreshlodFilter	-	-	-	Abbyy 라이브러리의 공통 속성입니다.

활용 예시

이미지 파일(Invoice.JPG) 내에 있는 텍스트를 읽어서 변수(readText)로 저장한 후 메시지 박스로 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Abbyy > GetText > P_GetTextOnFile_Test

사용된 변수

resultText = 이미지로부터 읽은 텍스트를 저장할 변수

사용된 속성

[Output] Output = this.readText
Scale(%) = 100
FilePath = Global.ResourcesDir + 'Invoice.JPG'
GrayFilter = OFF
ThreadholdFilter = OFF

연관/유사 액티비티

GetTextInfoOnFile, GetTableOnFile

GetTextInfoOnFile

개요

특정 이미지 파일에서 문자를 인식해 이미지 정보(위치, 높이, 너비)와 텍스트 정보를 읽어 옵니다.

사용 절차

OCR 서버를 이용하여 동작하는 방식으로 디자이너에 계정 로그인이 되어 있어야 사용할 수 있습니다.

[Output] Output에 OCR을 통해 추출한 파일의 텍스트와 이미지 정보를 저장할 변수를 입력하세요.
FilePath에 텍스트와 이미지 정보를 추출할 파일의 경로와 파일명을 입력하세요.
그 외 속성에 원하는 값을 지정하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Output	object	-	OCR을 이용하여 이미지 정보(위치, 텍스트, 높이, 너비)를 반환합니다.	Bounds(409,47,181,29)-Text(INVOICE) Table[0][0] Bounds(132,264,50,15)-Text(DATE) ※ 자세한 예시는 아래 Note를 참고해주시기 바랍니다 .

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
Y	OCR	Scale	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	FilePath	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	GrayFilter	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	ThreshlodFilter	-	-	-	Abbyy 라이브러리의 공통 속성입니다.

활용 예시

이미지 파일(Invoice.JPG) 내에 있는 Bounds와 텍스트 정보를 읽어서 변수로 저장하고, 모든 Bounds와 텍스트(테이블, 테이블 외 문자열 포함) 정보를 메시지 박스로 출력합니다.
- 테이블 내 두 번째 행, 세 번째 열의 문자열을 메시지 박스로 출력합니다.(결과값: '10') 
- 테이블 바깥에 있는 문자열 중 첫 번째 문자열을 출력합니다.(결과값: 'INVOICE')

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Abbyy > GetText > P_GetTextInfoOnFile_Test

사용된 변수

openBrowser = 실행한 브라우저를 지정할 변수
waitImage = 대상 이미지가 나타났는지 검사한 결과값을 저장할 변수
getTable = 테이블에서 추출한 텍스트를 지정한 변수
getImageTextInfo = 이미지로부터 읽은 Bounds와 텍스트 정보를 저장할 변수

사용된 속성

[Output] Output = this.result
Scale(%) = 100
FilePath = Global.ResourcesDir + 'Invoice.JPG'
GrayFilter = ON
ThreadholdFilter = ON

OCR 샘플 이미지를 기준의 Text info 결과값

• result Table 정보

result.TableList[0].RowList[0].ColList[0].RectList[0].Text -> DATE

• result Text 정보

result.RectList[0].Text -> INVOICE

• result value

Table[0][0]

Bounds(206,459,93,29)-Text(DATE)

Table[0][1]

Bounds(623,460,83,28)-Text(ITEM)

Table[0][2]

Bounds(935,459,159,29)-Text(AMOUNT)

Table[0][3]

Bounds(1303,459,248,29)-Text(DESCRIPTION)

Table[1][0]

Bounds(162,564,179,28)-Text(2019.11.29)

Table[1][1]

Bounds(606,564,119,29)-Text(ITEM A)

Table[1][2]

Bounds(997,564,38,29)-Text(10)

Table[1][3]

Bounds(1362,564,125,29)-Text(DESC1)

Table[2][0]

Bounds(162,669,179,28)-Text(2019.11.30)

Table[2][1]

Bounds(605,669,119,29)-Text(ITEMB)

Table[2][2]

Bounds(995,669,40,29)-Text(20)

Table[2][3]

Bounds(1362,669,130,29)-Text(DESC2)

Table[3][0]

Bounds(161,774,176,27)-Text(2019.12.01)

Table[3][1]

Bounds(604,774,122,29)-Text(ITEMC)

Table[3][2]

Bounds(995,774,40,29)-Text(30)

Table[3][3]

Bounds(1362,774,130,29)-Text(DESC3)

Table[4][0]

Bounds(161,879,181,27)-Text(2019.12.02)

Table[4][1]

Bounds(604,879,121,29)-Text(ITEMD)

Table[4][2]

Bounds(994,879,41,29)-Text(40)

Table[4][3]

Bounds(1362,879,130,29)-Text(DESC4)

Bounds(721,56,336,56)-Text(INVOICE)

Bounds(83,242,1609,27)-Text(Date : 2019.12.03 SAMSUNG SDS CORP.)

Bounds(83,285,447,35)-Text(Request Number: #100000)

연관/유사 액티비티

GetTextOnFile, GetTableOnFile

GetTableOnFile

개요

특정 이미지 파일의 표를 인식해 텍스트 정보를 2차원 배열 변수로 읽어 옵니다.

사용 절차

OCR 서버를 이용하여 동작하는 방식으로 디자이너에 계정 로그인이 되어 있어야 사용할 수 있습니다.

[Output] Output에 파일의 표에서 읽어온 텍스트를 저장할 변수를 입력하세요.
FilePath에 표에 있는 텍스트를 추출할 파일의 경로와 파일명을 입력하세요.
그 외 속성에 원하는 값을 지정하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Output	2차원배열	string	OCR을 이용하여 특정 이미지 파일의 테이블 내 텍스트를 2차원 배열로 반환합니다.	0: A \| B \| C 1: 1 \| 2 \| 3 2: 4 \| 5 \| 6

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
Y	OCR	Scale	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	FilePath	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	GrayFilter	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	ThreshlodFilter	-	-	-	Abbyy 라이브러리의 공통 속성입니다.

활용 예시

이미지 파일(Invoice.JPG)의 표에 있는 텍스트를 읽어서 2차원 배열 변수(resultObj)로 저장한 후 메시지 박스로 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Abbyy > GetText > P_GetTableOnFile_Test

사용된 변수

resultObj = 이미지로 부터 읽은 테이블 내의 텍스트를 저장할 2차원 배열 변수

사용된 속성

[Output] Output = this.resultObj
Scale(%) = 100
FilePath = Global.ResourcesDir + 'Invoice.JPG'
GrayFilter = ON
ThreadholdFilter = ON

연관/유사 액티비티

GetTextOnFile, GetTextInfoOnFile

GetImageFieldData

개요

특정 이미지 파일과 OCR 포털에 등록한 템플릿을 비교하여 미리 지정되어 있는 필드의 라벨과 값을 읽어옵니다.

사용 절차

OCR 서버를 이용하여 동작하는 방식으로 디자이너에 계정 로그인이 되어 있어야 사용할 수 있습니다.

확인할 파일의 전체 경로와 파일명을 'FilePath'에 입력합니다.
속성에 원하는 값을 지정합니다.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Output	object	-	OCR을 이용하여 가져온 필드의 라벨과 값을 반환합니다.	"Field1": "Date:2019.12.03 SAMSUNG SDS CORP.", "Field2": "Request Number:#100000" "Table": [{ "Field1": "DATE", "Field2": "ITEM" }] ※ 자세한 예시는 아래 Note를 참고해주시기 바랍니다.

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Output	변수	Y	-	Y	OCR을 이용하여 가져온 필드의 라벨과 값을 저장하기 위한 변수를 지정합니다. 별도의 설정을 하지 않으면 RESULT라는 변수가 자동입력되어 있습니다.
Y	OCR	FilePath	Y	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	Template	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	Language	-	-	-	Abbyy 라이브러리의 공통 속성입니다.

활용 예시

다음 경로에서 참조할 수 있습니다.

• > 도움말 > 샘플 > Sample > Abbyy > GetText > P_GetImageFieldData_Test

Excel_NewExcel_1K

이미지 파일(Invoice.JPG)을 OCR 서버의 템플릿과 비교하여 각 필드(Date, Item, Amount, Description)의 값을 읽어 변수(result)로 저장한 후 메시지 박스로 출력합니다.

사용된 변수

RESULT : 템플릿의 각 필드와 비교하여 라벨과 값을 문자열로 저장하기 위한 변수

사용된 속성

[Output] Output = this.result
[OCR] FilePath = Global.ResourcesDir + 'Invoice.JPG'
[OCR] Template = Invoice
[OCR] Language = All

OCR 샘플 이미지를 기준의 Field별 결과값

AdminPotal에서 생성한 Template을 기준으로 Field값이 지정되므로 Field이름 또한 수정 가능합니다.

• Text : result.필드명

result.Field1 -> Date:2019.12.03 SAMSUNG SDS CORP.

• Table : result.테이블명(Column).필드명

result.Table(0).Field1 -> DATE

• result value

"Field1": "Date:2019.12.03 SAMSUNG SDS CORP.",

"Field2": "Request Number:#100000"

"Table": [

{

"Field1": "DATE",

"Field2": "ITEM",

"Field3": "AMOUNT",

"Field4": "DESCRIPTION"

{

"Field1": "2019.11.29",

"Field2": "ITEM A",

"Field3": "10",

"Field4": "DESC1"

{

"Field1": "2019.11.30",

"Field2": "IT티VI B",

"Field3": "20",

"Field4": "DESC2"

{

"Field1": "2019.12.01",

"Field2": "ITEMC",

"Field3": "30",

"Field4": "DESC3"

{

"Field1": "2019.12.02",

"Field2": "ITEMD",

"Field3": "40",

"Field4": "DESC4"

}

연관/유사 액티비티

GetPDFFieldData

개요

PDF 파일과 OCR 포털에 등록한 템플릿을 비교하여 미리 지정되어 있는 필드의 라벨과 값을 읽어옵니다.

사용 절차

OCR 서버를 이용하여 동작하는 방식으로 디자이너에 계정 로그인이 되어 있어야 사용할 수 있습니다.

[Output] Output에 필드의 라벨과 값을 저장할 변수를 입력하세요.
FilePath에 필드의 라벨과 값을 확인할 파일의 경로와 파일명을 입력하세요.
그 외 속성에 원하는 값을 지정하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Output	object	-	OCR을 이용하여 가져온 필드의 라벨과 값을 반환합니다.	"Field1": "Date:2019.12.03 SAMSUNG SDS CORP.", "Field2": "Request Number:#100000" "Table": [{ "Field1": "DATE", "Field2": "ITEM" }] ※ 자세한 예시는 아래 Note를 참고해주시기 바랍니다.

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
Y	OCR	PDFPage	Y	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	FilePath	Y	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	Template	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	Language	-	-	-	Abbyy 라이브러리의 공통 속성입니다.

활용 예시

PDF 파일을 OCR 서버의 템플릿과 비교하여 각 필드(Date, Item, Amount, Description)의 값을 읽어 변수(result)로 저장한 후 메시지 박스로 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Abbyy > GetText > P_GetPDFFieldData_Test

사용된 변수

RESULT = 템플릿의 각 필드와 비교하여 라벨과 값을 문자열로 저장하기 위한 변수

사용된 속성

[Output] Output = this.result
FilePath = Global.ResourcesDir + 'Invoice.JPG'
Template = Invoice
Language = All

Excel_NewExcel_1K

OCR 샘플 이미지를 기준의 Field별 결과값

AdminPotal에서 생성한 Template을 기준으로 Field값이 지정되므로 Field이름 또한 수정 가능합니다.

• Text : result.필드명

result.Field1 -> Date:2019.12.03 SAMSUNG SDS CORP.

• Table : result.테이블명(Column).필드명

result.Table(0).Field1 -> DATE

• result value

"Field1": "Date:2019.12.03 SAMSUNG SDS CORP.",

"Field2": "Request Number:#100000"

"Table": [

{

"Field1": "DATE",

"Field2": "ITEM",

"Field3": "AMOUNT",

"Field4": "DESCRIPTION"

{

"Field1": "2019.11.29",

"Field2": "ITEM A",

"Field3": "10",

"Field4": "DESC1"

{

"Field1": "2019.11.30",

"Field2": "IT티VI B",

"Field3": "20",

"Field4": "DESC2"

{

"Field1": "2019.12.01",

"Field2": "ITEMC",

"Field3": "30",

"Field4": "DESC3"

{

"Field1": "2019.12.02",

"Field2": "ITEMD",

"Field3": "40",

"Field4": "DESC4"

}

연관/유사 액티비티

GetImageFieldData

TextClick

개요

이미지에서 지정된 특정 텍스트를 찾아 클릭합니다.

사용 절차

OCR 서버를 이용하여 동작하는 방식으로 디자이너에 계정 로그인이 되어 있어야 사용할 수 있습니다.

액티비티 카드의 No Target을 더블클릭하세요.
클릭할 대상 이미지의 범위를 지정하세요.
[Output] Output에 수행 결과를 저장할 변수를 입력하세요.
OCR 그룹 속성에서 원본 이미지 크기의 비율, 검색할 문구를 입력하세요.
그 외 속성에 원하는 값을 지정하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Output	string	-	OCR 수행 결과를 반환합니다.	'Google'

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Search Bounds	문자	N	-	Y	이미지 검색 시 검색할 화면상의 영역을 지정합니다. 대상을 선택하면 해당 범위가 자동으로 지정되며, 직접 수정도 할 수 있습니다.
N	Index	문자	N	-	N	지정한 영역에서 찾은 동일한 문자열이 2개 이상인 경우 몇 번째 문자열을 선택할지 번호를 입력합니다.
Y	IMAGE	Image	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	IMAGE	Bounds	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	Scale	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	TargetText	-	-	-	Abbyy 라이브러리의 공통 속성입니다.

활용 예시

크롬으로 구를 페이지(www.google.com)를 열고, 구글 로고 이미지가 나타나면 지정한 이미지를 클릭하여 'Google' 문자를 확인합니다. 확인한 내용을 메시지로 박스로 출력한 후 크롬 브라우저를 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Abbyy > Mouse Action > P_TextClick_Test

사용된 변수

openBrowser = 실행한 브라우저를 지정할 변수
waitImage = 대상 이미지가 나타났는지 검사한 결과값을 저장할 변수
textClick = OCR 수행 결과를 저장한 변수
textPoint = 이미지 검색할 범위를 저장한 변수

사용된 속성

[Output] Output = this.textClick
Search Bounds = this.textPoint
Scale(%) = 100
Target Text = 'Google'

연관/유사 액티비티

TextDoubleClick, TextRightClick, TextHover

TextDoubleClick

개요

이미지에서 특정 텍스트를 찾아 더블클릭합니다.

사용 절차

OCR 서버를 이용하여 동작하는 방식으로 디자이너에 계정 로그인이 되어 있어야 사용할 수 있습니다.

액티비티 카드의 No Target을 더블클릭하세요.
더블클릭할 대상 이미지의 범위를 지정하세요.
[Output] Output에 수행 결과를 저장할 변수를 입력하세요.
OCR 그룹 속성에서 원본 이미지 크기의 비율, 검색할 문구를 입력하세요.
그 외 속성에 원하는 값을 지정하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Output	string	-	OCR 수행 결과를 반환합니다.	'Google'

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Search Bounds	문자	N	-	Y	이미지 검색 시 검색할 화면상의 영역을 지정합니다. 대상을 선택하면 해당 범위가 자동으로 지정되며, 직접 수정도 할 수 있습니다.
N	Index	문자	N	-	N	지정한 영역에서 찾은 동일한 문자열이 2개 이상인 경우 몇 번째 문자열을 선택할지 번호를 입력합니다.
Y	IMAGE	Image	-	-	-	ImageRecognition 라이브러리의 공통 속성입니다.
Y	IMAGE	Bounds	-	-	-	ImageRecognition 라이브러리의 공통 속성입니다.
Y	OCR	Scale	-	-	-	ImageRecognition 라이브러리의 공통 속성입니다.
Y	OCR	Target Text	-	-	-	ImageRecognition 라이브러리의 공통 속성입니다.

활용 예시

크롬으로 구를 페이지(www.google.com)를 열고, 구글 로고 이미지가 나타나면 지정한 이미지를 더블클릭하여 'Google' 문자를 확인합니다. 확인한 내용을 메시지로 박스로 출력한 후 크롬 브라우저를 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Abbyy > Mouse Action > P_TextDoubleClick_Test

사용된 변수

openBrowser = 실행한 브라우를 지정할 변수
waitImage = 대상 이미지가 나타났는지 검사한 결과값을 저장할 변수
textDoubleClick = OCR 수행 결과를 저장한 변수
textPoint = 이미지 검색할 범위를 저장한 변수

사용된 속성

[Output] Output = this.textDoubleClick
Search Bounds = this.textPoint
Scale(%) = 100
Target Text = 'Google'

연관/유사 액티비티

TextClick, TextRightClick, TextHover

TextRightClick

개요

이미지에서 지정된 특정 텍스트를 찾아 마우스의 오른쪽 버튼으로 클릭합니다.

사용 절차

OCR 서버를 이용하여 동작하는 방식으로 디자이너에 계정 로그인이 되어 있어야 사용할 수 있습니다.

액티비티 카드의 No Target을 더블클릭하세요.
마우스 오른쪽 버튼으로 클릭할 대상 이미지의 범위를 지정하세요.
[Output] Output에 수행 결과를 저장할 변수를 입력하세요.
OCR 그룹 속성에서 원본 이미지 크기의 비율, 검색할 문구를 입력하세요.
그 외 속성에 원하는 값을 지정하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Output	string	-	OCR 수행 결과를 반환합니다.	'Google'

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Search Bounds	문자	N	-	Y	이미지 검색 시 검색할 화면상의 영역을 지정합니다. 대상을 선택하면 해당 범위가 자동으로 지정되며, 직접 수정도 할 수 있습니다.
N	Index	문자	N	-	N	지정한 영역에서 찾은 동일한 문자열이 2개 이상인 경우 몇 번째 문자열을 선택할지 번호를 입력합니다.
N	Igore Error	Image	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	IMAGE	Bounds	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	IMAGE	Scale	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	Target Text	-	-	-	Abbyy 라이브러리의 공통 속성입니다.

활용 예시

크롬으로 구를 페이지(www.google.com)를 열고, 구글 로고 이미지가 나타나면 지정한 이미지를 마우스 오른쪽 버튼으로 클릭하여 'Google' 문자를 확인합니다. 확인한 내용을 메시지로 박스로 출력한 후 크롬 브라우저를 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Abbyy > Mouse Action > P_TextRightClick_Test

사용된 변수

openBrowser = 실행한 브라우를 지정할 변수
waitImage = 대상 이미지 나타났는지 검사한 결과값을 저장할 변수
textRightClick = OCR 수행 결과를 저장한 변수
textPoint = 이미지 검색할 범위를 저장한 변수

사용된 속성

[Output] Output = this.textRightClick
Search Bounds = this.textPoint
Scale(%) = 100
Target Text = 'Google'

연관/유사 액티비티

TextClick, TextDoubleClick, TextHover

TextHover

개요

이미지에서 특정 텍스트를 찾아 마우스 포인터를 올려놓습니다.

사용 절차

OCR 서버를 이용하여 동작하는 방식으로 디자이너에 계정 로그인이 되어 있어야 사용할 수 있습니다.

액티비티 카드의 No Target을 더블클릭하세요.
마우스 포인터를 올려 놓을 대상 이미지의 범위를 지정하세요.
[Output] Output에 수행 결과를 저장할 변수를 입력하세요.
OCR 그룹 속성에서 원본 이미지 크기의 비율, 검색할 문구를 입력하세요.
그 외 속성에 원하는 값을 지정하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Output	string	-	OCR 수행 결과를 반환합니다.	'Google'

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Search Bounds	문자	N	-	Y	이미지 검색 시 검색할 화면상의 영역을 지정합니다. 대상을 선택하면 해당 범위가 자동으로 지정되며, 직접 수정도 할 수 있습니다.
N	Index	문자	N	-	N	지정한 영역에서 찾은 동일한 문자열이 2개 이상인 경우 몇 번째 문자열을 선택할지 번호를 입력합니다.
Y	IMAGE	Image	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	IMAGE	Bounds	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	Scale	-	-	-	Abbyy 라이브러리의 공통 속성입니다.
Y	OCR	Target Text	-	-	-	Abbyy 라이브러리의 공통 속성입니다.

활용 예시

크롬으로 구를 페이지(www.google.com)를 열고, 구글 로고 이미지가 나타나면 'Google' 문자를 확인하고 마우스 포인터를 올려 놓습니다. 확인한 내용을 메시지로 박스로 출력한 후 크롬 브라우저를 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Abbyy > Mouse Action > P_TextHover_Test

사용된 변수

openBrowser = 실행한 브라우를 지정할 변수
waitImage = 대상 이미지 나타났는지 검사한 결과값을 저장할 변수
textHover = OCR 수행 결과를 저장한 변수
textPoint = 이미지 검색할 범위를 저장한 변수

사용된 속성

[Output] Output = this.textRightClick
Search Bounds = this.textPoint
Scale(%) = 100
Target Text = 'Google'

연관/유사 액티비티

TextClick, TextDoubleClick, TextRightClick