개요
개요
App 라이브러리에서 제공하는 기능을 이용해 프로그램의 화면을 제어할 수 있습니다. Windows가 제공하는 UI 자동화 기술로 화면에 있는 UI 객체를 식별한 후, 사용자가 지정한 대상 UI 객체를 찾아 마우스 입력, 키보드 입력, 앱 실행 및 종료 등 지정한 동작을 수행시킬 수 있습니다. App 라이브러리에서 사용할 수 있는 기능은 다음과 같습니다.
UI 객체 인식: Find, FindAll FindElement, RunAction, SetCheckState, GetBounds, GetCheckState, WaitAppear, WaitDisappear, IsExist, IsVisible, IsRadioSelected, IsCheckState 등
마우스 동작: Click, RightClick, DoubleClick, MouseHover, MouseScroll, DragDrop, MouseDrag, MouseDrop, MouseLongPress, SelectListItem, MouseEvent 등
키보드 동작: SetText, TextInput, KeyInput, KeyboardEvent, GetText 등
실행 및 종료: OpenApp, ActivateApp, CloseApp, CloseAll, OpenWindow, CloseWindow 등
크리덴셜(Credential) 관련: CredentialSetText, CredentialTextInput
윈도우 메세지 전달: SendWindowsMessage, SendWindowsCopyData
일부 액티비티 카드들에서는 UI 자동화 기술로 객체를 찾지 못한 경우, 이미지 기반 탐색으로 UI 객체를 찾는 기능을 지원합니다
이미지 기반 탐색을 지원: Click, RightClick, DoubleClick, MouseHover, MouseScroll, DragDrop, MouseDrag, MouseDrop, MouseLongPress, GetText, SetText, TextInput, GetCheckState, SetCheckState, IsCheckState, IsRadioSelected, Find, IsExist, IsVisible, GetHiearchyInfo, GetListItems, SelectListItem, GetGridItems, GetBounds, OpenWindow, CloseWindow, WaitAppear, WaitDisappear, SendWindowsShortCut, SendWindowsMessage, SendWindowsCopyData 등
UI 자동화 기술로 인식할 수 없는 비 표준 UI의 경우 GuiDetector의 추가설치로 비 표준 UI 객체 인식기능을 사용할 수 있습니다
비 표준 UI 객체 인식 : GuiDetectorFindAll, GuiDetectorClick, GuiDetectorDoubleClick, GuiDetectorRightClick, GuiDetectorMouseHover, GuiDetectorTextInput, GuiDetectorGetBounds
대상 앱이 일반적인 개발 방식을 따르지 않는 경우, App 라이브러리가 의도대로 동작하지 않을 수 있습니다.
App 라이브러리에 대한 샘플을 디자이너 혹은 윈도우 탐색기를 이용하여 참조할 수 있습니다.
• 디자이너 경로: 메뉴 > 도움말 > 샘플 > Sample > Application
• 윈도 탐색기 경로: C:\Users\user\AppData\Roaming\Brity RPA Designer\samples\Application
[Application 샘플 프로젝트명과 관련 라이브러리]
• : Find, FindElement, FindAll, SelectMenu, SelectComboBox Find Target
• Get Target Detail: GetBounds, GetGridItemIndex, GetGridItems, GetHierachyInfo, GetListItemIndex, GetListItems, GetText
• Keyboard Action: KeyInput, KeyboardEvent, SetText, TextInput
• Manage Application State: GetCheckState, SetCheckState, IsCheckState, IsRadioSelected
• Manage Application: ActivateApp, CloseAll, CloseApp, OpenApp
• Manage Window: CloseWindow, OpenWindow
• Mouse Action: Click, DoubleClick, MouseEvent, MouseHover, MouseScroll, RightClick, DragDrop, MouseDrag, MouseDrop, MouseLongPress
• Wait Application Target: WaitAppear, WaitDisappear
• Other Samples: IsExist, IsVisible, RunAction, SelectListItem, SendWindowsShortCut,
SendWindowsMessage, SendWindowsCopyData, ExecuteRenoteDesktopWindow
객체 지정하기
UI 객체를 지정하는 라이브러리의 경우 액티비티 카드의 우측 영역에 대상 UI 객체를 지정할 수 있는 대상 지정 버튼이 표시됩니다.
버튼을 더블 클릭하면 UI객체 지정 모드로 전환되어 디자이너가 최소화되고, 마우스를 사용하여 원하는 대상 UI 객체를 지정할 수 있습니다.
UI 객체를 지정 모드에서는 다음과 같은 기능을 단축키를 통해 제공하고 객체의 기본 정보를 안내합니다.
마우스를 원하는 대상 UI 객체 위에 위치시키면 아래와 같이 대상 UI객체의 영역을 표시되고 마우스를 클릭하면, 객체 인식 어시스턴트 창이 표시되고, 해당 UI객체의 정보를 확인할 수 있습니다. 어시스턴트 창에서 객체 지정을 확정하면, 선택된 최종 객체 속성이 액티비티에 반영된 것을 디자이너에서 확인할 수 있습니다.
객체 인식 어시스턴트에 대해 더욱 자세한 정보를 살펴보려면, 객체 인식 어시스턴트 절을 참고하세요.
[설정 > 객체지정 > 객체 정보 툴팁 보기] 옵션을 사용함으로 설정하면 대상 UI 객체 영역 표시와 함께 현재 지정된 대상 UI객체의 정보와 적합성 정보를 함께 표시합니다.
안정적인 자동화 실행을 위해서 대상 UI객체 지정시 대상을 유일하게 식별할 수 있는 정보를 가진 대상을 지정하는 것이 중요합니다.
일반적으로 Name 혹은 Value 의 정보를 가지고 있으며 화면 구조상 더 이상의 하위 컨텐츠를 가지지 않는 최하위 UI 객체를 선택할수록 대상 UI객체를 좀 더 정확하게 찾을 확률이 높습니다.
대상 UI 객체 비교하기
대상 UI 객체가 지정된 액티비티의 객체 지정 버튼을 더블 클릭하여 [객체 비교]를 실행하여 액티비티의 대상 UI 객체 정보와 화면에서 선택한 UI객체의 정보를 비교해 볼 수 있습니다.
대상 UI 객체 재지정하기
대상 UI 객체가 지정된 액티비티의 객체 지정 버튼을 더블 클릭하면 대상 UI객체를 재지정 할 수 있습니다. 재지정 버튼을 누르고 최초 UI객체 지정시와 동일하게 대상 UI객체를 선택하여 변경합니다.
대상 UI 객체 추가하기
대상 UI 객체가 지정된 액티비티의 객체 지정 버튼을 더블 클릭하여 대상 UI 객체의 정보를 비교하거나 재지정하여 변경 혹은 추가 지정할 수 있습니다.
액티비티의 객체 정보가 2개 이상인 경우 속성창에 표시되는 페이지의 속성 정보를 이용하여 객체를 검색합니다. 만약 객체를 찾지 못하면 다음 페이지의 속성 정보를 이용하여 다시 객체를 검색합니다.
예를 들어, 위 그림과 같은 경우 2페이지 속성의 '메모.txt - Windows 메모장' 이라는 Title의 notepad 프로그램에서 '서식(O)' 라는 Name 속성을 이용하여 UI객체를 검색하는데, 실패할 경우 1페이지 속성에 따라 Title 과 관계없이 '서식(O)' Name 속성으로 대상 UI객체를 검색하도록 할 수 있습니다.
공통 속성
공통 속성
TARGET
타깃(UI 객체)과 관련된 속성을 설정할 수 있습니다.
속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|
Application | 문자 | Y | - | Y | 대상 객체의 윈도우 앱 이름이 자동으로 입력됩니다. 예) iexplore, notepad |
Type | 문자 | Y | - | Y | 대상 객체의 윈도우 클래스 타입이 자동으로 입력됩니다. 예) Button, Calendar, Grid, Image, Page, MenuItem 등 |
Index | 숫자 | N | - | Y | 동일한 정보＊를 가진 객체 목록 중 대상 객체를 식별하기 위한 색인을 숫자로 입력합니다. 대상 객체를 지정할 때 인덱스 확인을 묻는 팝업 창에서 예를 선택하면 자동으로 입력됩니다. ＊동일한 정보는 액티비티 카드의 속성 중 Application, Type, Title, Name, Value, Object Path, Legacy Value를 의미합니다. |
Title | 문자 | Y | - | Y | 대상 객체가 있는 앱 화면의 타이틀이 자동으로 입력됩니다. 여러 개의 앱이 동시에 실행되어 있는 경우에는 이 값과 일치하는 화면이 선택됩니다. 변수, Javascript 코딩 키워드를 입력할 수 있습니다. |
Name | 문자 | Y | - | Y | 대상 객체 속성의 이름을 의미합니다. 앱의 구동 방식에 따라 값이 있어도 나타나지 않을 수 있습니다. 변수, Javascript 코딩 키워드를 입력할 수 있습니다. |
Value | 문자 | Y | - | Y | 대상 객체가 가지고 있는 값 정보가 나타납니다. 앱의 구동 방식에 따라 값이 있어도 나타나지 않을 수 있습니다. 변수, Javascript 코딩 키워드를 입력할 수 있습니다. |
Image | 이미지 | N | - | Y | 대상 객체와 주변 화면의 이미지가 나타납니다. |
Size | 숫자 | N | 픽셀 | Y | 대상 객체의 위치와 크기가 실행된 앱 화면의 좌상단 기준 좌표로 나타납니다. (단위: 픽셀) X: 가로, Y:세로, W: 너비, H: 높이 |
TreeScope | 콤보박스 | N | - | Y | 대상 객체를 검색할 범위를 설정합니다. - Descendants: 자손(하위 객체 모두) - Child: 자식 - Parent: 부모 - Ancestors: 조상(상위 객체 모두) |
Class Name | 숫자 | N | 픽셀 | N | 대상 객체 검색 시 사용할 클래스 이름을 지정합니다. |
IMAGE OPTION
UI 자동화 기술로 타깃(UI 객체) 찾을 수 없는 경우, 현재 화면에 보여지는 전체 스크린 이미지 상에서 타깃 객체를 이미지 기반 비교 방식으로 탐색 할 수 있습니다. 이를 위해 사용자는 타깃을 지정할 때, Image 속성을 정확히 조정하여 탐색할 이미지 모양을 지정해야 합니다..
속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|
Use Image Match | 콤보박스 | N | - | Y | 이미지 기반 객체 탐색을 사용할 기준을 설정합니다. - NotUse: 항상 이미지 기반 탐색은 사용하지 않음 - Always: 항상 이미지 기반 탐색을 사용함 - WhenFailed: 자동화 기술로 객체 찾기에 실패한 경우에만 이미지 기반 탐색을 사용함. |
Image Index Method | 콤보박스 | N | - | Y | 이미지 기반 객체 탐색의 결과가 여러 개 일 때, 결과들을 정렬하는 방법을 설정합니다. - JustBest: 가장 비교 점수가 높은 하나만 사용 - RowFirst: 화면의 행 우선 순서로 정렬(상->하) - ColumnFirst: 화면의 열 우선 순서로 정렬(좌->우) - ScoreOrderRow: 비교 점수 높은 순서, 동점인 경우 행 우선(상->하) 순서로 정렬. - ScoreOrderColumn: 비교 점수 높은 순서, 동점인 경우 열 우선(좌->우) 순서로 정렬. |
Select Image Index | 숫자 | N | - | N | 이미지 기반 객체 탐색의 결과가 여러 개 일 때, 정렬된 목록에서 최종으로 사용할 결과의 색인 순서를 설정합니다. 0 부터 시작하는 정수 값 입니다. 결과 개수 범위를 벗어나는 값은 자동으로 결과 개수에 맞춰 변환되어 동작합니다 |
• 보통 이미지 기반 객체 탐색은 자동화 기술로 객체 탐색이 실패한 경우 등에 실행되므로, 탐색 과정의 가장 마지막에 일어나게 됩니다. 따라서, Timeout속성 값이 너무 작아서 이미지 기반 탐색이 시작되기 전에, 만료 시간이 되버리면, 이미지 기반 탐색을 사용하지 못하고 객체 탐색이 실패하게 됩니다.
• 가능하면, MORE OPTION 에 있는 Timeout 시간을 충분한 값으로 설정하세요.
이미지 기반 탐색을 위해 Image 속성의 이미지 모양을 정밀하게 설정하려면, Image 속성의 그림 부분을 더블 클릭하여, 이미지 속성 상세 보기 창을 띄웁니다.
Excel_NewExcel_1K
이미지 상세 보기 창에서는, 실제 이미지 비교에 사용할 이미지 영역을 다시 지정할 수 있으며, 마우스로 클릭할 위치도 지정할 수 있습니다. 만약, 이미지 영역이 부적절한 경우에는, 현재 화면을 기준으로 다시 화면 영역을 캡쳐 할 수 있습니다.
정확한 이미지 기반 비교를 위해서는 최대한 정밀하게 비교할 이미지 영역을 설정하세요.
MORE OPTION
타깃(UI 객체) 외의 속성이나 액티비티 카드의 기능 실행(Action) 관련 속성을 설정할 수 있습니다.
속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|
Timeout(Sec) | 숫자 | Y | 초 | Y | 대상 객체를 찾는 시간을 초 단위로 입력할 수 있습니다. 설정한 시간 내에 탐지에 성공하면 True, 탐지에 실패하면 False로 결괏값을 반환합니다. |
Object Path | 문자 | Y | - | Y | 대상 객체의 윈도우상의 경로 정보가 자동으로 입력됩니다. 객체를 경로 정보로 찾아서 식별할 때 사용할 수 있습니다. 윈도우상의 경로 정보를 더 알아보기 위해서는 디자이너 메뉴의 도구 > Inspector를 참고하세요. '@'를 입력하면 Xpath 구문으로 간주합니다. |
Focus Before | 토글버튼 | N | - | Y | 액티비티 카드가 작동하기 전에 전에 대상 객체에 포커스를 설정할 수 있습니다. 대상 객체에 포커스를 설정할 수 없는 경우에는 대상 앱의 메인 화면에 포커스를 설정합니다. 대상 앱이 여러 개가 실행되어 있는 경우에는 가장 앞에 위치한 앱에서부터 객체를 탐색합니다. 대상 객체를 찾지 못하면 뒤에 위치한 앱을 앞으로 가지고 온 다음 다시 탐색합니다. |
Draw Bounds | 토글버튼 | N | - | Y | 실행 시 객체를 인식하는 박스(테두리)가 표시되도록 설정합니다. |
Ignore off-screen objects | 토글버튼 | N | - | N | 화면을 벗어난 객체는 검사 대상에서 제외하도록 설정합니다. 사용 함으로 설정하더라도 제한시간동안 화면에서 대상객체를 찾을 수 없는 경우에는 모든 객체를 확인합니다. |
Invoke/Click | 토글버튼 | N | - | Y | 대상 객체가 버튼이나 링크 같은 API 형태를 지원할 때, Invoke API 호출 방식이나 마우스 클릭 방식을 선택할 수 있습니다. |
onError | 콤보박스 | N | - | Y | 오류 발생 시 처리 방법을 선택합니다. - Ignore: 해당 오류를 무시하고 진행합니다. - Retry: 해당 작업을 1회 재시도합니다. - Goto: 해당 액티비티가 실패한 경우 지정한 액티비티로 이동하여 시나리오를 수행합니다. - _Event: 프로젝트 내에 작성된 이벤트를 선택합니다. |
GotoStep Relative Position | 숫자 | N | - | N | 해당 액티비티를 기준으로 이동할 액티비티를 선택합니다. Ctrl + F 를 통해 액티비티 번호를 확인 후 [해당 액티비티 번호] - [대상 액티비티 번호] 값을 입력합니다. (기본값: 0) |
GotoStep Retry Count | 콤보박스 | N | - | N | 해당 액티비티가 실패한 경우 지정된 횟수만큼 이동을 반복합니다. (기본값: 1) |
Origin Point | 콤보박스 | N | - | Y | Click Point의 상대좌표 계산 시 사용되는 원점을 설정할 수 있습니다. - LeftTop: 좌측 상단 모서리 - RightTop: 우측 상단 모서리 - LeftBottom: 좌측 하단 모서리 - RightBottom: 우측 하단 모서리 - Center : 화면 중앙 |
Relative Origin | 콤보박스 | N | - | Y | 상대좌표에 사용핳 대상 객체의 원점(객체의 4개 모서리)을 설정합니다. - LeftTop: 좌측 상단 모서리 - RightTop: 우측 상단 모서리 - LeftBottom: 좌측 하단 모서리 - RightBottom: 우측 하단 모서리 - Center: 화면 중앙 |
Click Point | 문자 | N | 픽셀 | Y | 마우스 포인터가 위치할 좌표를 객체의 Origin Point를 기준으로 하는 상대 좌표를 'x, y' 형태의 문자열로 입력합니다. (단위: 픽셀) X: 가로, Y: 세로 |
Relative Point | 문자 | N | 픽셀 | Y | 대상 객체의 Origin Point를 기준으로 하는 상태 좌표 'x, y'형태의 문자열로 입력합니다. (단위: 픽셀) X: 가로, Y:세로 |
Raw Event | 토글버튼 | N | - | Y | 키보드 보안 프로그램을 사용하는 소프트웨어에서 사용이 가능하며, 공인인증서를 포함한 일반적인 윈도우 API 키 입력이 막혀있는 환경에서 활용할 수 있습니다. Raw Event 활용을 위해서는 Keyboard Device Driver가 설치되어 있어야 합니다. |
BeforeDelay(ms) | 숫자 | N | msec | Y | 단축키 실행 전 지연시간을 입력합니다. |
AfterDelay(ms) | 숫자 | N | msec | Y | 단축키 실행 후 지연시간을 입력합니다. |
ShortCutName | 문자 | N | - | Y | 단축키 명을 입력합니다. |
LEGACY
타깃(UI 객체) 의 Legacy 관련 속성이나 액티비티 카드의 기능 실행(Action) 관련 속성 중 Legacy 관련 속성을 설정할 수 있습니다.
속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|
Legacy Name | 문자 | N | - | N | 객체의 Legacy Name 속성 입니다. |
Legacy Value | 문자 | N | - | N | 객체의 Legacy Value 속성 입니다. |
Legacy Description | 문자 | N | - | N | 객체의 Legacy Description 속성 입니다. |
Legacy Help | 문자 | N | - | N | 객체의 Legacy Help 속성 입니다. |
DESCRIPTION
속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|
Description | 문자 | N | - | N | 해당 액티비티 카드에 대한 설명을 추가합니다. Description이 입력되면 플로차트의 해당 액티비티 설명에 표시되고, Description이 없는 경우에는 대푯값이 해당 액티비티 설명에 표시됩니다. |
Click
Click
개요
대상 UI 객체를 마우스 왼쪽 버튼으로 클릭합니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
클릭할 대상 UI 객체에 마우스 포인터를 올린 뒤 빨간색 테두리가 나타나면 클릭하여 선택하세요.
• 대상 UI 객체를 검색할 때에는 먼저 대상 UI 객체 지정 시 기록된 마우스의 위치에 있는 UI 객체가 대상 UI 객체의 정보와 일치하는지 확인합니다. 일치하지 않을 경우 대상 UI 객체의 상위 경로를 따라 내려가는 방식으로 찾습니다. 이 방식으로도 대상 UI 객체를 찾지 못할 경우, 대상 앱 내의 모든 UI 객체 정보를 수집한 후 대상 UI 객체의 정보와 비교하여 대상 UI 객체를 찾습니다.
• 하위 UI 객체를 가지는 경우 주황색 테두리가 나타납니다. 단, 대상을 안정적으로 검색하려면 하위 UI 객체를 가지지 않는 UI 객체를 지정하세요. 하위 UI 객체를 가질 경우 레코딩 시점의 화면 구성과 자동화 수행 시점의 화면 구성이 달라질 경우 대상을 검색하기 어려울 수 있습니다. 불가피하게 하위 UI 객체를 지정해야 하는 경우에는 자동화 수행 시 화면 구성이 변경될 경우를 고려하여 신중하게 지정하세요.
• 다른 UI 객체를 누른 후 대상 UI 객체를 선택해야 하는 경우, 또는 화면을 이동한 후 대상 UI 객체를 지정해야 하는 경우에는 키보드의 Ctrl 키를 누르세요. 객체 지정을 일시 정지 및 다시 시작할 수 있습니다.
• 대상 UI 객체 지정 시 마우스를 누른 시점에 테두리가 표시된 객체가 검색 대상이 되며, 마우스를 놓은 시점의 위치가 대상 UI 객체의 좌측 상단을 기준 상대좌표로 기록됩니다. 이를 활용하면 대상 UI 객체의 정보가 불분명한 경우 주변의 특정 가능한 객체를 지정한 후, 상대좌표의 위치로 마우스를 클릭할 수 있습니다. 이 기능은 객체 인식 어시스턴트 기능이 사용되는 경우 작동하지 않습니다. 객체 인식 어시스턴트의 핀 객체 지정 기능을 대신 사용하세요.
• UI 객체 테두리로 인해 팝업 화면이 사라지거나 대상 앱이 오동작하는 경우 키보드의 Alt 키를 한 번 눌러 객체 테두리가 표시되지 않도록 하세요. 한 번 더 누르면 테두리를 다시 표시합니다.
대상 UI 객체를 확인, 변경, 추가하려면 액티비티 카드 상에 나타나는 대상 UI 객체의 캡처 화면을 더블클릭한 후 "Find" 팝업창에서 스텝 실행 또는 재지정 , 객체 추가를 클릭하세요.
스텝 실행: 지정된 대상 UI 객체를 확인할 수 있습니다. 대상 UI 객체에 빨간색 테두리가 3초간 깜박거린 후 사라집니다.
속성 창의 객체 정보에 변수를 입력한 경우에는 검사를 수행할 수 없습니다. 이 경우, 액티비티 카드를 마우스 오른쪽 버튼으로 클릭한 후 한단계 실행을 클릭하면 해당 해당 액티비티 카드만 실행됩니다.
재지정: 대상 UI 객체를 재지정할 수 있습니다.
객체 추가: 대상 UI 객체를 추가할 수 있습니다. 추가할 경우 속성 화면에서 추가된 대상 UI 객체들을 선택할 수 있습니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
UI 객체를 클릭하는 기능을 수행합니다. Notepad 앱을 실행하여 파일 메뉴를 클릭한 후 끝내기 항목을 클릭합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Mouse Action > P_Click_Test_Notepad
사용된 변수
없음
사용된 속성
없음
연관/유사 액티비티
RightClick
RightClick
개요
대상 UI 객체를 마우스 오른쪽 버튼으로 클릭합니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
마우스 오른쪽 버튼 클릭을 지원하는 대상 객체를 클릭하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
해당 객체를 선택한 후 마우스 오른쪽 버튼을 클릭하여 해당 기능을 실행합니다. Notepad 앱을 실행한 후 본문 영역을 마우스 오른쪽 버튼으로 클릭해서 메뉴를 엽니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Mouse Action > P_RightClick_Test_Notepad
사용된 변수
없음
사용된 속성
없음
연관/유사 액티비티
DoubleClick
DoubleClick
개요
대상 UI 객체를 더블클릭합니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
더블클릭할 대상 객체를 선택하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
객체를 더블클릭하여 해당 기능을 실행합니다. Notepad 앱을 실행하여 텍스트를 입력한 후 입력한 텍스트를 더블클릭해서 선택합니다. 선택된 텍스트를 복사 및 붙여넣기한 후 앱을 종료합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Mouse Action > P_DoubleClick_Test_Notepad
사용된 변수
없음
사용된 속성
없음
연관/유사 액티비티
MouseHover
MouseHover
개요
대상 UI 객체 위에 마우스 포인터를 올려놓습니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
마우스 포인터를 올려 놓을 대상 객체를 선택하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
원하는 부분에 마우스 포인터를 위치시킵니다. Notepad 앱을 실행한 후 원하는 부분에 마우스 포인터를 위치시킵니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Mouse Action > P_MouseHover_Test_Notepad
사용된 변수
없음
사용된 속성
없음
연관/유사 액티비티
MouseDrag, MouseDrop, MouseLongPress
MouseScroll
MouseScroll
개요
대상 UI 객체를 설정한 횟수와 간격만큼 마우스 스크롤합니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
스크롤할 대상 객체를 지정하세요.
Wheel Value에 스크롤을 내리거나 올릴 횟수를 입력하세요.
Wheel Interval(ms)에 스크롤을 수행할 간격을 입력하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Wheel Value | 숫자 | Y | - | Y | 스크롤을 내리거나 올릴 횟수를 입력합니다. 정수만 입력할 수 있습니다. - 양수: 스크롤 내림 - 음수: 스크롤 올림 |
N | Wheel Interval(ms) | 숫자 | Y | ms | Y | 스크롤 수행 간격을 입력합니다.(단위: ms) |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
마우스 스크롤 기능을 적용합니다. 브라우저를 연 후 마우스 스크롤 기능으로 화면 하단으로 이동한 다음 브라우저를 닫습니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Mouse Action > P_MouseScroll_Test_Web
사용된 변수
없음
사용된 속성
Wheel Value = 3
Wheel Interval(ms) = 500
연관/유사 액티비티
DragDrop
DragDrop
개요
지정된 객체를 마우스 드래그 앤 드롭(끓어다 놓기) 기능으로 지정된 위치로 이동합니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
드래그 앤 드롭할 대상 객체를 선택하세요.
Hold Time(ms)에 마우스 버튼 다운(Down) 동작 후 업(Up) 동작 전까지의 대기 시간을 입력하세요.
Drop Point에 대상 객체를 드래그 앤 드롭할 좌표 정보를 입력하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Hold Time(ms) | 숫자 | N | ms | Y | 마우스 버튼을 누르고(Down) 뗄(Up) 때까지의 대기 시간)을 입력합니다. (기본값: 100) |
N | Drop Point | 문자 | Y | - | N | 대상 UI 객체를 드래그 앤 드롭할 좌표 정보를 입력합니다. 영역 정보(x, y, width, height 형태)를 입력하면 중심점이 사용됩니다. GetBounds 액티비티를 이용하여 값을 가져올 수 있습니다. |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
지정한 객체를 드래그 앤 드롭하여 원하는 위치로 이동합니다. 웹 페이지를 열고 "Brity Works" 텍스트를 선택하여 "Drop it here" 영역에 드래그 앤 드롭한 후 웹 페이지를 닫습니다.
Excel_NewExcel_1K
활용 Tip
Drop Point의 값 선정 방법 : mouse의 point 값을 Message 박스로 찍어보면 됨 1) Target의 위치가 명확한 경우에는 GetBounds 카드를 활용하여 값을 추출 2) Target의 위치가 불명확한 경우에는 원하는 곳에 마우스 커스를 위치한 다음 Mouse.Position 값을 MessageBox 카드로 찍어봄
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Mouse Action > P_DragDrop_Test
사용된 변수
point = 객체를 이동시킬 영역 정보
사용된 속성
Hold Time(ms) = 100
Drop Point =
this.point
연관/유사 액티비티
MouseDrag
MouseDrag
개요
지정된 객체를 마우스로 드래그하여 이동합니다.
사용 절차
MouseDrop과 함께 사용합니다.
액티비티 카드의 No Target을 더블클릭하세요.
드래그할 대상 객체를 선택하세요.
Hold Time(ms)에 마우스 버튼 다운(Down) 동작 후의 대기 시간을 입력하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Hold Time(ms) | 숫자 | N | ms | Y | 마우스 버튼 다운(Down) 동작 후의 대기 시간을 입력합니다. (기본값: 100) |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
웹 페이지를 열고 이동을 원하는 부분을 선택하여 드래그합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Mouse Action > P_MouseDrag_MouseDrop_Test
사용된 변수
없음
사용된 속성
Hold Time(ms) = 100 (기본값)
연관/유사 액티비티
MouseDrop
MouseDrop
개요
드래그된 객체를 지정된 객체에 드롭합니다.
사용 절차
MouseDrag와 함께 사용합니다.
액티비티 카드의 No Target을 더블클릭하세요.
드롭할 대상 객체를 선택하세요.
Hold Time(ms)에 마우스 버튼 업(Up) 동작 전의 대기 시간(ms)을 입력하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Hold Time(ms) | 숫자 | N | ms | Y | 마우스 버튼 업(Up) 동작 전의 대기시간을 입력합니다. (기본값: 100) |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
웹 페이지 내에서 MouseDrag로 선택한 객체를 이동하길 원하는 부분을 선택하여 이동합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Mouse Action > P_MouseDrag_MouseDrop_Test
사용된 변수
없음
사용된 속성
Hold Time(ms) = 100 (기본값)
연관/유사 액티비티
MouseLongPress
MouseLongPress
개요
대상 UI 객체를 마우스 포인터로 길게 누릅니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
마우스 포인터가 위치할 객체를 선택하세요.
Hold Time(ms)에 마우스 버튼을 누르고 있을 시간을 입력하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Hold Time(ms) | 숫자 | N | ms | Y | 마우스 버튼을 누르고 있을 시간을 입력합니다. (기본값: 1000) |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
메뉴가 나오게 하거나 객체를 이동시킬 때 활용할 수 있습니다. 웹 페이지를 열고 이동을 원하는 객체를 선택하여 다른 부분으로 이동시킵니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Application > Mouse Action > P_DragDrop_Test
사용된 변수
없음
사용된 속성
Hold Time(ms) = 1000 (기본값)
연관/유사 액티비티
MouseHover, MouseDrag, MouseDrop
SelectListItem
SelectListItem
개요
콤보박스 또는 리스트에서 특정 항목을 선택합니다.
사용 절차
대상의 속성이 ListItem 타입인 경우에만 사용할 수 있습니다.
액티비티 카드의 No Target을 더블클릭하세요.
대상 객체(콤보박스 또는 리스트)를 지정하세요.
Name에 선택할 항목을 입력하세요.
값으로 찾으려면 Value에 선택할 항목을 입력하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
Notepad 앱을 실행한 후 서식의 글꼴 목록에서 원하는 글꼴과 크기를 선택하고 앱을 종료합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Other Samples > P_SelectListItem_Test_Notepad
사용된 변수
없음
사용된 속성
없음
특이 사항
대상 UI 객체가 ListItem 타입인 경우에도 대상 앱의 구현 방식에 따라 동작하지 않거나 정보가 변경되지 않을 수 있으므로 주의가 필요합니다.
연관/유사 액티비티
GetListItems, GetGridItemIndex
SetText
SetText
개요
대상 UI 객체에 텍스트를 입력합니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
텍스트를 입력할 대상 객체를 선택하세요.
Input Text에 텍스트를 입력하세요.
대상 UI 객체가 Value Pattern을 지원하고 읽기 전용이 아닌 경우에만 사용할 수 있습니다.
UI 객체의 Pattern 정보는 객체가 제공하는 기능적 특성 정보를 나타내는 것으로 Value Pattern 을 지원하는 대상 UI 객체를 지정하면 속성창의 Supported Pattern 에서 Value 항목이 포함되는 것을 확인할 수 있습니다.
SetText 의 대상 UI 객체 지정시에 Value Pattern 을 지원하지 않는 UI 객체에 대해서는 다음과 같이 지정 불가로 표시되어 대상을 지정할 수 없습니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Input Text | 문자 | Y | - | N | 대상에 입력하고자 하는 문자열을 작은따옴표 내에 기입합니다. 문자열이 변수 처리된 경우 변수명을 기입합니다. -Normal: 일반 텍스트로 입력합니다. -Secure: 입력한 값이 암호화되어 저장됩니다. 비밀번호 등 암호화가 필요한 경우에 선택합니다. |
N | Done(Enter) | 토글버튼 | N | - | N | 텍스트를 입력한 후 Enter 키 기능을 사용할지 선택합니다. (기본값: 미사용 - 회색) |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
Notepad 앱을 실행하여 본문 영역을 입력 대상(Target)으로 지정한 후 "Set Text" 문구를 입력합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Keyboard Action > P_SetText_Test_Win10_Notepad
사용된 변수
없음
사용된 속성
Input Text = 'Set Text'
연관/유사 액티비티
TextInput
TextInput
개요
대상 UI 객체에 텍스트를 입력합니다.
사용 절차
유니코드에서 지원하지 않는 문자의 경우 입력되지 않을 수 있습니다.
액티비티 카드의 No Target을 더블클릭하세요.
텍스트를 입력할 대상 객체를 선택하세요.
Input Text 항목에 텍스트를 입력하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Input Text | 문자 | Y | - | N | 대상에 입력하고자 하는 문자열을 작은따옴표 내에 기입합니다. 문자열이 변수 처리된 경우 변수명을 기입합니다. -Normal: 일반 텍스트로 입력합니다. -Secure: 입력한 값이 암호화되어 저장됩니다. 비밀번호 등 암호화가 필요한 경우에 선택합니다. |
N | Clear Before | 토글버튼 | N | - | Y | 텍스트를 입력하기 전에 입력란에 있는 텍스트를 모두 삭제할지 선택합니다. (기본값 : 사용 - 청색) |
N | Done(Enter) | 토글버튼 | N | - | Y | 텍스트를 입력한 후 Enter 키 기능을 사용할지 선택합니다. (기본값: 미사용 - 회색) |
N | Before Delay(ms) | 숫자 | N | ms | Y | 문자열을 입력하기 전의 대기 시간을 입력합니다.(기본값: 0) |
N | After Delay(ms) | 숫자 | N | ms | Y | 문자열을 입력한 후의 대기 시간을 입력합니다.(기본값: 0) |
N | Interval(ms) | 숫자 | N | ms | Y | 한 문자를 입력하는 간격을 설정합니다.(기본값: 0) |
N | Retry Count | 숫자 | N | Y | 입력이 성공적으로 완료되지 않은 경우, 자동으로 재시도하는 최대 횟수를 설정합니다.(기본값: 1) 값이 0 인 경우, 입력 성공 검증을 진행하지 않습니다. | |
N | Raw Event | 토글버튼 | N | - | Y | 저수준 키보드 이벤트를 이용한 문자열 입력 여부를 선택합니다. (기본값 : 미사용 - 회색) |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
Rerty Count 속성은 입력할 텍스트 필드가 패스워드를 입력하는 필드인 경우에는 동작하지 않으며, 해당 속성은 보이지 않습니다.
Raw Event 속성을 사용으로 선택하면 가상키보드의 설치 유무에 따라 동작방식이 결정됩니다.
가상 키보드를 설치한 경우 가상 키보드를 통해 하드웨어 이벤트를 발생시켜 키보드 입력을 수행합니다.
가상 키보드가 설치되지 않은 경우에는 윈도우즈의 키보드 이벤트 API를 이용하여 키보드 입력을 수행합니다.
속성을 미사용으로 선택하면 윈도우즈의 문자 입력 API를 이용하여 문자 입력을 수행합니다.
활용 예시
Notepad 앱을 실행하여 본문 영역을 입력 대상(Target)으로 지정한 후 "Input Text" 문구를 입력합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Keyboard Action > P_TextInput_Test_Win10_Notepad
사용된 변수
없음
사용된 속성
Input Text = 'Input Text' (Normal)
Clear Before = False
Done(Enter) = False
Before Delay(ms) = 0
After Delay(ms) = 0
Interval(ms) = 0
Retry Count = 0
특이 사항
유니코드에서 지원하지 않는 문자의 경우 입력되지 않을 수 있습니다.
{{KeyCode}} 형태의 키워드를 이용하여 문자열 사이에 키보드 이벤트를 발생시킬 수 있습니다. 예를 들어, {{Enter}}는 키보드의 Enter 키를 누르는 동작이고, {{+Enter}}와 {{-Enter}}는 각각 키 다운과 업 동작을 나타냅니다. {{}} 사이에 입력할 키워드는 아래 링크를 참고하세요.
입력이 정상적으로 완료되지 않아서 재시도 되는 경우에는, 문자 입력 간격 시간(Interval 속성)이 자동으로 증가되어 수행됩니다.
연관/유사 액티비티
CredentialSetText
CredentialSetText
개요
지정한 패스워드 속성의 대상에 크리덴셜(Credential) 데이터를 입력합니다. 크리덴셜 리소스 이외에는 입력 데이터로 사용할 수 없습니다. 패스워드 속성이 없는 객체는 지정할 수 없습니다.
사용 절차
서버 포털에서 System > 공용 리소스 관리에서 크리덴셜(Credential) 유형의 리소스를 등록해야 합니다.
액티비티 카드의 No Target을 더블클릭하세요.
패스워드 속성이 있는 객체 중에서 원하는 객체를 선택하세요.
Input Text에 크리덴셜(Credential) 유형의 공용 리소스를 선택하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Input Text | 콤보박스 | Y | - | N | 입력할 크리덴셜(Credential) 공용 리소스를 선택합니다. |
N | Done(Enter) | 토글버튼 | N | - | N | 텍스트를 입력한 후 Enter 키 기능을 사용할지 선택합니다. (기본값 : 미사용-회색) |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
특이 사항
크리덴셜 리소스를 사용하는 것 외에 기본 사용법은 SetText 액티비티 카드와 동일합니다.
연관/유사 액티비티
CredentialTextInput
CredentialTextInput
개요
지정한 패스워드 속성의 대상에 크리덴셜(Credential) 데이터를 입력합니다. 크리덴셜 리소스 이외에는 입력 데이터로 사용할 수 없습니다. 패스워드 속성이 없는 객체는 지정할 수 없습니다.
사용 절차
서버 포털에서 System > 공용 리소스 관리에서 크리덴셜(Credential) 유형의 리소스를 등록해야 합니다.
액티비티 카드의 No Target을 더블클릭하세요.
패스워드 속성이 있는 객체 중에서 원하는 객체를 선택하세요.
Input Text에 크리덴셜(Credential) 유형의 공용 리소스를 선택하세요.
Clear Before(입력란 비우기 여부), Before Delay(ms)(입력 전 대기 시간), After Delay(ms)(입력 후 대기 시간), Interval(ms)(입력 간격) 속성 등을 설정하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Input Text | 콥보박스 | Y | - | N | 입력할 Credential 공용 리소스를 선택합니다. |
N | Clear Before | 토글버튼 | N | - | Y | 텍스트를 입력하기 전에 입력란에 있는 텍스트를 모두 삭제할지 선택합니다. (기본값: 사용 - 청색) |
N | Done(Enter) | 토글버튼 | N | - | Y | 텍스트를 입력한 후 Enter 키 기능을 사용할지 선택합니다. (기본값: 미사용 - 회색) |
N | Before Delay(ms) | 숫자 | N | ms | Y | 문자열을 입력하기 전의 대기 시간을 입력합니다. (기본값: 0) |
N | After Delay(ms) | 숫자 | N | ms | Y | 문자열을 입력한 후의 대기 시간을 입력합니다. (기본값: 0) |
N | Interval(ms) | 숫자 | N | ms | Y | 문자열을 입력하는 간격을 설정합니다. (기본값: 0) |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
특이 사항
Credential 리소스를 사용하는 것 외에 기본 사용법은 TextInput 과 동일합니다.
연관/유사 액티비티
KeyInput
KeyInput
개요
키보드 버튼 누르기, 떼기 등의 키보드 이벤트를 발생시킵니다. 'Ctrl+Shift+C'와 같이 여러 개의 키를 동시에 누르는 경우에도 사용할 수 있습니다. 대상 UI 객체를 지정하지 않고, 포커스가 설정된 UI 객체에 키보드 이벤트가 발생합니다.
사용 절차
키 이벤트의
(녹화 버튼)을 클릭하세요. 녹화가 시작되면 버튼이 회색으로 바뀝니다.
원하는 키를 입력하세요.
입력이 끝나면 녹화 버튼을 클릭하여 레코딩을 종료하세요. 버튼이 회색에서 빨간색으로 다시 바뀝니다.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | 키 이벤트 | 버튼 | N | - | N |
|
N | KeyCode | 문자 | N | - | N | 레코딩된 키보드 이벤트를 확인합니다. 이벤트 항목을 선택한 후 레코딩하면 선택된 항목 위에 새로운 이벤트가 추가됩니다. 이벤트 항목을 선택한 후 키보드의 Delete 키를 누르면 해당 이벤트가 삭제됩니다. 'Click here to add new item'을 클릭한 후 KeyCode와 Type 항목에 값을 입력하여 키보드 이벤트를 수동으로 추가할 수 있습니다. Type 항목에는 Press(일반 입력), Down(눌러진 상태), Up(눌렸다 올라오는 상태), Text(문자열), Variable(변수), Delay(대기)를 입력할 수 있습니다. |
N | Before Delay(ms) | 숫자 | N | ms | Y | 키보드 이벤트를 발생시키기 전의 대기 시간을 설정합니다.(기본값: 1000) |
N | After Delay(ms) | 숫자 | N | ms | Y | 키보드 이벤트를 발생시킨 후의 대기 시간을 설정합니다.(기본값: 500) |
N | Interval(ms) | 숫자 | N | ms | Y | 키를 누르는 간격을 설정합니다. 단축키의 경우 대상 앱에 따라 간격이 짧으면 동작하지 않을 수 있습니다.(기본값: 100) |
N | Restore KeyState | 토글버튼 | N | - | Y | KeyInput을 수행한 후 Ctrl, Alt, Shift 키 상태를 초기화할지 선택합니다. (기본값: 사용- 청색) |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
키보드 버튼을 누르고 떼는 등의 키보드 이벤트를 발생시킵니다. Notepad 본문 영역에 KeyInput 액티비티 카드를 이용하여 문자열을 입력하고, 입력한 문자열을 복사 및 붙여넣기를 수행합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Keyboard Action > P_KeyInput_Test_Win10_Notepad
사용된 변수
없음
사용된 속성
없음
연관/유사 액티비티
SetCheckState
SetCheckState
개요
체크박스를 선택하거나 해제합니다.
사용 절차
대상 UI 객체의 클래스 타입이 체크박스인 경우에만 사용할 수 있습니다.
액티비티 카드의 No Target을 더블클릭하세요.
원하는 객체를 선택하세요.
Command에서 Checked(체크박스 선택) 또는 Unchecked(체크박스 선택 해제) 중 하나를 선택하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Command | 콤보박스 | N | - | Y | 체크박스의 체크 여부를 Checked(선택) 또는 Unchecked(해제)로 설정합니다.(기본값: Checked) |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
브라우저 설정 화면에서 원하는 항목의 체크박스를 선택(V 표시)하거나 해제합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Manage Application State > P_CheckState_Test
사용된 변수
없음
사용된 속성
Command = Checked (첫 번째 SetCheckState 카드)
Command = UnChecked (두 번째 SetCheckState 카드)
연관/유사 액티비티
GetText
GetText
개요
대상 UI 객체의 텍스트를 읽어옵니다. 객체의 Name과 Value 중 읽어오고자 하는 항목을 선택할 수 있으며, 대상 객체의 지원 여부에 따라 Legacy 혹은 RangeText 를 읽기 위해 사용할 수도 있습니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
원하는 객체를 선택하세요.
Name 또는 Value 중 읽어 올 항목을 선택하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | string | - | 대상 UI 객체에서 읽어 온 텍스트를 반환합니다. | 'Help' |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Read Property Type | 콤보박스 | N | - | Y | 텍스트를 읽으려는 UI 객체 타입을 선택합니다. ※ Auto를 선택하면 대상 UI 객체가 Edit 또는 Document 타입일 경우 Value 값을, 그 외의 경우에는 Name 값을 우선적으로 읽습니다. 예) Auto : "Help" ; Name : "Help" ; Value : "https://www.amazon/com/gp/help..." ※ Name이나 Value 대신 Legacy 속성을 통해 정보를 제공하는 객체의 경우 LegacyValue, LegacyHelp 등을 Legacy 타입을 선택할 수 있습니다. ※ 대상 객체가 Text 패턴을 지원하는 경우에는 RangeText을 선택할 수 있습니다. RangeText 를 선택하면 대상 객체 영역 내의 여러 문자열을 문서화하여 하나의 문자열을 얻을 수 있습니다. ※ Name 및 Value, LegacyValue 등 모든 객체 속성 문자열의 최대 길이는 4096 개로 제한됩니다. 이 경우, RangeText를 활용하면 4096개를 초과하는 문자열을 얻을 수 있습니다. ※ Legacy 및 RangeText 타입을 사용하는 경우, 각 타입을 위한 패턴을 지원하지 않는 객체를 지정하면 실행 시 Result 반환없이 실패로 처리되므로 사용에 주의가 필요합니다. |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
OpenBrowser 카드로 브라우저를 열고, 화면 내 '텍스트' 와 '주소' 텍스트를 변수로 저장하고 메시지를 표시합니다. 텍스트 형식의 데이터 활용 시 유용하게 사용할 수 있습니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Get Target Detail > P_GetText_Test_Web_Auto
사용된 변수
browser = 실행된 브라우저를 지정할 변수
GetVal = 객체에서 읽어 온 텍스트를 저장할 변수
사용된 속성
[Output] Result =
this.GetVal
연관/유사 액티비티
GetBounds
GetBounds
개요
대상 UI 객체의 영역 정보를 가져옵니다. 결과는 x, y, width, height 형태의 문자열로 반환됩니다. 반환된 문자열은 자바스크립트 등을 활용하여 숫자 배열로 변환하여 사용할 수 있습니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
원하는 객체를 선택하세요.
[Output] Result에 가져온 영역 정보를 저장할 변수를 입력하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | string | - | 검색한 객체의 영역(Bounds) 정보를 반환합니다. ※ X, Y, Width, Height | '774,575,52,19' |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
Notepad를 실행하고 '파일(F)' 메뉴의 영역 정보를 가져와 메시지 박스로 표시한 후 Notepad를 종료합니다. 대상의 영역 정보는 x, y, width, height 형태의 문자열로 반환됩니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Get Target Detail > P_GetBounds_Test_Notepad
사용된 변수
browser = 실행된 Notepad 앱을 지정할 변수
getBounds = 가져온 영역 정보를 저장할 변수
사용된 속성
[Output] Result =
this.getBounds
특이 사항
반환된 문자열은 Assign 혹은 ExecuteScript 액티비티에서 eval 함수를 이용하여 숫자 배열로 변환하여 사용할 수 있습니다. 또한, Image Recognition 라이브러리의 Bounds 입력값으로 사용될 수 있습니다.
연관/유사 액티비티
없음
GetCheckState
GetCheckState
개요
지정한 체크박스의 상태 정보를 문자열로 가져옵니다. 상태 정보는 'Checked', 'UnChecked', 'Indeterminate' 3 가지가 있습니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
상태를 확인할 체크박스를 선택하세요.
[Output] Result에 상태 정보를 저장할 변수를 입력하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | string | - | 체크박스의 상태 정보를 반환합니다. ※ 결과값은 "Checked", "UnChecked", "Indeterminate" 3가지로 구성됩니다. | "Checked" |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
OpenBrowser 카드로 Internet Explorer를 열고, GetCheckState 액티비티 카드를 이용하여 해당 페이지의 체크박스 상태 확인한 후 그 결과를 메시지 박스로 출력합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Manage Application State > P_CheckState_Windows10_Test
사용된 변수
BrowserID = 실행된 브라우저를 지정할 변수
사용된 속성
없음
연관/유사 액티비티
WaitAppear
WaitAppear
개요
대상 UI 객체가 화면에 나타날 때까지 기다립니다. 화면 전환 시 유용하게 사용할 수 있습니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
원하는 객체를 선택하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | bool | - | 대상 객체가 나타났는지 검사한 결괏값을 저장할 변수를 입력합니다. ※ 대상 객체를 발견하면 True, 발견하지 못하면 False로 반환합니다. | True |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
OpenBrowser 카드로 "google.com" 웹 페이지를 열고, 'Google UI'가 화면에 나타나면 브라우저를 종료합니다.
대상 객체가 나타나는 것을 오래 기다려야 할 경우 WaitAppear 이전에 최소 대기 시간만큼의 Delay를 추가하는 것을 권장합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > WaitApplication Target > P_WaitAppear_Test_win10_Notepad
사용된 변수
없음
사용된 속성
없음
특이 사항
반복적으로 대상 앱의 UI 객체 정보를 검색하므로 대상 앱에 따라 동작이 느려지거나 오동작할 수 있습니다.
연관/유사 액티비티
WaitDisappear
WaitDisappear
개요
대상 UI 객체가 화면에서 사라질 때까지 기다립니다. 화면 전환 시 유용하게 사용할 수 있습니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
원하는 객체를 선택하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | bool | - | 대상 객체가 사라졌는지 검사한 결괏값을 반환합니다. ※ 대상 객체가 사라졌으면 True, 사라지지 않았으면 False로 반환합니다. | True |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
CloseBrowser 액티비티 카드로 "google.com" 웹 페이지를 닫고, 'Google' UI가 화면에서 사라지면 새로운 브라우저를 실행합니다.
대상 객체가 사라지는 것을 오래 기다려야 할 경우 WaitDisappear 이전에 최소 대기 시간만큼의 Delay를 추가하는 것을 권장합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > WaitApplication Target > P_WaitDisappear_Test_Win10_Web
사용된 변수
없음
사용된 속성
없음
특이 사항
반복적으로 대상 앱의 UI 객체 정보를 검색하므로 대상 앱에 따라 동작이 느려지거나 오동작할 수 있습니다.
연관/유사 액티비티
IsExist
IsExist
개요
대상 UI 객체가 화면에 있는지 검사합니다. 화면 전환이나 객체 존재 여부에 따른 조건문 등에 활용할 수 있습니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
원하는 대상 객체를 선택하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | [Output] Result | 변수 | Y | - | Y | 객체가 화면에 있는지 검사한 결괏값을 저장할 변수를 입력합니다. (기본값: RESULT) 설정한 시간 안에 지정한 객체를 찾으면 True, 찾지 못하면 False로 반환합니다. |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
OpenBrowser 액티비티 카드로 "www.google.com" 웹 사이트를 연 후, IsExist 액티비티 카드를 사용해 구글 객체가 화면에 있는지 메시지 박스로 출력합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Other Samples > P_IsExist_Test_Web
사용된 변수
browser = 실행된 브라우저를 지정할 변수
사용된 속성
없음
특이 사항
객체가 화면 스크롤 아래 있거나 숨겨져 있는 등 화면에 보이지 않더라도 객체 정보가 존재하면 True로 반환합니다. 이 경우 객체의 Bounds 정보는 0으로 표시될 수 있습니다. 이러한 경우에는 IsVisible 액티비티를 사용합니다.
연관/유사 액티비티
IsVisible
IsVisible
개요
대상 UI 객체가 화면에서 보이는지 검사합니다. 화면 전환이나 객체 존재 여부에 따른 조건문 등에 활용할 수 있습니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
원하는 객체를 선택하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | [Output] Result | 변수 | N | - | Y | 객체가 화면에서 보이는지 검사한 결괏값을 저장할 변수를 입력합니다. (기본값: RESULT) 대상 객체가 보이면 True, 보이지 않으면 False로 반환합니다. |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
OpenBrowser 액티비티 카드로 아마존 웹 페이지를 열고, IsVisible 액티비티 카드를 사용해 선택한 객체가 화면에 보이는지 메시지 박스로 출력합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Other Samples > P_IsVisible_Test
사용된 변수
browser = 실행된 브라우저를 지정할 변수
사용된 속성
없음
특이 사항
IsVisible 액티비티에서는 IsExist 액티비티 기능에 추가적으로 Bounds 정보도 함께 확인합니다.
Bounds 정보가 존재하는 경우 True를 반환하며, 다른 화면에 의해 가려진 경우에도 Bounds 정보가 존재하면 동일하게 True를 반환합니다.
연관/유사 액티비티
IsRadioSelected
IsRadioSelected
개요
대상 라디오 버튼이 선택되었는지 검사합니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
원하는 객체(라디오 버튼)를 선택하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | [Output] Result | 변수 | N | - | Y | 지정한 라디오 버튼의 선택 상태를 검사한 결괏값을 저장할 변수를 입력합니다. (기본값: RESULT) 지정한 라디오 버튼이 선택되어 있으면 True, 선택되어 있지 않으면 False로 반환합니다. |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
OpenBrowser 액티비티로 Internet Explorer를 열고, 인터넷 옵션 창에서 '시작 옵션'의 라디오 버튼 선택 여부를 파악하고 상태를 메시지화 합니다. 웹 페이지에서 라디오 버튼 선택/선택 해제 상태를 확인하여 특정 속성을 선택하는 경우에 사용합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Manage Application State > P_IsRadioSelected_Test
사용된 변수
BrowserID = 실행된 브라우저를 지정할 변수
사용된 속성
없음
연관/유사 액티비티
IsCheckedState
IsCheckedState
개요
대상 체크박스가 선택되었는지 검사합니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
원하는 객체(체크박스)를 선택하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | [Output] Result | 변수 | N | - | Y | 지정한 체크박스의 선택 상태를 검사한 결괏값을 저장할 변수를 입력합니다. (기본값: RESULT) 지정한 체크박스가 선택되어 있으면 True, 선택되어 있지 않으면 False로 반환합니다. |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
OpenBrowser 액티비티로 Internet Explorer를 열고, "인터넷 옵션" 창에서 '종료할 때 검색 기록 삭제' 체크박스 여부를 파악하고 상태를 메시지화 합니다. 웹 페이지에서 체크박스 선택/선택 해제 상태를 확인하여 특정 속성을 선택하는 경우에 사용합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Manage Application State > P_IsCheckedState_Window10_Test
사용된 변수
BrowserID = 실행된 브라우저를 지정할 변수
사용된 속성
없음
연관/유사 액티비티
OpenApp
OpenApp
개요
대상 앱(프로그램)을 실행합니다. 앱이 실행되면 실행된 앱의 PID(Process ID)를 반환합니다.
사용 절차
Command에 실행할 앱명을 입력하세요.
필요에 따라 속성에 원하는 값을 지정하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | [Output] PID | 변수 | Y | - | Y | 실행한 앱의 PID를 저장하기 위한 변수를 입력합니다. (기본값: RESULT) |
N | Command | 문자 | Y | - | N | 실행할 앱의 실행 명령어를 입력합니다. 전체 경로 입력을 권장합니다. |
N | Arguments | 문자 | N | - | N | 앱 실행 시 필요한 실행 인자를 입력합니다. 전달할 실행 인자가 없는 경우에는 빈 문자열(‘’)을 입력합니다. 예) 브라우저의 경우 시작할 URL 등 |
N | DrivedApp | 문자 | N | - | N | Command 항목에 입력한 앱이 아닌 다른 앱이 실행되는 경우 실제 실행될 앱의 이름을 지정할 수 있습니다. null 을 입력하면 대상 앱의 실행 여부를 검사하지 않습니다. |
N | WaitTime(Sec) | 숫자 | N | 초 | Y | 앱을 실행한 후 정상적으로 실행되었는지 확인하는 시간을 설정합니다. |
N | Maximize | 토글버튼 | Y | - | Y | 앱을 실행한 후 창 크기를 최대화 상태로 변경할지 선택합니다. (기본값: 미사용 - 회색) |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
Notepad 앱을 실행하고 PID(프로세스 ID)를 padID 변수에 저장한 후 종료합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Manage Application > P_OpenApp_Test_win10_notepad
사용된 변수
padID = 실행한 Notepad 앱을 지정할 변수
사용된 속성
[Output] PID =
this.padIDCommand = 'notepad'
WaitTime = 3
연관/유사 액티비티
OpenWindow, ActivateApp, CloseAll, CloseApp
ActivateApp
ActivateApp
개요
지정한 PID(프로세스 ID), 또는 이름에 해당하는 앱을 맨 앞으로 이동시켜 활성화합니다.
사용 절차
활성화하려는 앱이 실행되어 있어야 합니다.
[Input] Application에 활성화할 앱의 PID, 또는 이름을 입력하세요.
Maximize에서 앱을 활성화한 후 창 크기를 최대화할지 선택하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | [INPUT] Application | 변수 | Y | - | N | 활성화할 앱명 혹은 PID를 입력합니다. 앱명은 해당 프로그램이 1개만 존재하는 경우에 지정할 수 있습니다. |
N | Maximize | 토글버튼 | Y | - | Y | 앱을 활성화한 후 창 크기를 최대화 상태로 변경할지 선택합니다. (기본값: 미사용 - 회색) |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
두 개의 Notepad 앱을 실행한 후 각 Notepad를 순차적으로 활성화하여 텍스트를 입력한 후 종료합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Manage Application > P_ActivateApp_Test_Win10_Calc
사용된 변수
padID1, padID2 = 실행된 Notepad 앱의 PID
사용된 속성
[INPUT] Application =
this.padID1,this.padID2Maximize = False
연관/유사 액티비티
CloseApp
CloseApp
개요
지정한 PID(프로세스 ID), 또는 이름에 해당하는 앱을 종료합니다.
사용 절차
종료하려는 앱이 실행 중이어야 합니다.
[Input] PID에 종료할 앱의 PID, 또는 이름을 입력하세요.
Force에서 앱을 강제로 종료할 것인지 선택하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | [Input] PID | 변수 | Y | - | N | 종료할 앱명 또는 PID를 입력합니다. 앱명은 해당 프로그램이 1개만 존재하는 경우에 지정할 수 있습니다. |
N | Force | 토글버튼 | N | - | Y | 프로그램의 상태와 상관없이 강제로 종료할지 선택합니다. (기본값: 사용 - 청색) True(On)로 설정하면 프로그램의 상태와 상관없이 강제로 종료합니다. False(Off)로 설정하면 닫기 명령을 한 번만 전달합니다. 이 경우 앱의 상태에 따라 종료되지 않을 수 있습니다. 예를 들어, 편집 중인 Notepad 앱에 종료 명령을 보내도 작업 저장 여부를 묻는 창이 열려 종료되지 않습니다. |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
두 개의 Notepad 앱을 실행한 후 각각 종료합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Manage Application > P_CloseApp_Test_Win10_Notepad
사용된 변수
padID1, padID2 = 실행된 Notepad 앱의 PID
사용된 속성
[INPUT] PID =
this.padID1,this.padID2Force = ON(True)
연관/유사 액티비티
OpanApp, ActivateApp, CloseAll, CloseWindow
CloseAll
CloseAll
개요
지정한 PID(프로세스 ID), 또는 이름에 해당하는 모든 앱을 종료합니다.
사용 절차
종료하려는 앱이 실행 중이어야 합니다.
Application에 종료할 앱의 PID, 또는 이름을 입력하세요.
Force에서 Force에서 앱을 강제로 종료할 것인지 선택하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Application | 문자 | Y | - | N | 종료할 앱명 또는 PID를 입력합니다. 앱명을 입력하면 실행되어 있는 같은 이름을 가진 모든 앱을 종료합니다. PID를 입력하면 해당 1개 앱만 종료합니다. |
N | Force | 토글버튼 | N | - | Y | 프로그램의 상태와 상관없이 강제 종료할지 선택합니다. (기본값: 사용 - 청색) |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
두 개의 Notepad 앱을 실행한 후 한번에 모두 종료시킵니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Manage Application > P_CloseAll_Test_Win10_Notepad
사용된 변수
padID1, padID2 = 실행된 Notepad 앱의 PID
사용된 속성
Application = 'notepad'
Force = ON(True)
연관/유사 액티비티
OpanApp, ActivateApp, CloseApp
OpenWindow
OpenWindow
개요
프로그램(App)을 실행하여 윈도우를 엽니다. 일반 프로그램을 포함하여 OpenApp로 실행할 수 없는 런처 형태의 프로그램도 열 수 있습니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
원하는 대상 객체를 선택하세요.
필요에 따라 속성에 원하는 값을 지정하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Command | 문자 | Y | - | N | 실행할 프로그램의 실행 명령어를 입력합니다. 전체 경로 입력을 권장합니다. |
N | Arguments | 문자 | N | - | N | 프로그램 실행에 필요한 실행 인자를 입력합니다. 전달할 실행 인자가 없는 경우에는 빈 문자열(‘’)을 입력합니다. 예) 브라우저의 경우 시작할 URL 등 |
N | Maximize | 토글버튼 | N | - | Y | 앱을 실행한 후 창 크기를 최대화 상태로 변경할지 선택합니다. (기본값: 미사용 - 회색) |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
Notepad 앱을 실행한 후 종료합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Manage Window > P_OpenWindow_Test_Notepad
사용된 변수
없음
사용된 속성
Command = 'notepad'
연관/유사 액티비티
CloseWindow
CloseWindow
개요
선택된 프로그램의 윈도우를 종료합니다.
사용 절차
종료하려는 앱이 실행 중이어야 합니다.
액티비티 카드의 No Target을 더블클릭하세요.
원하는 객체를 선택하세요.
Force에서 앱을 강제로 종료할 것인지 선택하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Force | 토글버튼 | N | - | Y | 프로그램의 상태와 상관없이 강제 종료하도록 설정합니다. (기본값: 미사용 - 회색) |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
Notepad 앱을 실행하고, 종료합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Manage Window > P_CloseWindow_Test_Notepad
사용된 변수
없음
사용된 속성
Force = OFF(False)
특이 사항
CloseApp, CloseAll, CloseWindow의 차이점
- CloseApp은 닫고자 하는 앱명 또는 PID를 지정하여 닫을 수 있습니다.
- CloseAll은 앱명 또는 PID를 지정하여 열려 있는 동일한 모든 앱을 한번에 닫을 수 있습니다.
- CloseWindow는 별도의 PID를 지정하지 않고 화면상에서 닫고자 하는 앱 하나만 선택하여 닫을 수 있습니다.
연관/유사 액티비티
CloseApp, CloseAll, OpenWindow
FindAll
FindAll
개요
지정한 대상 UI 객체와 같은 속성을 갖는 모든 객체의 참조 정보를 찾습니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
원하는 객체를 선택하세요.
속성에 원하는 값을 지정하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | 1차원배열 | 배열의 요소는 Result Type 에 의해 결정됩니다. | 검색 조건에 맞는 객체의 목록을 반환합니다. | 만약 Result Type이 'Name' 일 때, 0: Heading 1: Heading 2: Heading |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Result Type | 콤보박스 | N | - | Y | 선택한 타입을 기준으로 정보를 반환합니다. (기본값: Object) Object인 경우 조건에 맞는 모든 타입의 참조 정보를 배열로 반환하며, 그 외 타입은 선택한 타입을 기준으로 정보를 반환합니다. ※ 타입 종류 - Object: 아래 타입의 모든 참조 정보를 연결한 문자열 - Bounds, ControlType, Name, Value, LegacyValue, RangeText |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
웹 브라우저로 'https://www.layoutit.com'을 열고 'Bootstrap Builder'를 클릭하여 이동한 페이지에서, 텍스트 유형의 객체 중 Name 속성이 'Heading'인 모든 객체의 참조 정보를 읽어서 메시지 박스로 출력합니다. 메시지 박스의 확인을 클릭하면 웹 페이지를 종료합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Find Target > P_FindAll_Test
사용된 변수
browser = 실행한 브라우저를 지정할 변수
findObj = FindAll 수행 결괏값을 저장할 변수(Name 속성이 'Heading'인 모든 객체의 참조 정보)
사용된 속성
[Output] Result =
this.findObjResult Type = Name
연관/유사 액티비티
Find
Find
개요
지정한 대상 UI 객체를 찾습니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
원하는 객체를 선택하세요.
속성에 원하는 값을 지정하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | Object | UI 객체 | 지정한 대상 UI 객체를 반환합니다. | Bounds:-1904,785,113,50, ControlType:Hyperlink, Name:아마존, Value:https://www.amazon.com/-/ko/ref=nav_logo, LegacyValue:https://www.amazon.com/-/ko/ref=nav_logo, RangeText: |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
'열기(O):'의 객체 정보를 변수 RESULT로 반환합니다. 'Windows 버튼 + R'을 입력하여 윈도우 실행 창을 띄운 후 '열기(O):' 입력란 객체를 찾고, 입력란에 'notepad'라는 텍스트를 입력한 후에 닫기 버튼을 클릭합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Find Target > P_Find_Test_Notepad
사용된 변수
없음
사용된 속성
없음
연관/유사 액티비티
FindElement
FindElement
개요
[Input] Target 항목에 입력한 객체의 하위에서 대상 UI 객체를 검색합니다. Find와 함께 주로 사용합니다.
사용 절차
속성에 원하는 값을 지정하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | Object | UI 객체 | 검색된 객체의 참조 정보를 반환합니다. | Bounds:-1904,785,113,50, ControlType:Hyperlink, Name:아마존, Value:https://www.amazon.com/-/ko/ref=nav_logo, LegacyValue:https://www.amazon.com/-/ko/ref=nav_logo, RangeText: |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | [Input] Target | 변수 | N | - | N | 검색의 시작 지점이 되는 기준 객체를 지정합니다. 미지정 시 가장 최근 검색된 객체가 사용됩니다. |
N | All or First | 버튼 | N | - | Y | 'All' 은 조건에 맞는 모든 대상(Target) 정보를 배열로 반환하고, 'First'는 처음 발견된 1개 대상만 반환합니다. |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
Notepad를 실행하여 '파일(F)' 메뉴를 찾은 후 첫 번째 요소(Element)를 찾아 참조 정보를 메시지 박스로 출력한 후 Notepad를 종료합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Find Target > P_FindElement_Test
사용된 변수
예제 파일 메뉴 > 도움말 > 샘플 > Sample > Application > Find Target > P_FindElement_Test
없음
사용된 속성
[Output] Result = RESULT
[Input] Target = 'notepad'
All or First = First
연관/유사 액티비티
RunAction
RunAction
개요
[Input] Target 항목에 입력한 대상 UI 객체에 클릭 등의 이벤트를 발생시키거나 주변 객체를 검색할 수 있습니다.
사용 절차
[Input] Target에 이벤트를 발생시키거나 검색할 기준 객체를 입력하세요.
Command에서 실행할 이벤트(동작 방법)를 선택하세요.
필요에 따라 속성에 원하는 값을 지정하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | [Output] Result | 변수 | N | - | Y | 이벤트를 실행한 결괏값을 저장할 변수를 입력합니다. (기본값: RESULT) |
N | [Input] Target | 변수 | N | - | N | 이벤트를 발생시키거나 검색할 기준 객체의 변수를 입력합니다. 지정하지 않으면 가장 최근 검색한 객체가 입력 값으로 사용됩니다. |
N | Command | 콤보박스 | Y | - | Y | 실행할 이벤트(동작 방법)를 선택합니다. 실행 가능한 이벤트의 종류는 아래 특이 사항 노트를 참고하세요. |
N | Arguments | 문자 | N | - | N | 앱 실행시 필요한 실행 인자를 입력합니다. 예) 브라우저를 열 때의 시작 URL 등 |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
Notepad 앱을 열고, 'File(F)' 객체를 찾아서 Click 이벤트를 실행합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Other Samples > P_RunAction_Test_Check
사용된 변수
없음
사용된 속성
[Output] RESULT = RESULT
[Input] Target = RESULT
Command = Click
특이 사항
이벤트로 지정 가능한 Command는 다음 목록과 같습니다.
- Click, DoubleClick, RightClick, LeftDown, LeftUP, MouseMove, Invoke, IsChecked, GetCheckState, Check, Uncheck, IsSelected, Select, AddToSelection, RemoveFromSelection, GetExpandState, Expand, Collapse, GetName, GetBounds, GetValue, SetValue, GetParentElement, GetChildElement, GetNextElement, GetPreviousElement, GetElementFromPoint
연관/유사 액티비티
없음
SelectMenu
SelectMenu
개요
지정한 메뉴 객체를 기준으로 메뉴 경로를 따라서 메뉴를 선택하여 실행합니다.
사용 절차
대상 UI 객체의 클래스 타입이 MenuBar, Menu, MenuItem인 경우에만 사용할 수 있습니다.
액티비티 카드의 No Target을 더블클릭하세요.
원하는 객체를 선택하세요.
Menu Path에 대상 객체를 기준으로 메뉴 경로를 지정하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Menu Path | 문자 | Y | - | N | 메뉴 순서를 '\\' 로 구분하여 메뉴 이름을 입력하면 해당 이름이 포함된 메뉴를 찾아 실행합니다. 이름 전체가 일치하는 메뉴를 찾으려면 메뉴명을 '"메뉴명"' 과 같이 따옴표를 붙여 작성합니다. 동일한 조건의 메뉴가 여러 개인 경우 검색된 메뉴 중에 하나를 선택하기 위해 'Open{0}' 과 같이 메뉴명 뒤에 '{ }' 를 사용하여 인덱스를 지정할 수 있습니다. |
N | Expand Menu | 토글버튼 | N | - | Y | Menu Path의 각 단계별 메뉴를 펼쳐 확장합니다. 상위 단계 메뉴가 펼쳐진 후에 하위 메뉴가 생성되는 앱에 대해서는 이 속성을 활성화해야 합니다. 일부 예외적인 경우를 제외한 대부분의 경우 이 설정을 적용하여야 메뉴를 검색할 수 있습니다. |
N | Expand Latency(ms) | 숫자 | N | - | Y | 메뉴를 펼친 후 하위 메뉴가 표시될 때까지 대기 시간을 100~10000(ms) 범위 내에서 설정합니다. 지정하지 않으면 기본값이 적용됩니다. (기본값: 300) |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
메모장의 "편집>시간/날짜" 메뉴와 "보기>확대하기/축소하기>확대", "보기>확대하기/축소하기>확대하기/축소하기 기본값 복원" 메뉴를 실행합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Find Target > P_SelectMenu_Test
사용된 변수
appID : 실행한 메모장의 PID
사용된 속성
Menu Path = '편집\\시간' (첫 번째 SelectMenu 카드)
Menu Path = '확대\\확대{0}' (두 번째 SelectMenu 카드)
Menu Path = '확대\\복원' (세 번째 SelectMenu 카드)
연관/유사 액티비티
없음
SelectComboBox
SelectComboBox
개요
지정한 콤보 상자 객체를 기준으로 대상 항목을 선택하여 실행합니다.
사용 절차
대상 UI 객체의 클래스 타입이 ComboBox 인 경우에만 사용할 수 있습니다.
콤보 박스가 클릭 등으로 목록이 열린 상태에서는 객체 지정 시 ListItem 이 보일 수 있습니다.
이때는 마우스를 조금 움직이면, 다시 ComboBox 가 인식되도록 할 수 있습니다.
액티비티 카드의 No Target을 더블클릭하세요.
원하는 객체를 선택하세요.
Item Path에 대상 객체를 기준으로 콤보 박스 항목 경로를 지정하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Item Name | 문자 | Y | - | N | 이름을 입력하면 해당 이름이 포함된 콤보 박스 항목을 찾아 실행합니다. 이름 전체가 일치하는 항목을 찾으려면 항목 이름을 '"항목명"' 과 같이 큰 따옴표를 붙여 작성합니다. 동일한 조건의 항목이 여러 개인 경우 검색된 항목 중에 하나를 선택하기 위해 'Item{0}' 과 같이 항목명 뒤에 '{ }' 를 사용하여 인덱스를 지정할 수 있습니다. |
N | Expand Latency(ms) | 숫자 | N | - | Y | 콤보 박스 팝업의 표시가 완료될 때까지 최대 대기 시간을 100~10000(ms) 범위 내에서 설정합니다. 지정하지 않으면 기본값이 적용됩니다. (기본값: 300) |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
메모장의 "서식>글꼴" 설정 창의 '스크립트(R):' 콤보 박스 항목을 변경합니다. '한글' 로 한번 변경하고, 다시 '영어' 로 변경합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Find Target > P_SelectComboBox_Test
사용된 변수
appID : 실행한 메모장의 PID
사용된 속성
Item Path = '한글' (첫 번째 SelectComboBox 카드)
Item Path = '영어' (두 번째 SelectComboBox 카드)
연관/유사 액티비티
없음
GetHierarchyInfo
GetHierarchyInfo
개요
지정한 객체 또는 앱을 기준으로 하위 객체의 정보를 Xml 형태로 반환합니다. 화면 내의 정보를 한번에 처리하는 용도 등으로 사용할 수 있습니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
원하는 객체를 선택하세요.
속성에 원하는 값을 지정하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | Object | Xml Document | 화면 구조에 대한 결과를 객체로 반환합니다. | <Hierarchy> <Window name = "Untitled-Notepad" class = "Notepad" ...> ... </Window> </Hierarchy> |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Target / App | 버튼 | N | - | Y | 정보를 추출할 범위를 선택합니다. 지정한 객체 정보(Target)와 지정한 객체가 속한 프로그램(App) 중에 선텍합니다. (기본값 : Target) |
N | Result Type | 버튼 | N | - | Y | 반환할 결과의 형식을 선택합니다. |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
Notepad 앱을 열고, GetHierachyInfo 액티비티로 notepad 하위 객체의 정보를 받아온 후 메시지 박스로 출력합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Get Target Detail > P_GetHierachyInfo_Test
사용된 변수
없음
사용된 속성
Target / App = Target
Result Type = XML
특이 사항
반환되는 객체 정보는 XmlDocument 객체로 표현됩니다.
XmlDocument에 대한 자세한 내용은 아래 링크를 참고하세요.
https://docs.microsoft.com/ko-kr/dotnet/api/system.xml.xmldocument?view=netframework-4.7.2
연관/유사 액티비티
없음
GetListItems
GetListItems
개요
리스트, 트리 또는 메뉴 등에서 대상 UI 객체와 동일한 경로에 있는 항목들을 반환합니다.
사용 절차
객체가 리스트, 트리 또는 메뉴 항목에서 선택되어야 합니다.
액티비티 카드의 No Target을 더블클릭하세요.
원하는 객체를 선택하세요.
속성에 원하는 값을 지정하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | 1차원배열 | string | 화면 구조에 대한 결과를 객체의 배열로 반환합니다. 배열의 요소는 Data Type에 의해 결정됩니다. | 만약 Data Type이 'Name' 일때, 0 : 맑은 고딕 1 : 바탕 2 : 바탕체 |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Data Type | 콤보박스 | N | - | Y | 데이터 타입을 선택합니다. (기본값 : Name) ※ 타입 종류 - Name, Value, Bounds, LegacyValue, RangeText |
N | SubItem Delimiter | 문자 | N | - | Y | 검색 대상의 하위 항목이 존재하는 경우 데이터를 합성하기 위한 구분 기호를 지정합니다. (기본값 : ';') |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
Notepad 앱을 열고, '서식' > '글꼴' 메뉴에서 글꼴 리스트를 GetListItems을 이용해 값을 받아온 후 메시지 박스로 출력합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Get Target Detail > P_GetListItems_Test
사용된 변수
padID = 실행된 Notepad 앱을 지정할 변수
사용된 속성
[Output] Result = RESULT
Data Type = Name
SubItem Delimiter = ';'
연관/유사 액티비티
GetListItemIndex, SelectListItem
GetGridItems
GetGridItems
개요
Grid(표)로 표시된 항목들을 반환합니다.
사용 절차
Grid(표)형태의 데이터가 객체로 선택되어야 합니다.
액티비티 카드의 No Target을 더블클릭하세요.
원하는 객체(Grid)를 선택하세요.
속성에 원하는 값을 지정하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | 2차원배열 | string | 화면 구조에 대한 결과를 객체의 2차원 배열로 반환합니다. 배열의 요소는 Result Type에 의해 결정됩니다. | 만약 Data Type이 'Name' 일때, 0 : Company | Contact | Country 1 : Alfreds Fultterkiste | Maria Anders | Germany 2 : Centro comercial Moctezuma | Francisco Chang | Mexico |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Data Type | 콤보박스 | N | - | Y | 데이터 타입을 선택합니다. (기본값 : Name) ※ 타입 종류 - Name, Value, Bounds, LegacyValue, RangeText |
N | SubItem Delimiter | 문자 | N | - | Y | 검색 대상의 하위 항목이 존재하는 경우 데이터를 합성하기 위한 구분 기호를 지정합니다. (기본값 : ';') |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
Grid(표)가 포함된 웹 사이트를 열고, GetGridItems을 이용해 값을 받아온 후 메시지 박스로 출력합니다. (배열이기 때문에 이중 for문)
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Get Target Detail > P_GetGridItems_Test_Web
사용된 변수
browserid = 실행된 브라우저를 지정할 변수
griditems = 읽어 온 Grid 값을 저장할 변수
사용된 속성
[Output] Result = RESULT
Data Type = Name
SubItem Delimiter = ';'
연관/유사 액티비티
GetListItemIndex
GetListItemIndex
개요
선택한 항목이 리스트에서 몇 번째 항목인지 가져옵니다.
사용 절차
리스트 형태의 데이터가 객체로 선택되어야 합니다.
액티비티 카드의 No Target을 더블클릭하세요.
원하는 객체를 선택하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | int | - | 리스트내 선택한 항목의 순서를 반환합니다. 순서는 0부터 시작합니다. | 0 |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
리스트 형식이 포함된 웹 사이트를 열고, GetListItemIndex를 이용해 리스트 순서값을 받아온 후 메시지 박스로 출력합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Get Target Detail > P_GetListItemIndex_Test_Web
사용된 변수
browserid = 실행된 브라우저를 지정할 변수
listitems = 리스트 순서 값을 저장할 변수
사용된 속성
[Output] Result =
this.listitems
연관/유사 액티비티
GetGridItemIndex
GetGridItemIndex
개요
선택한 항목이 Grid(표)에서 몇 번째 항목인지 가져옵니다.
사용 절차
Grid(표) 형태의 데이터가 객체로 선택되어야 합니다.
액티비티 카드의 No Target을 더블클릭하세요.
원하는 객체를 선택하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | Object | Dictionary<string, int> | Grid 항목 순서를 가진 Dictionary 객체를 반환합니다. ※ RESULT['Row'] = RESULT.Row = RESULT[0] RESULT['Column'] = RESULT.Column = RESULT[1] | { 'Row' : 1, 'Column' : 2, '0' : 1, '1' : 2 } |
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
Grid(표)가 포함된 웹 사이트를 열고, GetGridItemIndex를 이용해 선택한 항목의 순서 값을 받아온 후 메시지 박스로 출력합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Get Target Detail > P_GetGridItemIndex_Test_Web
사용된 변수
browserid = 실행한 브라우저를 지정할 변수
gridindex = Grid 순서 값을 저장할 변수
사용된 속성
[Output] Result =
this.gridindex
연관/유사 액티비티
MouseEvent
MouseEvent
개요
지정한 위치에 클릭 등의 마우스 이벤트를 발생시킵니다.
사용 절차
Action에서 실행할 마우스 이벤트(동작 방법)를 선택하세요.
Click Point에 마우스 포인터가 위치할 좌표를 입력하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Action | 콤보박스 | N | - | Y | 마우스 이벤트(동작 방법)를 선택합니다.(기본값: Click) ※ 타입 종류 - Click, DoubleClick, RightClick, Move, Down, Up, Scroll, DragDrop |
N | Click Point | 문자 | Y | - | Y | 마우스 포인터가 위치할 좌표를 입력합니다.(기본값: '0,0') 'Mouse.Position'을 입력하면 현재 마우스 포인터가 있는 위치를 클릭합니다. |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
Notepad 앱을 열고, MouseEvent 카드를 사용하여 'File' 메뉴를 클릭합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Mouse Action > P_MouseEvent_Test
사용된 변수
pid = 실행된 Notepad 앱을 지정할 변수
사용된 속성
Action = Click
Click Point =
RESUL.TX + 10, RESULT.Y + 10
연관/유사 액티비티
MouseHover, MouseScroll, MouseDrag, MouseDrop, MouseLongPress, DragDrop
KeyboardEvent
KeyboardEvent
개요
대상 UI 객체와 관계 없이 키보드 이벤트를 발생시킵니다. 대상 UI 객체를 지정하지 않고, 포커스가 설정된 UI 객체에 키보드 이벤트가 발생합니다.
사용 절차
Input Type에 실행할 키보드 이벤트(키보드 동작)를 선택하세요.
Input Data에 키보드로 입력할 데이터 내용을 입력하세요.
카드 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Intput Type | 콤보박스 | N | - | Y | 키보드 이벤트(동작 방법)를 선택합니다.(기본값: SendText) - SendText, SendKeys, KeyPress, KeyDown, KeyUp |
N | Intput Data | 문자 | Y | - | N | 이벤트 발생 시 입력될 데이터를 입력합니다. |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
활용 예시
Notepad를 열고, KeyboardEvent 카드를 사용하여 'key0A'를 입력합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > Keyboard Action > P_KeyboardEvent_Test
사용된 변수
inputData = 데이터 입력 변수
calcID = 실행된 Notepad 앱을 지정할 변수
사용된 속성
Input Type = SendKeys
Input Data =
this.inputData
연관/유사 액티비티
SendWindowsMessage
SendWindowsMessage
개요
대상 UI 객체에 윈도우 메세지를 보낸다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
마우스 오른쪽 버튼 클릭을 지원하는 대상 객체를 클릭하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | int | - | 메세지 전달 결과 | 0 |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
N | WMessage | 숫자 | Y | - | N | 윈도우 메세지(숫자)를 입력합니다. |
N | WParam | 숫자 | Y | - | N | 윈도우 메세지와 관련된 특정 정보를 입력합니다. |
N | LParam | 숫자 | Y | - | N | 윈도우 메세지와 관련된 특정 정보를 입력합니다. |
N | Response Timeout | 숫자 | Y | sec | N | 해당 윈도우의 응답을 기다리는 최대 시간(sec)을 입력합니다. |
활용 예시
임의의 어플리케이션을 실행 한 후, 해당 어플리케이션에 윈도우 메세지를 보냅니다. Notepad 앱을 실행한 후, 해당 어플리케이션에 WM_CLOSE 메세지를 보내서 어플리케이션을 종료합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > SendWindowsMessage > P_SendWindowsMessage_Test_Notepad
사용된 변수
없음
사용된 속성
[Output] Result = RESULT
WMessage = 16
WParam = 0
LParam = 0
Response Timeout = 5
연관/유사 액티비티
SendWindowsCopyData
SendWindowsCopyData
개요
대상 UI 객체에 윈도우 메세지(WM_COPYDATA)를 보낸다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
마우스 오른쪽 버튼 클릭을 지원하는 대상 객체를 클릭하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | int | - | 메세지 전달 결과 | 0 |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
N | Data | 문자열 | Y | - | N | 윈도우 메세지와 관련된 특정 정보를 입력합니다. |
N | Response Timeout | 숫자 | Y | msec | Y | 해당 윈도우의 응답을 기다리는 최대 시간(ms)을 입력합니다. |
활용 예시
윈도우 어플리케이션을 실행 한 후, 해당 어플리케이션에 윈도우 메세지(WM_COPYDATA)를 보냅니다. WndMsgTest앱을 실행한 후, 해당 어플리케이션에 WM_COPYDATA 메세지를 보낸다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > SendWindowsMessage > P_SendWindowsCopyData_Test
사용된 변수
없음
사용된 속성
[Output] Result = RESULT
Data = 'Hello!'
Response Timeout = 5
연관/유사 액티비티
SendWindowsShortCut
SendWindowsShortCut
개요
시스템에서 단축 키를 실행합니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
마우스 오른쪽 버튼 클릭을 지원하는 대상 객체를 클릭하세요.
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. | |
N | ALT | 토글버튼 | N | - | Y | ALT키 사용 여부를 입력합니다. |
N | CTRL | 토글버튼 | N | - | Y | CTRL키 사용 여부를 입력합니다. |
SHIFT | 토글버튼 | N | - | Y | SHIFT키 사용 여부를 입력합니다. | |
WIN | 토글버튼 | N | - | Y | WIN키 사용 여부를 입력합니다. | |
Keys | 문자열 | Y | - | N | 키 문자열을 입력합니다. |
활용 예시
윈도우 어플리케이션을 실행 한 후, 해당 어플리케이션에 단축 키(CTRL + ALT + A)와 (CTRL + ALT + X)를 보내 모든 문자열을 선택하고 잘라내기를 실행합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > SendWindowsShortCut > P_SendWindowsShortCut_Test
사용된 변수
없음
사용된 속성
ALT = False
CTRL = True
SHIFT = False
WIN = False
Keys = 'AX'
연관/유사 액티비티
ExecuteRemoteDesktopWindow
ExecuteRemoteDesktopWindow
개요
원격 데스크탑 연결 어플리케이션을 실행한다.
사용 절차
Output PID에 실행된 원격 데스크탑 연결 어플리케이션의 PID를 저장할 변수를 입력하세요.
Host에 접속할 원격 컴퓨터의 이름 또는 IP주소를 입력하세요.
ID에 접속할 원격 컴퓨터의 사용자 ID를 입력하세요.
Password에 접속할 원격 컴퓨터의 사용자 Password를 입력하세요.
Resolution에 원격 데스크탑 연결 뷰어의 해상도를 선택합니다.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | int | - | 원격 데스크탑 연결 어플리케이션의 PID | 0 |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | PID | 숫자 | Y | - | Y | 원격 데스크탑 연결 어플리케이션을 PID를 저장할 변수를 입력합니다. |
N | Host | 문자열 | Y | - | N | 원격 컴퓨터의 이름 또는 IP주소를 입력합니다. |
N | ID | 문자열 | Y | - | N | 사용자 ID를 입력합니다. |
N | Port | 숫자 | Y | - | Y | 원격 데스크탑 연결할 포트를 입력합니다. |
N | Password | 문자열 | Y | - | N | 사용자 password를 입력합니다. |
N | Resolution | 콤보박스 | Y | - | Y | 원격 데스크탑 연결의 해상도를 선택합니다. |
N | Maximize | 토글버튼 | - | - | Y | 원격 데스크탑 연결 어플리케이션의 윈도우를 최대화 할지 여부를 선택합니다. |
N | WaitTime | 숫자 | N | sec | Y | 원격 데스크탑 연결 어플리케이션이 시작할때까지 기다릴 시간을 입력합니다. |
활용 예시
원격 데스크탑 연결 어플리케이션을 실행하고 30초간 대기합니다.
Excel_NewExcel_1K
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > RemoteDesktopWindow > P_ExecuteRemoteDesktopWindow_Test
사용된 변수
없음
사용된 속성
[Output] Result = RESULT
Host = "DESKTOP-COMPUTER"
ID = "test"
Port = 3389
Password = "xxxxxxxx"
Resolution = 1920 x 1080
Maximize = true
WaitTime = 20
연관/유사 액티비티
비 표준 UI 객체 인식 (GUIDetector)
개요
UI 자동화 기술로 인식되지 않는 비 표준 UI객체의 경우 객체를 지정하기에 어려움이 있어, 기존의 라이브러리러를 사용할 수 없습니다. 따라서 GUIDetector라는 추가기능을 설치하여, 학습기반 모델을 통해 인식되지 않는 객체를 인식하는데 도움을 줄 수 있습니다.
이 기능은 비표준 UI를 인식하는데 도움을 주는 기능이므로 완벽하게 객체를 인식하여 실행할 수 는 없지만, 기존의 ImageRecognition과 더불어 비표준 UI의 작업을 수행 할 수 있습니다.
v3.0 부터 64비트 디자이너와 봇에서만 GUIDetector를 사용할 수 있습니다.
v3.1 부터 새 학습 모델이 추가 되었습니다. 새 학습 모델을 사용하면 시간이 오래걸리는 대신 더 많은 객체를 찾을 수 있습니다. 새 학습모델 사용은 디자이너 설정이나 봇 설정의 '엔진' 탭에서 사용여부를 선택할 수 있습니다. 기본값은 기존 모델을 사용합니다.
기존 모델을 사용중이던 사용자가 새 학습모델을 사용하려면 실행엔진을 다시 다운받아서 덮어써야합니다.
두 모델은 서로 호환이 되지 않습니다.
따라서, 설정 변경시 기존 시나리오의 대한 동작은 보장되지 않습니다.
설치 과정에서 아래와 같이 64비트 모드를 선택하면 64비트로 설치가 가능합니다.
v3.0 부터 학습 모델을 저장하는 폴더의 이름이 아래와 같이 변경되었습니다.
GUIDetector 실행을 위해서 아래 그림 처림 디자이너 또는 봇 경로에 ObjectDetector 폴더를 생성합니다.
학습 모델(GuiDetector)과 실행 엔진(Python37)을 각각 다운받아 아래 그림처럼 ObjectDetector 폴더 내부에 압축을 풀어서 저장합니다.
(새 학습모델 : GuiDetector_Grid)
비표준 UI 객체 지정하기
액티비티 카드의 우측 영역에 비표준 UI를 지정할 수 있는 대상 지정 버튼이 표시됩니다.
버튼을 더블 클릭하면 UI객체 지정 모드로 전환되어 디자이너가 최소화되고, 마우스를 사용하여 원하는 대상 UI 객체를 지정할 수 있습니다.
비표준 UI를 지정할때는 위 그림과 같이 비표준 UI가 전체에 박스가 그려지도록 마우스를 화면에 올려서 지정하도록 합니다.
지정 후 객체인식과정(시간소요)이 지나게되면 팝업화면에 인식된 객체가 박스로 그려져 나타납니다. 우상단의 콤보박스로 지정한 타입만 박스로 그리게 할 수 있으며, 화면을 클릭하여 원하는 컨트롤의 영역을 선택한 후 적용버튼을 누르면 지정한 속성이 아래와같이 입력됩니다.
GUIDetectorFindAll
GUIDetectorFindAll
개요
지정된 비표준UI에서 학습모델 기반으로 인식되는 모든 컨트롤 정보를 찾는다.
사용 절차
Control 에 인식된 결과를 저장할 변수를 입력합니다.
액티비티 카드의 No Target을 더블클릭하세요.
비표준UI 대상 객체를 클릭하세요.
인식된 화면을 확인하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Control | List | - | 인식된 모든 컨트롤타입 정보의 리스트 |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Control | 리스트 | Y | - | Y | 인식된 결과를 저장할 변수를 입력합니다. |
N | Application | 문자열 | N | - | Y | 비표준 UI의 부모객체의 프로세스정보 |
N | Title | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 제목 |
N | Name | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 이름 |
N | Value | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 Value |
N | Image | 이미지 | - | - | Y | 인식할 비표준 UI의 대상 이미지 |
N | ControlType | 콤보박스 | ㅛ | - | Y | 인식된 결과에서 가져올 컨트롤타입 이름 |
N | Timeout | 숫자 | N | sec | Y | 대상을 찾고 비표준 UI를 인식해서 컨트롤정보를 가져올때 까지 기다릴 시간을 입력합니다. |
활용 예시
비표준UI가 캡쳐된 이미지를 열고, GUIDetectorFindAll카드를 사용하여 인식된 모든 컨트롤의 이름을 MessageBox로 출력합니다.
예제 파일
메뉴 > 도움말 > 샘플 > Sample > Application > GUIDetector > P_GUIDetectorFindAll
사용된 변수
GUIControl = List에서 이름을 받아올 변수
GUIControlList = 인식된 GUI컨트롤의 리스트
사용된 속성
Control Type = All
GUIDetectorClick
GUIDetectorClick
개요
지정된 비표준UI에서 학습모델로 인식한 컨트롤을 마우스 왼쪽버튼으로 클릭한다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
비표준UI 대상 객체를 클릭하세요.
인식된 화면을 확인하세요.
인식된 화면에서 표시된 컨트롤을 찾아 마우스로 클릭하여 지정한 뒤 적용버튼을 누르세요.
입력된 속성들을 확인하세요.
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Application | 문자열 | N | - | Y | 비표준 UI의 부모객체의 프로세스정보 |
N | Title | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 제목 |
N | Name | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 이름 |
N | Value | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 Value |
N | Image | 이미지 | - | - | Y | 인식할 비표준 UI의 대상 이미지 |
N | Control Type | 콤보박스 | Y | - | Y | 인식된 결과에서 가져올 컨트롤타입 이름 |
N | Control Index | 숫자 | N | - | N | 같은 컨트롤 타입 중 인식할 대상의 인덱스 번호 |
N | Control Image | 이미지 | Y | - | Y | 컨트롤 선택화면에서 선택된 컨트롤의 크롭이미지 |
N | Control Bounds | Rect | N | - | Y | 선택된 컨트롤의 Bounds 정보 |
N | Timeout | 숫자 | N | sec | Y | 대상을 찾고 비표준 UI를 인식해서 컨트롤정보를 가져올때 까지 기다릴 시간을 입력합니다. |
활용 예시
비표준 UI가 캡처된 이미지를 열고 GUIDetectorClick카드를 사용하여 객체를 인식한 뒤 선택한 객체를 마우스로 클릭합니다.
예제 파일
메뉴 > 도움말 > 샘플 > Sample >Application > GUIDetector > P_GUIDetectorClick
사용된 변수
없음
사용된 속성
Control Type = Button Control Index = 0
GUIDetectorDoubleClick
GUIDetectorDoubleClick
개요
지정된 비표준UI에서 학습모델로 인식한 컨트롤을 마우스 왼쪽버튼으로 더블 클릭한다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
비표준UI 대상 객체를 클릭하세요.
인식된 화면을 확인하세요.
인식된 화면에서 표시된 컨트롤을 찾아 마우스로 클릭하여 지정한 뒤 적용버튼을 누르세요.
입력된 속성들을 확인하세요.
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Application | 문자열 | N | - | Y | 비표준 UI의 부모객체의 프로세스정보 |
N | Title | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 제목 |
N | Name | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 이름 |
N | Value | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 Value |
N | Image | 이미지 | - | - | Y | 인식할 비표준 UI의 대상 이미지 |
N | Control Type | 콤보박스 | Y | - | Y | 인식된 결과에서 가져올 컨트롤타입 이름 |
N | Control Index | 숫자 | N | - | N | 같은 컨트롤 타입 중 인식할 대상의 인덱스 번호 |
N | Control Image | 이미지 | Y | - | Y | 컨트롤 선택화면에서 선택된 컨트롤의 크롭이미지 |
N | Control Bounds | Rect | N | - | Y | 선택된 컨트롤의 Bounds 정보 |
N | Timeout | 숫자 | N | sec | Y | 대상을 찾고 비표준 UI를 인식해서 컨트롤정보를 가져올때 까지 기다릴 시간을 입력합니다. |
활용 예시
비표준 UI가 캡처된 이미지를 열고 GUIDetectorDoubleClick카드를 사용하여 객체를 인식한 뒤 선택한 객체를 마우스로 더블 클릭합니다.
예제 파일
메뉴 > 도움말 > 샘플 > Sample >Application > GUIDetector > P_GUIDetectorDoubleClick
사용된 변수
없음
사용된 속성
Control Type = Number Control Index = 4
GUIDetectorRightClick
GUIDetectorRightClick
개요
지정된 비표준UI에서 학습모델로 인식한 컨트롤을 마우스 오른쪽버튼으로 클릭한다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
비표준UI 대상 객체를 클릭하세요.
인식된 화면을 확인하세요.
인식된 화면에서 표시된 컨트롤을 찾아 마우스로 클릭하여 지정한 뒤 적용버튼을 누르세요.
입력된 속성들을 확인하세요.
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Application | 문자열 | N | - | Y | 비표준 UI의 부모객체의 프로세스정보 |
N | Title | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 제목 |
N | Name | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 이름 |
N | Value | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 Value |
N | Image | 이미지 | - | - | Y | 인식할 비표준 UI의 대상 이미지 |
N | Control Type | 콤보박스 | Y | - | Y | 인식된 결과에서 가져올 컨트롤타입 이름 |
N | Control Index | 숫자 | N | - | N | 같은 컨트롤 타입 중 인식할 대상의 인덱스 번호 |
N | Control Image | 이미지 | Y | - | Y | 컨트롤 선택화면에서 선택된 컨트롤의 크롭이미지 |
N | Control Bounds | Rect | N | - | Y | 선택된 컨트롤의 Bounds 정보 |
N | Timeout | 숫자 | N | sec | Y | 대상을 찾고 비표준 UI를 인식해서 컨트롤정보를 가져올때 까지 기다릴 시간을 입력합니다. |
활용 예시
비표준 UI가 캡처된 이미지를 열고 GUIDetectorRightClick카드를 사용하여 객체를 인식한 뒤 선택한 객체를 마우스로 우클릭합니다.
예제 파일
메뉴 > 도움말 > 샘플 > Sample >Application > GUIDetector > P_GUIDetectorRightClick
사용된 변수
없음
사용된 속성
Control Type = CheckBox_Unchecked Control Index = 0
GUIDetectorMouseHover
GUIDetectorMouseHover
개요
지정된 비표준UI에서 학습모델로 인식한 컨트롤에 마우스 포인터가 이동한다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
비표준UI 대상 객체를 클릭하세요.
인식된 화면을 확인하세요.
인식된 화면에서 표시된 컨트롤을 찾아 마우스로 클릭하여 지정한 뒤 적용버튼을 누르세요.
입력된 속성들을 확인하세요.
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Application | 문자열 | N | - | Y | 비표준 UI의 부모객체의 프로세스정보 |
N | Title | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 제목 |
N | Name | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 이름 |
N | Value | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 Value |
N | Image | 이미지 | - | - | Y | 인식할 비표준 UI의 대상 이미지 |
N | Control Type | 콤보박스 | Y | - | Y | 인식된 결과에서 가져올 컨트롤타입 이름 |
N | Control Index | 숫자 | N | - | N | 같은 컨트롤 타입 중 인식할 대상의 인덱스 번호 |
N | Control Image | 이미지 | Y | - | Y | 컨트롤 선택화면에서 선택된 컨트롤의 크롭이미지 |
N | Control Bounds | Rect | N | - | Y | 선택된 컨트롤의 Bounds 정보 |
N | Timeout | 숫자 | N | sec | Y | 대상을 찾고 비표준 UI를 인식해서 컨트롤정보를 가져올때 까지 기다릴 시간을 입력합니다. |
활용 예시
비표준 UI가 캡처된 이미지를 열고 GUIDetectorMouseHover카드를 사용하여 객체를 인식한 뒤 선택한 객체위로 마우스 포인터를 이동합니다.
예제 파일
메뉴 > 도움말 > 샘플 > Sample >Application > GUIDetector > P_GUIDetectorMouseHover
사용된 변수
없음
사용된 속성
Control Type = Tab Control Index = 3
GUIDetectorTextInput
GUIDetectorTextInput
개요
지정된 비표준UI에서 학습모델로 인식한 컨트롤에 속성에서 입력한 텍스트를 입력한다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
비표준UI 대상 객체를 클릭하세요.
인식된 화면을 확인하세요.
인식된 화면에서 표시된 컨트롤을 찾아 마우스로 클릭하여 지정한 뒤 적용버튼을 누르세요.
입력된 속성들을 확인하세요.
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Application | 문자열 | N | - | Y | 비표준 UI의 부모객체의 프로세스정보 |
N | Title | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 제목 |
N | Name | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 이름 |
N | Value | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 Value |
N | Image | 이미지 | - | - | Y | 인식할 비표준 UI의 대상 이미지 |
N | Control Type | 콤보박스 | Y | - | Y | 인식된 결과에서 가져올 컨트롤타입 이름 |
N | Control Index | 숫자 | N | - | N | 같은 컨트롤 타입 중 인식할 대상의 인덱스 번호 |
N | Control Image | 이미지 | Y | - | Y | 컨트롤 선택화면에서 선택된 컨트롤의 크롭이미지 |
N | Control Bounds | Rect | N | - | Y | 선택된 컨트롤의 Bounds 정보 |
N | Timeout | 숫자 | N | sec | Y | 대상을 찾고 비표준 UI를 인식해서 컨트롤정보를 가져올때 까지 기다릴 시간을 입력합니다. |
N | Input Text | 문자열 | Y | - | N | 입력할 텍스트 문자열 |
N | Clear Before | 토글버튼 | N | - | Y | 지정한 컨트롤에 입력된 문자열을 모두 지울 것인지 유무 |
N | Done | 토글버튼 | N | - | Y | 입력후 엔터키를 입력할 것인지 유무 |
N | Before Delay | 숫자 | N | ms | Y | 키를 입력하기 전의 딜레이 |
N | After Delay | 숫자 | N | ms | Y | 키를 입력하고 난 후의 딜레이 |
N | Interval | 숫자 | N | ms | Y | 키입력시 간격에 추가될 딜레이 |
활용 예시
비표준 UI가 캡처된 이미지를 열고 GUIDetectorTextInput카드를 사용하여 객체를 인식한 뒤 선택한 객체에 텍스트를 입력합니다.
예제 파일
메뉴 > 도움말 > 샘플 > Sample >Application > GUIDetector > P_GUIDetectorTextInput
사용된 변수
없음
사용된 속성
Control Type = EditBox Control Index = 0 Input Text = 'GUI Detector'
GUIDetectorGetBounds
GUIDetectorGetBounds
개요
지정된 비표준UI에서 학습모델 기반으로 인식되는 컨트롤 정보를 찾고, 해당 컨트롤의 Bounds를 리턴한다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
비표준UI 대상 객체를 클릭하세요.
인식된 화면을 확인하세요.
인식된 화면에서 표시된 컨트롤을 찾아 마우스로 클릭하여 지정한 뒤 적용버튼을 누르세요.
입력된 속성들을 확인하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | bool | - | 인식된 컨트롤의 Bounds 정보 |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Application | 문자열 | N | - | Y | 비표준 UI의 부모객체의 프로세스정보 |
N | Title | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 제목 |
N | Name | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 이름 |
N | Value | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 Value |
N | Image | 이미지 | - | - | Y | 인식할 비표준 UI의 대상 이미지 |
N | Control Type | 콤보박스 | Y | - | Y | 인식된 결과에서 가져올 컨트롤타입 이름 |
N | Control Index | 숫자 | N | - | N | 같은 컨트롤 타입 중 인식할 대상의 인덱스 번호 |
N | Control Image | 이미지 | Y | - | Y | 컨트롤 선택화면에서 선택된 컨트롤의 크롭이미지 |
N | Control Bounds | Rect | N | - | Y | 선택된 컨트롤의 Bounds 정보 |
N | Timeout | 숫자 | N | sec | Y | 대상을 찾고 비표준 UI를 인식해서 컨트롤정보를 가져올때 까지 기다릴 시간을 입력합니다. |
활용 예시
비표준 UI가 캡처된 이미지를 열고 GUIDetectorGetBounds카드를 사용하여 객체를 인식한 뒤 선택한 객체의 Bounds 정보를 가져옵니다.
예제 파일
메뉴 > 도움말 > 샘플 > Sample >Application > GUIDetector > P_GUIDetectorGetBounds
사용된 변수
controlBounds = 인식한 컨트롤의 bounds 정보
사용된 속성
Control Type = EditBox Control Index = 0
차트 인식 (ChartDetector)
개요
일반적으로 차트는 UI 자동화 기술로 인식되지 않으며, 형태가 일정하지 않아 광학문자인식(OCR)로도 차트의 값을 추출 할 수 없습니다. Brity RPA는 AI 기술을 활용하여 차트의 정보와 데이터를 추출하는데 도움을 줄 수 있습니다.
본 기능은 꺽은 선형(Line), 원형(Pie), 세로막대형(Bar) 타입의 차트만 인식이 가능합니다.
64비트 디자이너와 봇에서만 ChartDetector를 사용할 수 있습니다.
설치 과정에서 아래와 같이 64비트 모드를 선택하면 64비트로 설치가 가능합니다.
ChartDetector 실행을 위해서 아래 그림 처림 디자이너 또는 봇 경로에 ObjectDetector 폴더를 생성합니다.
이미 존재한다면 생성하지 않아도 됩니다.
학습 모델과 실행 엔진을 각각 다운받아 아래 그림처럼 ObjectDetector 폴더 내부에 압축을 풀어서 저장합니다.
GuiDetector와 동일한 엔진을 사용하기에 기존에 Pyton37 폴더가 있다면 학습 모델만 사용하면 됩니다.
GetChartInfo
GetChartInfo
개요
지정된 차트의 기본 정보를 인식하여 출력합니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
대상 차트를 클릭하세요.
입력된 속성들을 확인하세요.
차트 정보를 받을 Output을 지정하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | Object | - | 인식된 차트의 정보가 포함된 객체 |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Application | 문자열 | N | - | Y | 비표준 UI의 부모객체의 프로세스정보 |
N | Title | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 제목 |
N | Name | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 이름 |
N | Value | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 Value |
N | Image | 이미지 | - | - | Y | 인식할 비표준 UI의 대상 이미지 |
N | Timeout | 숫자 | N | sec | Y | 대상을 찾고 비표준 UI를 인식해서 컨트롤정보를 가져올때 까지 기다릴 시간을 입력합니다. |
N | Focus Before | True/False | N | Y | 액티비티 카드가 작동하기 전에 전에 대상 객체에 포커스를 설정할 수 있습니다. 대상 객체에 포커스를 설정할 수 없는 경우에는 대상 앱의 메인 화면에 포커스를 설정합니다. 대상 앱이 여러 개가 실행되어 있는 경우에는 가장 앞에 위치한 앱에서부터 객체를 탐색합니다. 대상 객체를 찾지 못하면 뒤에 위치한 앱을 앞으로 가지고 온 다음 다시 탐색합니다. | |
N | Draw Bounds | True/False | N | Y | 실행 시 객체를 인식하는 박스(테두리)가 표시되도록 설정합니다. | |
N | OnError | 콤보박스 | N | Y | 오류 발생 시 처리 방법을 선택합니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
인식 예시
인식되는 차트 정보
Type : 3가지 차트 타입(Bar,Pie,Line)
Title : 차트의 타이틀(노란색 박스)
MinYAxis : 차트의 Y좌표 최소값
MaxYAxis : 차트의 Y좌표 최대값
PlotArea : 차트 영역(하늘색 박스)
LegendArea : 차트 라벨 영역(녹색 박스)
활용 예시
차트가 포함된 엑셀 파일을 열고 GetChartInfo카드를 사용하여 차트를 인식한 뒤 선택한 차트의 기본 정보를 가져옵니다.
대상 차트
예제 파일
메뉴 > 도움말 > 샘플 > Sample >Application > ChartDetection > Get_ChartInfo
사용된 변수
ChartInfo = 인식한 차트의 객체 정보를 출력할 변수
사용된 속성
[Output]Result = this.ChartInfo
this.ChartInfo.Type = Bar this.ChartInfo.Title = Sales Quantity this.ChartInfo.MinYAxis = 0 this.ChartInfo.MaxYAxis = 250 this.ChartInfo.PlotArea = 38, 49, 464, 225 this.ChartInfo.LegendArea = 118, 258, 365, 278
GetChartData
GetChartData
개요
지정된 차트의 데이터를 인식하여 출력합니다.
사용 절차
액티비티 카드의 No Target을 더블클릭하세요.
대상 차트를 클릭하세요.
입력된 속성들을 확인하세요.
차트 데이터를 받을 Output을 지정하세요.
카드 출력 속성
속성 | 리턴타입 | 리턴 추가설명 | 설명 | 결과 예시 |
|---|---|---|---|---|
Result | 2D List | - | 인식된 차트의 데이터가 포함된 이차원 리스트. 차트의 그룹 하위에 각 데이터를 가지고 있는 구조입니다. 상세 내용은 아래 인식 예시를 참조하십시요. |
카드 입력 속성
공통여부 | 속성 | 유형 | 필수여부 | 단위 | 자동입력여부 | 설명 |
|---|---|---|---|---|---|---|
N | Application | 문자열 | N | - | Y | 비표준 UI의 부모객체의 프로세스정보 |
N | Title | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 제목 |
N | Name | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 이름 |
N | Value | 문자열 | Y | - | Y | 비표준 UI의 부모객체의 Value |
N | Image | 이미지 | - | - | Y | 인식할 비표준 UI의 대상 이미지 |
N | Timeout | 숫자 | N | sec | Y | 대상을 찾고 비표준 UI를 인식해서 컨트롤정보를 가져올때 까지 기다릴 시간을 입력합니다. |
N | Focus Before | True/False | N | Y | 액티비티 카드가 작동하기 전에 전에 대상 객체에 포커스를 설정할 수 있습니다. 대상 객체에 포커스를 설정할 수 없는 경우에는 대상 앱의 메인 화면에 포커스를 설정합니다. 대상 앱이 여러 개가 실행되어 있는 경우에는 가장 앞에 위치한 앱에서부터 객체를 탐색합니다. 대상 객체를 찾지 못하면 뒤에 위치한 앱을 앞으로 가지고 온 다음 다시 탐색합니다. | |
N | Draw Bounds | True/False | N | Y | 실행 시 객체를 인식하는 박스(테두리)가 표시되도록 설정합니다. | |
N | DataSortMethod | ComboBox | Y | - | Y | 차트 데이터의 그룹내부의 데이터를 정렬하는 방법을 지정합니다. NotUse(정렬없음, 데이터 순서대로 표시), Descending(내림차순), Aescending(오름차순) |
N | OnError | 콤보박스 | N | Y | 오류 발생 시 처리 방법을 선택합니다. | |
Y | - | - | - | - | App 라이브러리의 공통 속성입니다. |
꺽은 선형(Line), 원형(Pie), 세로막대형(Bar) 타입의 차트에 대해서 각각 다른 결과를 출력합니다.
인식 예시(꺽은 선형)
꺽은 선형(Line)
인식되는 차트 정보
Group : 각 꺽은 선형(CompanyA, CompanyB, CompanyC)
각 Group의 하위에 아래 정보가 존재
Color : 각 꺽은 선형의 색성(RGB)
Data : 꺽은 선형의 데이터 List
각 Data 하위에 아래 정보가 존재
Value : 각 Line상의 점의 값
DataPoint : 각 Line상의 점의 좌표
활용 예시(꺽은 선형)
차트가 포함된 엑셀 파일을 열고 GetChartData카드를 사용하여 차트를 인식한 뒤 선택한 차트의 데이터 정보를 가져옵니다.
대상 차트
예제 파일
메뉴 > 도움말 > 샘플 > Sample >Application > ChartDetection >Get_LineChartData
사용된 변수
ChartData = 인식한 차트의 데이터 정보를 출력할 변수
사용된 속성
[Output]Result = this.ChartData DataSortMethod = NotUse
사용 예시
this.ChartData.Group(0).Color = 166, 166, 166(회색) this.ChartData.Group(1).Color = 95, 157, 214(파랑) this.ChartData.Group(2).Color = 237, 127, 53(주황)
this.ChartData.Group(0).Data(0).Value = 48.86 this.ChartData.Group(0).Data(0).DataPoint = 92, 374 this.ChartData.Group(1).Data(0).Value = 8.91 this.ChartData.Group(1).Data(0).DataPoint = 92, 336 this.ChartData.Group(2).Data(0).Value = 198.94 this.ChartData.Group(2).Data(0).DataPoint = 92, 194
인식 예시(원형)
원형(Pie)
인식되는 차트 정보
Group : 각 원형(CompanyA), 위 예시에는 1개만 존재
각 Group의 하위에 아래 정보가 존재
Data : 원형의 데이터 List
각 Data 하위에 아래 정보가 존재
Value : 각 Pie 영역의 값(%)
Center : 각 Pie 영역의 중심점
X1 : 각 Pie 영역의 좌측점
X2 : 각 Pie 영역의 우측점
InnerAngle : 각 Pie 영역의 내각
AccumAngle : 각 Pie 영역의 축적된 각도(좌측 기준)
Color : 각 Pie 영역의 색상
활용 예시(원형)
차트가 포함된 엑셀 파일을 열고 GetChartData카드를 사용하여 차트를 인식한 뒤 선택한 차트의 데이터 정보를 가져옵니다.
대상 차트
예제 파일
메뉴 > 도움말 > 샘플 > Sample >Application > ChartDetection >Get_PieChartData
사용된 변수
ChartData = 인식한 차트의 데이터 정보를 출력할 변수
사용된 속성
[Output]Result = this.ChartData DataSortMethod = NotUse
사용 예시
0도를 기준으로 시계방향으로 데이터가 위치한다.
this.ChartData.Group(0).Data(0).Value = 18.19% this.ChartData.Group(0).Data(0).Center = 240, 145 this.ChartData.Group(0).Data(0).X1 = 240, 49 this.ChartData.Group(0).Data(0).X2 = 328, 105 this.ChartData.Group(0).Data(0).InnerAngle = 65.48도 this.ChartData.Group(0).Data(0).AccumAngle = 0.01도(좌측 기준) this.ChartData.Group(0).Data(0).Color = 91, 155, 213 this.ChartData.Group(0).Data(1).Value = 9% this.ChartData.Group(0).Data(1).Center = 240, 145 this.ChartData.Group(0).Data(1).X1 = 328, 105 this.ChartData.Group(0).Data(1).X2 = 335, 158 this.ChartData.Group(0).Data(1).InnerAngle = 32.41도 this.ChartData.Group(0).Data(1).AccumAngle = 65.49도(좌측 기준) this.ChartData.Group(0).Data(1).Color = 237, 125, 49
인식 예시(세로막대형)
세로막대형(Bar)
인식되는 차트 정보
Group : 각 꺽은 선형(CompanyA, CompanyB, CompanyC)
각 Group의 하위에 아래 정보가 존재
Color : 각 세로막대형의 색성(RGB)
Data : 세로막대형의 데이터 List
각 Data 하위에 아래 정보가 존재
Value : 각 Bar의 값
BarRect : 각 Bar의 영역
활용 예시(세로막대형)
차트가 포함된 엑셀 파일을 열고 GetChartData카드를 사용하여 차트를 인식한 뒤 선택한 차트의 데이터 정보를 가져옵니다.
대상 차트
예제 파일
메뉴 > 도움말 > 샘플 > Sample >Application > ChartDetection >Get_BarChartData
사용된 변수
ChartData = 인식한 차트의 데이터 정보를 출력할 변수
사용된 속성
[Output]Result = this.ChartData DataSortMethod = NotUse
사용 예시
this.ChartData.Group(0).Color = 91, 155, 213(파랑) this.ChartData.Group(1).Color = 237, 125, 49(주황) this.ChartData.Group(2).Color = 165, 165, 165(회색)
this.ChartData.Group(0).Data(0).Value = 50.54 this.ChartData.Group(0).Data(0).BarRect = 64, 190, 89, 226