IA-Connect UI
IA-Connect 클라우드에서 온-프레미스 가상 머신 또는 Citrix 또는 Microsoft 원격 데스크톱 'RDS' 연결을 통해 RPA 기능을 추가하는 로봇 프로세스 자동화 'RPA' 플랫폼입니다. 이 모듈은 Windows 애플리케이션 사용자 인터페이스 자동화 'UIA'에 대한 모듈입니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | Ultima Labs |
| URL | https://www.ultima.com/ultima-labs |
| 전자 메일 | IAConnect@ultima.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Ultima Business |
| 웹 사이트 | https://www.ultima.com/ultima-labs |
| 개인 정보 보호 정책 | https://www.ultima.com/privacy-policy |
| 카테고리 | IT 작업; 생산력 |
IA-Connect Power Automate Cloud Flows의 RPA 기능을 온-프레미스 가상 머신 또는 Citrix 또는 RDS(Microsoft Remote Desktop) 연결을 통해 RPA 기능을 추가하는 RPA(로봇 프로세스 자동화) 플랫폼입니다. IA-Connect 커넥터는 800개 이상의 작업을 제공하므로 Power Automate 클라우드 흐름에서 직접 모든 유형의 온-프레미스 애플리케이션을 자동화할 수 있습니다. 모든 IA-Connect 작업은 Power Automate Cloud Flow에서 직접 사용할 수 있으며, 클라우드 기반 애플리케이션과 온-프레미스 애플리케이션 간에 쉽게 통합할 수 있으며, RPA 프로세스에서 기존 Power Automate 조건, 루프, 동적 콘텐츠, 식 및 예외 처리를 활용할 수 있습니다. IA-Connect 커넥터를 활용하면 흐름 실행 기록의 전체 실행 기록 및 감사 가능성도 제공하는 동시에 RPA 프로세스를 개발하기 위한 별도의 애플리케이션/콘솔/스튜디오가 필요하지 않습니다.
필수 조건
IA-Connect 커넥터를 사용하려면 IA-Connect 소프트웨어를 설치해야 합니다. 30일 동안 무료로 테스트할 수 있으며, IA-Connect 라이선스가 필요합니다.
IA-Connect 소프트웨어는 다음 두 가지 주요 구성 요소로 구성됩니다.
IA-Connect Orchestrator는 사용자 고유의 Azure 테넌트에서 호스트할 Azure WebApp입니다. 이는 하나 이상의 온-프레미스 또는 클라우드 기반 가상 머신에 대한 RPA 흐름의 라우팅 및 보안을 처리합니다.
자동화하려는 소프트웨어에 액세스할 수 있는 가상 머신에 설치된 IA-Connect 에이전트 및 디렉터입니다. 또한 IA-Connect 에이전트는 Citrix 또는 Microsoft RDS(원격 데스크톱 서비스) 세션 내에서 실행할 수 있습니다. 여기서 RPA 명령은 실행을 위해 가상 채널을 원격 세션으로 전달합니다. IA-Connect 에이전트는 네트워크 공유에서 실행할 수 있으며 설치가 필요하지 않습니다.
사용 가능한 IA-Connect 커넥터
사용 가능한 IA-Connect 커넥터는 다음과 같습니다.
- 동적 코드 IA-Connect
- java IA-Connect
- JML IA-Connect
- IA-Connect 메인프레임
- Microsoft Office IA-Connect
- SAP GUI IA-Connect
- IA-Connect 세션
- IA-Connect UI
- IA-Connect 웹 브라우저
자격 증명을 가져오는 방법
라이선스를 받고 30일 무료 평가판을 시작하려면 웹 사이트(https://www.ultima.com/IA-Connect/Power-Automate)에 요청을 제출하세요.
평가판 요청이 수신되면 IA-Connect 소프트웨어 설정을 지원하고 평가판 라이선스를 제공하기 위해 제공된 이메일 주소를 통해 연락을 드립니다. 이 평가판은 완전한 기능을 갖춘 평가판이며 평가 기간 동안 사용자 환경 내의 모든 9개 IA-Connect 커넥터에서 800개의 작업을 테스트할 수 있습니다.
커넥터 시작
IA-Connect에 대한 평가판 요청을 제출한 후에는 설치 및 설치를 다루는 IA-Connect 소프트웨어 및 설명서가 포함된 ZIP 파일을 다운로드할 수 있습니다. 또한 필요에 따라 설치 프로세스를 통해 지원 및 지침을 제공하기 위해 연락을 드립니다.
Support
평가 기간 동안 Ultima Labs(IAConnect@ultima.com)에 문의하여 지원 및 지원을 받을 수 있습니다.
IA-Connect 라이선스를 구매하면 Ultima의 영국 기반 TSC(기술 서비스 센터)에서 맞춤형 교육 또는 지원을 위해 사용할 수 있는 지원 토큰을 받게 됩니다.
알려진 문제, 일반적인 오류 및 FAQ
기술 자료에는 알려진 문제, IA-Connect 커넥터를 사용할 때 발생할 수 있는 일반적인 오류 및 질문과 대답을 다루는 여러 문서가 포함되어 있습니다. 이 기능은 액세스할 https://support.ultima.com/ultimalabs 수 있으며 IA-Connect 평가판 및 IA-Connect 라이선스 구매 시 이러한 리소스에 액세스할 수 있는 계정이 제공됩니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| API 키 | 시큐어스트링 (보안 문자열) | 이 API의 API 키 | 진실 |
| IA-Connect Orchestrator 주소 | 문자열 | HTTP(S) 구성 요소 없이 IA-Connect Orchestrator 주소 지정 | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| Focus UIA 요소 |
키보드 포커스의 활성 요소로 만드는 요소에 초점을 맞추고 애플리케이션에 따라 요소 창을 포그라운드로 가져올 수 있습니다. |
| UIA datagrid 요소 속성 가져오기 |
DataGrid 요소의 테이블 속성을 반환합니다. 행, 열, 머리글 및 셀(예: 표)이 있는 요소입니다. |
| UIA datagrid 요소 콘텐츠 가져오기 |
datagrid 요소의 내용을 반환합니다. 행, 열, 머리글 및 셀(예: 표)이 있는 요소입니다. 이 작업은 에이전트 스레드로 실행된 이 작업의 이전 실행에서 결과를 검색하는 데 사용할 수도 있습니다. |
| UIA 데스크톱 요소 가져오기 |
바탕 화면의 모든 창 및 대화 상자 목록을 반환합니다. |
| UIA 데스크톱 요소 대기 |
데스크톱 요소(일반적으로 창)가 존재할 때까지 기다립니다. |
| UIA 데스크톱 요소가 없을 때까지 기다립니다. |
데스크톱 요소(일반적으로 창)가 더 이상 존재하지 않을 때까지 기다립니다. |
| UIA 데스크톱 요소가 존재하나요? |
데스크톱 요소가 있는지 여부를 보고하고 몇 가지 기본 요소 속성을 제공합니다. |
| UIA 목록 요소 항목 가져오기 |
지정된 요소 아래에 있는 자식 요소 항목의 목록을 반환합니다(일반적으로 드롭다운/메뉴 항목). |
| UIA 부모 요소 핸들 가져오기 |
지정된 요소의 부모 요소에 대한 핸들을 반환합니다. 부모 요소는 UIA 'tree'의 다음 수준에 있고 거의 항상 포함하는 요소인 요소로 정의됩니다. |
| UIA 요소 값 가져오기 |
요소의 값을 반환합니다. 값은 일반적으로 텍스트 입력 영역과 연결되지만 많은 요소에 이 속성이 있을 수 있습니다. |
| UIA 요소 검색 모드 가져오기 |
UIA 작업에 대한 IA-Connect 에이전트에서 사용 중인 UIA 요소 검색 모드를 검색합니다. |
| UIA 요소 검색 모드 설정 |
UIA 작업을 수행할 때 IA-Connect 에이전트에서 사용해야 하는 UIA 요소 검색 모드를 선택합니다. 일반적으로 이 작업은 기본 모드에 문제가 있는 경우에만 사용됩니다(모두 찾기). |
| UIA 요소 검색 색상 영역 가져오기 |
지정된 색상 조건을 충족하는 UIA 요소 내 픽셀 영역의 세부 정보를 반환합니다. 에이전트가 요소의 좌표에서 스크린샷을 찍어 색을 찾기 때문에 요소를 먼저 맨 앞으로 가져와야 합니다. |
| UIA 요소 내에 표시되는 검색 이미지가 없을 때까지 기다립니다. |
이 작업에 대한 입력으로 제공된 검색 이미지가 화면의 UIA 요소 내에서 눈에 띄게 위치하거나 찾지 못하거나 지정된 시간이 지났고 이미지가 계속 존재할 때까지 기다립니다. 에이전트는 요소의 좌표에서 스크린샷을 사용하고 스크린샷 내에서 제공된 검색 이미지를 검색하므로 요소를 맨 앞으로 가져와야 합니다. UIA 요소는 처음부터 존재해야 합니다. 이미지가 더 이상 존재하지 않는 즉시 작업이 완료됩니다. |
| UIA 요소 내에서 표시되는 검색 이미지 찾기 |
이 작업에 대한 입력으로 제공된 검색 이미지가 화면의 UIA 요소 내에 눈에 띄게 배치되었는지 여부를 반환합니다. 에이전트는 요소의 좌표에서 스크린샷을 사용하고 스크린샷 내에서 제공된 검색 이미지를 검색하므로 요소를 맨 앞으로 가져와야 합니다. |
| UIA 요소 내에서 표시되는 검색 이미지를 기다립니다. |
이 작업에 대한 입력으로 제공된 검색 이미지가 화면의 UIA 요소 내에 눈에 띄게 배치되거나 지정된 시간이 경과할 때까지 기다립니다. 에이전트는 요소의 좌표에서 스크린샷을 사용하고 스크린샷 내에서 제공된 검색 이미지를 검색하므로 요소를 맨 앞으로 가져와야 합니다. UIA 요소는 처음부터 존재해야 합니다. 이미지가 배치되면 작업이 즉시 완료됩니다. |
| UIA 요소 누르기 |
요소(일반적으로 단추)를 누릅니다. |
| UIA 요소 대기 |
요소(일반적으로 단추 또는 텍스트 입력 영역과 같은 창 내의 개별 요소)가 존재할 때까지 기다립니다. |
| UIA 요소 레이블 값 가져오기 |
요소에 대한 레이블의 값을 반환합니다. |
| UIA 요소 선택 |
요소(일반적으로 목록 또는 드롭다운의 항목)를 선택합니다. |
| UIA 요소 설정/해제 |
요소(일반적으로 확인란 또는 라디오 상자)를 전환합니다. 이렇게 하면 요소의 현재 상태와 반대 상태가 됩니다(예: 선택됨은 선택 취소되고 그 반대의 경우도 마찬가지임). 특정 상태를 설정하려면 'Check 요소' 작업을 대신 사용합니다. |
| UIA 요소 속성 가져오기 |
요소의 모든 속성을 반환합니다. 이는 필요한 속성 값을 보유하는 필드가 확실하지 않은 경우에 유용할 수 있습니다. |
| UIA 요소 속성을 목록으로 가져오기 |
요소의 속성을 개별 항목 대신 한 줄 목록(단일 줄 컬렉션/데이터 테이블)으로 반환합니다. 이는 데이터를 사용하는 방법에 따라 유용할 수 있습니다. |
| UIA 요소 스크롤 백분율 설정 |
해당 요소에서 스크롤을 지원하는 경우 지정된 요소의 가로 및/또는 세로 스크롤 비율을 설정합니다. 요소가 'scroll' 패턴을 지원하는 경우 이 동작을 요소에 직접 적용하고 가로 또는 세로 스크롤 양(또는 둘 다)을 지정할 수 있습니다. 요소가 '스크롤' 패턴을 지원하지 않는 경우 이 작업은 '범위 값' 또는 '값' 패턴으로 대체되지만 요소 자체가 아닌 스크롤 막대 컨트롤에 직접 적용해야 합니다. |
| UIA 요소 위치 스크린샷 |
요소 위치의 스크린샷을 찍고 이미지를 반환합니다. 스크린샷이 요소 위치에서 화면의 복사본을 가져오기 때문에 요소를 먼저 맨 앞으로 가져와야 합니다. |
| UIA 요소 이동 |
UIA 요소를 화면에서 지정된 위치로 이동합니다. 이 작업은 일반적으로 Window 요소(변환 패턴 포함)에서만 작동합니다. |
| UIA 요소 주위에 사각형 그리기 |
요소의 경계 주위에 사각형을 그려 찾은 요소가 필수 요소임을 식별하는 데 도움이 됩니다. 사각형은 5초 후에 자동으로 제거됩니다. |
| UIA 요소 창 닫기 |
요소 창을 닫습니다. 일반적으로 창 또는 대화 상자에서만 작동합니다. |
| UIA 요소 축소 |
요소를 축소합니다(일반적으로 메뉴/드롭다운 항목). 항목이 이미 축소된 경우 아무 일도 발생하지 않습니다. |
| UIA 요소 크기 조정 |
UIA 요소의 크기를 조정합니다. 이 작업은 일반적으로 Window 요소(변환 패턴 포함)에서만 작동합니다. |
| UIA 요소 텍스트 값 가져오기 |
요소의 텍스트 값을 반환합니다. 텍스트 값은 일반적으로 레이블과 연결되지만 많은 요소에 이 속성이 있을 수 있습니다. |
| UIA 요소 패턴 가져오기 |
UIA 요소에 사용할 수 있는 UIA 패턴을 검색하여 IA-Connect UIA 동작이 요소에 영향을 미칠 수 있습니다. |
| UIA 요소 확인 |
요소의 상태(일반적으로 확인란 또는 라디오 상자)를 선택하거나 선택 취소로 설정합니다. |
| UIA 요소 확장 |
요소를 확장합니다(일반적으로 메뉴/드롭다운 항목). 항목이 이미 확장된 경우 아무 일도 발생하지 않습니다. |
| UIA 요소가 선택되어 있는지 확인 |
이 작업은 요소(일반적으로 확인란 또는 라디오 상자)가 선택되어 있는지 여부를 나타내는 true 또는 false를 반환합니다. |
| UIA 요소가 없을 때까지 기다립니다. |
요소(일반적으로 단추 또는 텍스트 입력 영역과 같은 창 내의 개별 요소)가 더 이상 존재하지 않을 때까지 기다립니다. |
| UIA 요소가 존재하나요? |
요소가 존재하는지 여부를 보고하고 몇 가지 기본 요소 속성을 반환합니다. |
| UIA 요소를 마우스 오른쪽 단추로 클릭하는 전역 |
UIA 요소를 기준으로 마우스를 가운데 또는 선택한 가장자리, 모서리 또는 오프셋으로 이동하고 마우스 오른쪽 단추를 클릭합니다. |
| UIA 요소를 숫자 값으로 설정 |
숫자 입력이 있는 요소의 값(예: 텍스트 필드 또는 스크롤 막대)을 설정합니다. |
| UIA 요소를 숫자 범위 값으로 설정 |
숫자 범위가 있는 요소의 값(예: 스크롤 막대)을 설정합니다. |
| UIA 요소에 대한 입력 반환 |
기존 텍스트를 대체하거나 특정 위치에 반환을 삽입하여 Windows 반환/새 줄을 요소(일반적으로 텍스트 입력 필드)에 입력합니다. |
| UIA 요소에 대한 전역 입력 암호 |
마우스를 요소의 가운데로 이동하고, 포커스를 지정하고, 왼쪽 클릭하여 키를 누릅니다. 일반적으로 네이티브 UIA 입력 메서드를 허용하지 않는 암호 입력과 함께 사용됩니다. |
| UIA 요소에 대한 전역 입력 텍스트 |
마우스를 요소의 가운데로 이동하고, 포커스를 지정하고, 왼쪽 클릭하여 키를 누릅니다. 일반적으로 네이티브 UIA 입력 메서드를 허용하지 않는 텍스트 입력과 함께 사용됩니다. |
| UIA 요소에 암호 입력 |
기존 텍스트를 대체하는 요소(일반적으로 암호 입력 필드)에 암호를 입력하는 UIA 작업입니다. |
| UIA 요소에 텍스트 입력 |
기존 텍스트를 대체하거나 특정 위치에 새 값을 삽입하여 요소(일반적으로 텍스트 입력 필드)에 텍스트를 입력하는 UIA 동작입니다. |
| UIA 요소에서 전역 가운데 마우스 클릭 |
UIA 요소를 기준으로 마우스를 가운데 또는 선택한 가장자리, 모서리 또는 오프셋으로 이동하고 가운데 마우스 단추를 클릭합니다. |
| UIA 요소에서 전역 왼쪽 두 번 마우스 클릭 |
UIA 요소를 기준으로 마우스를 가운데 또는 선택한 가장자리, 모서리 또는 오프셋으로 이동하고 왼쪽 마우스 단추를 두 번 클릭합니다. |
| UIA 요소에서 전역 왼쪽 마우스 클릭 |
UIA 요소를 기준으로 마우스를 가운데 또는 선택한 가장자리, 모서리 또는 오프셋으로 이동하고 왼쪽 마우스 단추를 클릭합니다. |
| UIA 창 최대화 |
지정된 UIA 핸들을 사용하여 창을 최대화합니다. |
| UIA 창 최소화 |
지정된 UIA 핸들을 사용하여 창을 최소화합니다. |
| UIA 창을 표준으로 설정 |
지정된 UIA 핸들을 사용하여 창을 정규화합니다(즉, 최소화 또는 최대화 대신 일반 크기 창으로 설정). |
| UIA 최상위 Win32 창 대기 |
UIA 핸들을 반환하기 전에 최상위 Win32 창이 존재할 때까지 지정된 시간 동안 기다리는 빠른 Win32 작업입니다. 최상위 창은 데스크톱에 연결된 창입니다. 클래스 이름 또는 창 제목으로 검색하거나 와일드카드를 포함하여 고급 검색 필터를 지정할 수 있습니다. 이 작업은 Win32 API를 사용하지만 Windows, Java, ModernUI 및 웹 창을 검색할 수 있습니다. 더 강력한 UIA 작업 '데스크톱 요소 대기'를 사용하는 것이 더 일반적이지만 이 Win32 작업은 일반적으로 더 빠르게 실행됩니다. |
| UIA 트랜잭션 시간 제한 설정 |
UIA API가 애플리케이션이 요소에 대한 정보를 반환할 때까지 대기하는 시간을 제어합니다. 이 트랜잭션 시간 제한은 일반적으로 애플리케이션이 응답하지 않는 경우에만 도달합니다. |
| UIA 프로세스 ID 주 창 대기 |
프로세스의 주 창(프로세스 ID로 지정됨)이 존재할 때까지 대기하고 핸들을 반환하는 간단하고 빠른 Win32 작업입니다. '기본' 창은 일반적으로 주 애플리케이션 창입니다. 로그인 대화 상자 또는 하위 창은 일반적으로 '기본' 창이 아닙니다. 더 강력한 '데스크톱 요소 대기' 작업을 사용하는 것이 좋습니다. |
| UIA 프로세스 주 창 대기 |
핸들을 반환하기 전에 프로세스의 주 창(이름으로 지정됨)이 존재할 때까지 지정된 시간 동안 대기하는 간단하고 빠른 Win32 작업입니다. '기본' 창은 일반적으로 주 애플리케이션 창입니다. 로그인 대화 상자 또는 하위 창은 일반적으로 '기본' 창이 아닙니다. 더 강력한 '데스크톱 요소 대기' 작업을 사용하는 것이 좋습니다. |
| Win32 창 가져오기 |
필요에 따라 지정된 클래스 이름 또는 창 제목이 있는 모든 Win32 창 목록을 반환하거나 와일드카드를 포함하여 고급 검색 필터를 지정할 수 있는 빠른 Win32 작업입니다. 이 작업은 Win32 API를 사용하지만 Windows, Java, ModernUI 및 웹 창을 검색할 수 있습니다. Win32 Windows에는 작업 표시줄, 바탕 화면, 시작 메뉴, 투명한 오버레이, 오프스크린 또는 숨겨진 창을 비롯한 예기치 않은 항목이 포함될 수 있으므로 반환된 목록에 예상보다 많은 결과가 포함될 수 있습니다. |
| 데스크톱용 UIA 핸들 가져오기 |
바탕 화면에 대한 핸들을 반환합니다. 핸들 '-2'를 사용하여 데스크톱 요소를 참조할 수 있지만 데스크톱을 기준으로 검색할 수 있는 작업이 많기 때문에(예: '데스크톱 요소 대기') 사용되지 않는 작업입니다. |
| 모든 UIA 요소 핸들 다시 설정 |
많은 요소를 식별하고 많은 수의 요소 핸들이 저장된 경우 유용할 수 있는 IA-Connect 의해 현재 저장된 모든 UIA 요소 핸들을 다시 설정합니다. 매우 많은 수의 요소 핸들(100,000개 이상)이 있는 시나리오에서는 이 작업을 사용하여 RAM 사용량을 확보할 수도 있습니다. |
| 여러 UIA 부모 요소 속성 가져오기 |
지정된 요소의 부모 요소 계층 트리를 바탕 화면(루트 수준)까지 반환합니다. 부모 요소는 UIA 'tree'의 다음 수준에 있고 거의 항상 포함하는 요소인 요소로 정의됩니다. |
| 여러 UIA 요소 속성 가져오기 |
여러 요소의 속성을 반환합니다. 이는 필요한 속성 값을 보유하는 필드가 확실하지 않은 경우에 유용할 수 있습니다. |
| 여러 UIA 요소 확인 |
여러 요소(일반적으로 확인란 또는 라디오 상자)의 상태를 선택 또는 선택 취소로 설정합니다. |
| 여러 UIA 요소를 테이블로 가져오기 |
지정된 부모 요소의 자식 요소 값을 열거하고 테이블 형식으로 반환합니다. 기술적으로 테이블이 아니지만 테이블 구조로 함께 정렬된 요소에서 데이터의 행과 열을 반환하는 데 사용할 수 있습니다. 이 작업은 에이전트 스레드로 실행된 이 작업의 이전 실행에서 결과를 검색하는 데 사용할 수도 있습니다. |
| 여러 UIA 요소에 텍스트 입력 |
기존 텍스트를 대체하거나 특정 위치에 새 값을 삽입하여 여러 요소(일반적으로 텍스트 입력 필드)에 다양한 텍스트를 입력하는 UIA 작업입니다. |
| 이름으로 UIA 목록 요소 항목 클릭 |
지정된 이름을 가진 목록 요소를 클릭합니다. 일반적으로 드롭다운/메뉴 항목에서 항목을 선택하는 데 사용됩니다. |
| 인덱스별 UIA 목록 요소 항목 클릭 |
지정된 인덱스와 일치하는 목록 요소를 클릭합니다. 일반적으로 드롭다운/메뉴 항목에서 항목을 선택하는 데 사용됩니다. |
| 전경 UIA 창 설정 |
창을 전경으로 가져옵니다. |
| 전역 마우스 클릭 UIA 요소 검색 색 영역 |
지정된 색상 조건을 충족하는 UIA 요소 내의 픽셀 영역 위로 마우스를 이동하고 마우스 클릭을 수행합니다. 스크린샷이 요소 위치에서 화면의 복사본을 가져오기 때문에 요소를 먼저 맨 앞으로 가져와야 합니다. |
| 첫 번째 UIA 부모 요소 검색 |
UIA 트리 계층 구조에서 검색 조건과 일치하는 첫 번째 부모 요소를 검색합니다. 부모 요소는 UIA 'tree'의 다음 수준에 있고 거의 항상 포함하는 요소인 요소로 정의됩니다. |
| 최상위 Win32 창에 대한 UIA 핸들 가져오기 |
지정된 클래스 이름 또는 창 제목이 있는 최상위 Win32 창에 대한 UIA 핸들을 반환하거나 와일드카드를 비롯한 고급 검색 필터를 지정할 수 있는 빠른 Win32 작업입니다. 최상위 창은 데스크톱에 연결된 창입니다. 이 작업은 Win32 API를 사용하지만 Windows, Java, ModernUI 및 웹 창을 검색할 수 있습니다. 창이 있어야 IA-Connect 기다리지 않습니다. 더 강력한 UIA 작업 'UIA 데스크톱 요소가 존재하나요'를 사용하는 것이 더 일반적이지만 이 Win32 작업은 일반적으로 더 빠르게 실행됩니다. |
| 최상위 Win32 창이 있나요? |
최상위 Win32 창이 있는지 여부를 보고하는 빠른 Win32 작업입니다. 최상위 창은 데스크톱에 연결된 창입니다. 클래스 이름 또는 창 제목으로 검색하거나 와일드카드를 포함하여 고급 검색 필터를 지정할 수 있습니다. 이 작업은 Win32 API를 사용하지만 Windows, Java, ModernUI 및 웹 창을 검색할 수 있습니다. 창이 있어야 IA-Connect 기다리지 않습니다. 더 강력한 UIA 작업 'UIA 데스크톱 요소가 존재하나요'를 사용하는 것이 더 일반적이지만 이 Win32 작업은 일반적으로 더 빠르게 실행됩니다. |
| 포커스가 있는 요소에 대한 UIA 핸들 가져오기 |
현재 포커스가 있는 UIA 요소에 대한 핸들을 반환합니다. |
| 포커스가 있는 요소의 주 창에 대한 UIA 핸들 가져오기 |
현재 포커스가 있는 UIA 요소의 주 창에 대한 핸들을 반환합니다. '기본' 창은 일반적으로 주 애플리케이션 창입니다. 로그인 대화 상자 또는 하위 창은 일반적으로 '기본' 창이 아닙니다. |
| 프로세스 ID 주 창에 대한 UIA 핸들 가져오기 |
프로세스 ID로 지정된 프로세스의 모든 주 창에 대한 핸들을 반환하는 간단하고 빠른 Win32 작업입니다. '기본' 창은 일반적으로 주 애플리케이션 창입니다. 로그인 대화 상자 또는 하위 창은 일반적으로 '기본' 창이 아닙니다. 더 강력한 '데스크톱 요소 대기' 작업을 사용하는 것이 좋습니다. |
| 프로세스 주 창에 대한 UIA 핸들 가져오기 |
프로세스의 주 창(이름으로 지정됨)에 대한 핸들을 반환하는 간단하고 빠른 Win32 작업입니다. '기본' 창은 일반적으로 주 애플리케이션 창입니다. 로그인 대화 상자 또는 하위 창은 일반적으로 '기본' 창이 아닙니다. 창이 있어야 합니다. IA-Connect 기다리지 않습니다. 더 강력한 '데스크톱 요소 대기' 작업을 사용하는 것이 좋습니다. |
| 프로세스에 Win32 창이 있나요? |
프로세스(이름으로 지정됨)에 표시되는 창이 있는지 여부를 보고하는 간단하고 빠른 Win32 작업입니다. 창이 있어야 합니다. IA-Connect 기다리지 않습니다. 더 강력한 '데스크톱 요소 대기' 작업을 사용하는 것이 좋습니다. |
| 화면 좌표에서 UIA 요소 가져오기 |
지정된 화면 좌표에 있는 UIA 요소를 반환합니다. |
Focus UIA 요소
키보드 포커스의 활성 요소로 만드는 요소에 초점을 맞추고 애플리케이션에 따라 요소 창을 포그라운드로 가져올 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA datagrid 요소 속성 가져오기
DataGrid 요소의 테이블 속성을 반환합니다. 행, 열, 머리글 및 셀(예: 표)이 있는 요소입니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
대체 헤더 행 이름
|
AlternativeHeaderRowName | string |
기본적으로 DataGrid의 헤더 행에는 UIA 이름이 'Top Row'입니다. 머리글 행의 이름이 다른 경우 여기에서 해당 이름을 지정합니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
열 수
|
NumberOfColumns | integer |
datagrid의 열 수입니다. |
|
표시되는 열 수
|
NumberOfVisibleColumns | integer |
datagrid에 표시되는 열의 수입니다. |
|
행 수
|
NumberOfRows | integer |
datagrid의 행 수입니다. |
|
표시되는 행 수
|
NumberOfVisibleRows | integer |
datagrid에 표시되는 행의 수입니다. |
|
첫 번째 행 표시
|
FirstVisibleRow | integer |
datagrid에서 처음 표시되는 행의 인덱스입니다. |
|
마지막으로 표시된 행
|
LastVisibleRow | integer |
datagrid에서 마지막으로 표시되는 행의 인덱스입니다. |
|
스크롤 막대 수
|
NumberOfScrollbars | integer |
datagrid에 있는 스크롤 막대의 수입니다. |
|
스크롤 막대 이름
|
ScrollbarNames | string |
스크롤 막대 이름(예: 가로, 세로)의 쉼표로 구분된 목록입니다. |
UIA datagrid 요소 콘텐츠 가져오기
datagrid 요소의 내용을 반환합니다. 행, 열, 머리글 및 셀(예: 표)이 있는 요소입니다. 이 작업은 에이전트 스레드로 실행된 이 작업의 이전 실행에서 결과를 검색하는 데 사용할 수도 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
화상 열만 검색
|
OnScreenColumnsOnly | boolean |
true로 설정하면 화면 열만 반환됩니다. |
|
|
화상 행만 검색
|
OnScreenRowsOnly | boolean |
true로 설정하면 화면의 행만 반환됩니다. |
|
|
null 값을 공백으로 반환
|
ReturnNullValuesAsBlank | boolean |
true로 설정하면 null 값이 ''(즉, 공백)로 반환됩니다. false로 설정하면 null 값은 일반적으로 '(null)'로 반환됩니다. |
|
|
대체 헤더 행 이름
|
AlternativeHeaderRowName | string |
기본적으로 DataGrid의 헤더 행에는 UIA 요소 이름 'Top Row'가 있습니다. 머리글 행의 이름이 다른 경우 여기에서 해당 이름을 지정합니다. |
|
|
행 UIA 이름 반환
|
ReturnRowUIAName | boolean |
이 입력을 설정하면 UIA 행 이름이 출력 컬렉션의 열에 저장됩니다. 열 이름은 '행 UIA 이름을 저장할 열의 이름' 입력으로 정의됩니다. |
|
|
행 UIA 이름을 저장할 열의 이름
|
NameOfColumnToStoreRowUIAName | string |
입력 '행 UIA 이름 반환'이 true로 설정된 경우 이 입력은 행 UIA 이름을 저장할 출력 컬렉션의 열 이름을 지정합니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
반환할 첫 번째 항목
|
FirstItemToReturn | integer |
반환할 첫 번째 항목(행)의 요소 인덱스(1부터 시작)입니다. |
|
|
반환할 최대 항목
|
MaxItemsToReturn | integer |
반환할 최대 항목 수(행) 또는 모든 항목(행)을 반환할 0입니다. |
|
|
빈 행에 대한 첫 번째 N개 행 검색
|
ScanFirstNRowsForEmptyRows | integer |
일부 datagrids에는 UIA 트리(일반적으로 맨 위에 있음)에 빈/null 행 요소가 몇 가지 있으며 IA-Connect UI에 표시되는 테이블의 아무 것도 나타내지 않으므로 이러한 행 요소를 자동으로 건너뜁니다. 이 입력이 0(기본값)으로 설정된 경우 IA-Connect 에이전트는 '반환할 첫 번째 항목'이 테이블 내에서 더 깊은 행을 검색하도록 설정된 경우에도 항상 첫 번째 행부터 행 요소를 검색합니다. 이렇게 하면 행 인덱스 번호와의 일관성이 보장되지만 첫 번째 행에서 요청된 행까지의 모든 행을 검색해야 하므로 성능에 영향을 줍니다. 테이블의 빈/null 행 요소만 첫 번째 N(예: 10) 행 내에 있다고 확신하는 경우 이 요소를 N(예: 10)으로 설정하여 성능을 향상시킬 수 있습니다. 수행하는 작업을 알 수 없는 경우 0 이외의 값으로 설정하지 마세요. |
|
|
테이블을 스레드로 읽기
|
ReadTableAsThread | boolean |
false(기본값)로 설정하면 IA-Connect 에이전트가 테이블을 즉시 읽고 내용을 디렉터에게 반환합니다. 큰 테이블을 읽는 경우 이 작업은 시간이 초과할 수 있습니다. true로 설정하면 IA-Connect 에이전트가 테이블을 에이전트 스레드로 읽고 IA-Connect 디렉터(또는 Orchestrator, PowerShell 모듈, Blue Prism)가 이 에이전트 스레드의 상태를 모니터링하여 완료될 때까지 대기할 수 있습니다. 이렇게 하면 시간 제한 없이 큰 테이블을 읽을 수 있습니다. IA-Connect 에이전트 9.3 이하에서는 에이전트 스레드가 아니라 테이블을 즉시 읽을 수 있습니다. |
|
|
스레드 ID에 대한 출력 데이터 검색
|
RetrieveOutputDataFromThreadId | integer |
이전에 이 작업을 에이전트 스레드로 실행하고 '스레드를 기다리는 시간(초)'을 0으로 설정한 경우 에이전트 스레드 ID를 제공하여 결과를 검색합니다. 이 에이전트 스레드 ID는 이 작업에 대한 이전 호출에서 제공된 것입니다. datagrid를 읽는 경우(따라서 에이전트 스레드로 실행된 이전 쿼리의 결과를 검색하지 않음) 0(기본값)으로 설정합니다. |
|
|
스레드를 기다리는 시간(초)
|
SecondsToWaitForThread | integer |
'스레드로 테이블 읽기'가 true로 설정된 경우 에이전트 스레드가 완료되기를 기다리는 시간(초)입니다. 현재 테이블을 읽는 에이전트 스레드가 완료되지 않은 경우 예외가 발생합니다. 대기를 무시하려면 0으로 설정합니다. 에이전트는 계속해서 datagrid를 읽지만 다음 작업에도 사용할 수 있습니다. 그런 다음 나중에 '에이전트 스레드가 완료될 때까지 대기' 작업을 사용하여 결과(datagrid의 내용)를 검색하여 에이전트 스레드가 완료될 때까지 기다린 다음 에이전트 스레드 ID로 설정된 입력 '스레드 ID에 대한 출력 데이터 검색'을 사용하여 이 'UIA datagrid 요소 콘텐츠 가져오기' 작업을 다시 실행할 수 있습니다. |
|
|
매 N%마다 세로로 datagrid 스크롤
|
ScrollDataGridVerticallyEveryNPercent | integer |
일부 큰 데이터 그리드(예: 수천 개의 행 포함)를 읽는 성능이 관찰되어 주기적으로 스크롤되는 위치(또는 그 근처)로 datagrid를 스크롤하는 경우 개선되었습니다. 0(기본값)으로 설정하면 내용을 읽는 동안 datagrid가 스크롤되지 않습니다. 1에서 100 사이의 값으로 설정하면 내용을 읽는 동안 데이터 그리드는 주기적으로 스크롤됩니다(총 행 수의 N%마다). 예를 들어 20으로 설정하면 datagrid가 0, 20, 40, 60, 80%로 스크롤됩니다. 또는 '모든 N행마다 세로로 datagrid 스크롤'을 사용하여 모든 N% 대신 모든 N행을 스크롤합니다. |
|
|
모든 N개 행을 세로로 데이터 그리드 스크롤
|
ScrollDataGridVerticallyEveryNRows | integer |
일부 큰 데이터 그리드(예: 수천 개의 행 포함)를 읽는 성능이 관찰되어 주기적으로 스크롤되는 위치(또는 그 근처)로 datagrid를 스크롤하는 경우 개선되었습니다. 0(기본값)으로 설정하면 내용을 읽는 동안 datagrid가 스크롤되지 않습니다. 값 1 이상으로 설정하면 내용을 읽는 동안 모든 N행마다 datagrid가 스크롤됩니다. 예를 들어 5로 설정하면 데이터 그리드는 5개 행마다 스크롤됩니다. 또는 '모든 N%마다 세로로 datagrid 스크롤'을 사용하여 모든 N개 행 대신 행의 모든 N%를 스크롤합니다. |
|
|
Datagrid 세로 요소 핸들 스크롤
|
ScrollDataGridVerticallyElementHandle | integer |
내용을 읽는 동안 datagrid를 세로로 스크롤하는 경우 이 입력은 IA-Connect 세로 스크롤 막대를 찾는 방법을 정의합니다. 0으로 설정하면 IA-Connect '스크롤' 패턴(datagrid가 지원하는 경우)을 사용하거나 datagrid 내에 포함된 세로 스크롤 막대를 검색하여 datagrid를 직접 스크롤하려고 시도합니다. 또는 세로 스크롤 막대 요소의 IA-Connect UIA 핸들(내 단추가 아닌 스크롤 막대 요소 자체)을 지정할 수 있습니다. 이 핸들은 값이 1 이상입니다. |
|
|
스크롤을 위한 최소 데이터 그리드 행
|
MinimumDataGridRowsForScrolling | integer |
내용을 읽는 동안 datagrid를 세로로 스크롤하는 경우 이 입력은 IA-Connect 스크롤을 수행하기 전에 테이블에 필요한 최소 행 수를 지정합니다. 0으로 설정하면 행 수에 관계없이 IA-Connect 스크롤됩니다. 양수로 설정하면 IA-Connect datagrid에 행 수가 있는 경우에만 스크롤을 수행합니다. |
|
|
스크롤할 수 없는 경우 예외 발생
|
RaiseExceptionIfCannotScroll | boolean |
내용을 읽는 동안 datagrid를 세로로 스크롤하는 경우: 스크롤 실패를 예외로 간주할 경우 이 입력을 true로 설정하거나 스크롤 실패를 무시해야 하는 경우 false(기본값)로 설정합니다. 스크롤에 대한 일반적인 실패에는 스크롤 막대를 찾지 못하거나 스크롤 막대에 스크롤에 적합한 UIA 패턴('scroll', 'rangevalue' 또는 'value')이 없습니다. |
|
|
대체 세로 스크롤 막대 이름
|
AlternativeVerticalScrollbarName | string |
기본적으로 datagrid의 세로 스크롤 막대 'row'에는 UIA 요소 이름 '세로 스크롤 막대'가 있습니다. 세로 스크롤 막대의 이름이 다른 경우 여기에서 해당 이름을 지정합니다. 내용을 읽는 동안 IA-Connect 주기적으로 datagrid를 스크롤하려면 입력 'Scroll datagrid vertically element handle' 필드가 0으로 설정되지만(IA-Connect datagrid를 직접 스크롤하도록 지정) datagrid는 '스크롤' 패턴을 구현하지 않습니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Datagrid 콘텐츠 JSON
|
DataGridContentsJSON | string |
JSON 형식의 datagrid 요소 콘텐츠입니다. |
|
테이블의 행 수
|
NumberOfRowsInTable | integer |
테이블을 즉시 읽은 경우 출력 테이블의 행 수입니다. |
|
테이블의 열 수
|
NumberOfColumnsInTable | integer |
테이블을 즉시 읽은 경우 출력 테이블의 열 수입니다. |
|
스레드 ID
|
ThreadId | integer |
이 작업을 에이전트 스레드로 실행하는 경우 이 출력에는 작업의 프로세스를 모니터링하고 스레드가 완료될 때 datagrid 콘텐츠를 검색하는 데 사용할 수 있는 에이전트 스레드 ID가 포함됩니다. |
UIA 데스크톱 요소 가져오기
바탕 화면의 모든 창 및 대화 상자 목록을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
지역화된 컨트롤 형식 검색 요소
|
SearchElementLocalizedControlType | string |
요소의 지역화된 컨트롤 형식별로 결과를 필터링합니다. |
|
|
검색 프로세스 ID
|
SearchProcessID | integer |
지정된 경우 검색은 이 프로세스 ID(PID)가 있는 프로세스에서 소유하는 요소만 고려합니다. IA-Connect 프로세스를 시작한 경우 PID는 IA-Connect 환경/세션 작업의 '프로세스 실행' 작업에 의해 제공됩니다. PID를 모르는 경우 이 필드를 비워 둡니다. |
|
|
반환 요소 핸들
|
ReturnElementHandle | boolean |
true로 설정하면 찾은 요소에 대한 핸들이 반환됩니다. 이 핸들은 추가 작업에서 '부모' 핸들 역할을 하는 데 사용할 수 있습니다. |
|
|
반환할 첫 번째 항목
|
FirstItemToReturn | integer |
반환할 첫 번째 항목의 요소 인덱스(1부터 시작)입니다. UIA 트리의 아래쪽에서 역순으로 요소를 반환하려는 경우 -1부터 시작하는 음수 인덱스도 지정할 수 있습니다. |
|
|
반환할 최대 항목
|
MaxItemsToReturn | integer |
반환할 최대 요소 수 또는 모든 항목을 반환할 0입니다. |
|
|
자식 프로세스 포함
|
IncludeChildProcesses | boolean |
true로 설정하고 '검색 프로세스 ID'를 지정하면 해당 프로세스 ID의 자식 프로세스도 검색에 포함됩니다. false로 설정하면 정확한 '검색 프로세스 ID'에 일치하는 프로세스만 반환됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
찾은 요소 수
|
NumberOfElementsFound | integer |
검색 조건과 일치하는 데스크톱 요소의 수입니다. |
|
반환된 요소 수
|
NumberOfElementsReturned | integer |
반환되는 데스크톱 요소의 수입니다(반환할 최대 항목 수를 지정하는 경우 찾은 요소 수보다 낮을 수 있음). |
|
요소 속성
|
ElementProperties | array of object |
검색 조건과 일치하는 데스크톱 요소의 요소 속성입니다. |
|
items
|
ElementProperties | object |
UIA 데스크톱 요소 대기
데스크톱 요소(일반적으로 창)가 존재할 때까지 기다립니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 프로세스 ID
|
SearchProcessId | integer |
지정된 경우(값이 1 이상)이면 이 프로세스 ID(PID)가 있는 프로세스에서 소유하는 요소만 검색에서 고려합니다. IA-Connect 프로세스를 시작한 경우 PID는 IA-Connect 환경/세션 작업의 '프로세스 실행' 작업에 의해 제공됩니다. PID를 모르는 경우 이 필드를 비워 둡니다(또는 0). |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
반환 요소 핸들
|
ReturnElementHandle | boolean |
true로 설정하면 찾은 요소에 대한 핸들이 반환됩니다. 이 핸들은 추가 작업에서 '부모' 핸들 역할을 하는 데 사용할 수 있습니다. |
|
|
대기 시간(초)
|
SecondsToWait | True | integer |
요소가 존재할 때까지 대기할 최대 시간(초)입니다. |
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
자식 프로세스 포함
|
IncludeChildProcesses | boolean |
true로 설정하고 '검색 프로세스 ID'를 지정하면 해당 프로세스 ID의 자식 프로세스도 검색에 포함됩니다. false로 설정하면 정확한 '검색 프로세스 ID'에 일치하는 프로세스만 반환됩니다. |
|
|
요소를 찾을 수 없는 경우 예외 발생
|
RaiseExceptionIfElementNotFound | boolean |
대기 기간 후에 UIA 요소가 없는 경우 예외를 발생시켜야 IA-Connect? |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
요소가 있음
|
ElementExists | boolean |
요소가 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다. |
|
요소 핸들
|
ElementHandle | integer |
요소에 대한 UIA 핸들입니다. 이 요소는 이 요소에 대해 작동하는 추가 UIA 작업에 대한 입력으로 사용할 수 있습니다. |
|
요소 이름
|
ElementName | string |
요소의 UIA 이름입니다. |
|
요소 클래스 이름
|
ElementClassName | string |
요소의 UIA 클래스 이름입니다. |
|
요소 자동화 ID
|
ElementAutomationId | string |
요소의 UIA 자동화 ID입니다. |
|
지역화된 요소 컨트롤 형식
|
ElementLocalizedControlType | string |
요소의 UIA 지역화된 컨트롤 형식입니다. |
UIA 데스크톱 요소가 없을 때까지 기다립니다.
데스크톱 요소(일반적으로 창)가 더 이상 존재하지 않을 때까지 기다립니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 프로세스 ID
|
SearchProcessId | integer |
지정된 경우(값이 1 이상)이면 이 프로세스 ID(PID)가 있는 프로세스에서 소유하는 요소만 검색에서 고려합니다. IA-Connect 프로세스를 시작한 경우 PID는 IA-Connect 환경/세션 작업의 '프로세스 실행' 작업에 의해 제공됩니다. PID를 모르는 경우 이 필드를 비워 둡니다(또는 0). |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
대기 시간(초)
|
SecondsToWait | True | integer |
요소가 없을 때까지 대기할 최대 시간(초)입니다. |
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
자식 프로세스 포함
|
IncludeChildProcesses | boolean |
true로 설정하고 '검색 프로세스 ID'를 지정하면 해당 프로세스 ID의 자식 프로세스도 검색에 포함됩니다. false로 설정하면 정확한 '검색 프로세스 ID'에 일치하는 프로세스만 반환됩니다. |
|
|
요소가 여전히 있는 경우 예외 발생
|
RaiseExceptionIfElementStillExists | boolean |
대기 기간 후에도 UIA 요소가 여전히 존재하는 경우 IA-Connect 예외를 발생시켜야 하나요? |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
대기하기 전에 요소가 존재합니다.
|
ElementExistsBeforeWait | boolean |
대기하기 전에 요소가 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다. |
|
대기 후 요소가 존재합니다.
|
ElementExistsAfterWait | boolean |
대기한 후 요소가 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다. |
UIA 데스크톱 요소가 존재하나요?
데스크톱 요소가 있는지 여부를 보고하고 몇 가지 기본 요소 속성을 제공합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 프로세스 ID
|
SearchProcessId | integer |
지정된 경우(값이 1 이상)이면 이 프로세스 ID(PID)가 있는 프로세스에서 소유하는 요소만 검색에서 고려합니다. IA-Connect 프로세스를 시작한 경우 PID는 IA-Connect 환경/세션 작업의 '프로세스 실행' 작업에 의해 제공됩니다. PID를 모르는 경우 이 필드를 비워 둡니다(또는 0). |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
반환 요소 핸들
|
ReturnElementHandle | boolean |
true로 설정하면 찾은 요소에 대한 핸들이 반환됩니다. 이 핸들은 추가 작업에서 '부모' 핸들 역할을 하는 데 사용할 수 있습니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
자식 프로세스 포함
|
IncludeChildProcesses | boolean |
true로 설정하고 '검색 프로세스 ID'를 지정하면 해당 프로세스 ID의 자식 프로세스도 검색에 포함됩니다. false로 설정하면 정확한 '검색 프로세스 ID'에 일치하는 프로세스만 반환됩니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
요소가 있음
|
ElementExists | boolean |
요소가 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다. |
|
요소 핸들
|
ElementHandle | integer |
요소에 대한 UIA 핸들입니다. 이 요소는 이 요소에 대해 작동하는 추가 UIA 작업에 대한 입력으로 사용할 수 있습니다. |
|
요소 이름
|
ElementName | string |
요소의 UIA 이름입니다. |
|
요소 클래스 이름
|
ElementClassName | string |
요소의 UIA 클래스 이름입니다. |
|
요소 자동화 ID
|
ElementAutomationId | string |
요소의 UIA 자동화 ID입니다. |
|
지역화된 요소 컨트롤 형식
|
ElementLocalizedControlType | string |
요소의 UIA 지역화된 컨트롤 형식입니다. |
UIA 목록 요소 항목 가져오기
지정된 요소 아래에 있는 자식 요소 항목의 목록을 반환합니다(일반적으로 드롭다운/메뉴 항목).
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
먼저 확장
|
ExpandFirst | boolean |
true로 설정하면 IA-Connect 목록 항목 요소를 검색하기 전에 목록을 확장하려고 시도합니다. 목록이 확장될 때까지 목록 항목 요소를 만들지 못할 수 있으므로 동적 목록에 유용합니다. |
|
|
이후 축소
|
CollapseAfter | boolean |
true로 설정하면 검색을 실행한 후 목록이 축소됩니다. |
|
|
선택한 항목 확인
|
CheckForSelectedItems | boolean |
true로 설정하면 출력 컬렉션에 목록 항목이 현재 선택되어 있는지 여부를 나타내는 추가 속성이 포함됩니다. |
|
|
확장과 축소 사이의 초
|
SecondsBetweenExpandCollapse | double |
true로 설정된 경우 확장 및 축소 작업 간에 대기할 시간(초)입니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
목록 항목 수
|
NumberOfListItems | integer |
목록의 항목 수입니다. |
|
목록 항목 JSON
|
ListItemsJSON | string |
목록의 항목 속성(JSON 형식)입니다. |
|
선택한 항목 수
|
NumberOfSelectedItems | integer |
목록에서 선택한 항목의 수입니다. |
|
처음 선택한 항목의 인덱스
|
IndexOfFirstSelectedItem | integer |
선택한 첫 번째 항목 목록의 인덱스입니다. |
|
선택한 항목 이름
|
SelectedItemName | string |
선택한 항목의 이름입니다. |
UIA 부모 요소 핸들 가져오기
지정된 요소의 부모 요소에 대한 핸들을 반환합니다. 부모 요소는 UIA 'tree'의 다음 수준에 있고 거의 항상 포함하는 요소인 요소로 정의됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요소 핸들
|
ElementHandle | True | integer |
대상 요소에 대한 UIA 핸들입니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
부모 요소 핸들
|
ParentElementHandle | integer |
부모 요소에 대한 UIA 핸들입니다. |
UIA 요소 값 가져오기
요소의 값을 반환합니다. 값은 일반적으로 텍스트 입력 영역과 연결되지만 많은 요소에 이 속성이 있을 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
요소 값
|
ElementValue | string |
요소의 값입니다. |
UIA 요소 검색 모드 가져오기
UIA 작업에 대한 IA-Connect 에이전트에서 사용 중인 UIA 요소 검색 모드를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
UIA 요소 검색 모드
|
UIAElementSearchMode | string |
IA-Connect 에이전트에서 사용하는 UIA 요소 검색 모드입니다. |
UIA 요소 검색 모드 설정
UIA 작업을 수행할 때 IA-Connect 에이전트에서 사용해야 하는 UIA 요소 검색 모드를 선택합니다. 일반적으로 이 작업은 기본 모드에 문제가 있는 경우에만 사용됩니다(모두 찾기).
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
UIA 요소 검색 모드
|
UIAElementSearchMode | True | string |
사용할 UIA 요소 검색 모드입니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
SetUIAElementSearchModeResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
UIA 요소 검색 색상 영역 가져오기
지정된 색상 조건을 충족하는 UIA 요소 내 픽셀 영역의 세부 정보를 반환합니다. 에이전트가 요소의 좌표에서 스크린샷을 찍어 색을 찾기 때문에 요소를 먼저 맨 앞으로 가져와야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
색 검색
|
SearchColour | True | string |
각 색상 채널이 16진수 형식의 바이트인 0xAARRGGBB, #AARRGGBB, 0xRRGGBB 또는 #RRGGBB 형식으로 색상을 검색합니다(00은 완전히 꺼져 있으며 FF는 완전히 켜집니다). 예를 들어 빨간색의 경우 #FF0000, 파란색의 경우 #00FF00, 검은색의 경우 #000000, 흰색은 #FFFFFF. |
|
최대 색 편차
|
MaxColourDeviation | True | integer |
요소의 최대 색상은 일치 항목으로 간주되지 않기 전에 검색 색에서 벗어날 수 있습니다. 편차가 없는 경우 0입니다. 편차는 RGB 값으로 측정됩니다. 예를 들어 #FF0000 #FE0102 4와 다릅니다. 15의 편차는 좋은 출발점이 될 것입니다. |
|
왼쪽 픽셀 X 오프셋
|
LeftPixelXOffset | integer |
검색 영역의 왼쪽 가장자리에 대한 선택적 X 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(음수 값 포함) 줄이거나(양수 값 포함) 할 수 있습니다. |
|
|
오른쪽 픽셀 X 오프셋
|
RightPixelXOffset | integer |
검색 영역의 오른쪽 가장자리에 대한 선택적 X 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(양수 값 포함) 줄이거나(음수 값 포함) 할 수 있습니다. |
|
|
위쪽 픽셀 Y 오프셋
|
TopPixelYOffset | integer |
검색 영역의 위쪽 가장자리에 대한 선택적 Y 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(음수 값 포함) 줄이거나(양수 값 포함) 할 수 있습니다. |
|
|
아래쪽 픽셀 Y 오프셋
|
BottomPixelYOffset | integer |
검색 영역의 아래쪽 가장자리에 대한 선택적 Y 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(양수 값 포함) 줄이거나(음수 값 포함) 할 수 있습니다. |
|
|
에이전트 숨기기
|
HideAgent | boolean |
분석 중인 요소가 가려지지 않도록 에이전트를 자동으로 숨기려면 true로 설정합니다(표시되는 경우). |
|
|
화면 좌표를 실제로 반환
|
ReturnPhysicalCoordinates | boolean |
화면 좌표가 실제 좌표로 반환되려면 true로 설정합니다. 화면 좌표가 가상 좌표로 반환되도록 하려면 false로 설정합니다. 기본 디스플레이 크기 조정이%100이면 실제 좌표와 가상 좌표가 모두 동일합니다. 요소 좌표는 항상 가상 좌표로 반환됩니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
색상과 일치하는 픽셀 수
|
NumberOfPixelsMatchingColour | integer |
지정된 색상과 일치하는 픽셀 수입니다. |
|
색상 일치 경계 상자 요소 왼쪽 픽셀
|
ColourMatchBoundingBoxElementLeftPixelXCoord | integer |
요소 가상 왼쪽을 기준으로 지정된 색상과 일치하는 가장 왼쪽 픽셀의 가상 X 좌표입니다. |
|
색상 일치 경계 상자 요소 오른쪽 픽셀
|
ColourMatchBoundingBoxElementRightPixelXCoord | integer |
요소 가상 왼쪽을 기준으로 지정된 색상과 일치하는 가장 오른쪽 픽셀의 가상 X 좌표입니다. |
|
색상 일치 경계 상자 요소 위쪽 픽셀
|
ColourMatchBoundingBoxElementTopPixelYCoord | integer |
지정된 색상과 일치하는 최상위 픽셀의 가상 Y 좌표로, 요소 가상 왼쪽을 기준으로 합니다. |
|
색상 일치 경계 상자 요소 아래쪽 픽셀
|
ColourMatchBoundingBoxElementBottomPixelYCoord | integer |
지정된 색상과 일치하는 최하위 픽셀의 가상 Y 좌표로, 요소 가상 왼쪽을 기준으로 합니다. |
|
색 일치 경계 상자 요소 센터 X 픽셀
|
ColourMatchBoundingBoxElementCenterPixelXCoord | integer |
지정된 색상과 일치하는 픽셀을 포함하는 경계 상자 중앙의 가상 X 좌표로, 요소 가상 왼쪽을 기준으로 합니다. |
|
색상 일치 경계 상자 요소 중심 Y 픽셀
|
ColourMatchBoundingBoxElementCenterPixelYCoord | integer |
지정된 색상과 일치하는 픽셀이 포함된 경계 상자 중앙의 가상 Y 좌표로, 요소 가상 왼쪽을 기준으로 합니다. |
|
색상 일치 경계 상자 화면 왼쪽 픽셀
|
ColourMatchBoundingBoxScreenLeftPixelXCoord | integer |
지정된 색상과 일치하는 가장 왼쪽 픽셀의 화면 픽셀 X 좌표입니다. 입력 '실제 좌표 반환'에 따라 물리적 또는 가상 좌표입니다. |
|
색상 일치 경계 상자 화면 오른쪽 픽셀
|
ColourMatchBoundingBoxScreenRightPixelXCoord | integer |
지정된 색상과 일치하는 가장 오른쪽 픽셀의 화면 픽셀 X 좌표입니다. 입력 '실제 좌표 반환'에 따라 물리적 또는 가상 좌표입니다. |
|
색상 일치 경계 상자 화면 위쪽 픽셀
|
ColourMatchBoundingBoxScreenTopPixelYCoord | integer |
지정된 색상과 일치하는 최상위 픽셀의 화면 픽셀 Y 좌표입니다. 입력 '실제 좌표 반환'에 따라 물리적 또는 가상 좌표입니다. |
|
색상 일치 경계 상자 화면 아래쪽 픽셀
|
ColourMatchBoundingBoxScreenBottomPixelYCoord | integer |
지정된 색상과 일치하는 최하위 픽셀의 화면 픽셀 Y 좌표입니다. 입력 '실제 좌표 반환'에 따라 물리적 또는 가상 좌표입니다. |
|
색 일치 경계 상자 화면 중심 X 픽셀
|
ColourMatchBoundingBoxScreenCenterPixelXCoord | integer |
지정된 색상과 일치하는 픽셀을 포함하는 경계 상자 가운데의 화면 픽셀 X 좌표입니다. 입력 '실제 좌표 반환'에 따라 물리적 또는 가상 좌표입니다. |
|
색상 일치 경계 상자 화면 중심 Y 픽셀
|
ColourMatchBoundingBoxScreenCenterPixelYCoord | integer |
지정된 색상과 일치하는 픽셀을 포함하는 경계 상자 가운데의 화면 픽셀 Y 좌표입니다. 입력 '실제 좌표 반환'에 따라 물리적 또는 가상 좌표입니다. |
UIA 요소 내에 표시되는 검색 이미지가 없을 때까지 기다립니다.
이 작업에 대한 입력으로 제공된 검색 이미지가 화면의 UIA 요소 내에서 눈에 띄게 위치하거나 찾지 못하거나 지정된 시간이 지났고 이미지가 계속 존재할 때까지 기다립니다. 에이전트는 요소의 좌표에서 스크린샷을 사용하고 스크린샷 내에서 제공된 검색 이미지를 검색하므로 요소를 맨 앞으로 가져와야 합니다. UIA 요소는 처음부터 존재해야 합니다. 이미지가 더 이상 존재하지 않는 즉시 작업이 완료됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
이미지 유형 검색
|
SearchImageType | string |
'이미지 검색' 입력이 나타내는 항목을 정의합니다. '디렉터 이미지 파일'로 설정하면 검색 이미지는 디렉터가 액세스할 수 있는 파일의 경로입니다. '에이전트 이미지 파일'로 설정하면 검색 이미지는 에이전트에서 액세스할 수 있는 파일의 경로입니다. 'Base64'로 설정하면 검색 이미지는 이미지의 base64 표현입니다. |
|
|
검색 이미지
|
SearchImage | string |
지정된 UIA 요소 내에서 찾을 검색 이미지입니다. 지정된 '검색 이미지 유형'에 따라 디렉터 또는 에이전트 끝에 있는 이미지 파일의 경로를 포함하거나 검색할 이미지의 base64(텍스트 표현)를 포함할 수 있습니다. |
|
|
대체 검색 이미지 유형
|
AltSearchImageType | string |
'대체 검색 이미지' 입력이 나타내는 항목을 정의합니다. 'None' 또는 blank로 설정하면 대체 검색 이미지가 없습니다. '디렉터 이미지 파일'로 설정하면 검색 이미지는 디렉터가 액세스할 수 있는 파일의 경로입니다. '에이전트 이미지 파일'로 설정하면 검색 이미지는 에이전트에서 액세스할 수 있는 파일의 경로입니다. 'Base64'로 설정하면 검색 이미지는 이미지의 base64 표현입니다. |
|
|
대체 검색 이미지
|
AltSearchImage | string |
지정된 UIA 요소 내에서 찾을 선택적 대체 검색 이미지입니다. 지정된 '대체 검색 이미지 유형'에 따라 디렉터 또는 에이전트 끝에 있는 이미지 파일의 경로를 포함하거나 검색할 이미지의 base64(텍스트 표현)를 포함할 수 있습니다. 대체 검색 이미지를 지정하는 경우 에이전트는 검색 또는 대체 검색 이미지와 검색 이미지가 있는 보고서를 찾습니다. |
|
|
최대 색 편차
|
MaxColourDeviation | integer |
요소의 최대 픽셀 색상은 검색 이미지 픽셀 색상에서 벗어날 수 있으며 일치 항목으로 간주되지 않습니다. 편차가 없는 경우 0입니다. 편차는 RGB 값으로 측정됩니다. 예를 들어 #FF0000 #FE0102 4와 다릅니다. 이렇게 하면 사소한 착색 차이를 무시할 수 있습니다. |
|
|
최대 픽셀 차이
|
MaxPixelDifferences | integer |
이미지가 일치하지 않는 것으로 간주되기 전에 전체 검색 이미지에서 다를 수 있는 최대 픽셀 수(최대 색 편차 이상)입니다. 이렇게 하면 이미지 간의 사소한 차이를 무시할 수 있지만 값이 높을수록 이미지를 찾는 데 필요한 시간이 늘어나게 됩니다. 0으로 설정하고 필요한 경우 소량씩 늘리는 것이 좋습니다. 0을 초과하는 값으로 설정하는 경우 '최대 연속 픽셀 차이'도 설정해야 합니다. |
|
|
최대 연속 픽셀 차이
|
MaxConsecutivePixelDifferences | integer |
이미지가 일치하지 않는 것으로 간주되기 전에 모든 행에서 다를 수 있는 최대 픽셀 수(최대 색 편차 이상)입니다. 이렇게 하면 이미지 간의 사소한 차이를 무시할 수 있지만 값이 높을수록 이미지를 찾는 데 필요한 시간이 늘어나게 됩니다. 0으로 설정하고 필요한 경우 소량씩 늘리는 것이 좋습니다. 0을 초과하는 값으로 설정하는 경우 '최대 픽셀 차이'도 설정해야 합니다. |
|
|
왼쪽 픽셀 X 오프셋
|
LeftPixelXOffset | integer |
검색 영역의 왼쪽 가장자리에 대한 선택적 X 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(음수 값 포함) 줄이거나(양수 값 포함) 할 수 있습니다. |
|
|
오른쪽 픽셀 X 오프셋
|
RightPixelXOffset | integer |
검색 영역의 오른쪽 가장자리에 대한 선택적 X 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(양수 값 포함) 줄이거나(음수 값 포함) 할 수 있습니다. |
|
|
위쪽 픽셀 Y 오프셋
|
TopPixelYOffset | integer |
검색 영역의 위쪽 가장자리에 대한 선택적 Y 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(음수 값 포함) 줄이거나(양수 값 포함) 할 수 있습니다. |
|
|
아래쪽 픽셀 Y 오프셋
|
BottomPixelYOffset | integer |
검색 영역의 아래쪽 가장자리에 대한 선택적 Y 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(양수 값 포함) 줄이거나(음수 값 포함) 할 수 있습니다. |
|
|
Pixel X 오프셋 단위
|
PixelXOffsetsUnit | string |
왼쪽 및 오른쪽 픽셀 X 오프셋이 픽셀 단위로 측정되면 'Pixel'(기본값)으로 설정합니다. 왼쪽 및 오른쪽 픽셀 X 오프셋이 요소 너비의 백분율로 측정되는 경우 '백분율'로 설정합니다. |
|
|
Pixel Y 오프셋 단위
|
PixelYOffsetsUnit | string |
위쪽 및 아래쪽 픽셀 Y 오프셋이 픽셀 단위로 측정되면 'Pixel'(기본값)으로 설정합니다. 위쪽 및 아래쪽 픽셀 Y 오프셋이 요소 높이의 백분율로 측정되면 '백분율'로 설정합니다. |
|
|
이미지 인덱스 검색
|
SearchImageIndex | integer |
UIA 요소 내에서 검색 이미지의 첫 번째 인스턴스(검색 방향)를 찾으려면 1로 설정합니다. 두 번째 인스턴스의 경우 2로 설정됩니다. .... - N번째 인스턴스의 경우 N입니다. 또한 대체 이미지를 검색하는 경우 UIA 요소는 먼저 검색 이미지를 검색하고, 두 번째로 대체 이미지를 검색하여 해당 특정 이미지의 요청된 인스턴스를 검색합니다(즉, 에이전트는 두 이미지의 혼합이 아닌 하나 또는 다른 이미지를 예상합니다). |
|
|
이미지 검색 방향
|
ImageSearchDirection | string |
검색 방향입니다. '위쪽에서'는 위쪽에서 행을 검색하여 각 행 내에서 왼쪽에서 오른쪽으로 검색합니다. '아래쪽에서'는 아래쪽에서 행을 검색하여 각 행 내에서 왼쪽에서 오른쪽으로 검색합니다. '왼쪽에서'는 왼쪽에서 열을 검색하여 각 열 내에서 위쪽에서 아래쪽으로 검색합니다. '오른쪽에서'는 오른쪽에서 열을 검색하여 각 열 내에서 위쪽에서 아래쪽으로 검색합니다. '이미지 인덱스 검색'과 함께 사용하여 위쪽, 아래쪽, 왼쪽 또는 오른쪽에서 N번째 이미지를 찾을 수 있습니다. 성능을 향상시키려면 이미지를 더 빠르게 찾을 수 있는 검색 방향을 선택합니다. |
|
|
에이전트 숨기기
|
HideAgent | boolean |
분석 중인 요소가 가려지지 않도록 에이전트를 자동으로 숨기려면 true로 설정합니다(표시되는 경우). |
|
|
강조 표시 사각형 표시
|
ShowHighlightRectangle | boolean |
true로 설정하면 IA-Connect 에이전트가 화면에 있는 이미지를 강조 표시합니다. 이는 개발 중에 올바른 이미지가 검색되고 있음을 시각화하는 데 유용할 수 있습니다. |
|
|
검색 이미지가 없을 때까지 대기하는 시간(초)
|
SecondsToWait | integer |
검색 이미지가 UIA 요소 내에 눈에 띄게 배치되지 않을 때까지 대기할 시간(초)입니다. 이 시간 후에도 이미지가 여전히 있는 경우 '이미지가 여전히 있는 경우 예외 발생'이 true로 설정된 경우 예외가 발생합니다. 그렇지 않으면 작업이 이미지가 여전히 있음을 보고합니다. |
|
|
검색 간격(밀리초)
|
MillisecondsBetweenSearches | integer |
화면의 각 UIA 요소 간 대기 시간(밀리초)입니다. 이미지 인식은 CPU 비용이 많이 들 수 있으므로 지연은 CPU 활용도를 낮추고 분산하는 데 도움이 될 수 있습니다. 예를 들어 이미지가 표시되는 데 최대 1분이 걸릴 것으로 예상하는 경우 검색 사이에 5000밀리초(5초) 일시 중지를 추가하면 CPU 사용량이 크게 낮아지지만(검사 수를 크게 줄임) 응답 시간에는 작은 영향만 있습니다. 허용되는 최소값은 100밀리초(1/10초)입니다. |
|
|
이미지가 여전히 있는 경우 예외 발생
|
RaiseExceptionIfImageStillPresent | boolean |
대기 기간 후에도 이미지가 여전히 있는 경우 IA-Connect 예외를 발생시켜야 하는 경우 true로 설정합니다. |
|
|
스레드 ID에 대한 출력 데이터 검색
|
RetrieveOutputDataFromThreadId | integer |
이전에 '스레드 대기'를 false로 설정한 경우(에이전트가 백그라운드 스레드에서 대기를 수행하게 됨) 에이전트 스레드 ID를 제공하여 결과를 검색합니다. 이 에이전트 스레드 ID는 이 작업에 대한 이전 호출에서 제공된 것입니다. 그렇지 않으면 0(기본값)으로 설정합니다. |
|
|
스레드 대기
|
WaitForThread | boolean |
에이전트 스레드가 완료되기를 기다리려면 true로 설정합니다. 에이전트는 '검색 이미지가 존재하지 않을 때까지 기다리는 시간(초)'으로 지정된 기간 동안 대기합니다. 대기를 무시하려면 false로 설정합니다. 에이전트는 백그라운드 스레드에서 대기를 계속 수행하지만 다음 작업에도 사용할 수 있습니다. 그런 다음 에이전트 스레드가 완료되기를 기다리는 '에이전트 스레드가 성공적으로 완료되기를 기다립니다'라는 작업을 사용하여 나중에 결과를 검색한 다음, '스레드 ID에 대한 출력 데이터 검색' 입력을 에이전트 스레드 ID로 설정하여 이 'UIA 요소 내에 표시되는 검색 이미지가 없을 때까지 대기' 작업을 다시 실행할 수 있습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
대기하기 전에 표시되는 검색 이미지
|
SearchImagePresentBeforeWait | boolean |
검색 이미지가 대기 기간의 시작 부분에 있는 경우 이 출력은 true로 설정됩니다. 검색 이미지가 처음부터 없는 경우 이 출력은 false로 설정됩니다. |
|
대기 후에도 검색 이미지가 계속 있음
|
SearchImageStillPresentAfterWait | boolean |
이 출력은 대기 기간 후에 검색 이미지가 여전히 있는 경우 true로 설정됩니다. 이 출력은 대기 기간 동안 검색 이미지가 더 이상 없는 경우 false로 설정됩니다(이미지가 더 이상 존재하지 않으면 작업이 즉시 완료됨). |
|
여전히 존재하는 검색 이미지
|
WhichSearchImageStillPresent | integer |
이 출력은 대기 기간 후에 검색 이미지가 아직 없는 경우 0으로 설정됩니다. 대기 기간 이후에 검색 이미지가 여전히 있는 경우 1로 설정합니다. 대기 기간 후에도 대체 검색 이미지가 여전히 있는 경우 2로 설정합니다. |
|
스레드 ID
|
ThreadId | integer |
'스레드 대기'를 false로 설정하면(에이전트가 백그라운드 스레드에서 대기를 수행하게 됨) 이 출력에는 작업의 프로세스를 모니터링하고 스레드가 완료되면 나중에 결과를 검색하는 데 사용할 수 있는 에이전트 스레드 ID가 포함됩니다. |
UIA 요소 내에서 표시되는 검색 이미지 찾기
이 작업에 대한 입력으로 제공된 검색 이미지가 화면의 UIA 요소 내에 눈에 띄게 배치되었는지 여부를 반환합니다. 에이전트는 요소의 좌표에서 스크린샷을 사용하고 스크린샷 내에서 제공된 검색 이미지를 검색하므로 요소를 맨 앞으로 가져와야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
이미지 유형 검색
|
SearchImageType | string |
'이미지 검색' 입력이 나타내는 항목을 정의합니다. '디렉터 이미지 파일'로 설정하면 검색 이미지는 디렉터가 액세스할 수 있는 파일의 경로입니다. '에이전트 이미지 파일'로 설정하면 검색 이미지는 에이전트에서 액세스할 수 있는 파일의 경로입니다. 'Base64'로 설정하면 검색 이미지는 이미지의 base64 표현입니다. |
|
|
검색 이미지
|
SearchImage | string |
지정된 UIA 요소 내에서 찾을 검색 이미지입니다. 지정된 '검색 이미지 유형'에 따라 디렉터 또는 에이전트 끝에 있는 이미지 파일의 경로를 포함하거나 검색할 이미지의 base64(텍스트 표현)를 포함할 수 있습니다. |
|
|
대체 검색 이미지 유형
|
AltSearchImageType | string |
'대체 검색 이미지' 입력이 나타내는 항목을 정의합니다. 'None' 또는 blank로 설정하면 대체 검색 이미지가 없습니다. '디렉터 이미지 파일'로 설정하면 검색 이미지는 디렉터가 액세스할 수 있는 파일의 경로입니다. '에이전트 이미지 파일'로 설정하면 검색 이미지는 에이전트에서 액세스할 수 있는 파일의 경로입니다. 'Base64'로 설정하면 검색 이미지는 이미지의 base64 표현입니다. |
|
|
대체 검색 이미지
|
AltSearchImage | string |
지정된 UIA 요소 내에서 찾을 선택적 대체 검색 이미지입니다. 지정된 '대체 검색 이미지 유형'에 따라 디렉터 또는 에이전트 끝에 있는 이미지 파일의 경로를 포함하거나 검색할 이미지의 base64(텍스트 표현)를 포함할 수 있습니다. 대체 검색 이미지를 지정하는 경우 에이전트는 검색 또는 대체 검색 이미지와 검색 이미지가 있는 보고서를 찾습니다. |
|
|
최대 색 편차
|
MaxColourDeviation | integer |
요소의 최대 픽셀 색상은 검색 이미지 픽셀 색상에서 벗어날 수 있으며 일치 항목으로 간주되지 않습니다. 편차가 없는 경우 0입니다. 편차는 RGB 값으로 측정됩니다. 예를 들어 #FF0000 #FE0102 4와 다릅니다. 이렇게 하면 사소한 착색 차이를 무시할 수 있습니다. |
|
|
최대 픽셀 차이
|
MaxPixelDifferences | integer |
이미지가 일치하지 않는 것으로 간주되기 전에 전체 검색 이미지에서 다를 수 있는 최대 픽셀 수(최대 색 편차 이상)입니다. 이렇게 하면 이미지 간의 사소한 차이를 무시할 수 있지만 값이 높을수록 이미지를 찾는 데 필요한 시간이 늘어나게 됩니다. 0으로 설정하고 필요한 경우 소량씩 늘리는 것이 좋습니다. 0을 초과하는 값으로 설정하는 경우 '최대 연속 픽셀 차이'도 설정해야 합니다. |
|
|
최대 연속 픽셀 차이
|
MaxConsecutivePixelDifferences | integer |
이미지가 일치하지 않는 것으로 간주되기 전에 모든 행에서 다를 수 있는 연속 픽셀의 최대 수입니다(최대 색 편차 이상). 이렇게 하면 이미지 간의 사소한 차이를 무시할 수 있지만 값이 높을수록 이미지를 찾는 데 필요한 시간이 늘어나게 됩니다. 0으로 설정하고 필요한 경우 소량씩 늘리는 것이 좋습니다. 0을 초과하는 값으로 설정하는 경우 '최대 픽셀 차이'도 설정해야 합니다. |
|
|
왼쪽 픽셀 X 오프셋
|
LeftPixelXOffset | integer |
검색 영역의 왼쪽 가장자리에 대한 선택적 X 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(음수 값 포함) 줄이거나(양수 값 포함) 할 수 있습니다. |
|
|
오른쪽 픽셀 X 오프셋
|
RightPixelXOffset | integer |
검색 영역의 오른쪽 가장자리에 대한 선택적 X 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(양수 값 포함) 줄이거나(음수 값 포함) 할 수 있습니다. |
|
|
위쪽 픽셀 Y 오프셋
|
TopPixelYOffset | integer |
검색 영역의 위쪽 가장자리에 대한 선택적 Y 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(음수 값 포함) 줄이거나(양수 값 포함) 할 수 있습니다. |
|
|
아래쪽 픽셀 Y 오프셋
|
BottomPixelYOffset | integer |
검색 영역의 아래쪽 가장자리에 대한 선택적 Y 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(양수 값 포함) 줄이거나(음수 값 포함) 할 수 있습니다. |
|
|
Pixel X 오프셋 단위
|
PixelXOffsetsUnit | string |
왼쪽 및 오른쪽 픽셀 X 오프셋이 픽셀 단위로 측정되면 'Pixel'(기본값)으로 설정합니다. 왼쪽 및 오른쪽 픽셀 X 오프셋이 요소 너비의 백분율로 측정되는 경우 '백분율'로 설정합니다. |
|
|
Pixel Y 오프셋 단위
|
PixelYOffsetsUnit | string |
위쪽 및 아래쪽 픽셀 Y 오프셋이 픽셀 단위로 측정되면 'Pixel'(기본값)으로 설정합니다. 위쪽 및 아래쪽 픽셀 Y 오프셋이 요소 높이의 백분율로 측정되면 '백분율'로 설정합니다. |
|
|
이미지 인덱스 검색
|
SearchImageIndex | integer |
UIA 요소 내에서 검색 이미지의 첫 번째 인스턴스(검색 방향)를 찾으려면 1로 설정합니다. 두 번째 인스턴스의 경우 2로 설정됩니다. .... - N번째 인스턴스의 경우 N입니다. 또한 대체 이미지를 검색하는 경우 UIA 요소는 먼저 검색 이미지를 검색하고, 두 번째로 대체 이미지를 검색하여 해당 특정 이미지의 요청된 인스턴스를 검색합니다(즉, 에이전트는 두 이미지의 혼합이 아닌 하나 또는 다른 이미지를 예상합니다). |
|
|
이미지 검색 방향
|
ImageSearchDirection | string |
검색 방향입니다. '위쪽에서'는 위쪽에서 행을 검색하여 각 행 내에서 왼쪽에서 오른쪽으로 검색합니다. '아래쪽에서'는 아래쪽에서 행을 검색하여 각 행 내에서 왼쪽에서 오른쪽으로 검색합니다. '왼쪽에서'는 왼쪽에서 열을 검색하여 각 열 내에서 위쪽에서 아래쪽으로 검색합니다. '오른쪽에서'는 오른쪽에서 열을 검색하여 각 열 내에서 위쪽에서 아래쪽으로 검색합니다. '이미지 인덱스 검색'과 함께 사용하여 위쪽, 아래쪽, 왼쪽 또는 오른쪽에서 N번째 이미지를 찾을 수 있습니다. 성능을 향상시키려면 이미지를 더 빠르게 찾을 수 있는 검색 방향을 선택합니다. |
|
|
에이전트 숨기기
|
HideAgent | boolean |
분석 중인 요소가 가려지지 않도록 에이전트를 자동으로 숨기려면 true로 설정합니다(표시되는 경우). |
|
|
화면 좌표를 실제로 반환
|
ReturnPhysicalCoordinates | boolean |
화면 좌표가 실제 좌표로 반환되려면 true로 설정합니다. 화면 좌표가 가상 좌표로 반환되도록 하려면 false로 설정합니다. 기본 디스플레이 크기 조정이%100이면 실제 좌표와 가상 좌표가 모두 동일합니다. 요소 좌표는 항상 가상 좌표로 반환됩니다. |
|
|
강조 표시 사각형 표시
|
ShowHighlightRectangle | boolean |
true로 설정하면 IA-Connect 에이전트가 화면에 있는 이미지를 강조 표시합니다. 이는 개발 중에 올바른 이미지가 검색되고 있음을 시각화하는 데 유용할 수 있습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
검색 이미지 위치
|
SearchImageLocated | boolean |
검색 이미지가 있는 경우 true로 설정합니다. 검색 이미지가 없는 경우 false로 설정합니다. |
|
어떤 검색 이미지가 있는가
|
WhichSearchImageLocated | integer |
검색 이미지가 없는 경우 0으로 설정합니다. 검색 이미지가 있는 경우 1로 설정합니다. 대체 검색 이미지가 있는 경우 2로 설정합니다. |
|
이미지 일치 경계 상자 요소 왼쪽 픽셀
|
SearchImageBoundingBoxElementLeftPixelXCoord | integer |
요소 가상 왼쪽을 기준으로 지정된 이미지와 일치하는 가장 왼쪽 픽셀의 가상 X 좌표입니다. |
|
이미지 일치 경계 상자 요소 오른쪽 픽셀
|
SearchImageBoundingBoxElementRightPixelXCoord | integer |
요소 가상 왼쪽을 기준으로 지정된 이미지와 일치하는 가장 오른쪽 픽셀의 가상 X 좌표입니다. |
|
이미지 일치 경계 상자 요소 위쪽 픽셀
|
SearchImageBoundingBoxElementTopPixelYCoord | integer |
지정된 이미지와 일치하는 최상위 픽셀의 가상 Y 좌표로, 요소 가상 왼쪽을 기준으로 합니다. |
|
이미지 일치 경계 상자 요소 아래쪽 픽셀
|
SearchImageBoundingBoxElementBottomPixelYCoord | integer |
지정된 이미지와 일치하는 맨 아래 픽셀의 가상 Y 좌표로, 요소 가상 왼쪽을 기준으로 합니다. |
|
이미지 일치 경계 상자 요소 센터 X 픽셀
|
SearchImageBoundingBoxElementCenterPixelXCoord | integer |
지정된 이미지와 일치하는 픽셀을 포함하는 경계 상자의 가운데에 있는 가상 X 좌표로, 요소 가상 왼쪽을 기준으로 합니다. |
|
이미지 일치 경계 상자 요소 센터 Y 픽셀
|
SearchImageBoundingBoxElementCenterPixelYCoord | integer |
지정된 이미지와 일치하는 픽셀을 포함하는 경계 상자 가운데의 가상 Y 좌표로, 요소 가상 왼쪽을 기준으로 합니다. |
|
이미지 일치 경계 상자 화면 왼쪽 픽셀
|
SearchImageBoundingBoxScreenLeftPixelXCoord | integer |
지정된 이미지와 일치하는 가장 왼쪽 픽셀의 화면 픽셀 X 좌표입니다. 입력 '실제 좌표 반환'에 따라 물리적 또는 가상 좌표입니다. |
|
이미지 일치 경계 상자 화면 오른쪽 픽셀
|
SearchImageBoundingBoxScreenRightPixelXCoord | integer |
지정된 이미지와 일치하는 가장 오른쪽 픽셀의 화면 픽셀 X 좌표입니다. 입력 '실제 좌표 반환'에 따라 물리적 또는 가상 좌표입니다. |
|
이미지 일치 경계 상자 화면 위쪽 픽셀
|
SearchImageBoundingBoxScreenTopPixelYCoord | integer |
지정된 이미지와 일치하는 최상위 픽셀의 화면 픽셀 Y 좌표입니다. 입력 '실제 좌표 반환'에 따라 물리적 또는 가상 좌표입니다. |
|
이미지 일치 경계 상자 화면 아래쪽 픽셀
|
SearchImageBoundingBoxScreenBottomPixelYCoord | integer |
지정된 이미지와 일치하는 최하위 픽셀의 화면 픽셀 Y 좌표입니다. 입력 '실제 좌표 반환'에 따라 물리적 또는 가상 좌표입니다. |
|
이미지 일치 경계 상자 화면 센터 X 픽셀
|
SearchImageBoundingBoxScreenCenterPixelXCoord | integer |
지정된 이미지와 일치하는 픽셀을 포함하는 경계 상자 가운데의 화면 픽셀 X 좌표입니다. 입력 '실제 좌표 반환'에 따라 물리적 또는 가상 좌표입니다. |
|
이미지 일치 경계 상자 화면 센터 Y 픽셀
|
SearchImageBoundingBoxScreenCenterPixelYCoord | integer |
지정된 이미지와 일치하는 픽셀을 포함하는 경계 상자 가운데의 화면 픽셀 Y 좌표입니다. 입력 '실제 좌표 반환'에 따라 물리적 또는 가상 좌표입니다. |
UIA 요소 내에서 표시되는 검색 이미지를 기다립니다.
이 작업에 대한 입력으로 제공된 검색 이미지가 화면의 UIA 요소 내에 눈에 띄게 배치되거나 지정된 시간이 경과할 때까지 기다립니다. 에이전트는 요소의 좌표에서 스크린샷을 사용하고 스크린샷 내에서 제공된 검색 이미지를 검색하므로 요소를 맨 앞으로 가져와야 합니다. UIA 요소는 처음부터 존재해야 합니다. 이미지가 배치되면 작업이 즉시 완료됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
이미지 유형 검색
|
SearchImageType | string |
'이미지 검색' 입력이 나타내는 항목을 정의합니다. '디렉터 이미지 파일'로 설정하면 검색 이미지는 디렉터가 액세스할 수 있는 파일의 경로입니다. '에이전트 이미지 파일'로 설정하면 검색 이미지는 에이전트에서 액세스할 수 있는 파일의 경로입니다. 'Base64'로 설정하면 검색 이미지는 이미지의 base64 표현입니다. |
|
|
검색 이미지
|
SearchImage | string |
지정된 UIA 요소 내에서 찾을 검색 이미지입니다. 지정된 '검색 이미지 유형'에 따라 디렉터 또는 에이전트 끝에 있는 이미지 파일의 경로를 포함하거나 검색할 이미지의 base64(텍스트 표현)를 포함할 수 있습니다. |
|
|
대체 검색 이미지 유형
|
AltSearchImageType | string |
'대체 검색 이미지' 입력이 나타내는 항목을 정의합니다. 'None' 또는 blank로 설정하면 대체 검색 이미지가 없습니다. '디렉터 이미지 파일'로 설정하면 검색 이미지는 디렉터가 액세스할 수 있는 파일의 경로입니다. '에이전트 이미지 파일'로 설정하면 검색 이미지는 에이전트에서 액세스할 수 있는 파일의 경로입니다. 'Base64'로 설정하면 검색 이미지는 이미지의 base64 표현입니다. |
|
|
대체 검색 이미지
|
AltSearchImage | string |
지정된 UIA 요소 내에서 찾을 선택적 대체 검색 이미지입니다. 지정된 '대체 검색 이미지 유형'에 따라 디렉터 또는 에이전트 끝에 있는 이미지 파일의 경로를 포함하거나 검색할 이미지의 base64(텍스트 표현)를 포함할 수 있습니다. 대체 검색 이미지를 지정하는 경우 에이전트는 검색 또는 대체 검색 이미지와 검색 이미지가 있는 보고서를 찾습니다. |
|
|
최대 색 편차
|
MaxColourDeviation | integer |
요소의 최대 픽셀 색상은 검색 이미지 픽셀 색상에서 벗어날 수 있으며 일치 항목으로 간주되지 않습니다. 편차가 없는 경우 0입니다. 편차는 RGB 값으로 측정됩니다. 예를 들어 #FF0000 #FE0102 4와 다릅니다. 이렇게 하면 사소한 착색 차이를 무시할 수 있습니다. |
|
|
최대 픽셀 차이
|
MaxPixelDifferences | integer |
이미지가 일치하지 않는 것으로 간주되기 전에 전체 검색 이미지에서 다를 수 있는 최대 픽셀 수(최대 색 편차 이상)입니다. 이렇게 하면 이미지 간의 사소한 차이를 무시할 수 있지만 값이 높을수록 이미지를 찾는 데 필요한 시간이 늘어나게 됩니다. 0으로 설정하고 필요한 경우 소량씩 늘리는 것이 좋습니다. 0을 초과하는 값으로 설정하는 경우 '최대 연속 픽셀 차이'도 설정해야 합니다. |
|
|
최대 연속 픽셀 차이
|
MaxConsecutivePixelDifferences | integer |
이미지가 일치하지 않는 것으로 간주되기 전에 모든 행에서 다를 수 있는 최대 픽셀 수(최대 색 편차 이상)입니다. 이렇게 하면 이미지 간의 사소한 차이를 무시할 수 있지만 값이 높을수록 이미지를 찾는 데 필요한 시간이 늘어나게 됩니다. 0으로 설정하고 필요한 경우 소량씩 늘리는 것이 좋습니다. 0을 초과하는 값으로 설정하는 경우 '최대 픽셀 차이'도 설정해야 합니다. |
|
|
왼쪽 픽셀 X 오프셋
|
LeftPixelXOffset | integer |
검색 영역의 왼쪽 가장자리에 대한 선택적 X 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(음수 값 포함) 줄이거나(양수 값 포함) 할 수 있습니다. |
|
|
오른쪽 픽셀 X 오프셋
|
RightPixelXOffset | integer |
검색 영역의 오른쪽 가장자리에 대한 선택적 X 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(양수 값 포함) 줄이거나(음수 값 포함) 할 수 있습니다. |
|
|
위쪽 픽셀 Y 오프셋
|
TopPixelYOffset | integer |
검색 영역의 위쪽 가장자리에 대한 선택적 Y 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(음수 값 포함) 줄이거나(양수 값 포함) 할 수 있습니다. |
|
|
아래쪽 픽셀 Y 오프셋
|
BottomPixelYOffset | integer |
검색 영역의 아래쪽 가장자리에 대한 선택적 Y 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(양수 값 포함) 줄이거나(음수 값 포함) 할 수 있습니다. |
|
|
Pixel X 오프셋 단위
|
PixelXOffsetsUnit | string |
왼쪽 및 오른쪽 픽셀 X 오프셋이 픽셀 단위로 측정되면 'Pixel'(기본값)으로 설정합니다. 왼쪽 및 오른쪽 픽셀 X 오프셋이 요소 너비의 백분율로 측정되는 경우 '백분율'로 설정합니다. |
|
|
Pixel Y 오프셋 단위
|
PixelYOffsetsUnit | string |
위쪽 및 아래쪽 픽셀 Y 오프셋이 픽셀 단위로 측정되면 'Pixel'(기본값)으로 설정합니다. 위쪽 및 아래쪽 픽셀 Y 오프셋이 요소 높이의 백분율로 측정되면 '백분율'로 설정합니다. |
|
|
이미지 인덱스 검색
|
SearchImageIndex | integer |
UIA 요소 내에서 검색 이미지의 첫 번째 인스턴스(검색 방향)를 찾으려면 1로 설정합니다. 두 번째 인스턴스의 경우 2로 설정됩니다. .... - N번째 인스턴스의 경우 N입니다. 또한 대체 이미지를 검색하는 경우 UIA 요소는 먼저 검색 이미지를 검색하고, 두 번째로 대체 이미지를 검색하여 해당 특정 이미지의 요청된 인스턴스를 검색합니다(즉, 에이전트는 두 이미지의 혼합이 아닌 하나 또는 다른 이미지를 예상합니다). |
|
|
이미지 검색 방향
|
ImageSearchDirection | string |
검색 방향입니다. '위쪽에서'는 위쪽에서 행을 검색하여 각 행 내에서 왼쪽에서 오른쪽으로 검색합니다. '아래쪽에서'는 아래쪽에서 행을 검색하여 각 행 내에서 왼쪽에서 오른쪽으로 검색합니다. '왼쪽에서'는 왼쪽에서 열을 검색하여 각 열 내에서 위쪽에서 아래쪽으로 검색합니다. '오른쪽에서'는 오른쪽에서 열을 검색하여 각 열 내에서 위쪽에서 아래쪽으로 검색합니다. '이미지 인덱스 검색'과 함께 사용하여 위쪽, 아래쪽, 왼쪽 또는 오른쪽에서 N번째 이미지를 찾을 수 있습니다. 성능을 향상시키려면 이미지를 더 빠르게 찾을 수 있는 검색 방향을 선택합니다. |
|
|
에이전트 숨기기
|
HideAgent | boolean |
분석 중인 요소가 가려지지 않도록 에이전트를 자동으로 숨기려면 true로 설정합니다(표시되는 경우). |
|
|
화면 좌표를 실제로 반환
|
ReturnPhysicalCoordinates | boolean |
화면 좌표가 실제 좌표로 반환되려면 true로 설정합니다. 화면 좌표가 가상 좌표로 반환되도록 하려면 false로 설정합니다. 기본 디스플레이 크기 조정이%100이면 실제 좌표와 가상 좌표가 모두 동일합니다. 요소 좌표는 항상 가상 좌표로 반환됩니다. |
|
|
강조 표시 사각형 표시
|
ShowHighlightRectangle | boolean |
true로 설정하면 IA-Connect 에이전트가 화면에 있는 이미지를 강조 표시합니다. 이는 개발 중에 올바른 이미지가 검색되고 있음을 시각화하는 데 유용할 수 있습니다. |
|
|
검색 이미지 대기 시간(초)
|
SecondsToWait | integer |
검색 이미지가 UIA 요소 내에 위치할 때까지 대기할 시간(초)입니다. 이미지가 없으면 '이미지를 찾을 수 없는 경우 예외 발생'이 true로 설정된 경우 예외가 발생합니다. 그렇지 않으면 작업이 이미지를 찾을 수 없음을 보고합니다. |
|
|
검색 간격(밀리초)
|
MillisecondsBetweenSearches | integer |
화면의 각 UIA 요소 간 대기 시간(밀리초)입니다. 이미지 인식은 CPU 비용이 많이 들 수 있으므로 지연은 CPU 활용도를 낮추고 분산하는 데 도움이 될 수 있습니다. 예를 들어 이미지가 표시되는 데 최대 1분이 걸릴 것으로 예상하는 경우 검색 사이에 5000밀리초(5초) 일시 중지를 추가하면 CPU 사용량이 크게 낮아지지만(검사 수를 크게 줄임) 응답 시간에는 작은 영향만 있습니다. 허용되는 최소값은 100밀리초(1/10초)입니다. |
|
|
이미지를 찾을 수 없는 경우 예외 발생
|
RaiseExceptionIfImageNotFound | boolean |
대기 기간 후에 이미지를 배치할 수 없는 경우 IA-Connect 예외를 발생시켜야 하는 경우 true로 설정합니다. |
|
|
스레드 ID에 대한 출력 데이터 검색
|
RetrieveOutputDataFromThreadId | integer |
이전에 '스레드 대기'를 false로 설정한 경우(에이전트가 백그라운드 스레드에서 대기를 수행하게 됨) 에이전트 스레드 ID를 제공하여 결과를 검색합니다. 이 에이전트 스레드 ID는 이 작업에 대한 이전 호출에서 제공된 것입니다. 그렇지 않으면 0(기본값)으로 설정합니다. |
|
|
스레드 대기
|
WaitForThread | boolean |
에이전트 스레드가 완료되기를 기다리려면 true로 설정합니다. 에이전트는 '검색 이미지를 기다리는 시간(초)'으로 지정된 기간 동안 대기합니다. 대기를 무시하려면 false로 설정합니다. 에이전트는 백그라운드에서 대기를 계속 수행하지만 다음 작업에도 사용할 수 있습니다. 그런 다음 나중에 '에이전트 스레드가 완료되기를 기다립니다'라는 작업을 사용하여 에이전트 스레드가 완료되기를 기다렸다가 '스레드 ID에 대한 출력 데이터 검색' 입력이 에이전트 스레드 ID로 설정된 이 'UIA 요소 내에서 표시되는 검색 이미지 대기' 작업을 다시 실행하여 결과를 검색할 수 있습니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
검색 이미지 위치
|
SearchImageLocated | boolean |
검색 이미지가 있는 경우 이 출력은 true로 설정됩니다. 검색 이미지가 없는 경우 이 출력은 false로 설정됩니다. |
|
어떤 검색 이미지가 있는가
|
WhichSearchImageLocated | integer |
검색 이미지가 없는 경우 이 출력은 0으로 설정됩니다. 검색 이미지가 있는 경우 1로 설정합니다. 대체 검색 이미지가 있는 경우 2로 설정합니다. |
|
이미지 일치 경계 상자 요소 왼쪽 픽셀
|
SearchImageBoundingBoxElementLeftPixelXCoord | integer |
요소 가상 왼쪽을 기준으로 지정된 이미지와 일치하는 가장 왼쪽 픽셀의 가상 X 좌표입니다. |
|
이미지 일치 경계 상자 요소 오른쪽 픽셀
|
SearchImageBoundingBoxElementRightPixelXCoord | integer |
요소 가상 왼쪽을 기준으로 지정된 이미지와 일치하는 가장 오른쪽 픽셀의 가상 X 좌표입니다. |
|
이미지 일치 경계 상자 요소 위쪽 픽셀
|
SearchImageBoundingBoxElementTopPixelYCoord | integer |
지정된 이미지와 일치하는 최상위 픽셀의 가상 Y 좌표로, 요소 가상 왼쪽을 기준으로 합니다. |
|
이미지 일치 경계 상자 요소 아래쪽 픽셀
|
SearchImageBoundingBoxElementBottomPixelYCoord | integer |
지정된 이미지와 일치하는 맨 아래 픽셀의 가상 Y 좌표로, 요소 가상 왼쪽을 기준으로 합니다. |
|
이미지 일치 경계 상자 요소 센터 X 픽셀
|
SearchImageBoundingBoxElementCenterPixelXCoord | integer |
지정된 이미지와 일치하는 픽셀을 포함하는 경계 상자의 가운데에 있는 가상 X 좌표로, 요소 가상 왼쪽을 기준으로 합니다. |
|
이미지 일치 경계 상자 요소 센터 Y 픽셀
|
SearchImageBoundingBoxElementCenterPixelYCoord | integer |
지정된 이미지와 일치하는 픽셀을 포함하는 경계 상자 가운데의 가상 Y 좌표로, 요소 가상 왼쪽을 기준으로 합니다. |
|
이미지 일치 경계 상자 화면 왼쪽 픽셀
|
SearchImageBoundingBoxScreenLeftPixelXCoord | integer |
지정된 이미지와 일치하는 가장 왼쪽 픽셀의 화면 픽셀 X 좌표입니다. 입력 '실제 좌표 반환'에 따라 물리적 또는 가상 좌표입니다. |
|
이미지 일치 경계 상자 화면 오른쪽 픽셀
|
SearchImageBoundingBoxScreenRightPixelXCoord | integer |
지정된 이미지와 일치하는 가장 오른쪽 픽셀의 화면 픽셀 X 좌표입니다. 입력 '실제 좌표 반환'에 따라 물리적 또는 가상 좌표입니다. |
|
이미지 일치 경계 상자 화면 위쪽 픽셀
|
SearchImageBoundingBoxScreenTopPixelYCoord | integer |
지정된 이미지와 일치하는 최상위 픽셀의 화면 픽셀 Y 좌표입니다. 입력 '실제 좌표 반환'에 따라 물리적 또는 가상 좌표입니다. |
|
이미지 일치 경계 상자 화면 아래쪽 픽셀
|
SearchImageBoundingBoxScreenBottomPixelYCoord | integer |
지정된 이미지와 일치하는 최하위 픽셀의 화면 픽셀 Y 좌표입니다. 입력 '실제 좌표 반환'에 따라 물리적 또는 가상 좌표입니다. |
|
이미지 일치 경계 상자 화면 센터 X 픽셀
|
SearchImageBoundingBoxScreenCenterPixelXCoord | integer |
지정된 이미지와 일치하는 픽셀을 포함하는 경계 상자 가운데의 화면 픽셀 X 좌표입니다. 입력 '실제 좌표 반환'에 따라 물리적 또는 가상 좌표입니다. |
|
이미지 일치 경계 상자 화면 센터 Y 픽셀
|
SearchImageBoundingBoxScreenCenterPixelYCoord | integer |
지정된 이미지와 일치하는 픽셀을 포함하는 경계 상자 가운데의 화면 픽셀 Y 좌표입니다. 입력 '실제 좌표 반환'에 따라 물리적 또는 가상 좌표입니다. |
|
스레드 ID
|
ThreadId | integer |
'스레드 대기'를 false로 설정하면(에이전트가 백그라운드 스레드에서 대기를 수행하게 됨) 이 출력에는 작업의 프로세스를 모니터링하고 스레드가 완료되면 나중에 결과를 검색하는 데 사용할 수 있는 에이전트 스레드 ID가 포함됩니다. |
UIA 요소 누르기
요소(일반적으로 단추)를 누릅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
단추 이벤트가 완료되기를 기다립니다.
|
Wait | boolean |
계속하기 전에 자동화에서 단추 이벤트가 완료되기를 기다리는 경우 true로 설정하면 단추가 모달 대화 상자를 열면 시간 제한이 발생할 수 있습니다. |
|
|
Win32 클릭 단추
|
Win32ClickButton | boolean |
true로 설정하면 UIA를 사용하는 대신 Win32 클릭 이벤트가 사용됩니다. 클릭 후 표시되는 모달 대화 상자 또는 UIA 호출 패턴이 없는 요소를 처리할 때 유용할 수 있는 'fire and forget' 클릭 이벤트입니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
호출 패턴 사용해 보기
|
TryInvokePattern | boolean |
true(기본값)로 설정하면 IA-Connect 에이전트는 UIA 호출 패턴을 사용하여 누름 동작을 수행합니다('Win32 클릭 단추'가 true로 설정되지 않은 경우). 선택한 요소에서 UIA 호출 패턴을 사용할 수 없는 경우 IA-Connect 에이전트는 다른 패턴(이 작업에 대한 다른 입력을 통해 사용 또는 사용 안 함)으로 대체됩니다. false로 설정하면 IA-Connect 에이전트가 호출 패턴을 사용하지 않고 선택한 다른 패턴으로 즉시 대체됩니다. |
|
|
레거시 패턴 사용해 보기
|
TryLegacyPattern | boolean |
true로 설정하면 IA-Connect 에이전트가 UIA 레거시 패턴을 사용하여 호출 패턴을 사용할 수 없는 경우(요소에 없거나 사용이 비활성화되었기 때문에) 누름 동작을 수행하려고 시도하고 'Win32 클릭 단추'가 false인 경우. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 요소 대기
요소(일반적으로 단추 또는 텍스트 입력 영역과 같은 창 내의 개별 요소)가 존재할 때까지 기다립니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 프로세스 ID
|
SearchProcessId | integer |
지정된 경우(값이 1 이상)이면 이 프로세스 ID(PID)가 있는 프로세스에서 소유하는 요소만 검색에서 고려합니다. IA-Connect 프로세스를 시작한 경우 PID는 IA-Connect 환경/세션 작업의 '프로세스 실행' 작업에 의해 제공됩니다. PID를 모르는 경우 이 필드를 비워 둡니다(또는 0). |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
반환 요소 핸들
|
ReturnElementHandle | boolean |
true로 설정하면 찾은 요소에 대한 핸들이 반환됩니다. 이 핸들은 추가 작업에서 '부모' 핸들 역할을 하는 데 사용할 수 있습니다. |
|
|
대기 시간(초)
|
SecondsToWait | True | integer |
요소가 존재할 때까지 대기할 최대 시간(초)입니다. |
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
자식 프로세스 포함
|
IncludeChildProcesses | boolean |
true로 설정하고 '검색 프로세스 ID'를 지정하면 해당 프로세스 ID의 자식 프로세스도 검색에 포함됩니다. false로 설정하면 정확한 '검색 프로세스 ID'에 일치하는 프로세스만 반환됩니다. |
|
|
요소를 찾을 수 없는 경우 예외 발생
|
RaiseExceptionIfElementNotFound | boolean |
대기 기간 후에 UIA 요소가 없는 경우 예외를 발생시켜야 IA-Connect? |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
요소가 있음
|
ElementExists | boolean |
요소가 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다. |
|
요소 핸들
|
ElementHandle | integer |
요소에 대한 UIA 핸들입니다. 이 요소는 이 요소에 대해 작동하는 추가 UIA 작업에 대한 입력으로 사용할 수 있습니다. |
|
요소 이름
|
ElementName | string |
요소의 UIA 이름입니다. |
|
요소 클래스 이름
|
ElementClassName | string |
요소의 UIA 클래스 이름입니다. |
|
요소 자동화 ID
|
ElementAutomationId | string |
요소의 UIA 자동화 ID입니다. |
|
지역화된 요소 컨트롤 형식
|
ElementLocalizedControlType | string |
요소의 UIA 지역화된 컨트롤 형식입니다. |
UIA 요소 레이블 값 가져오기
요소에 대한 레이블의 값을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
요소 레이블 값
|
ElementLabelValue | string |
요소에 있는 레이블의 값입니다. |
UIA 요소 선택
요소(일반적으로 목록 또는 드롭다운의 항목)를 선택합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 요소 설정/해제
요소(일반적으로 확인란 또는 라디오 상자)를 전환합니다. 이렇게 하면 요소의 현재 상태와 반대 상태가 됩니다(예: 선택됨은 선택 취소되고 그 반대의 경우도 마찬가지임). 특정 상태를 설정하려면 'Check 요소' 작업을 대신 사용합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 요소 속성 가져오기
요소의 모든 속성을 반환합니다. 이는 필요한 속성 값을 보유하는 필드가 확실하지 않은 경우에 유용할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
반환 요소 핸들
|
ReturnElementHandle | boolean |
true로 설정하면 찾은 요소에 대한 핸들이 반환됩니다. 이 핸들은 추가 작업에서 '부모' 핸들 역할을 하는 데 사용할 수 있습니다. |
|
|
반환 요소 값
|
ReturnElementValue | boolean |
true로 설정하면 찾은 요소의 값보다 값이 반환됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
요소 경계 내에서 클릭 가능한 지점의 유효성을 검사합니다.
|
ValidateClickablePointWithinElementBoundary | boolean |
일부 요소의 경우 UIA는 요소 내에서 클릭 가능한 점을 인식하지 못하며 요소의 중심 대신 잘못된 좌표(예: 0,0)를 반환합니다. 이 입력이 true로 설정된 경우 IA-Connect UIA에서 제공하는 좌표의 유효성을 확인하고 요소 경계 내에 없는 경우 UIA에서 제공하는 값을 무시하고 대신 요소의 중심을 사용합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
요소 이름
|
ElementName | string |
요소의 UIA 이름입니다. |
|
요소 클래스 이름
|
ElementClassName | string |
요소의 UIA 클래스 이름입니다. |
|
요소 자동화 ID
|
ElementAutomationId | string |
요소의 UIA 자동화 ID입니다. |
|
요소 프레임워크 ID
|
ElementFrameworkId | string |
요소의 UIA 프레임워크 ID입니다. |
|
요소 컨트롤 형식
|
ElementControlType | string |
UIA 컨트롤 형식을 숫자로 지정합니다. 이는 지역화된 컨트롤 형식과 유사하지만 언어에 따라 다릅니다. |
|
지역화된 요소 컨트롤 형식
|
ElementLocalizedControlType | string |
요소의 UIA 지역화된 컨트롤 형식입니다. |
|
요소를 사용할 수 있습니다.
|
ElementIsEnabled | boolean |
요소를 사용할지 여부를 반환합니다. |
|
요소가 오프스크린입니다.
|
ElementIsOffscreen | boolean |
요소가 오프스크린인지 여부를 반환합니다. |
|
요소가 키보드 포커스 가능
|
ElementIsKeyboardFocusable | boolean |
키보드에서 요소를 포커스할 수 있는지 여부를 반환합니다. |
|
요소에 키보드 포커스가 있습니다.
|
ElementHasKeyboardFocus | boolean |
요소에 현재 키보드 포커스가 있는지 여부를 반환합니다. |
|
요소가 암호 필드입니다.
|
ElementIsPasswordField | boolean |
요소가 암호 입력 필드인지 여부를 반환합니다. |
|
요소 가속기 키
|
ElementAcceleratorKey | string |
요소를 활성화하기 위해 누를 수 있는 바로 가기 키를 반환합니다. |
|
요소 액세스 키
|
ElementAccessKey | string |
메뉴 요소를 활성화하기 위해 누를 수 있는 바로 가기 키를 반환합니다. |
|
요소 왼쪽 가장자리
|
ElementLeftEdge | integer |
요소 또는 창의 왼쪽 가장자리와 디스플레이의 왼쪽 가장자리 사이의 거리(픽셀)입니다. |
|
요소 오른쪽 가장자리
|
ElementRightEdge | integer |
요소 또는 창의 오른쪽 가장자리와 디스플레이의 왼쪽 가장자리 사이의 거리(픽셀)입니다. |
|
요소 위쪽 가장자리
|
ElementTopEdge | integer |
요소 또는 창의 위쪽 가장자리와 디스플레이의 위쪽 가장자리 사이의 거리(픽셀)입니다. |
|
요소 아래쪽 가장자리
|
ElementBottomEdge | integer |
요소 또는 창의 아래쪽 가장자리와 디스플레이의 위쪽 가장자리 사이의 거리(픽셀)입니다. |
|
요소 클릭 가능 지점 X
|
ElementClickablePointX | integer |
기본 애플리케이션에서 반환한 디스플레이의 왼쪽 가장자리를 기준으로 요소의 중앙 클릭 가능 지점 픽셀 단위 X 좌표입니다. |
|
요소 클릭 가능 지점 Y
|
ElementClickablePointY | integer |
기본 애플리케이션에서 반환한 디스플레이의 위쪽 가장자리를 기준으로 요소의 중앙 클릭 가능 지점 픽셀 단위 Y 좌표입니다. |
|
요소 프로세스 ID
|
ElementProcessId | integer |
이 요소를 소유하는 프로세스의 PID(프로세스 ID)입니다. |
|
요소 핸들
|
ElementHandle | integer |
입력 'Return 요소 핸들'이 true로 설정된 경우 추가 작업에 사용할 수 있는 숫자 요소 핸들이 추가 작업에 대한 '부모' 핸들로 작동합니다. |
|
요소 값
|
ElementValue | string |
입력 'Return 요소 값'이 true로 설정되어 있고 요소에 값 패턴이 있는 경우 해당 값이 유지됩니다. |
|
요소 텍스트 값
|
ElementTextValue | string |
입력 'Return 요소 값'이 true로 설정되어 있고 요소에 텍스트 값 패턴이 있는 경우 해당 텍스트 값이 유지됩니다. |
UIA 요소 속성을 목록으로 가져오기
요소의 속성을 개별 항목 대신 한 줄 목록(단일 줄 컬렉션/데이터 테이블)으로 반환합니다. 이는 데이터를 사용하는 방법에 따라 유용할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요소 핸들
|
ElementHandle | True | integer |
대상 요소에 대한 UIA 핸들입니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
찾은 요소 수
|
NumberOfElementsFound | integer |
찾은 요소의 수입니다. |
|
반환된 요소 수
|
NumberOfElementsReturned | integer |
반환된 요소의 수입니다. |
|
UIA 요소 속성 JSON
|
UIAElementPropertiesJSON | string |
요소의 UIA 속성(JSON 형식)입니다. |
UIA 요소 스크롤 백분율 설정
해당 요소에서 스크롤을 지원하는 경우 지정된 요소의 가로 및/또는 세로 스크롤 비율을 설정합니다. 요소가 'scroll' 패턴을 지원하는 경우 이 동작을 요소에 직접 적용하고 가로 또는 세로 스크롤 양(또는 둘 다)을 지정할 수 있습니다. 요소가 '스크롤' 패턴을 지원하지 않는 경우 이 작업은 '범위 값' 또는 '값' 패턴으로 대체되지만 요소 자체가 아닌 스크롤 막대 컨트롤에 직접 적용해야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
가로 스크롤 백분율
|
HorizontalScrollPercentage | double |
요소를 가로로 스크롤하거나(0에서 100까지 포함, 100진수 지원) 가로 스크롤 위치를 변경하지 않고 -1 위치입니다. |
|
|
세로 스크롤 백분율
|
VerticalScrollPercentage | double |
요소를 세로로 스크롤하거나(0에서 100까지 포함, 10진수 지원) 세로 스크롤 위치를 변경하지 않고 -1 위치입니다. |
|
|
스크롤 패턴 사용해 보기
|
TryScrollPattern | boolean |
true로 설정하면 IA-Connect 에이전트가 UIA 스크롤 패턴을 사용하여 스크롤 작업을 수행하려고 시도합니다. 선택한 요소에서 UIA 스크롤 패턴을 사용할 수 없는 경우 IA-Connect 에이전트는 다른 선택한 패턴(이 작업에 대한 다른 입력을 통해 사용 또는 사용 안 함)으로 대체됩니다. false로 설정하면 IA-Connect 에이전트는 스크롤 패턴을 사용하지 않고 선택한 다른 패턴으로 즉시 대체됩니다. 시도된 패턴의 순서(이 작업에 대한 입력을 통해 사용하도록 설정된 경우)는 스크롤, 범위 값 및 값입니다. |
|
|
범위 값 패턴 사용해 보기
|
TryRangeValuePattern | boolean |
true로 설정하면 IA-Connect 에이전트가 UIA 범위 값 패턴을 사용하여 스크롤 작업을 수행하려고 시도합니다. 선택한 요소에서 UIA 범위 값 패턴을 사용할 수 없는 경우 IA-Connect 에이전트는 선택한 다른 패턴(이 작업에 대한 다른 입력을 통해 사용 또는 사용 안 함)으로 대체됩니다. false로 설정하면 IA-Connect 에이전트는 범위 값 패턴을 사용하지 않고 선택한 다른 패턴으로 즉시 대체됩니다. 시도된 패턴의 순서(이 작업에 대한 입력을 통해 사용하도록 설정된 경우)는 스크롤, 범위 값 및 값입니다. |
|
|
값 패턴 사용해 보기
|
TryValuePattern | boolean |
true로 설정하면 IA-Connect 에이전트는 UIA 값 패턴을 사용하여 스크롤 작업을 수행하려고 시도합니다. 선택한 요소에서 UIA 값 패턴을 사용할 수 없는 경우 IA-Connect 에이전트는 선택한 다른 패턴(이 작업에 대한 다른 입력을 통해 사용 또는 사용 안 함)으로 대체됩니다. false로 설정하면 IA-Connect 에이전트가 값 패턴을 사용하지 않고 선택한 다른 패턴으로 즉시 대체됩니다. 시도된 패턴의 순서(이 작업에 대한 입력을 통해 사용하도록 설정된 경우)는 스크롤, 범위 값 및 값입니다. 경고: 편집 요소에 값 패턴을 사용하면 편집 요소에 값이 입력됩니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
UIASetElementScrollPercentageResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
UIA 요소 위치 스크린샷
요소 위치의 스크린샷을 찍고 이미지를 반환합니다. 스크린샷이 요소 위치에서 화면의 복사본을 가져오기 때문에 요소를 먼저 맨 앞으로 가져와야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
이미지 형식
|
ImageFormat | string |
스크린샷에 사용할 이미지 형식입니다. 이는 반환되는 데이터의 품질 및 크기에 영향을 줄 수 있습니다. 지원되는 형식은 PNG(기본값), JPG, BMP 및 GIF입니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
에이전트 숨기기
|
HideAgent | boolean |
스크린샷을 가리지 않도록 에이전트를 자동으로 숨기려면 true로 설정합니다(표시되는 경우). |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Base64로 화면 이미지
|
ScreenBitmapBase64 | string |
Base64로 인코딩된 문자열인 화면 이미지입니다. |
UIA 요소 이동
UIA 요소를 화면에서 지정된 위치로 이동합니다. 이 작업은 일반적으로 Window 요소(변환 패턴 포함)에서만 작동합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
가로 이동 유형
|
HorizontalMovementType | string |
이동 유형: 절대 또는 상대입니다. |
|
|
가로 위치
|
HorizontalPosition | True | integer |
요소의 새 가로 위치입니다. 이동 형식(예: 절대 또는 상대)은 입력 '가로 이동 형식'으로 정의됩니다. 가로 위치를 변경하지 않고 그대로 두려면 값 0을 선택하고 '가로 이동 유형'을 '상대'로 설정합니다. |
|
세로 이동 유형
|
VerticalMovementType | string |
이동 유형: 절대 또는 상대입니다. |
|
|
세로 위치
|
VerticalPosition | True | integer |
요소의 새 세로 위치입니다. 이동 형식(예: 절대 또는 상대)은 입력 '세로 이동 형식'으로 정의됩니다. 세로 위치를 변경하지 않고 그대로 두려면 값 0을 선택하고 '세로 이동 유형'을 'Relative'로 설정합니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
UIAMoveElementResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
UIA 요소 주위에 사각형 그리기
요소의 경계 주위에 사각형을 그려 찾은 요소가 필수 요소임을 식별하는 데 도움이 됩니다. 사각형은 5초 후에 자동으로 제거됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
펜 색상
|
PenColour | string |
그릴 사각형의 색(예: 빨간색, 녹색, 파란색, 노란색, 자주색 또는 주황색) 또는 문자열 16진수 코드(예: #FF0000)입니다. |
|
|
펜 두께 픽셀
|
PenThicknessPixels | integer |
강조 사각형 테두리의 두께(픽셀)입니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 요소 창 닫기
요소 창을 닫습니다. 일반적으로 창 또는 대화 상자에서만 작동합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 요소 축소
요소를 축소합니다(일반적으로 메뉴/드롭다운 항목). 항목이 이미 축소된 경우 아무 일도 발생하지 않습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 요소 크기 조정
UIA 요소의 크기를 조정합니다. 이 작업은 일반적으로 Window 요소(변환 패턴 포함)에서만 작동합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
너비 형식 크기 조정
|
ResizeWidthType | string |
너비 크기 조정 유형: 절대 또는 상대입니다. |
|
|
새 너비
|
NewWidth | True | integer |
요소의 새 너비입니다. 크기 조정 형식(예: 절대 또는 상대)은 입력 '너비 크기 조정 형식'에 의해 정의됩니다. 너비를 변경하지 않고 그대로 두려면 값 0을 선택하고 '너비 형식 크기 조정'을 'Relative'로 설정합니다. |
|
높이 유형 크기 조정
|
ResizeHeightType | string |
높이 크기 조정 유형: 절대 또는 상대입니다. |
|
|
새 높이
|
NewHeight | True | integer |
요소의 새 높이입니다. 크기 조정 형식(예: 절대 또는 상대)은 입력 '높이 형식 크기 조정'에 의해 정의됩니다. 높이를 변경하지 않고 그대로 두려면 값 0을 선택하고 '높이 유형 크기 조정'을 'Relative'로 설정합니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
UIAResizeElementResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
UIA 요소 텍스트 값 가져오기
요소의 텍스트 값을 반환합니다. 텍스트 값은 일반적으로 레이블과 연결되지만 많은 요소에 이 속성이 있을 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
요소 텍스트 값
|
ElementTextValue | string |
요소의 텍스트 값입니다. |
UIA 요소 패턴 가져오기
UIA 요소에 사용할 수 있는 UIA 패턴을 검색하여 IA-Connect UIA 동작이 요소에 영향을 미칠 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사용 가능한 축소 패턴 확장
|
ExpandCollapsePatternAvailable | boolean |
UIA 확장 축소 패턴을 사용할 수 있으므로 요소(예: 드롭다운 메뉴)를 확장하거나 축소하는 작업이 작동할 수 있습니다. |
|
사용 가능한 호출 패턴
|
InvokePatternAvailable | boolean |
UIA 호출 패턴을 사용할 수 있으므로 요소를 누르거나 목록 요소 항목을 클릭하는 작업이 작동할 수 있습니다. |
|
사용 가능한 범위 값 패턴
|
RangeValuePatternAvailable | boolean |
UIA 범위 값 패턴을 사용할 수 있으므로 요소 또는 슬라이더를 스크롤하는 작업이 작동할 가능성이 높습니다. |
|
사용 가능한 스크롤 패턴
|
ScrollPatternAvailable | boolean |
UIA 스크롤 패턴을 사용할 수 있으므로 요소를 스크롤하는 작업이 작동할 가능성이 높습니다. |
|
선택 항목 패턴 사용 가능
|
SelectionItemPatternAvailable | boolean |
UIA 선택 항목 패턴을 사용할 수 있으므로 요소를 선택하는 작업이 작동할 가능성이 높습니다. |
|
사용할 수 있는 텍스트 패턴
|
TextPatternAvailable | boolean |
UIA 텍스트 패턴을 사용할 수 있으므로 요소 텍스트 값을 읽는 작업이 작동할 수 있습니다. |
|
사용 가능한 토글 패턴
|
TogglePatternAvailable | boolean |
UIA 토글 패턴을 사용할 수 있으므로 요소를 확인, 선택 취소 또는 토글하는 작업이 작동할 수 있습니다. |
|
사용 가능한 값 패턴
|
ValuePatternAvailable | boolean |
UIA 값 패턴을 사용할 수 있으므로 요소에 텍스트를 입력하거나 요소 값을 읽는 작업이 작동할 수 있습니다. 스크롤 막대는 값 패턴에 반응할 수도 있습니다. |
|
사용 가능한 창 패턴
|
WindowPatternAvailable | boolean |
UIA 창 패턴을 사용할 수 있으므로 요소를 닫거나 최대화하거나 최소화하는 작업이 작동할 가능성이 높습니다. |
|
사용 가능한 그리드 패턴
|
GridPatternAvailable | boolean |
UIA 그리드 패턴을 사용할 수 있습니다. 이 패턴은 IA-Connect에서 사용되지 않습니다. |
|
사용할 수 있는 그리드 항목 패턴
|
GridItemPatternAvailable | boolean |
UIA 그리드 항목 패턴을 사용할 수 있습니다. 이 패턴은 IA-Connect에서 사용되지 않습니다. |
|
사용 가능한 레거시 IAccessible 패턴
|
LegacyIAccessiblePatternAvailable | boolean |
UIA 레거시 IAccessible 패턴을 사용할 수 있습니다. 이 패턴은 IA-Connect에서 사용되지 않습니다. |
|
선택 패턴 사용 가능
|
SelectionPatternAvailable | boolean |
UIA 선택 패턴을 사용할 수 있습니다. 이 패턴은 IA-Connect에서 사용되지 않습니다. |
|
스프레드시트 패턴 사용 가능
|
SpreadsheetPatternAvailable | boolean |
UIA 스프레드시트 패턴을 사용할 수 있습니다. 이 패턴은 IA-Connect에서 사용되지 않습니다. |
|
스프레드시트 항목 패턴 사용 가능
|
SpreadsheetItemPatternAvailable | boolean |
UIA 스프레드시트 항목 패턴을 사용할 수 있습니다. 이 패턴은 IA-Connect에서 사용되지 않습니다. |
|
사용 가능한 테이블 패턴
|
TablePatternAvailable | boolean |
UIA 테이블 패턴을 사용할 수 있습니다. 이 패턴은 IA-Connect에서 사용되지 않습니다. |
|
사용 가능한 테이블 항목 패턴
|
TableItemPatternAvailable | boolean |
UIA 테이블 항목 패턴을 사용할 수 있습니다. 이 패턴은 IA-Connect에서 사용되지 않습니다. |
|
텍스트 패턴 2 사용 가능
|
TextPattern2Available | boolean |
UIA 텍스트 패턴 2를 사용할 수 있습니다. 이 패턴은 IA-Connect에서 사용되지 않습니다. |
|
텍스트 편집 패턴 사용 가능
|
TextEditPatternAvailable | boolean |
UIA 텍스트 편집 패턴을 사용할 수 있습니다. 이 패턴은 IA-Connect에서 사용되지 않습니다. |
|
사용 가능한 변환 패턴
|
TransformPatternAvailable | boolean |
UIA 변환 패턴을 사용할 수 있습니다. 이 패턴은 IA-Connect에서 사용되지 않습니다. |
UIA 요소 확인
요소의 상태(일반적으로 확인란 또는 라디오 상자)를 선택하거나 선택 취소로 설정합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
Check 요소
|
CheckElement | boolean |
요소를 선택(true) 또는 선택 취소(false)해야 하나요? |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 요소 확장
요소를 확장합니다(일반적으로 메뉴/드롭다운 항목). 항목이 이미 확장된 경우 아무 일도 발생하지 않습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 요소가 선택되어 있는지 확인
이 작업은 요소(일반적으로 확인란 또는 라디오 상자)가 선택되어 있는지 여부를 나타내는 true 또는 false를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
요소가 선택되어 있습니다.
|
ElementIsChecked | boolean |
요소가 선택되어 있으면 true를 반환하고 그렇지 않으면 false를 반환합니다. |
UIA 요소가 없을 때까지 기다립니다.
요소(일반적으로 단추 또는 텍스트 입력 영역과 같은 창 내의 개별 요소)가 더 이상 존재하지 않을 때까지 기다립니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 프로세스 ID
|
SearchProcessId | integer |
지정된 경우(값이 1 이상)이면 이 프로세스 ID(PID)가 있는 프로세스에서 소유하는 요소만 검색에서 고려합니다. IA-Connect 프로세스를 시작한 경우 PID는 IA-Connect 환경/세션 작업의 '프로세스 실행' 작업에 의해 제공됩니다. PID를 모르는 경우 이 필드를 비워 둡니다(또는 0). |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
대기 시간(초)
|
SecondsToWait | True | integer |
요소가 없을 때까지 대기할 최대 시간(초)입니다. |
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
자식 프로세스 포함
|
IncludeChildProcesses | boolean |
true로 설정하고 '검색 프로세스 ID'를 지정하면 해당 프로세스 ID의 자식 프로세스도 검색에 포함됩니다. false로 설정하면 정확한 '검색 프로세스 ID'에 일치하는 프로세스만 반환됩니다. |
|
|
요소가 여전히 있는 경우 예외 발생
|
RaiseExceptionIfElementStillExists | boolean |
대기 기간 후에도 UIA 요소가 여전히 존재하는 경우 IA-Connect 예외를 발생시켜야 하나요? |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
대기하기 전에 요소가 존재합니다.
|
ElementExistsBeforeWait | boolean |
대기하기 전에 요소가 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다. |
|
대기 후 요소가 존재합니다.
|
ElementExistsAfterWait | boolean |
대기한 후 요소가 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다. |
UIA 요소가 존재하나요?
요소가 존재하는지 여부를 보고하고 몇 가지 기본 요소 속성을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 프로세스 ID
|
SearchProcessId | integer |
지정된 경우(값이 1 이상)이면 이 프로세스 ID(PID)가 있는 프로세스에서 소유하는 요소만 검색에서 고려합니다. IA-Connect 프로세스를 시작한 경우 PID는 IA-Connect 환경/세션 작업의 '프로세스 실행' 작업에 의해 제공됩니다. PID를 모르는 경우 이 필드를 비워 둡니다(또는 0). |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
반환 요소 핸들
|
ReturnElementHandle | boolean |
true로 설정하면 찾은 요소에 대한 핸들이 반환됩니다. 이 핸들은 추가 작업에서 '부모' 핸들 역할을 하는 데 사용할 수 있습니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
자식 프로세스 포함
|
IncludeChildProcesses | boolean |
true로 설정하고 '검색 프로세스 ID'를 지정하면 해당 프로세스 ID의 자식 프로세스도 검색에 포함됩니다. false로 설정하면 정확한 '검색 프로세스 ID'에 일치하는 프로세스만 검색됩니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
요소가 있음
|
ElementExists | boolean |
요소가 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다. |
|
요소 핸들
|
ElementHandle | integer |
요소에 대한 UIA 핸들입니다. 이 요소는 이 요소에 대해 작동하는 추가 UIA 작업에 대한 입력으로 사용할 수 있습니다. |
|
요소 이름
|
ElementName | string |
요소의 UIA 이름입니다. |
|
요소 클래스 이름
|
ElementClassName | string |
요소의 UIA 클래스 이름입니다. |
|
요소 자동화 ID
|
ElementAutomationId | string |
요소의 UIA 자동화 ID입니다. |
|
지역화된 요소 컨트롤 형식
|
ElementLocalizedControlType | string |
요소의 UIA 지역화된 컨트롤 형식입니다. |
UIA 요소를 마우스 오른쪽 단추로 클릭하는 전역
UIA 요소를 기준으로 마우스를 가운데 또는 선택한 가장자리, 모서리 또는 오프셋으로 이동하고 마우스 오른쪽 단추를 클릭합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
먼저 포커스 요소
|
FocusElementFirst | boolean |
IA-Connect 전역 클릭 전에 요소에 초점을 맞추려고 해야 하나요? |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
오프셋 X 클릭
|
ClickOffsetX | integer |
클릭 동작을 오프셋할 X 픽셀의 수입니다. 이 매개 변수는 양수(오른쪽) 및 음수(왼쪽) 오프셋 값을 모두 지원합니다. |
|
|
오프셋 Y 클릭
|
ClickOffsetY | integer |
클릭 동작을 오프셋할 Y 픽셀의 수입니다. 이 매개 변수는 양수(아래쪽) 및 음수(위쪽) 오프셋 값을 모두 지원합니다. |
|
|
에 상대적인 오프셋
|
OffsetRelativeTo | string |
오프셋할 요소의 상대 위치입니다(가운데/가운데/가운데, 왼쪽, 오른쪽, 위쪽, 아래쪽, 왼쪽 위, 오른쪽 위, 왼쪽 아래, 오른쪽 아래). |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
요소 경계 내에서 클릭 가능한 지점의 유효성을 검사합니다.
|
ValidateClickablePointWithinElementBoundary | boolean |
일부 요소의 경우 UIA는 요소 내에서 클릭 가능한 점을 인식하지 못하며 요소의 중심 대신 잘못된 좌표(예: 0,0)를 반환합니다. 이 입력이 true로 설정된 경우 IA-Connect UIA에서 제공하는 좌표의 유효성을 확인하고 요소 경계 내에 없는 경우 UIA에서 제공하는 값을 무시하고 대신 요소의 중심을 사용합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 요소를 숫자 값으로 설정
숫자 입력이 있는 요소의 값(예: 텍스트 필드 또는 스크롤 막대)을 설정합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
새 값
|
NewValue | True | integer |
요소를 설정할 숫자 값입니다. |
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
입력 유효성 검사에 실패할 경우 예외 발생
|
RaiseExceptionIfInputValidationFails | boolean |
사용하도록 설정된 경우 IA-Connect 에이전트는 요청된 텍스트를 입력한 후 요소의 새 값을 확인합니다. 새 값이 예상 값과 일치하지 않으면 예외가 발생합니다. 이 입력이 false(기본값)이면 경고가 로그에 입력되지만 예외는 발생하지 않습니다. |
|
|
값 패턴 사용해 보기
|
TryValuePattern | boolean |
true(기본값)로 설정하면 IA-Connect 에이전트가 UIA 값 패턴을 사용하여 텍스트 입력 작업을 수행하려고 합니다. 선택한 요소에서 UIA 값 패턴을 사용할 수 없는 경우 IA-Connect 에이전트는 다른 패턴(이 작업에 대한 다른 입력을 통해 사용 또는 사용 안 함)으로 대체됩니다. false로 설정하면 IA-Connect 에이전트가 값 패턴을 사용하지 않고 선택한 다른 패턴으로 즉시 대체됩니다. |
|
|
레거시 패턴 사용해 보기
|
TryLegacyPattern | boolean |
true로 설정하면 IA-Connect 에이전트는 값 패턴을 사용할 수 없는 경우(요소에 없거나 사용이 비활성화되었기 때문에) UIA 레거시 패턴을 사용하여 텍스트 입력 작업을 수행하려고 시도합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 요소를 숫자 범위 값으로 설정
숫자 범위가 있는 요소의 값(예: 스크롤 막대)을 설정합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
새 값
|
NewValue | True | double |
요소를 설정할 숫자 범위 값입니다. |
|
새 값이 백분율입니다.
|
NewValueIsPercentage | boolean |
새 값이 백분율인가요? |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 요소에 대한 입력 반환
기존 텍스트를 대체하거나 특정 위치에 반환을 삽입하여 Windows 반환/새 줄을 요소(일반적으로 텍스트 입력 필드)에 입력합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
기존 값 바꾸기
|
ReplaceExistingValue | boolean |
요소에 기존 텍스트가 있는 경우 대체해야 하나요? |
|
|
삽입 위치
|
InsertPosition | integer |
텍스트 삽입을 시작할 위치(인덱스)입니다. 기존 텍스트가 있는 경우 삽입 위치를 사용하여 기존 텍스트 내의 특정 위치에 삽입할 수 있습니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
입력 유효성 검사에 실패할 경우 예외 발생
|
RaiseExceptionIfInputValidationFails | boolean |
사용하도록 설정된 경우 IA-Connect 에이전트는 요청된 텍스트를 입력한 후 요소의 새 값을 확인합니다. 새 값이 예상 값과 일치하지 않으면 예외가 발생합니다. 이 입력이 false(기본값)이면 경고가 로그에 입력되지만 예외는 발생하지 않습니다. |
|
|
값 패턴 사용해 보기
|
TryValuePattern | boolean |
true(기본값)로 설정하면 IA-Connect 에이전트가 UIA 값 패턴을 사용하여 텍스트 입력 작업을 수행하려고 합니다. 선택한 요소에서 UIA 값 패턴을 사용할 수 없는 경우 IA-Connect 에이전트는 다른 패턴(이 작업에 대한 다른 입력을 통해 사용 또는 사용 안 함)으로 대체됩니다. false로 설정하면 IA-Connect 에이전트가 값 패턴을 사용하지 않고 선택한 다른 패턴으로 즉시 대체됩니다. |
|
|
레거시 패턴 사용해 보기
|
TryLegacyPattern | boolean |
true로 설정하면 IA-Connect 에이전트는 값 패턴을 사용할 수 없는 경우(요소에 없거나 사용이 비활성화되었기 때문에) UIA 레거시 패턴을 사용하여 텍스트 입력 작업을 수행하려고 시도합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 요소에 대한 전역 입력 암호
마우스를 요소의 가운데로 이동하고, 포커스를 지정하고, 왼쪽 클릭하여 키를 누릅니다. 일반적으로 네이티브 UIA 입력 메서드를 허용하지 않는 암호 입력과 함께 사용됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
먼저 포커스 요소
|
FocusElement | boolean |
IA-Connect 전역 클릭 전에 요소에 초점을 맞추려고 해야 하나요? |
|
|
요소를 마우스 왼쪽 단추로 클릭하는 전역
|
GlobalMouseClickOnElement | boolean |
텍스트를 입력하기 전에 요소 좌표에서 전역 마우스 클릭을 수행해야 하나요(요소에 초점을 맞추기 위해)? |
|
|
두 번 마우스 클릭 삭제를 사용하여 기존 값 바꾸기
|
ReplaceExistingValueUsingDoubleClickDelete | boolean |
기존 값을 마우스를 두 번 클릭하여 강조 표시한 다음 삭제하여 바꿔야 하나요? |
|
|
CTRL-A 삭제를 사용하여 기존 값 바꾸기
|
ReplaceExistingValueUsingCTRLADelete | boolean |
기존 값을 Ctrl-A 누른 다음(모두 강조 표시) 삭제하여 바꿔야 하나요? 일부 요소는 Ctrl-A 강조 표시를 지원하지 않을 수 있습니다. 이 경우 '두 번 마우스 클릭 삭제를 사용하여 기존 값 바꾸기'의 대체 옵션을 시도해야 합니다. |
|
|
입력할 암호
|
PasswordToInput | True | password |
키보드를 사용하여 전역 입력에 대한 암호 값입니다. |
|
키 이벤트 보내기 사용
|
SendKeyEvents | boolean |
true로 설정하면 키 이벤트(시뮬레이션된 키 입력을 운영 체제로 보내는 하위 수준 API)를 보냅니다. false로 설정하면 키 보내기(키 입력을 포커스가 있는 요소로 보내는 상위 수준 API)가 대신 사용됩니다. |
|
|
간격(밀리초)
|
Interval | integer |
각 키 누름 사이의 시간(밀리초)입니다. |
|
|
기호 해석 안 함
|
DontInterpretSymbols | boolean |
'입력 암호'의 기호를 특수 키(예: Shift의 경우 + ^ Ctrl)로 해석하지 않아야 하나요? 실제 기호를 입력하려는 경우 true로 설정해야 합니다. |
|
|
암호에 저장된 암호가 포함되어 있습니다.
|
PasswordContainsStoredPassword | boolean |
암호에 {IAConnectPassword:StoredPasswordIdentifier} 형식의 IA-Connect 저장된 암호 식별자 또는 {OrchestratorCredential:FriendlyName} 형식의 IA-Connect Orchestrator 제네릭 자격 증명이 포함되어 있는 경우 true로 설정합니다. 이 저장된 암호는 '암호 생성' 작업(예: IA-Connect Orchestrator)에 의해 생성되거나 유지될 수 있습니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
요소 경계 내에서 클릭 가능한 지점의 유효성을 검사합니다.
|
ValidateClickablePointWithinElementBoundary | boolean |
일부 요소의 경우 UIA는 요소 내에서 클릭 가능한 점을 인식하지 못하며 요소의 중심 대신 잘못된 좌표(예: 0,0)를 반환합니다. 이 입력이 true로 설정된 경우 IA-Connect UIA에서 제공하는 좌표의 유효성을 확인하고 요소 경계 내에 없는 경우 UIA에서 제공하는 값을 무시하고 대신 요소의 중심을 사용합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 요소에 대한 전역 입력 텍스트
마우스를 요소의 가운데로 이동하고, 포커스를 지정하고, 왼쪽 클릭하여 키를 누릅니다. 일반적으로 네이티브 UIA 입력 메서드를 허용하지 않는 텍스트 입력과 함께 사용됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
먼저 포커스 요소
|
FocusElement | boolean |
IA-Connect 전역 클릭 전에 요소에 초점을 맞추려고 해야 하나요? |
|
|
요소를 마우스 왼쪽 단추로 클릭하는 전역
|
GlobalMouseClickOnElement | boolean |
텍스트를 입력하기 전에 요소 좌표에서 전역 마우스 클릭을 수행해야 하나요(요소에 초점을 맞추기 위해)? |
|
|
두 번 마우스 클릭 삭제를 사용하여 기존 값 바꾸기
|
ReplaceExistingValueUsingDoubleClickDelete | boolean |
기존 값을 마우스를 두 번 클릭하여 강조 표시한 다음 삭제하여 바꿔야 하나요? |
|
|
CTRL-A 삭제를 사용하여 기존 값 바꾸기
|
ReplaceExistingValueUsingCTRLADelete | boolean |
기존 값을 Ctrl-A 누른 다음(모두 강조 표시) 삭제하여 바꿔야 하나요? 일부 요소는 Ctrl-A 강조 표시를 지원하지 않을 수 있습니다. 이 경우 '두 번 마우스 클릭 삭제를 사용하여 기존 값 바꾸기'의 대체 옵션을 시도해야 합니다. |
|
|
입력할 텍스트
|
TextToInput | string |
키보드를 사용하여 전역 입력에 대한 텍스트 값입니다. |
|
|
키 이벤트 보내기 사용
|
SendKeyEvents | boolean |
true로 설정하면 키 이벤트(시뮬레이션된 키 입력을 운영 체제로 보내는 하위 수준 API)를 보냅니다. false로 설정하면 키 보내기(키 입력을 포커스가 있는 요소로 보내는 상위 수준 API)가 대신 사용됩니다. |
|
|
간격(밀리초)
|
Interval | integer |
각 키 누름 사이의 시간(밀리초)입니다. |
|
|
기호 해석 안 함
|
DontInterpretSymbols | boolean |
'입력할 텍스트'의 기호를 특수 키(예: Shift의 경우 + ^ Ctrl)로 해석하지 않아야 하나요? 실제 기호를 입력하려는 경우 true로 설정해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
요소 경계 내에서 클릭 가능한 지점의 유효성을 검사합니다.
|
ValidateClickablePointWithinElementBoundary | boolean |
일부 요소의 경우 UIA는 요소 내에서 클릭 가능한 점을 인식하지 못하며 요소의 중심 대신 잘못된 좌표(예: 0,0)를 반환합니다. 이 입력이 true로 설정된 경우 IA-Connect UIA에서 제공하는 좌표의 유효성을 확인하고 요소 경계 내에 없는 경우 UIA에서 제공하는 값을 무시하고 대신 요소의 중심을 사용합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 요소에 암호 입력
기존 텍스트를 대체하는 요소(일반적으로 암호 입력 필드)에 암호를 입력하는 UIA 작업입니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
입력할 암호
|
PasswordToInput | True | password |
입력할 암호 값입니다. |
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
암호에 저장된 암호가 포함되어 있습니다.
|
PasswordContainsStoredPassword | boolean |
암호에 {IAConnectPassword:StoredPasswordIdentifier} 형식의 IA-Connect 저장된 암호 식별자 또는 {OrchestratorCredential:FriendlyName} 형식의 IA-Connect Orchestrator 제네릭 자격 증명이 포함되어 있는 경우 true로 설정합니다. 이 저장된 암호는 '암호 생성' 작업(예: IA-Connect Orchestrator)에 의해 생성되거나 유지될 수 있습니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
값 패턴 사용해 보기
|
TryValuePattern | boolean |
true(기본값)로 설정하면 IA-Connect 에이전트가 UIA 값 패턴을 사용하여 텍스트 입력 작업을 수행하려고 합니다. 선택한 요소에서 UIA 값 패턴을 사용할 수 없는 경우 IA-Connect 에이전트는 다른 패턴(이 작업에 대한 다른 입력을 통해 사용 또는 사용 안 함)으로 대체됩니다. false로 설정하면 IA-Connect 에이전트가 값 패턴을 사용하지 않고 선택한 다른 패턴으로 즉시 대체됩니다. |
|
|
레거시 패턴 사용해 보기
|
TryLegacyPattern | boolean |
true로 설정하면 IA-Connect 에이전트는 값 패턴을 사용할 수 없는 경우(요소에 없거나 사용이 비활성화되었기 때문에) UIA 레거시 패턴을 사용하여 텍스트 입력 작업을 수행하려고 시도합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 요소에 텍스트 입력
기존 텍스트를 대체하거나 특정 위치에 새 값을 삽입하여 요소(일반적으로 텍스트 입력 필드)에 텍스트를 입력하는 UIA 동작입니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
입력할 텍스트
|
TextToInput | string |
입력할 텍스트 값입니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
기존 값 바꾸기
|
ReplaceExistingValue | boolean |
요소에 기존 텍스트가 있는 경우 대체해야 하나요? |
|
|
삽입 위치
|
InsertPosition | integer |
텍스트 삽입을 시작할 위치(인덱스)입니다. 기존 텍스트가 있는 경우 삽입 위치를 사용하여 기존 텍스트 내의 특정 위치에 삽입할 수 있습니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
입력 유효성 검사에 실패할 경우 예외 발생
|
RaiseExceptionIfInputValidationFails | boolean |
사용하도록 설정된 경우 IA-Connect 에이전트는 요청된 텍스트를 입력한 후 요소의 새 값을 확인합니다. 새 값이 예상 값과 일치하지 않으면 예외가 발생합니다. 이 입력이 false(기본값)이면 경고가 로그에 입력되지만 예외는 발생하지 않습니다. |
|
|
값 패턴 사용해 보기
|
TryValuePattern | boolean |
true(기본값)로 설정하면 IA-Connect 에이전트가 UIA 값 패턴을 사용하여 텍스트 입력 작업을 수행하려고 합니다. 선택한 요소에서 UIA 값 패턴을 사용할 수 없는 경우 IA-Connect 에이전트는 다른 패턴(이 작업에 대한 다른 입력을 통해 사용 또는 사용 안 함)으로 대체됩니다. false로 설정하면 IA-Connect 에이전트가 값 패턴을 사용하지 않고 선택한 다른 패턴으로 즉시 대체됩니다. |
|
|
레거시 패턴 사용해 보기
|
TryLegacyPattern | boolean |
true로 설정하면 IA-Connect 에이전트는 값 패턴을 사용할 수 없는 경우(요소에 없거나 사용이 비활성화되었기 때문에) UIA 레거시 패턴을 사용하여 텍스트 입력 작업을 수행하려고 시도합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 요소에서 전역 가운데 마우스 클릭
UIA 요소를 기준으로 마우스를 가운데 또는 선택한 가장자리, 모서리 또는 오프셋으로 이동하고 가운데 마우스 단추를 클릭합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
먼저 포커스 요소
|
FocusElementFirst | boolean |
IA-Connect 전역 클릭 전에 요소에 초점을 맞추려고 해야 하나요? |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
오프셋 X 클릭
|
ClickOffsetX | integer |
클릭 동작을 오프셋할 X 픽셀의 수입니다. 이 매개 변수는 양수(오른쪽) 및 음수(왼쪽) 오프셋 값을 모두 지원합니다. |
|
|
오프셋 Y 클릭
|
ClickOffsetY | integer |
클릭 동작을 오프셋할 Y 픽셀의 수입니다. 이 매개 변수는 양수(아래쪽) 및 음수(위쪽) 오프셋 값을 모두 지원합니다. |
|
|
에 상대적인 오프셋
|
OffsetRelativeTo | string |
오프셋할 요소의 상대 위치입니다(가운데/가운데/가운데, 왼쪽, 오른쪽, 위쪽, 아래쪽, 왼쪽 위, 오른쪽 위, 왼쪽 아래, 오른쪽 아래). |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
요소 경계 내에서 클릭 가능한 지점의 유효성을 검사합니다.
|
ValidateClickablePointWithinElementBoundary | boolean |
일부 요소의 경우 UIA는 요소 내에서 클릭 가능한 점을 인식하지 못하며 요소의 중심 대신 잘못된 좌표(예: 0,0)를 반환합니다. 이 입력이 true로 설정된 경우 IA-Connect UIA에서 제공하는 좌표의 유효성을 확인하고 요소 경계 내에 없는 경우 UIA에서 제공하는 값을 무시하고 대신 요소의 중심을 사용합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 요소에서 전역 왼쪽 두 번 마우스 클릭
UIA 요소를 기준으로 마우스를 가운데 또는 선택한 가장자리, 모서리 또는 오프셋으로 이동하고 왼쪽 마우스 단추를 두 번 클릭합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
지연 시간(밀리초)
|
DelayInMilliseconds | integer |
각 클릭 사이의 지연 시간(밀리초)입니다. |
|
|
먼저 포커스 요소
|
FocusElementFirst | boolean |
IA-Connect 전역 클릭 전에 요소에 초점을 맞추려고 해야 하나요? |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
오프셋 X 클릭
|
ClickOffsetX | integer |
클릭 동작을 오프셋할 X 픽셀의 수입니다. 이 매개 변수는 양수(오른쪽) 및 음수(왼쪽) 오프셋 값을 모두 지원합니다. |
|
|
오프셋 Y 클릭
|
ClickOffsetY | integer |
클릭 동작을 오프셋할 Y 픽셀의 수입니다. 이 매개 변수는 양수(아래쪽) 및 음수(위쪽) 오프셋 값을 모두 지원합니다. |
|
|
에 상대적인 오프셋
|
OffsetRelativeTo | string |
오프셋할 요소의 상대 위치입니다(가운데/가운데/가운데, 왼쪽, 오른쪽, 위쪽, 아래쪽, 왼쪽 위, 오른쪽 위, 왼쪽 아래, 오른쪽 아래). |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
요소 경계 내에서 클릭 가능한 지점의 유효성을 검사합니다.
|
ValidateClickablePointWithinElementBoundary | boolean |
일부 요소의 경우 UIA는 요소 내에서 클릭 가능한 점을 인식하지 못하며 요소의 중심 대신 잘못된 좌표(예: 0,0)를 반환합니다. 이 입력이 true로 설정된 경우 IA-Connect UIA에서 제공하는 좌표의 유효성을 확인하고 요소 경계 내에 없는 경우 UIA에서 제공하는 값을 무시하고 대신 요소의 중심을 사용합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 요소에서 전역 왼쪽 마우스 클릭
UIA 요소를 기준으로 마우스를 가운데 또는 선택한 가장자리, 모서리 또는 오프셋으로 이동하고 왼쪽 마우스 단추를 클릭합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
먼저 포커스 요소
|
FocusElementFirst | boolean |
IA-Connect 전역 클릭 전에 요소에 초점을 맞추려고 해야 하나요? |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
오프셋 X 클릭
|
ClickOffsetX | integer |
클릭 동작을 오프셋할 X 픽셀의 수입니다. 이 매개 변수는 양수(오른쪽) 및 음수(왼쪽) 오프셋 값을 모두 지원합니다. |
|
|
오프셋 Y 클릭
|
ClickOffsetY | integer |
클릭 동작을 오프셋할 Y 픽셀의 수입니다. 이 매개 변수는 양수(아래쪽) 및 음수(위쪽) 오프셋 값을 모두 지원합니다. |
|
|
에 상대적인 오프셋
|
OffsetRelativeTo | string |
오프셋할 요소의 상대 위치입니다(가운데/가운데/가운데, 왼쪽, 오른쪽, 위쪽, 아래쪽, 왼쪽 위, 오른쪽 위, 왼쪽 아래, 오른쪽 아래). |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
요소 경계 내에서 클릭 가능한 지점의 유효성을 검사합니다.
|
ValidateClickablePointWithinElementBoundary | boolean |
일부 요소의 경우 UIA는 요소 내에서 클릭 가능한 점을 인식하지 못하며 요소의 중심 대신 잘못된 좌표(예: 0,0)를 반환합니다. 이 입력이 true로 설정된 경우 IA-Connect UIA에서 제공하는 좌표의 유효성을 확인하고 요소 경계 내에 없는 경우 UIA에서 제공하는 값을 무시하고 대신 요소의 중심을 사용합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 창 최대화
지정된 UIA 핸들을 사용하여 창을 최대화합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
창 핸들
|
WindowHandle | True | integer |
최대화할 창의 UIA 핸들입니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 창 최소화
지정된 UIA 핸들을 사용하여 창을 최소화합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
창 핸들
|
WindowHandle | True | integer |
최소화할 창의 UIA 핸들입니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 창을 표준으로 설정
지정된 UIA 핸들을 사용하여 창을 정규화합니다(즉, 최소화 또는 최대화 대신 일반 크기 창으로 설정).
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
창 핸들
|
WindowHandle | True | integer |
정규화할 창의 UIA 핸들입니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 최상위 Win32 창 대기
UIA 핸들을 반환하기 전에 최상위 Win32 창이 존재할 때까지 지정된 시간 동안 기다리는 빠른 Win32 작업입니다. 최상위 창은 데스크톱에 연결된 창입니다. 클래스 이름 또는 창 제목으로 검색하거나 와일드카드를 포함하여 고급 검색 필터를 지정할 수 있습니다. 이 작업은 Win32 API를 사용하지만 Windows, Java, ModernUI 및 웹 창을 검색할 수 있습니다. 더 강력한 UIA 작업 '데스크톱 요소 대기'를 사용하는 것이 더 일반적이지만 이 Win32 작업은 일반적으로 더 빠르게 실행됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
검색 클래스 이름
|
SearchClassName | string |
검색할 최상위 창의 요소 클래스 이름(예: '메모장')입니다. |
|
|
검색 창 제목
|
SearchWindowTitle | string |
검색할 최상위 창의 제목입니다. |
|
|
대기 시간(초)
|
SecondsToWait | True | integer |
창이 존재할 때까지 대기할 최대 시간(초)입니다. |
|
검색 프로세스 ID
|
SearchProcessId | integer |
창을 소유하는 프로세스의 선택적 프로세스 ID입니다(예: IA-Connect 환경/세션 작업에서 '프로세스 실행' 작업의 출력에서 제공됨). 프로세스 ID로 검색하지 않도록 0으로 설정합니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자를 사용하여 검색을 사용 가능한 창 속성에 대해 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: '*Excel' 및 [IsMinimised] = False AND [IsResizeable] = True와 같은 [제목]입니다. 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 창이 검색과 일치하는 경우 정렬 기준 창 속성을 지정할 수 있습니다. 이는 '인덱스 일치'와 함께 필요한 창을 선택하는 데 사용됩니다. 예를 들어 '열 이름 기준 정렬'이 [TopEdge]이고 '인덱스 일치'가 1이면 화면 맨 위에 가장 가까운 일치하는 창이 반환됩니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 창이 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록의 맨 아래(false)에서 '인덱스 일치'가 일치해야 합니다. |
|
|
창을 찾을 수 없는 경우 예외 발생
|
RaiseExceptionIfWindowNotFound | boolean |
대기 기간 이후에 검색 Win32 창이 없는 경우 예외를 발생시켜야 IA-Connect? |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
창 핸들
|
WindowHandle | integer |
창에 대한 UIA 핸들입니다. 이 창 내에서 추가 UIA 작업에 대한 입력으로 사용할 수 있습니다. |
|
요소 이름
|
ElementName | string |
창 요소의 UIA 이름입니다. |
|
요소 클래스 이름
|
ElementClassName | string |
창 요소의 UIA 클래스 이름입니다. |
|
요소 자동화 ID
|
ElementAutomationId | string |
창 요소의 UIA 자동화 ID입니다. |
|
지역화된 요소 컨트롤 형식
|
ElementLocalizedControlType | string |
창 요소의 UIA 지역화된 컨트롤 형식입니다. |
|
요소가 있음
|
ElementExists | boolean |
창이 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다. |
UIA 트랜잭션 시간 제한 설정
UIA API가 애플리케이션이 요소에 대한 정보를 반환할 때까지 대기하는 시간을 제어합니다. 이 트랜잭션 시간 제한은 일반적으로 애플리케이션이 응답하지 않는 경우에만 도달합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
제한 시간(초)
|
TimeoutInSeconds | True | double |
UIA API가 애플리케이션이 요소에 대한 정보를 반환할 때까지 대기하는 최대 시간입니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
UIA 프로세스 ID 주 창 대기
프로세스의 주 창(프로세스 ID로 지정됨)이 존재할 때까지 대기하고 핸들을 반환하는 간단하고 빠른 Win32 작업입니다. '기본' 창은 일반적으로 주 애플리케이션 창입니다. 로그인 대화 상자 또는 하위 창은 일반적으로 '기본' 창이 아닙니다. 더 강력한 '데스크톱 요소 대기' 작업을 사용하는 것이 좋습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
검색 프로세스 ID
|
ProcessId | True | integer |
대기할 프로세스의 ID입니다(IA-Connect 환경/세션 작업의 '프로세스 실행' 작업에서 제공). |
|
대기 시간(초)
|
SecondsToWait | True | integer |
프로세스 주 창을 대기할 최대 시간(초)입니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
요소가 있음
|
ElementExists | boolean |
요소가 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다. |
|
창 핸들
|
WindowHandle | integer |
창에 대한 UIA 핸들입니다. 이 창 내에서 추가 UIA 작업에 대한 입력으로 사용할 수 있습니다. |
|
요소 이름
|
ElementName | string |
창 요소의 UIA 이름입니다. |
|
요소 클래스 이름
|
ElementClassName | string |
창 요소의 UIA 클래스 이름입니다. |
|
요소 자동화 ID
|
ElementAutomationId | string |
창 요소의 UIA 자동화 ID입니다. |
|
지역화된 요소 컨트롤 형식
|
ElementLocalizedControlType | string |
창 요소의 UIA 지역화된 컨트롤 형식입니다. |
UIA 프로세스 주 창 대기
핸들을 반환하기 전에 프로세스의 주 창(이름으로 지정됨)이 존재할 때까지 지정된 시간 동안 대기하는 간단하고 빠른 Win32 작업입니다. '기본' 창은 일반적으로 주 애플리케이션 창입니다. 로그인 대화 상자 또는 하위 창은 일반적으로 '기본' 창이 아닙니다. 더 강력한 '데스크톱 요소 대기' 작업을 사용하는 것이 좋습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
검색 프로세스 이름
|
SearchProcessName | True | string |
검색할 프로세스의 이름(예: 메모장)입니다. |
|
대기 시간(초)
|
SecondsToWait | True | integer |
프로세스 주 창을 대기할 최대 시간(초)입니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
창 핸들
|
WindowHandle | integer |
창에 대한 UIA 핸들입니다. 이 창 내에서 추가 UIA 작업에 대한 입력으로 사용할 수 있습니다. |
|
요소 이름
|
ElementName | string |
창 요소의 UIA 이름입니다. |
|
요소 클래스 이름
|
ElementClassName | string |
창 요소의 UIA 클래스 이름입니다. |
|
요소 자동화 ID
|
ElementAutomationId | string |
창 요소의 UIA 자동화 ID입니다. |
|
지역화된 요소 컨트롤 형식
|
ElementLocalizedControlType | string |
창 요소의 UIA 지역화된 컨트롤 형식입니다. |
|
요소가 있음
|
ElementExists | boolean |
창이 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다. |
Win32 창 가져오기
필요에 따라 지정된 클래스 이름 또는 창 제목이 있는 모든 Win32 창 목록을 반환하거나 와일드카드를 포함하여 고급 검색 필터를 지정할 수 있는 빠른 Win32 작업입니다. 이 작업은 Win32 API를 사용하지만 Windows, Java, ModernUI 및 웹 창을 검색할 수 있습니다. Win32 Windows에는 작업 표시줄, 바탕 화면, 시작 메뉴, 투명한 오버레이, 오프스크린 또는 숨겨진 창을 비롯한 예기치 않은 항목이 포함될 수 있으므로 반환된 목록에 예상보다 많은 결과가 포함될 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
검색 클래스 이름
|
SearchClassName | string |
검색할 최상위 창의 선택적 클래스 이름(예: 'Chrome_WidgetWin_1')입니다. |
|
|
검색 창 제목
|
SearchWindowTitle | string |
검색할 최상위 창의 선택적 제목입니다. |
|
|
최상위 창만 검색
|
TopLevelWindowsOnly | boolean |
OS가 최상위 수준으로 간주하는 Win32 창만 검색하려면 true로 설정합니다. 모든 Win32 창을 검색하려면 false로 설정합니다. 창의 Win32 정의에는 창으로 인식할 수 없는 항목이 포함되며, 부모 창의 자식임에도 불구하고 많은 대화 상자와 메시지 상자가 최상위로 표시됩니다. |
|
|
표시되는 창만 검색
|
VisibleWindowsOnly | boolean |
OS가 표시되는 것으로 간주하는 Win32 창만 검색하려면 true로 설정합니다. 표시 및 보이지 않는 Win32 창을 모두 검색하려면 false로 설정합니다. 화면 끄기 또는 투명 창이 표시되는 것으로 표시될 수 있지만 볼 수는 없습니다. |
|
|
제목 표시줄이 있는 창만 검색
|
WindowsWithTitlebarOnly | boolean |
제목 표시줄이 있는 Win32 창만 검색하려면 true로 설정합니다. 제목 표시줄이 있는지 여부에 관계없이 Win32 창을 검색하려면 false로 설정합니다. 일부 투명 창에는 제목 표시줄이 있지만 볼 수 없습니다. |
|
|
제목이 있는 창만 검색
|
WindowsWithTitleOnly | boolean |
제목이 있는 Win32 창만 검색하려면 true로 설정합니다(예: 일부 텍스트가 포함된 제목 표시줄). 타이틀이 있는지 여부에 관계없이 Win32 창을 검색하려면 false로 설정합니다. 제목 표시줄은 창 위쪽의 스트립인 반면 제목은 창 안의 텍스트입니다. |
|
|
투명 창 무시
|
IgnoreTransparentWindows | boolean |
투명도가 없는 Win32 창만 검색하려면 true로 설정합니다. 투명도 설정 여부에 관계없이 Win32 창을 검색하려면 false로 설정합니다. |
|
|
검색 프로세스 ID
|
SearchProcessId | integer |
창을 소유하는 프로세스의 선택적 프로세스 ID입니다(예: IA-Connect 환경/세션 작업에서 '프로세스 실행' 작업의 출력에서 제공됨). 프로세스 ID로 검색하지 않도록 0으로 설정합니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: '*Excel' 및 [IsMinimised] = False AND [IsResizeable] = True와 같은 [제목]입니다. 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 창이 검색과 일치하는 경우 정렬 기준 창 속성을 지정할 수 있습니다. 예를 들어 '열 이름 기준 정렬'이 [TopEdge]이면 창 목록이 위쪽 가장자리 순으로 반환됩니다. 이 필드를 비워 두면 검색된 순서대로 창이 반환됩니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 창이 검색과 일치하고 정렬 열이 지정된 경우 오름차순으로 정렬하려면 true(기본값)로 설정하거나 내림차순으로 정렬하려면 false로 설정합니다. |
|
|
UIA 요소 핸들 반환
|
ReturnElementHandle | boolean |
true로 설정하면 각 Win32 창에 대한 UIA 핸들이 출력 컬렉션('UIAHandle' 열)에 반환됩니다. 이 핸들은 추가 작업에서 IA-Connect UIA 작업에서 '부모' 핸들 역할을 하는 데 사용할 수 있습니다. |
|
|
반환할 첫 번째 항목
|
FirstItemToReturn | integer |
반환할 첫 번째 창(행)의 인덱스(1부터 시작)입니다. |
|
|
반환할 최대 항목
|
MaxItemsToReturn | integer |
반환할 최대 창 수 또는 모든 항목을 반환할 0입니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Win32 windows JSON
|
Win32WindowsJSON | string |
검색 조건과 일치하는 Win32 창 목록(JSON 형식)입니다. |
|
Win32 창 수
|
NumberOfWin32Windows | integer |
반환된 Win32 창의 수입니다. |
데스크톱용 UIA 핸들 가져오기
바탕 화면에 대한 핸들을 반환합니다. 핸들 '-2'를 사용하여 데스크톱 요소를 참조할 수 있지만 데스크톱을 기준으로 검색할 수 있는 작업이 많기 때문에(예: '데스크톱 요소 대기') 사용되지 않는 작업입니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
창 핸들
|
WindowHandle | integer |
데스크톱에 대한 UIA 핸들입니다. 이 창 내에서 추가 UIA 작업에 대한 입력으로 사용할 수 있습니다. |
|
요소 이름
|
ElementName | string |
데스크톱 요소의 UIA 이름입니다. |
|
요소 클래스 이름
|
ElementClassName | string |
데스크톱 요소의 UIA 클래스 이름입니다. |
|
요소 자동화 ID
|
ElementAutomationId | string |
데스크톱 요소의 UIA 자동화 ID입니다. |
|
지역화된 요소 컨트롤 형식
|
ElementLocalizedControlType | string |
데스크톱 요소의 UIA 지역화된 컨트롤 형식입니다. |
모든 UIA 요소 핸들 다시 설정
많은 요소를 식별하고 많은 수의 요소 핸들이 저장된 경우 유용할 수 있는 IA-Connect 의해 현재 저장된 모든 UIA 요소 핸들을 다시 설정합니다. 매우 많은 수의 요소 핸들(100,000개 이상)이 있는 시나리오에서는 이 작업을 사용하여 RAM 사용량을 확보할 수도 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
여러 UIA 부모 요소 속성 가져오기
지정된 요소의 부모 요소 계층 트리를 바탕 화면(루트 수준)까지 반환합니다. 부모 요소는 UIA 'tree'의 다음 수준에 있고 거의 항상 포함하는 요소인 요소로 정의됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요소 핸들
|
ElementHandle | True | integer |
대상 요소에 대한 UIA 핸들입니다. |
|
처리할 최대 부모
|
MaxParentsToProcess | integer |
처리할 부모 요소의 최대 수입니다. 기본적으로 50으로 설정됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
UIA 부모 요소
|
UIAParentElements | array of object |
모든 부모 요소(및 해당 속성)의 목록입니다. 반환된 속성은 '여러 요소 속성 가져오기' 작업에서 반환한 속성과 동일합니다. |
|
items
|
UIAParentElements | object | |
|
반환된 부모 요소 수
|
NumberOfParentElementsReturned | integer |
검색에서 반환된 부모 요소의 수입니다. |
여러 UIA 요소 속성 가져오기
여러 요소의 속성을 반환합니다. 이는 필요한 속성 값을 보유하는 필드가 확실하지 않은 경우에 유용할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
지역화된 컨트롤 형식 검색 요소
|
SearchElementLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
하위 항목 검색
|
SearchDescendants | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
반환 요소 핸들
|
ReturnElementHandle | boolean |
true로 설정하면 찾은 요소에 대한 핸들이 반환됩니다. 이 핸들은 추가 작업에서 '부모' 핸들 역할을 하는 데 사용할 수 있습니다. |
|
|
반환 요소 값
|
ReturnElementValue | boolean |
true로 설정하면 찾은 요소의 값보다 값이 반환됩니다. |
|
|
반환할 첫 번째 항목
|
FirstItemToReturn | integer |
반환할 첫 번째 항목의 요소 인덱스(1부터 시작)입니다. UIA 트리의 아래쪽에서 역순으로 요소를 반환하려는 경우 -1부터 시작하는 음수 인덱스도 지정할 수 있습니다. |
|
|
반환할 최대 항목
|
MaxItemsToReturn | integer |
반환할 최대 요소 수 또는 모든 항목을 반환할 0입니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
찾은 요소 수
|
NumberOfElementsFound | integer |
검색 조건과 일치하는 요소의 수입니다. |
|
반환된 요소 수
|
NumberOfElementsReturned | integer |
반환되는 요소의 수입니다(반환할 최대 항목 수를 지정하는 경우 찾은 요소 수보다 낮을 수 있음). |
|
요소 속성
|
ElementProperties | array of object |
검색 조건과 일치하는 요소의 요소 속성입니다. |
|
items
|
ElementProperties | object |
여러 UIA 요소 확인
여러 요소(일반적으로 확인란 또는 라디오 상자)의 상태를 선택 또는 선택 취소로 설정합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
입력 요소
|
InputElementsJSON | True | string |
확인할 UIA 요소의 배열(JSON 형식)입니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
여러 UIA 요소를 테이블로 가져오기
지정된 부모 요소의 자식 요소 값을 열거하고 테이블 형식으로 반환합니다. 기술적으로 테이블이 아니지만 테이블 구조로 함께 정렬된 요소에서 데이터의 행과 열을 반환하는 데 사용할 수 있습니다. 이 작업은 에이전트 스레드로 실행된 이 작업의 이전 실행에서 결과를 검색하는 데 사용할 수도 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색 셀 머리글 하위 요소 지역화된 컨트롤 형식
|
SearchCellHeaderSubElementLocalizedControlType | string |
검색할 셀 머리글 하위 요소 지역화된 컨트롤 형식입니다. 셀 머리글을 검색하지 않으면 비워 둡니다. |
|
|
셀 머리글 하위 요소 컨트롤 형식 검색
|
SearchCellHeaderSubElementControlType | integer |
검색할 셀 머리글 하위 요소 컨트롤 형식(지역화되지 않은 정수)입니다. 이는 여러 언어에서 동일한 값입니다. 셀 머리글을 검색하지 않으면 0으로 둡니다. |
|
|
검색 셀 하위 요소 지역화된 컨트롤 형식
|
SearchCellSubElementLocalizedControlType | string |
검색할 지역화된 컨트롤 형식의 하위 셀입니다. |
|
|
셀 하위 요소 컨트롤 형식 검색
|
SearchCellSubElementControlType | integer |
검색할 셀 하위 요소 컨트롤 형식(지역화되지 않은 정수)입니다. 이는 여러 언어에서 동일한 값입니다. |
|
|
셀 하위 요소에 대한 하위 항목 검색
|
SearchDescendantsForCellSubElements | boolean |
true로 설정하면 찾은 요소 아래의 UIA 트리에서 셀 및 셀 머리글 하위 요소(즉, 출력 테이블의 셀을 채울 요소 값)를 검색합니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. 요소 바로 아래에 있는 요소에만 관심이 있는 경우 이 값을 false로 설정할 수 있습니다. |
|
|
반환할 첫 번째 셀 머리글 하위 요소
|
FirstCellHeaderSubElementToReturn | integer |
반환할 첫 번째 셀 헤더 하위 요소의 인덱스(1부터 시작)입니다. UIA 트리의 아래쪽에서 역순으로 요소를 반환하려는 경우 -1부터 시작하는 음수 인덱스도 지정할 수 있습니다. |
|
|
반환할 최대 셀 머리글 하위 요소
|
MaxCellHeaderSubElementsToReturn | integer |
반환할 셀 머리글 하위 요소의 최대 수 또는 모든 하위 값을 반환하는 0입니다. |
|
|
반환할 첫 번째 셀 하위 요소
|
FirstCellSubElementToReturn | integer |
반환할 첫 번째 셀 하위 요소의 인덱스(1부터 시작)입니다. UIA 트리의 아래쪽에서 역순으로 요소를 반환하려는 경우 -1부터 시작하는 음수 인덱스도 지정할 수 있습니다. |
|
|
반환할 최대 셀 하위 요소
|
MaxCellSubElementsToReturn | integer |
반환할 셀 하위 요소의 최대 수 또는 모든 하위 집합을 반환하는 0입니다. |
|
|
요청된 열 수
|
RequestedNumberOfColumns | integer |
출력 테이블에서 원하는 열 수입니다. 이 값은 읽는 요소에 대해 올바르거나 예기치 않은 결과를 받게 됩니다. |
|
|
셀 하위 요소 값 우선 순위
|
CellSubElementValuePriority | integer |
셀 하위 값을 출력 테이블에서 사용할 값으로 사용하는 우선 순위입니다. 1은 가장 높은 우선 순위입니다. 2는 두 번째 우선 순위입니다. 3은 세 번째 우선 순위입니다. 0은 사용하지 않습니다. |
|
|
셀 하위 요소 텍스트 값 우선 순위
|
CellSubElementTextValuePriority | integer |
셀 하위 텍스트 값을 출력 테이블에서 사용할 값으로 사용하는 우선 순위입니다. 1은 가장 높은 우선 순위입니다. 2는 두 번째 우선 순위입니다. 3은 세 번째 우선 순위입니다. 0은 사용하지 않습니다. |
|
|
셀 하위 요소 이름 값 우선 순위
|
CellSubElementNameValuePriority | integer |
셀 하위 요소 이름(레이블에 공통)을 출력 테이블에서 사용할 값으로 사용하는 우선 순위입니다. 1은 가장 높은 우선 순위입니다. 2는 두 번째 우선 순위입니다. 3은 세 번째 우선 순위입니다. 0은 사용하지 않습니다. |
|
|
최소 셀 하위 요소 너비
|
MinimumCellSubElementWidth | integer |
표에 포함할 셀 하위 요소의 최소 너비(픽셀)입니다. |
|
|
최소 셀 하위 높이
|
MinimumCellSubElementHeight | integer |
표에 포함할 셀 하위 요소의 최소 높이(픽셀)입니다. |
|
|
셀 하위 경계 상자 왼쪽 검색
|
SearchCellSubElementBoundingBoxLeft | integer |
경계 상자 내에 완전히 포함된 셀 하위 요소만 포함합니다. 기본적으로 경계 상자는 모든 요소를 포함할 수 있습니다. |
|
|
셀 하위 요소 경계 상자 오른쪽 검색
|
SearchCellSubElementBoundingBoxRight | integer |
경계 상자 내에 완전히 포함된 셀 하위 요소만 포함합니다. 기본적으로 경계 상자는 모든 요소를 포함할 수 있습니다. |
|
|
셀 하위 요소 경계 상자 위쪽 검색
|
SearchCellSubElementBoundingBoxTop | integer |
경계 상자 내에 완전히 포함된 셀 하위 요소만 포함합니다. 기본적으로 경계 상자는 모든 요소를 포함할 수 있습니다. |
|
|
검색 셀 하위 요소 경계 상자 아래쪽
|
SearchCellSubElementBoundingBoxBottom | integer |
경계 상자 내에 완전히 포함된 셀 하위 요소만 포함합니다. 기본적으로 경계 상자는 모든 요소를 포함할 수 있습니다. |
|
|
테이블을 스레드로 읽기
|
ReadTableAsThread | boolean |
false(기본값)로 설정하면 IA-Connect 에이전트가 테이블을 즉시 읽고 내용을 디렉터에게 반환합니다. 큰 테이블을 읽는 경우 이 작업은 시간이 초과할 수 있습니다. true로 설정하면 IA-Connect 에이전트가 테이블을 에이전트 스레드로 읽고 IA-Connect 디렉터(또는 Orchestrator, PowerShell 모듈, Blue Prism)가 이 에이전트 스레드의 상태를 모니터링하여 완료될 때까지 대기할 수 있습니다. 이렇게 하면 시간 제한 없이 큰 테이블을 읽을 수 있습니다. IA-Connect 에이전트 9.3 이하에서는 에이전트 스레드가 아니라 테이블을 즉시 읽을 수 있습니다. |
|
|
스레드 ID에 대한 출력 데이터 검색
|
RetrieveOutputDataFromThreadId | integer |
이전에 이 작업을 에이전트 스레드로 실행하고 '스레드를 기다리는 시간(초)'을 0으로 설정한 경우 에이전트 스레드 ID를 제공하여 결과를 검색합니다. 이 에이전트 스레드 ID는 이 작업에 대한 이전 호출에서 제공된 것입니다. 테이블을 읽는 경우(따라서 에이전트 스레드로 실행된 이전 쿼리의 결과를 검색하지 않음) 0(기본값)으로 설정합니다. |
|
|
스레드를 기다리는 시간(초)
|
SecondsToWaitForThread | integer |
'스레드로 테이블 읽기'가 true로 설정된 경우 에이전트 스레드가 완료되기를 기다리는 시간(초)입니다. 현재 테이블을 읽는 에이전트 스레드가 완료되지 않은 경우 예외가 발생합니다. 대기를 무시하려면 0으로 설정합니다. 에이전트는 테이블을 계속 읽지만 다음 작업에도 사용할 수 있습니다. 그런 다음 나중에 '에이전트 스레드가 완료되기를 기다립니다.' 작업을 사용하여 에이전트 스레드가 완료되기를 기다렸다가 '스레드 ID에 대한 출력 데이터 검색' 입력을 사용하여 이 '여러 UIA 요소를 테이블로 가져오기' 작업을 에이전트 스레드 ID로 설정하여 다시 실행하여 나중에 결과(테이블의 내용)를 검색할 수 있습니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
찾은 셀 하위 요소 수
|
NumberOfCellSubElementsFound | integer |
검색 조건과 일치하는 셀 하위 요소(머리글 아님)의 수입니다. |
|
반환된 셀 하위 요소 수
|
NumberOfCellSubElementsReturned | integer |
반환되는 셀 하위 요소 수(머리글 아님)입니다(반환할 항목의 첫 번째 또는 최대 수를 지정하는 경우 찾은 요소 수보다 작을 수 있음). |
|
테이블 내용 JSON
|
TableContentsJSON | string |
JSON 형식의 여러 요소 내용에서 만든 테이블입니다. |
|
테이블의 행 수
|
NumberOfRowsInTable | integer |
출력 테이블의 행 수입니다. |
|
테이블의 열 수
|
NumberOfColumnsInTable | integer |
출력 테이블의 열 수입니다. |
|
스레드 ID
|
ThreadId | integer |
이 작업을 에이전트 스레드로 실행하는 경우 이 출력에는 작업의 프로세스를 모니터링하고 스레드가 완료될 때 테이블 내용을 검색하는 데 사용할 수 있는 에이전트 스레드 ID가 포함됩니다. |
여러 UIA 요소에 텍스트 입력
기존 텍스트를 대체하거나 특정 위치에 새 값을 삽입하여 여러 요소(일반적으로 텍스트 입력 필드)에 다양한 텍스트를 입력하는 UIA 작업입니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
입력 요소
|
InputElementsJSON | True | string |
텍스트를 JSON 형식으로 입력할 UIA 요소의 배열입니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
이름으로 UIA 목록 요소 항목 클릭
지정된 이름을 가진 목록 요소를 클릭합니다. 일반적으로 드롭다운/메뉴 항목에서 항목을 선택하는 데 사용됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
먼저 확장
|
ExpandFirst | boolean |
true로 설정하면 IA-Connect 목록 항목 요소를 검색하기 전에 목록을 확장하려고 시도합니다. 목록이 확장될 때까지 목록 항목 요소를 만들지 못할 수 있으므로 동적 목록에 유용합니다. |
|
|
이후 축소
|
CollapseAfter | boolean |
true로 설정하면 검색을 실행한 후 목록이 축소됩니다. |
|
|
항목 이름
|
ItemName | string |
클릭할 요소 항목의 이름입니다. |
|
|
확장과 축소 사이의 초
|
SecondsBetweenExpandCollapse | double |
true로 설정된 경우 확장 및 축소 작업 간에 대기할 시간(초)입니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
인덱스별 UIA 목록 요소 항목 클릭
지정된 인덱스와 일치하는 목록 요소를 클릭합니다. 일반적으로 드롭다운/메뉴 항목에서 항목을 선택하는 데 사용됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
먼저 확장
|
ExpandFirst | boolean |
true로 설정하면 IA-Connect 목록 항목 요소를 검색하기 전에 목록을 확장하려고 시도합니다. 목록이 확장될 때까지 목록 항목 요소를 만들지 못할 수 있으므로 동적 목록에 유용합니다. |
|
|
이후 축소
|
CollapseAfter | boolean |
true로 설정하면 검색을 실행한 후 목록이 축소됩니다. |
|
|
항목 인덱스
|
ItemIndex | integer |
클릭할 항목 목록의 인덱스입니다. |
|
|
확장과 축소 사이의 초
|
SecondsBetweenExpandCollapse | double |
true로 설정된 경우 확장 및 축소 작업 간에 대기할 시간(초)입니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
전경 UIA 창 설정
창을 전경으로 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
창 핸들
|
WindowHandle | True | integer |
전경 창으로 설정해야 하는 창에 대한 UIA 핸들입니다. |
|
토글 창
|
ToggleWindow | boolean |
포커스를 설정하거나 클릭하여 창을 전환해야 하나요? 이렇게 하면 창이 전경으로 안정적으로 이동되도록 할 수 있습니다. |
|
|
전역 마우스 왼쪽 클릭 에이전트를 사용하는 토글
|
ToggleUsesGlobalLeftMouseClickAgent | boolean |
창을 토글하도록 선택하는 경우 전역 마우스 클릭을 사용하여 IA-Connect 에이전트에 먼저 초점을 맞출지 여부를 지정합니다. |
|
|
지연 시간(초) 설정/해제
|
ToggleDelay | double |
창을 토글하도록 선택하는 경우 토글 후 일시 중지를 지정합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
전역 마우스 클릭 UIA 요소 검색 색 영역
지정된 색상 조건을 충족하는 UIA 요소 내의 픽셀 영역 위로 마우스를 이동하고 마우스 클릭을 수행합니다. 스크린샷이 요소 위치에서 화면의 복사본을 가져오기 때문에 요소를 먼저 맨 앞으로 가져와야 합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
부모 창 핸들
|
ParentWindowHandle | True | integer |
검색의 시작점으로 사용할 부모 UIA 창 핸들(값 1 이상)입니다. '데스크톱 요소 대기' 또는 '요소 대기'와 같은 작업을 사용하여 검사를 통해 검색할 수 있습니다. |
|
검색 요소 이름
|
SearchElementName | string |
검색할 선택적 UIA 요소 이름입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
Search 요소 클래스 이름
|
SearchElementClassName | string |
검색할 선택적 UIA 요소 클래스 이름입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
검색 요소 자동화 ID
|
SearchElementAutomationId | string |
검색할 선택적 UIA 요소 자동화 ID입니다(부모 창 핸들에서 시작). 검사를 통해 검색할 수 있습니다. |
|
|
지역화된 컨트롤 형식 검색 요소
|
SearchLocalizedControlType | string |
검색할 선택적 UIA 요소 지역화된 컨트롤 형식입니다(부모 창 핸들부터 시작). 검사를 통해 검색할 수 있습니다. |
|
|
UIA 하위 트리 검색
|
SearchSubTree | boolean |
true로 설정하면 부모 창 핸들 아래의 전체 UIA 트리가 검색됩니다. 이것은 더 철저하지만 더 오래 걸릴 수 있습니다. false로 설정하면 UIA 트리의 부모 창 핸들 바로 아래에 있는 요소만 검색됩니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자와 요소 필드를 사용하여 검색을 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: 'Document*' 및 [ClassName]과 같은 [이름](예: 'Label*') 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 요소가 검색과 일치하는 경우 정렬 기준으로 사용할 요소 속성을 지정할 수 있습니다. 이 항목은 'Match index'와 함께 사용하여 필요한 요소를 선택합니다. 예를 들어 '열 이름을 기준으로 정렬'이 [TopEdge]이고 '일치 인덱스'가 1이면 화면 맨 위에 가장 가까운 일치하는 요소가 일치합니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 요소가 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록(false)의 맨 아래에서 '인덱스 일치'가 일치해야 합니다. |
|
|
색 검색
|
SearchColour | True | string |
각 색상 채널이 16진수 형식의 바이트인 0xAARRGGBB, #AARRGGBB, 0xRRGGBB 또는 #RRGGBB 형식으로 색상을 검색합니다(00은 완전히 꺼져 있으며 FF는 완전히 켜집니다). 예를 들어 빨간색의 경우 #FF0000, 파란색의 경우 #00FF00, 검은색의 경우 #000000, 흰색은 #FFFFFF. |
|
최대 색 편차
|
MaxColourDeviation | True | integer |
요소의 최대 색상은 일치 항목으로 간주되지 않기 전에 검색 색에서 벗어날 수 있습니다. 편차가 없는 경우 0입니다. 편차는 RGB 값으로 측정됩니다. 예를 들어 #FF0000 #FE0102 4와 다릅니다. 15의 편차는 좋은 출발점이 될 것입니다. |
|
왼쪽 픽셀 X 오프셋
|
LeftPixelXOffset | integer |
검색 영역의 왼쪽 가장자리에 대한 선택적 X 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(음수 값 포함) 줄이거나(양수 값 포함) 할 수 있습니다. |
|
|
오른쪽 픽셀 X 오프셋
|
RightPixelXOffset | integer |
검색 영역의 오른쪽 가장자리에 대한 선택적 X 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(양수 값 포함) 줄이거나(음수 값 포함) 할 수 있습니다. |
|
|
위쪽 픽셀 Y 오프셋
|
TopPixelYOffset | integer |
검색 영역의 위쪽 가장자리에 대한 선택적 Y 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(음수 값 포함) 줄이거나(양수 값 포함) 할 수 있습니다. |
|
|
아래쪽 픽셀 Y 오프셋
|
BottomPixelYOffset | integer |
검색 영역의 아래쪽 가장자리에 대한 선택적 Y 오프셋입니다. 이렇게 하면 검색 영역을 늘리거나(양수 값 포함) 줄이거나(음수 값 포함) 할 수 있습니다. |
|
|
마우스 단추
|
MouseButton | string |
누를 마우스 단추(왼쪽, 오른쪽, 가운데, 왼쪽 두 번)입니다. |
|
|
오프셋 X 클릭
|
ClickOffsetX | integer |
클릭 동작을 오프셋할 X 픽셀의 수입니다. 이 매개 변수는 양수(오른쪽) 및 음수(왼쪽) 오프셋 값을 모두 지원합니다. |
|
|
오프셋 Y 클릭
|
ClickOffsetY | integer |
클릭 동작을 오프셋할 Y 픽셀의 수입니다. 이 매개 변수는 양수(아래쪽) 및 음수(위쪽) 오프셋 값을 모두 지원합니다. |
|
|
에 상대적인 오프셋
|
OffsetRelativeTo | string |
오프셋할 색 영역의 상대 위치입니다(가운데/가운데/가운데, 왼쪽, 오른쪽, 위쪽, 아래쪽, 왼쪽 위, 오른쪽 위, 왼쪽 아래, 오른쪽 아래). |
|
|
지연 시간(밀리초)
|
DelayInMilliseconds | integer |
두 번 클릭을 수행하는 경우 각 클릭 사이의 지연 시간(밀리초)입니다. |
|
|
에이전트 숨기기
|
HideAgent | boolean |
분석 중인 요소가 가려지지 않도록 에이전트를 자동으로 숨기려면 true로 설정합니다(표시되는 경우). |
|
|
검색할 최대 요소
|
MaxElementsToSearch | integer |
UIA 트리에서 대상 요소를 검색할 때 검색할 최대 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
최대 상대 검색 깊이
|
MaxRelativeSearchDepth | integer |
부모 요소 아래에 있는 자식 요소를 검색할 최대 상대 트리 깊이입니다. 직접 자식 요소의 깊이 값은 1입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 검색 깊이가 무제한인 경우 0으로 설정합니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
노드당 검색할 최대 자식 요소
|
MaxChildElementsToSearchPerNode | integer |
UIA 트리에서 대상 요소를 검색할 때 각 요소 아래에서 검색할 최대 자식 요소 수입니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 기본적으로 이 값은 0(무제한)으로 설정됩니다. 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
트래버스하지 않을 지역화된 컨트롤 형식 요소
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 트리에서 대상 요소를 검색할 때 트래버스하지 않도록 지역화된 UIA 요소 컨트롤 형식의 쉼표로 구분된 목록입니다(단계별 실행). 검색은 개별 요소가 검색 조건과 일치하는지 계속 확인합니다. 그러나 지역화된 컨트롤 형식이 이 제외 목록에 있는 경우 해당 요소의 자식 요소는 검색하지 않습니다. 이 입력은 UIA 요소 검색 모드가 "트리 워크"인 경우에만 작동합니다(검사기에서 설정 페이지에서 사용하도록 설정할 수 있습니다). 이 입력은 일반적으로 요소 검색을 최적화하는 데 사용됩니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
명령 결과
|
UIAGlobalMouseClickElementSearchColourRegionResult | boolean |
명령의 결과(성공 또는 실패)입니다. |
|
오류 메시지
|
ErrorMessage | string |
명령에 성공하지 못한 경우 반환된 오류 메시지가 포함됩니다. |
첫 번째 UIA 부모 요소 검색
UIA 트리 계층 구조에서 검색 조건과 일치하는 첫 번째 부모 요소를 검색합니다. 부모 요소는 UIA 'tree'의 다음 수준에 있고 거의 항상 포함하는 요소인 요소로 정의됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
요소 핸들
|
ElementHandle | True | integer |
대상 요소에 대한 UIA 핸들입니다. |
|
부모 요소 지역화된 컨트롤 형식 검색
|
SearchParentLocalizedControlType | string |
검색할 부모 UIA 요소 지역화된 컨트롤 형식입니다. 검사를 통해 검색할 수 있습니다. |
|
|
상위 요소 컨트롤 형식 검색
|
SearchParentControlType | integer |
검색할 부모 UIA 요소 컨트롤 형식(지역화되지 않은 정수)입니다. 이는 여러 언어에서 동일한 값입니다. |
|
|
처리할 최대 부모
|
MaxParentsToProcess | integer |
처리할 부모 요소의 최대 수입니다. 기본적으로 50으로 설정됩니다. |
|
|
부모 요소를 찾을 수 없는 경우 예외 발생
|
RaiseExceptionIfParentElementNotFound | boolean |
검색 UIA 요소가 없는 경우 IA-Connect 예외를 발생시켜야 하나요? |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
부모 요소를 찾습니다.
|
ParentElementFound | boolean |
검색 부모 UIA 요소가 발견되면 true를 반환합니다. |
|
부모 요소 핸들
|
ParentElementHandle | integer |
찾은 부모 요소에 대한 UIA 핸들입니다. 이 요소는 이 요소에 대해 작동하는 추가 UIA 작업에 대한 입력으로 사용할 수 있습니다. |
|
부모 요소 이름
|
ParentElementName | string |
찾은 부모 요소의 UIA 이름입니다. |
|
부모 요소 클래스 이름
|
ParentElementClassName | string |
찾은 부모 요소의 UIA 클래스 이름입니다. |
|
부모 요소 자동화 ID
|
ParentElementAutomationId | string |
찾은 부모 요소의 UIA 자동화 ID입니다. |
|
부모 요소 지역화된 컨트롤 형식
|
ParentElementLocalizedControlType | string |
찾은 부모 요소의 UIA 지역화된 컨트롤 형식입니다. |
최상위 Win32 창에 대한 UIA 핸들 가져오기
지정된 클래스 이름 또는 창 제목이 있는 최상위 Win32 창에 대한 UIA 핸들을 반환하거나 와일드카드를 비롯한 고급 검색 필터를 지정할 수 있는 빠른 Win32 작업입니다. 최상위 창은 데스크톱에 연결된 창입니다. 이 작업은 Win32 API를 사용하지만 Windows, Java, ModernUI 및 웹 창을 검색할 수 있습니다. 창이 있어야 IA-Connect 기다리지 않습니다. 더 강력한 UIA 작업 'UIA 데스크톱 요소가 존재하나요'를 사용하는 것이 더 일반적이지만 이 Win32 작업은 일반적으로 더 빠르게 실행됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
검색 클래스 이름
|
SearchClassName | string |
검색할 최상위 창의 요소 클래스 이름(예: '메모장')입니다. |
|
|
검색 창 제목
|
SearchWindowTitle | string |
검색할 최상위 창의 제목입니다. |
|
|
검색 프로세스 ID
|
SearchProcessId | integer |
창을 소유하는 프로세스의 선택적 프로세스 ID입니다(예: IA-Connect 환경/세션 작업에서 '프로세스 실행' 작업의 출력에서 제공됨). 프로세스 ID로 검색하지 않도록 0으로 설정합니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자를 사용하여 검색을 사용 가능한 창 속성에 대해 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: '*Excel' 및 [IsMinimised] = False AND [IsResizeable] = True와 같은 [제목]입니다. 자세한 예제는 설명서를 참조하세요. |
|
|
열 이름을 기준으로 정렬
|
SortByColumn | string |
여러 창이 검색과 일치하는 경우 정렬 기준 창 속성을 지정할 수 있습니다. 이는 '인덱스 일치'와 함께 필요한 창을 선택하는 데 사용됩니다. 예를 들어 '열 이름 기준 정렬'이 [TopEdge]이고 '인덱스 일치'가 1이면 화면 맨 위에 가장 가까운 일치하는 창이 반환됩니다. |
|
|
일치 인덱스가 오름차순입니다.
|
MatchIndexAscending | boolean |
여러 창이 검색과 일치하는 경우 정렬된 목록의 맨 위(true) 또는 정렬된 목록의 맨 아래(false)에서 '인덱스 일치'가 일치해야 합니다. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
창 핸들
|
WindowHandle | integer |
창에 대한 UIA 핸들입니다. 이 창 내에서 추가 UIA 작업에 대한 입력으로 사용할 수 있습니다. |
|
요소 이름
|
ElementName | string |
창 요소의 UIA 이름입니다. |
|
요소 클래스 이름
|
ElementClassName | string |
창 요소의 UIA 클래스 이름입니다. |
|
요소 자동화 ID
|
ElementAutomationId | string |
창 요소의 UIA 자동화 ID입니다. |
|
지역화된 요소 컨트롤 형식
|
ElementLocalizedControlType | string |
창 요소의 UIA 지역화된 컨트롤 형식입니다. |
최상위 Win32 창이 있나요?
최상위 Win32 창이 있는지 여부를 보고하는 빠른 Win32 작업입니다. 최상위 창은 데스크톱에 연결된 창입니다. 클래스 이름 또는 창 제목으로 검색하거나 와일드카드를 포함하여 고급 검색 필터를 지정할 수 있습니다. 이 작업은 Win32 API를 사용하지만 Windows, Java, ModernUI 및 웹 창을 검색할 수 있습니다. 창이 있어야 IA-Connect 기다리지 않습니다. 더 강력한 UIA 작업 'UIA 데스크톱 요소가 존재하나요'를 사용하는 것이 더 일반적이지만 이 Win32 작업은 일반적으로 더 빠르게 실행됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
검색 클래스 이름
|
SearchClassName | string |
검색할 최상위 창의 요소 클래스 이름(예: '메모장')입니다. |
|
|
검색 창 제목
|
SearchWindowTitle | string |
검색할 최상위 창의 제목입니다. |
|
|
검색 프로세스 ID
|
SearchProcessId | integer |
창을 소유하는 프로세스의 선택적 프로세스 ID입니다(예: IA-Connect 환경/세션 작업에서 '프로세스 실행' 작업의 출력에서 제공됨). 프로세스 ID로 검색하지 않도록 0으로 설정합니다. |
|
|
인덱스 일치
|
MatchIndex | integer |
여러 요소가 검색과 일치하면 어떤 요소(1부터 시작)가 일치해야 합니다. '열 기준 정렬'과 함께 사용하여 일치하는 정렬 순서를 선택할 수 있습니다. |
|
|
필터 검색
|
SearchFilter | string |
조건부 연산자를 사용하여 검색을 사용 가능한 창 속성에 대해 추가로 제한하는 선택적 고급 필터입니다. 예제 1: [너비] < 200 예제 2: '*Excel' 및 [IsMinimised] = False AND [IsResizeable] = True와 같은 [제목]입니다. 자세한 예제는 설명서를 참조하세요. |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
창이 있음
|
WindowExists | boolean |
창이 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다. |
포커스가 있는 요소에 대한 UIA 핸들 가져오기
현재 포커스가 있는 UIA 요소에 대한 핸들을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
창 핸들
|
WindowHandle | integer |
창에 대한 UIA 핸들입니다. 이 창 내에서 추가 UIA 작업에 대한 입력으로 사용할 수 있습니다. |
|
요소 이름
|
ElementName | string |
요소의 UIA 이름입니다. |
|
요소 클래스 이름
|
ElementClassName | string |
요소의 UIA 클래스 이름입니다. |
|
요소 자동화 ID
|
ElementAutomationId | string |
요소의 UIA 자동화 ID입니다. |
|
지역화된 요소 컨트롤 형식
|
ElementLocalizedControlType | string |
요소의 UIA 지역화된 컨트롤 형식입니다. |
포커스가 있는 요소의 주 창에 대한 UIA 핸들 가져오기
현재 포커스가 있는 UIA 요소의 주 창에 대한 핸들을 반환합니다. '기본' 창은 일반적으로 주 애플리케이션 창입니다. 로그인 대화 상자 또는 하위 창은 일반적으로 '기본' 창이 아닙니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
창 핸들
|
WindowHandle | integer |
창에 대한 UIA 핸들입니다. 이 창 내에서 추가 UIA 작업에 대한 입력으로 사용할 수 있습니다. |
|
요소 이름
|
ElementName | string |
창 요소의 UIA 이름입니다. |
|
요소 클래스 이름
|
ElementClassName | string |
창 요소의 UIA 클래스 이름입니다. |
|
요소 자동화 ID
|
ElementAutomationId | string |
창 요소의 UIA 자동화 ID입니다. |
|
지역화된 요소 컨트롤 형식
|
ElementLocalizedControlType | string |
창 요소의 UIA 지역화된 컨트롤 형식입니다. |
프로세스 ID 주 창에 대한 UIA 핸들 가져오기
프로세스 ID로 지정된 프로세스의 모든 주 창에 대한 핸들을 반환하는 간단하고 빠른 Win32 작업입니다. '기본' 창은 일반적으로 주 애플리케이션 창입니다. 로그인 대화 상자 또는 하위 창은 일반적으로 '기본' 창이 아닙니다. 더 강력한 '데스크톱 요소 대기' 작업을 사용하는 것이 좋습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
검색 프로세스 ID
|
ProcessId | True | integer |
대기할 프로세스의 ID입니다(IA-Connect 환경/세션 작업의 '프로세스 실행' 작업에서 제공). |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
창 핸들
|
WindowHandle | integer |
창에 대한 UIA 핸들입니다. 이 창 내에서 추가 UIA 작업에 대한 입력으로 사용할 수 있습니다. |
|
요소 이름
|
ElementName | string |
창 요소의 UIA 이름입니다. |
|
요소 클래스 이름
|
ElementClassName | string |
창 요소의 UIA 클래스 이름입니다. |
|
요소 자동화 ID
|
ElementAutomationId | string |
창 요소의 UIA 자동화 ID입니다. |
|
지역화된 요소 컨트롤 형식
|
ElementLocalizedControlType | string |
창 요소의 UIA 지역화된 컨트롤 형식입니다. |
프로세스 주 창에 대한 UIA 핸들 가져오기
프로세스의 주 창(이름으로 지정됨)에 대한 핸들을 반환하는 간단하고 빠른 Win32 작업입니다. '기본' 창은 일반적으로 주 애플리케이션 창입니다. 로그인 대화 상자 또는 하위 창은 일반적으로 '기본' 창이 아닙니다. 창이 있어야 합니다. IA-Connect 기다리지 않습니다. 더 강력한 '데스크톱 요소 대기' 작업을 사용하는 것이 좋습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
검색 프로세스 이름
|
SearchProcessName | True | string |
검색할 프로세스의 이름(예: 메모장)입니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
창 핸들
|
WindowHandle | integer |
창에 대한 UIA 핸들입니다. 이 창 내에서 추가 UIA 작업에 대한 입력으로 사용할 수 있습니다. |
|
요소 이름
|
ElementName | string |
창 요소의 UIA 이름입니다. |
|
요소 클래스 이름
|
ElementClassName | string |
창 요소의 UIA 클래스 이름입니다. |
|
요소 자동화 ID
|
ElementAutomationId | string |
창 요소의 UIA 자동화 ID입니다. |
|
지역화된 요소 컨트롤 형식
|
ElementLocalizedControlType | string |
창 요소의 UIA 지역화된 컨트롤 형식입니다. |
프로세스에 Win32 창이 있나요?
프로세스(이름으로 지정됨)에 표시되는 창이 있는지 여부를 보고하는 간단하고 빠른 Win32 작업입니다. 창이 있어야 합니다. IA-Connect 기다리지 않습니다. 더 강력한 '데스크톱 요소 대기' 작업을 사용하는 것이 좋습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
검색 프로세스 이름
|
SearchProcessName | True | string |
검색할 프로세스의 이름(예: 메모장)입니다. |
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
프로세스에 창이 있습니다.
|
ProcessHasWindow | boolean |
프로세스에 표시되는 창이 있으면 true를 반환하고, 그렇지 않으면 false를 반환합니다. |
화면 좌표에서 UIA 요소 가져오기
지정된 화면 좌표에 있는 UIA 요소를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
X 좌표
|
XCoord | integer |
UIA 요소를 검색해야 하는 화면 X 좌표 값(픽셀)입니다. |
|
|
Y 좌표
|
YCoord | integer |
UIA 요소를 검색해야 하는 화면 Y 좌표 값(픽셀)입니다. |
|
|
요소를 찾을 수 없는 경우 예외 발생
|
RaiseExceptionIfElementNotFound | boolean |
UIA 요소가 지정된 위치에 없는 경우 IA-Connect 예외가 발생해야 하나요? |
|
|
워크플로
|
Workflow | True | string |
여기에 다음 식을 추가합니다. workflow() |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
요소를 찾았습니다.
|
ElementFound | boolean |
지정된 위치에서 UIA 요소가 발견되면 true를 반환합니다. |
|
요소 핸들
|
ElementHandle | integer |
요소에 대한 UIA 핸들입니다. 이 요소는 이 요소에 대해 작동하는 추가 UIA 작업에 대한 입력으로 사용할 수 있습니다. |
|
요소 이름
|
ElementName | string |
요소의 UIA 이름입니다. |
|
요소 클래스 이름
|
ElementClassName | string |
요소의 UIA 클래스 이름입니다. |
|
요소 자동화 ID
|
ElementAutomationId | string |
요소의 UIA 자동화 ID입니다. |
|
지역화된 요소 컨트롤 형식
|
ElementLocalizedControlType | string |
요소의 UIA 지역화된 컨트롤 형식입니다. |