AntBot Studio > Activity > 화면제어 > Object > Finder
정의 (Description)
WEB 또는 SAP 의 요소(Element) 를 찾는 Activity 입니다.
찾은 요소를 이용하여 클릭 기능, 속성 가져오기 기능,이미지캡쳐 등을 제공 합니다.
속성 (Properties) (*은 필수값입니다.)
| 항목 | 설명 | 데이터타입 | 기본값 | 설정가능옵션 |
|---|---|---|---|---|
| Common | ||||
| Activity 이름 | 해당 Activity의 이름을 설정합니다. - 기본값은 Activity명이며, 사용자가 직접 변경 가능합니다. |
String | Finder | |
| 에러무시여부 | 해당 Activity에서 발생한 오류를 무시할지 선택합니다. | Boolean | False | - True : 액티비티에서 발생하는 오류사항 무시 - False : 액티비티에서 발생하는 오류를 출력 |
| 지연(시작전) | 액티비티를 시작하기 전 대기시간을 설정합니다. | Int32 | Null | ms단위이며 기본은 0ms입니다. (예시 : 입력값 1000일경우 1초후 실행) |
| 지연(완료후) | 액비티티를 종료 후 대기시간을 설정합니다. | Int32 | Null | ms단위이며 기본은 0ms입니다. (예시 : 입력값 1000일경우 종료 후 1초대기) |
| 타임 아웃 | 액티비티의 최대 실행 시간을 설정합니다. 해당 시간이 지나면 실행실패로 판정합니다. | Int32 | 15000 | ms단위이며 기본은 15000ms입니다. (예시 : 입력값 15000일 경우 15초 후 타임아웃 실패로 판정되게됩니다.) |
| Information | ||||
| 이미지파일 | Element 속성들에 대한 정보(Image File)의 정보입니다. | String | Null | |
| Input Common | ||||
| Finder 속성들 * | Element를 찾기 위한 속성값을 가져옵니다. Web 이면 Web속성(tagname, classname등 )을 가집니다. |
String | Null | |
| 대상 Process명 * | 선택한 창에 대한 Process명을 가져옵니다. (예시 : Chrome, msEdge) |
String | Null | |
| 대상 창 Title 명 | 선택한 창의 Title명을 가져옵니다. | String | Null | |
| 출력힐 UI 속성명 | Element에서 출력하고자 하는 속성값을 설정합니다. (예시 : innerText, Value) |
String | Null | |
| Option | ||||
| 재시도 횟수 | 설정한 영역에 에러가 있어 찾지 못할 경우, 액티비티의 재시도 횟수를 설정합니다. | Int32 | 3 | |
| Option Execution | ||||
| Scroll옵션(Web만) | Web관련 Element를 찾은 후 Scroll옵션 적용 유형을 지정합니다. | Center | -Center : Finder가 찾는 Element의 요소가 Center로 오도록 스크롤합니다. -None : 마우스 Scroll이벤트가 발동하지않습니다. |
|
| 결과 이미지 캡쳐 여부 | 결과 이미지 캡쳐 여부를 설정합니다. | Boolean | False | -True : 결과 이미지를 캡쳐합니다. -False : 이미지 캡쳐를 진행하지 않습니다. |
| 마우스 이벤트 Skip | 요소를 찾은 후 모든 마우스 이벤트를 생략합니다. | Boolean | False | -True : 마우스 이벤트를 생략합니다. -False : 마우스 이벤트가 발동합니다. |
| 마우스동작 | 요소를 찾은 후 마우스 이벤트에 대한 액션을 설정합니다. | String | None | -None : Elemnet의 고유Action을 수행합니다. -LButtonClick : 마우스 왼쪽 버튼을 1회 클릭합니다. -RButtonClick : 마우스 오른쪽 버튼을 1회 클릭합니다. -LButtonDblClick : 마우스 왼쪽 버튼을 2회 클릭합니다. -Hover : 마우스가 해당 Element 위치로 이동합니다. |
| 마우스클릭X좌표 | 마우스 이벤트에 대한 X좌표를 설정합니다. | Int32 | -1 | |
| 마우스클릭Y좌표 | 마우스 이벤트에 대한 Y좌표를 설정합니다. | Int32 | -1 | |
| Output | ||||
| 결과 | 찾은 Elenment의 속성값을 출력합니다. | String | Null | |
| 결과 Element | 찾은 Element에 대한 Finder의 객체를 출력합니다. | ktds.AntBot.Common.Finder.FinderElement | Null | |
| 결과 이미지 | 찾은 Element에 대한 Image 객체를 출력합니다. | System.Drawing.Image | Null | |
| 찾기 결과 | 찾은 Element 결과를 출력합니다. | Boolean | Null |
액티비티 사용 예시 (Example Usage)
Finder 요소 찾기 시작
- 사진기 버튼을 클릭해서 Finder 작업을 시작합니다.
- 사진기 버튼을 클릭해서 Finder 작업을 시작합니다.
Finder Toolbar
- 작업 시작시 열리는 Finder Toolbar 에선 무엇을(유형 선택) 작업 할것인지 어떻게(방식 선택) 작업할 것 인지 선택 해야 합니다.
- 작업 시작시 열리는 Finder Toolbar 에선 무엇을(유형 선택) 작업 할것인지 어떻게(방식 선택) 작업할 것 인지 선택 해야 합니다.
유형 선택(WEB/SAP)
- WEB : Web 브라우져 환경에서 작업을 진행하며 지원 하는 브라우저 는 아래와 같습니다. 해당 기능은 브라우저별 Driver가 설치되어 있어야 하며 사용중인 브라우저와 웹드라이버 버전을 일치 시켜야 합니다.
브라우저 지원 여부 Chrome O Edge O Internet Exprorer X Firefox X 네이버 웨일 X SAP : SAP 어플리케이션 환경에서 작업을 진행합니다.
방식 선택
영역표시
- 선택영역의 요소값을 저장하고 실시간으로 해당 영역을 표시해줍니다.
영역표시 실제 적용 모습
윈도우
네모칸 중간에 빨간 십자가를 목표하는 요소에 위치시켜 S키를 눌러 추출하는 방식입니다.
윈도우 실제 적용 모습
선택 저장
선택 저장을 True상태로 설정 할 경우 Toolbar에서 선택하는 작업(유형선택, 방식선택)을 기존 방법으로 자동적용하며 작업 시 Toolbar가 등장하지 않습니다.
선택 저장초기화 하는 방법
선택 저장 옵션을 다시 초기화 하기 위해서는 AntbotStudio > 상단 "홈" 메뉴 > Finder초기화버튼을 클릭해주시면 됩니다.
실제 사용 예제
- 네이버 검색창에 "Antbot" 검색하기
기본 프로세스 구성
브라우져 열기액티비티 활용하여 "NAVER"접속
도구상자에서 "브라우져 열기"액티비티를 Main Sequence에 추가합니다.
브라우져 열기 액티비티의 속성창에 값을 설정합니다.
- URL : "https://www.naver.com/"
- 브라우져 타입 : Chrome
Finder액티비티를 활용하여 NAVER 검색창 찾기
- 도구상자에서 "finder"액티비티를 Main Sequence에 추가해줍니다.
- ※해당 작업을 위해서는 Naver메인화면이 실행되어있어야 합니다.
- Finder액티비티의 캡쳐버튼을 클릭합니다.
- Toolbar에서 "영역표시"를 선택하고 "WEB"을 선택합니다.
- Web Auto Toolbar에서 Naver를 선택합니다.
- NAVER의 검색창에 마우스를 가져가면 붉은색으로 선택영역이 보이게됩니다.
- 해당 영역이 붉은색으로 보일때 클릭합니다.
- Finder 액티비티 Input Common의 속성값이 정상적으로 들어갔는지 확인합니다.
- Finder 속성들을 직접 확인하고 편집 가능합니다.
- Finder 마우스 아이콘을 클릭하여 마우스액션을 선택합니다.
- Finder 마우스 액션을 LButtonDblClick으로 설정합니다.
키보드 입력 액티비티를 활용하여 "Antbot"입력하기
- 도구상자에서 "키보드입력"액티비티를 Main Sequence에 추가합니다.
- 키보드입력 액티비티에 "Antbot" 을 입력합니다.
실제 실행모습
- 네이버 검색창에 "Antbot" 검색하기