개요

NativeApp 라이브러리는 윈도우즈 어플리케이션(.exe) 파일의 문자열을 가지고와 실행하는 라이브러리 입니다. 
"비표준 UI"로 개발되어 기존의 UI자동화 기술로는 인식할 수 없는 대상 시스템에 대해
다음 신규 라이브러리들을 사용해 자동화를 시도해 볼 수 있습니다.

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

NativeApp에서 문자열 정보를 추출 : GetNativeAppTextList, GetNativeAppTextInfoList
NativeApp에서 추출된 정보를 기반한 마우스 동작 : NativeAppTextClick, NativeAppTextDoubleClick, NativeAppTextRightClick, NativeAppTextHover
NativeApp 내 텍스트 영역 가져오기 : GetNativeAppTextBound
NativeApp 내 텍스트 인식 : NativeAppTextWaitAppear, NativeAppTextWaitDisAppear

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

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

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

NativeApp 라이브러리 설치하기

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

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

공통 속성

INPUT

App 라이브러리의 Find Activity의 Result로 출력된 객체 정보가 필요하기 때문에 항상 Find Activity와 같이 프로세스 수행이 되어야 합니다.

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
NativeApp	객체	Y	-	N	Find Activity의 Result로 출력된 객체 정보를 입력합니다.

MORE OPTION

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
WaitDrawTime	정수	Y	초	Y	대상 Native App의 화면 로딩이 완료되는 최대 시간을 입력합니다. 화면 내 전체 컨트롤이 로딩 완료되는 시간을 의미합니다. (5초 이상 입력 필요)
DrawInterval	정수	Y	밀리초	Y	대상 Native App의 화면 내 각 텍스트간 출력되는 최대 간격을 입렵합니다.
On Error	콤보박스	N	-	N	오류 발생 시 수행할 동작을 지정합니다. - 미지정: 오류를 출력하고 작업을 종료합니다. - Ignore: 해당 오류를 무시합니다. - Retry: 해당 액티비티를 1회 재시도합니다. - Goto: 해당 엑티비티가 실패한 경우 지정한 엑티비티로 이동하여 시나리오를 수행합니다. - Event: 프로젝트에 등록된 이벤트를 호출합니다.

DESCRIPTION

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

GetNativeAppTextList

overview

입력된 NativeApp 객체 내부의 모든 문자열을 리스트로 가지고 옵니다.

사용 절차

NativeApp에 Find Activity의 Result로 받은 객체 변수를 입력합니다.

카드 속성

Array1D_Clone 카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
[Output]Result	리스트	Y	-	N	문자열 리스트를 저장할 변수를 입력합니다.
INPUT	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.
MORE OPTION	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.
DESCRIPTION	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.

예제 파일

메뉴 > 도움말 > 샘플 > Sample > NativeApp > P_GetNativeAppTextList

GetNativeAppTextInfoList

개요

입력된 NativeApp 객체 내부의 모든 문자열과 문자열의 화면상 위치 정보를 리스트로 가지고 옵니다.

사용 절차

NativeApp에 Find Activity의 Result로 받은 객체 변수를 입력합니다.

카드 속성

Array1D_Clone 카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
[Output]Result	리스트	Y	-	N	문자열 정보 리스트를 저장할 변수를 입력합니다.
INPUT	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.
MORE OPTION	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.
DESCRIPTION	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.

예제 파일

메뉴 > 도움말 > 샘플 > Sample > NativeApp > P_GetNativeAppTextInfoList

Output 활용 예

[Output]Result에 변수 this.list 라고 입력했다면 수행후에 리스트를 입력을 받은 후 아래와 같이 활용이 가능합니다.

리스트의 첫번째 아이템의 텍스트 가져오기 : this.list[0].AppText
리스트의 첫번째 아이템의 텍스트 영역 화면 좌표 가져오기 : this.list[0].Bounds
리스트의 첫번째 아이템의 텍스트 영역 x 좌표 가져오기 : this.list[0].Left
리스트의 첫번째 아이템의 텍스트 영역 y 좌표 가져오기 : this.list[0].Top
리스트의 첫번째 아이템의 텍스트 영역 너비값 가져오기 : this.list[0].Width
리스트의 첫번째 아이템의 텍스트 영역 높이값 가져오기 : this.list[0].Height

NativeAppTextClick

개요

입력된 Native App 객체의 텍스트 중 지정된 대상 텍스트를 찾아 해당 영역에 클릭을 수행합니다.

사용 절차

[Output]Result 에 화면에서 검색 성공 시 대상 문자열의 화면 좌표를 저장할 변수를 입력합니다.
NativeApp에 Find Activity의 Result로 받은 객체 변수를 입력합니다.
TargetText에 화면에서 검색하고자 하는 대상 텍스트를 입력합니다.
Index에 대상 텍스트가 동일한 경우 순서를 지정합니다.

