AntBot Studio > Activity > 화면제어 > Object > Finder 콤보박스

정의 (Description)

콤보박스 요소 안에 열거된 항목 중 특정 항목을 선택하는 Activity입니다.

브라우져 내에서 Tag 속성 값이 Combobox인 항목만 선택 가능합니다.

속성 (Properties) (*은 필수값입니다.)

항목	설명	데이터타입	기본값	설정가능옵션
Common
Activity이름	해당 Activity의 이름을 설정합니다. - 기본값은 Activity명이며, 사용자가 직접 변경 가능합니다.	String	Finder 콤보박스
에러무시여부	해당 Activity에서 발생한 오류를 무시할지 선택합니다.	Boolean	False	- True : 액티비티에서 발생하는 오류사항 무시 - False : 액티비티에서 발생하는 오류를 출력
지연(시작전)	액티비티를 시작하기 전 대기시간을 설정합니다.	Int32	Null	ms단위이며 기본은 0ms입니다. (예시 : 입력값 1000일경우 1초후 실행)
지연(완료후)	액티비티를 종료 후 대기시간을 설정합니다.	Int32	Null	ms단위이며 기본은 0ms입니다. (예시 : 입력값 1000일경우 종료 후 1초대기)
Information
이미지파일	Element 속성들에 대한 정보(Image File)의 정보입니다.	String	Null
Input Common
Finder 속성들 *	Element를 찾기 위한 속성값을 가져옵니다. Web 이면 Web속성(tagname, classname등 )을 가집니다.	String	Null
대상 Process명 *	선택한 Element의 페이지에 대한 Process명을 가져옵니다. (예시 : Chrome, msEdge)	String	Null
대상 창 Title명 *	선택한 Element의 페이지에 대한 Title 명을 가져옵니다.	String	Null
찾을 Text	콤보박스 내 항목들 중 찾을 항목에 대한 값을 지정합니다.	String	Null
찾을 방법	지정한 항목을 찾을 기준을 설정합니다.	String	Index	- Index - text - Value
Option
재시도 횟수	해당 기능을 재시도하는 횟수를 설정합니다.	Int32	3
Output
찾기 결과	해당 element 요소 찾기 성공 여부를 반환합니다.	Boolean	Null	- True : 찾기 성공 시 True 반환. - False : 찾기 실패 시 False 반환

액티비티 사용 예시 (Example Usage)

Sequence 내부에 Finder 콤보박스 액티비티 배치
액티비티 내부에 카메라 모양 아이콘 버튼 클릭
Combobox 항목 레코딩 진행
- Toolbar 레코딩 방식 지정
  - 영역 선택 유형
    Web : 웹 어플리케이션 환경에서 액티비티를 동작 시킬 경우
    SAP : SAP 어플리케이션 환경에서 액티비티를 동작 시킬 경우
  - 영역 선택 방식 : 영역표시/윈도우 중 한가지 선택
  - 선택 저장 : 선택저장을 체크 후에 영역 선택 진행 시 해당 방식 저장됨
    (방식 변경을 위한 초기화 진행 시 Antbot Studio 상단의 Finder 초기화 버튼 클릭)
- Web Auto Toolbar에서 선택 할 항목이 포함된 페이지 선택
- 레코딩 방식 '영역표시' 선택 시
  - 마우스가 이동하는 위치(한 위치에서 0.5초 대기 후 분석시작)의 Element를 분석하여
    Element의 크기와 위치에 맞게 영역이 표시됩니다. 해당 영역이 찾는 영역이 맞다면 클릭하여 영역을 레코딩합니다.
- 레코딩 방식 '윈도우' 선택 시
  - 박스의 한 가운데 빨간색 십자가가 있으며, 해당 십자가의 가운데 위치를 Recording 하고자 하는 Element이 위치시킨 후
    S 키를 눌러 영역을 레코딩합니다. (레코딩 진행 취소는 C키를 눌러 취소합니다.)
- 잘못된 항목 선택 시 오류 메세지 발생
  - Element의 Tag 속성이 Combobox가 아닌 영역 선택 시 해당 오류 메세지 발생
Combobox 항목 중 선택할 항목 지정
- 선택할 Text 스크롤 박스 아래 버튼으로 확인 후 선택
- 선택할 Text or 속성창에서 찾을 Text에 값 직접 입력
실행 결과 화면
- 찾을 항목 설정 화면
- 실행 전 화면
- 실행 결과