텍스트 요소 캡처 도구

텍스트 요소 캡처 도구는 기기의 현재 화면에서 시스템이 인식할 수 있는 텍스트, 버튼, 입력란과 기타 UI 요소를 캡처합니다. 클릭, 입력, 스크롤과 특정 텍스트가 페이지에 나타났는지 판단하는 스크립트 코드를 만들 때 적합합니다.

여는 방법

• 샘플 작업대를 열고 위쪽의 텍스트 요소 페이지로 전환합니다.
• 기기 목록에서 대상 기기를 마우스 오른쪽 버튼으로 클릭하고 텍스트 요소 캡처를 선택합니다. 그러면 해당 기기가 지정된 상태로 텍스트 요소 페이지가 바로 열립니다.

현재 페이지 캡처하기

캡처하기 전에 기기를 분석할 앱 페이지에 둡니다. 원격 제어 패널로 기기를 조작하거나 기기에서 직접 대상 페이지로 전환할 수 있습니다. 기기는 온라인 상태여야 하며 텍스트 요소 캡처를 지원해야 합니다.

1. 패널 오른쪽 위의 설정을 클릭합니다.
2. 요소 캡처 기기에서 기기 선택을 클릭합니다. 개발 테스트 기기를 이미 설정했다면 현재 개발 테스트 기기를 선택할 수도 있습니다.
3. 텍스트 요소 캡처를 클릭합니다.
4. 캡처가 끝나면 왼쪽에는 스크린샷과 요소 상자가, 오른쪽에는 계층 구조 개요와 요소 세부 정보가 표시됩니다.
5. 스크린샷 또는 계층 구조 트리 위에서 마우스를 움직여 요소 범위를 확인하고 클릭하여 선택을 고정합니다.
6. 요소 세부 정보에서 작업을 선택하고 코드 복사를 클릭합니다.

캡처 결과는 탭으로 유지됩니다. 서로 다른 화면을 여러 번 캡처했다면 결과 탭 사이를 전환하고, 탭을 끌어 순서를 조정하거나 오래된 결과를 닫을 수 있습니다.

생성할 작업 선택하기

자주 사용하는 작업은 다음과 같습니다.

• 버튼을 클릭하려면 클릭을 선택합니다.
• 페이지에 특정 텍스트가 나타났는지 판단하려면 존재 확인을 선택합니다.
• 입력란에 내용을 입력하려면 텍스트 입력 또는 텍스트 설정을 선택합니다.
• 입력란을 비우려면 텍스트 지우기를 선택합니다.
• 목록이나 페이지를 넘기려면 스크롤을 선택합니다.
• 먼저 요소를 찾기만 하려면 찾기를 선택합니다.

일반 스크립트에서는 코드 복사를 우선 사용하세요. 조건을 직접 조합하려면 일치 필드 복사를 사용할 수 있습니다. JSON 복사는 문제를 진단하거나 유지보수 담당자에게 정보를 보낼 때 더 적합하며 일상적인 스크립트 작성의 첫 선택으로는 권장하지 않습니다.

같은 요소에 여러 작업을 연속으로 수행하려면 생성 방식을 요소 참조 재사용으로 전환할 수 있습니다. 클릭이나 판단을 한 번만 수행한다면 기본값을 유지하면 됩니다.

클릭하거나 캡처할 수 없을 때

• 캡처 실패: 다시 시도를 클릭하고 기기가 온라인 상태인지, 현재 페이지가 계속 바뀌고 있지는 않은지 확인하세요.
• 결과가 비어 있음: 페이지에 시스템이 인식할 수 있는 텍스트나 컨트롤이 실제로 있는지 확인하세요. 없다면 색상 선택기의 좌표와 색상 방식을 대신 사용할 수 있습니다.
• 요소 상자 위치가 정확하지 않거나 생성한 클릭이 작동하지 않음: 현재 페이지를 다시 캡처하고 설정에서 히트 그리드를 조정하세요. 필요하면 강제 히트를 활성화한 뒤 다시 캡처합니다.
• 현재 기기가 텍스트 요소 캡처를 지원하지 않는다는 메시지가 표시됨: 이 기능을 지원하는 기기로 바꾸거나 색상 선택기로 위치를 지정하세요.