카드 속성

Array1D_Clone 카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
[Output]Result	리스트	Y	-	N	화면에서 검색 성공 시 대상 문자열의 화면 좌표(left,top,width,height)를 저장할 변수를 입력합니다.
INPUT	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.
TargetText	문자	Y	-	N	화면에서 검색하고자 하는 대상 텍스트를 입력합니다.
Index	정수	Y	-	Y	대상 텍스트가 동일한 경우 순서를 지정합니다. 화면 왼쪽 상단에 위치할 수록 순서 번호가 낮습니다. 0부터 지정할 수 있습니다.
MORE OPTION	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.
DESCRIPTION	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.

예제 파일

메뉴 > 도움말 > 샘플 > Sample > NativeApp > P_NativeAppTextClick

NativeAppTextDoubleClick

개요

입력된 Native App 객체의 텍스트 중 지정된 대상 텍스트를 찾아 해당 영역에 더블 클릭을 수행합니다.

사용 절차

[Output]Result 에 화면에서 검색 성공 시 대상 문자열의 화면 좌표를 저장할 변수를 입력합니다.
NativeApp에 Find Activity의 Result로 받은 객체 변수를 입력합니다.
TargetText에 화면에서 검색하고자 하는 대상 텍스트를 입력합니다.
Index에 대상 텍스트가 동일한 경우 순서를 지정합니다.

카드 속성

Array1D_Clone 카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
[Output]Result	문자열	Y	-	N	화면에서 검색 성공 시 대상 문자열의 화면 좌표(left,top,width,height)를 저장할 변수를 입력합니다.
INPUT	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.
TargetText	문자열	Y	-	N	화면에서 검색하고자 하는 대상 텍스트를 입력합니다.
Index	정수	Y	-	Y	대상 텍스트가 동일한 경우 순서를 지정합니다. 화면 왼쪽 상단에 위치할 수록 순서 번호가 낮습니다. 0부터 지정할 수 있습니다.
MORE OPTION	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.
DESCRIPTION	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.

예제 파일

메뉴 > 도움말 > 샘플 > Sample > NativeApp > P_NativeAppTextDoubleClick

NativeAppTextRightClick

개요

입력된 Native App 객체의 텍스트 중 지정된 대상 텍스트를 찾아 해당 영역에 우클릭을 수행합니다.

사용 절차

[Output]Result 에 화면에서 검색 성공 시 대상 문자열의 화면 좌표를 저장할 변수를 입력합니다.
NativeApp에 Find Activity의 Result로 받은 객체 변수를 입력합니다.
TargetText에 화면에서 검색하고자 하는 대상 텍스트를 입력합니다.
Index에 대상 텍스트가 동일한 경우 순서를 지정합니다.

카드 속성

Array1D_Clone 카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
[Output]Result	문자열	Y	-	N	화면에서 검색 성공 시 대상 문자열의 화면 좌표(left,top,width,height)를 저장할 변수를 입력합니다.
INPUT	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.
TargetText	문자	Y	-	N	화면에서 검색하고자 하는 대상 텍스트를 입력합니다.
Index	정수	Y	-	Y	대상 텍스트가 동일한 경우 순서를 지정합니다. 화면 왼쪽 상단에 위치할 수록 순서 번호가 낮습니다. 0부터 지정할 수 있습니다.
MORE OPTION	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.
DESCRIPTION	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.

예제 파일

메뉴 > 도움말 > 샘플 > Sample > NativeApp > P_NativeAppTextRightClick

NativeAppTextHover

개요

입력된 Native App 객체의 텍스트 중 지정된 대상 텍스트를 찾아 해당 영역에 마우스를 이동합니다.

사용 절차

[Output]Result 에 화면에서 검색 성공 시 대상 문자열의 화면 좌표를 저장할 변수를 입력합니다.
NativeApp에 Find Activity의 Result로 받은 객체 변수를 입력합니다.
TargetText에 화면에서 검색하고자 하는 대상 텍스트를 입력합니다.
Index에 대상 텍스트가 동일한 경우 순서를 지정합니다.

카드 속성

Array1D_Clone 카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
[Output]Result	문자열	Y	-	N	화면에서 검색 성공 시 대상 문자열의 화면 좌표(left,top,width,height)를 저장할 변수를 입력합니다.
INPUT	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.
TargetText	문자열	Y	-	N	화면에서 검색하고자 하는 대상 텍스트를 입력합니다.
Index	정수	Y	-	Y	대상 텍스트가 동일한 경우 순서를 지정합니다. 화면 왼쪽 상단에 위치할 수록 순서 번호가 낮습니다. 0부터 지정할 수 있습니다.
MORE OPTION	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.
DESCRIPTION	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.

예제 파일

메뉴 > 도움말 > 샘플 > Sample > NativeApp > P_NativeAppTextHover

GetNativeAppTextBound

개요

입력된 Native App 객체의 텍스트 중 지정된 대상 텍스트를 찾아 해당 영역 정보을 가져옵니다.

사용 절차

[Output]Result 에 화면에서 검색 성공 시 대상 문자열의 화면 좌표를 저장할 변수를 입력합니다.
NativeApp에 Find Activity의 Result로 받은 객체 변수를 입력합니다.
TargetText에 화면에서 검색하고자 하는 대상 텍스트를 입력합니다.
Index에 대상 텍스트가 동일한 경우 순서를 지정합니다.

카드 속성

Array1D_Clone 카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
[Output]Result	문자열	Y	-	N	화면에서 검색 성공 시 대상 문자열의 화면 좌표(left,top,width,height)를 저장할 변수를 입력합니다.
INPUT	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.
TargetText	문자열	Y	-	N	화면에서 검색하고자 하는 대상 텍스트를 입력합니다.
Index	정수	Y	-	Y	대상 텍스트가 동일한 경우 순서를 지정합니다. 화면 왼쪽 상단에 위치할 수록 순서 번호가 낮습니다. 0부터 지정할 수 있습니다.
MORE OPTION	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.
DESCRIPTION	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.

예제 파일

메뉴 > 도움말 > 샘플 > Sample > NativeApp > P_GetNativeAppTextBound

WaitAppearNativeAppText

개요

입력된 Native App 객체의 텍스트 중 지정된 대상 텍스트가 화면에 출력될때까지 대기합니다.

사용 절차

[Output]Result 에 화면에서 대상 문자열이 Timeout 내 출력되는지 여부를 저장할 변수를 입력합니다.
NativeApp에 Find Activity의 Result로 받은 객체 변수를 입력합니다.
TargetText에 화면에서 검색하고자 하는 대상 텍스트를 입력합니다.
Index에 대상 텍스트가 동일한 경우 순서를 지정합니다.
Timeout에 최대 대기 시간을 입력합니다.

카드 속성

Array1D_Clone 카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
[Output]Result	True/False	Y	-	N	화면에서 대상 문자열이 Timeout 내 출력되는지 여부를 저장할 변수를 입력합니다.
INPUT	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.
TargetText	문자열	Y	-	N	화면에서 검색하고자 하는 대상 텍스트를 입력합니다.
Index	정수	Y	-	Y	대상 텍스트가 동일한 경우 순서를 지정합니다. 화면 왼쪽 상단에 위치할 수록 순서 번호가 낮습니다. 0부터 지정할 수 있습니다.
Timeout	정수	Y	초	Y	최대 대기 시간을 입력합니다. WaitDrawTime 보다 작은 값은 입력할 수 없습니다.
MORE OPTION	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.
DESCRIPTION	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.

예제 파일

메뉴 > 도움말 > 샘플 > Sample > NativeApp > P_WaitAppearNativeAppText

WaitDisappearNativeAppText

개요

입력된 Native App 객체의 텍스트 중 지정된 대상 텍스트가 화면에 출력되지 않을때까지 대기합니다.

사용 절차

[Output]Result 에 화면에서 대상 문자열이 Timeout 내 출력되지 않는지 여부를 저장할 변수를 입력합니다.
NativeApp에 Find Activity의 Result로 받은 객체 변수를 입력합니다.
TargetText에 화면에서 검색하고자 하는 대상 텍스트를 입력합니다.
Index에 대상 텍스트가 동일한 경우 순서를 지정합니다.
Timeout에 최대 대기 시간을 입력합니다.

카드 속성

Array1D_Clone 카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
[Output]Result	True/False	Y	-	N	화면에서 대상 문자열이 Timeout 내 출력되지 않는지 여부를 저장할 변수를 입력합니다.
INPUT	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.
TargetText	문자열	Y	-	N	화면에서 검색하고자 하는 대상 텍스트를 입력합니다.
Index	정수	Y	-	Y	대상 텍스트가 동일한 경우 순서를 지정합니다. 화면 왼쪽 상단에 위치할 수록 순서 번호가 낮습니다. 0부터 지정할 수 있습니다.
Timeout	정수	Y	초	Y	최대 대기 시간을 입력합니다. WaitDrawTime 보다 작은 값은 입력할 수 없습니다.
MORE OPTION	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.
DESCRIPTION	-	-	-	-	NativeApp 라이브러리 공통 속성입니다.

예제 파일

메뉴 > 도움말 > 샘플 > Sample > NativeApp > P_WaitDisappearNativeAppText