Rocket BlueZone 에뮬레이터 메서드

Rocket BlueZone 에뮬레이터 메서드를 사용하여 Rocket BlueZone 에뮬레이터에서 다양한 자동화 작업을 수행합니다.

화면 수준 메서드

화면 수준 메서드를 사용하여 에뮬레이터 화면에서 자동화 작업을 수행합니다. 예를 들어 화면에서 명령을 시뮬레이션하거나 화면에서 텍스트를 가져올 수 있습니다.

GetFieldText

지정하는 행과 열 번호로 필드를 식별한 후 필드에 포함된 텍스트를 반환합니다. 지정하는 행과 열이 필드의 시작점입니다. 메서드는 전체 필드를 식별한 다음 필드의 텍스트를 반환합니다. 다음 예에서 H 는 필드의 첫 번째 문자이자 시작점이고 Host OS: 는 필드의 전체 텍스트입니다.

표 1. GetFieldText 메서드 매개변수

매개변수	설명	데이터 포트 입력 유형	데이터 유형	기본값	필수	메모
행	필드를 식별하는 필드 행 번호입니다.	데이터 입력	정수	해당 사항 없음	예
열	필드를 식별하는 필드 열 번호입니다.	데이터 입력	정수	해당 사항 없음	예
돌아가기	필드의 텍스트를 반환합니다.	데이터 출력	문자열	해당 사항 없음	해당 사항 없음

GetTextFromRect

화면에서 정의하는 직사각형 영역의 모든 필드에 텍스트를 반환합니다. 시작 및 종료 행과 열 번호를 제공하여 영역을 정의합니다. 이 메서드는 첫 번째 필드와 마지막 필드를 찾아 식별하고 해당 영역 내의 모든 필드에 있는 모든 텍스트를 반환합니다. 다음 예는 정의한 영역을 보여줍니다.

표 2. GetTextFromRect 메서드 매개변수

매개변수	설명	데이터 포트 입력 유형	데이터 유형	기본값	필수	메모
시작 행	직사각형 영역의 첫 번째 필드의 첫 번째 문자를 나타내는 행 번호입니다.	데이터 입력	정수	해당 사항 없음	예
시작 열	사각형 영역의 첫 번째 필드의 첫 번째 문자를 포함하는 열 번호입니다.	데이터 입력	정수	해당 사항 없음	예
끝행	직사각형 영역에 있는 마지막 필드의 마지막 문자를 포함하는 행 번호입니다.	데이터 입력	정수	해당 사항 없음	예
끝 열	사각형 영역에 있는 마지막 필드의 마지막 문자를 포함하는 열 번호입니다.	데이터 입력	정수	해당 사항 없음	예
돌아가기	사각형 영역 내의 모든 필드에서 텍스트를 반환합니다.	데이터 출력	문자열	해당 사항 없음	해당 사항 없음

IsCreated됨

화면 일치 규칙에 따라 에뮬레이터 화면이 존재하는지, 사용자의 입력을 수락할 수 있는지 확인합니다. 확인 후 메서드는 적절한 부울 값을 반환합니다.

표 3. IsCreated 메서드 매개변수

매개변수	설명	데이터 포트 입력 유형	데이터 유형	기본값	필수	메모
MatchAllChildren 일치	캡처한 하위 요소와 일치시켜 에뮬레이터 화면을 찾는 옵션입니다.	데이터 입력	부울	아니오	예	경고: 이 옵션을 사용하면 메서드 속도가 느려질 수 있습니다.
돌아가기	화면 일치 규칙에 따라 에뮬레이터 화면이 존재하고 사용자의 입력을 수락할 수 있는지 여부에 따라 부울 값을 반환합니다.	데이터 출력	부울	해당 사항 없음	해당 사항 없음

SearchText

지정하는 텍스트의 첫 번째 문자를 포함하는 행과 열의 번호를 반환합니다. 예를 들어 문자열 에뮬레이터를 지정하면 메서드는 단어 에뮬레이터 의 시작점인 e의 행과 열 번호를 반환합니다.

주:

여러 필드에 걸쳐 있는 텍스트를 제공하는 경우 메서드가 단일 필드의 텍스트만 지원하기 때문에 Row 및 Col 포트는 0을 반환합니다.

표 4. SearchText 메서드 매개변수

매개변수	설명	데이터 포트 입력 유형	데이터 유형	기본값	필수	메모
텍스트	메서드가 검색하는 텍스트입니다.	데이터 입력	문자열	해당 사항 없음	예	지정하는 텍스트는 사용하는 에뮬레이터에 따라 대/소문자를 구분할 수 있습니다.
행	지정하는 텍스트의 첫 번째 문자가 있는 행 번호입니다.	데이터 출력	정수	해당 사항 없음	해당 사항 없음	지정한 텍스트가 여러 행과 열에서 발생하는 경우 메서드는 텍스트가 포함된 첫 번째 행과 열을 반환합니다.
열	지정하는 텍스트의 첫 번째 문자가 있는 열 번호입니다.	데이터 출력	정수	해당 사항 없음	해당 사항 없음	지정한 텍스트가 여러 행과 열에서 발생하는 경우 메서드는 텍스트가 포함된 첫 번째 행과 열을 반환합니다.

Send키

에뮬레이터 화면의 마우스 장치 위치에서 키보드에서 입력하는 키 입력을 시뮬레이션합니다. 예를 들어 화면에서 <Enter> 키 입력을 시뮬레이션할 수 있습니다.

표 5. SendKeys 메서드 매개변수

매개변수	설명	데이터 포트 입력 유형	데이터 유형	기본값	필수	메모
키	키보드에서 입력하는 키 입력입니다.	데이터 입력	문자열	안 함	예	팁: 키 입력에 대한 자세한 내용은 각 터미널 에뮬레이터 설명서를 참조하십시오.

SendKeysSecure

에뮬레이터 화면의 마우스 장치 위치에 있는 보안 문자열인 키 입력을 시뮬레이션합니다.

표 6. SendKeysSecure 메서드 매개변수

매개변수	설명	데이터 포트 입력 유형	데이터 유형	기본값	필수	메모
키	보안 문자열로 입력하는 키 입력입니다.	데이터 입력	보안 문자열	안 함	예	팁: 키 입력에 대한 자세한 내용은 해당 터미널 에뮬레이터 설명서를 참조하십시오.

커서 위치 설정

지정한 행과 열 번호에서 마우스 장치를 설정하려고 시도합니다.

표 7. SetCursorPosition 메서드 매개변수

매개변수	설명	데이터 포트 입력 유형	데이터 유형	기본값	필수	메모
행	메서드가 화면에서 마우스 장치를 설정하려고 시도하는 기준이 되는 행 수를 제공하는 옵션입니다.	데이터 입력	정수	해당 사항 없음	해당 사항 없음	행 번호는 양수여야 하며 에뮬레이터 화면의 크기 이내여야 합니다. 예를 들어 화면 크기가 24X80인 경우 행에 제공할 수 있는 최대 값은 24입니다.
열	메서드가 화면에서 마우스 장치를 설정하려고 시도하는 기준이 되는 행 수를 제공하는 옵션입니다.	데이터 입력	정수	해당 사항 없음	해당 사항 없음	열 번호는 양수여야 하며 에뮬레이터 화면 크기 이내여야 합니다. 예를 들어 화면 크기가 24X80인 경우 열에 제공할 수 있는 최대값은 80입니다.

WaitForCreate

커넥터가 화면 일치 규칙을 사용하여 화면이 있는지 확인하는 동안 지정한 기간 동안 대기합니다.

표 8. WaitForCreate 메서드 매개변수

매개변수	설명	데이터 포트 입력 유형	데이터 유형	기본값	필수	메모
timeoutinSeconds	커넥터가 화면 일치 규칙을 사용하여 화면이 있는지 찾는 동안 메서드가 대기하는 시간(초)을 제공하는 옵션입니다.	데이터 입력	정수	30	예
MatchAllChildren 일치	화면이 있는지 확인하기 위해 캡처한 모든 화면 요소를 일치시키는 옵션입니다.	데이터 입력	부울	아니오	예	경고: 이 옵션을 사용하면 메서드 실행이 지연될 수 있습니다.
돌아가기	에뮬레이터 화면을 찾았는지 여부에 따라 부울 값을 반환합니다.	데이터 출력	부울	해당 사항 없음	해당 사항 없음

요소 수준 메서드

요소 수준 메서드는 터미널 커넥터 화면에서 추가하는 에뮬레이터 화면 요소에서 자동화 작업을 수행합니다. 화면 요소를 필드 또는 테이블로 추가할 수 있습니다.

GetAs테이블

데이터 테이블 객체로 캡처한 텍스트를 반환합니다. 화면에서 데이터를 테이블로 캡처할 때 이 방법을 사용합니다. 그러나 필드로 캡처하는 데이터에 대해 이 메서드를 사용할 수도 있습니다. 데이터를 테이블로 캡처하는 방법에 대한 자세한 내용은 문서를 참조하십시오 개인 통신 에뮬레이터 구성 IBM.

표 9. GetAsTable 메서드 매개변수

매개변수	설명	데이터 포트 입력 유형	데이터 유형	기본값	필수	메모
돌아가기	터미널 화면에서 캡처한 텍스트를 데이터 테이블 객체로 반환합니다.	데이터 출력	데이터 테이블	해당 사항 없음	해당 사항 없음	테이블을 보려면 매개변수를 마우스 오른쪽 버튼으로 클릭하고 데이터 미리 보기를 선택합니다.

텍스트 가져오기

에뮬레이터 화면에서 캡처한 필드의 텍스트를 반환합니다. 캡처한 테이블에 이 메서드를 사용하면 사각형의 첫 번째 필드에 텍스트가 반환됩니다.

표 10. GetText 메서드 매개변수

매개변수	설명	데이터 포트 입력 유형	데이터 유형	기본값	필수입니까?	메모
돌아가기	캡처된 필드에서 텍스트를 반환합니다.	데이터 출력	문자열	해당 사항 없음	해당 사항 없음

IsCreated됨

규칙과 일치하고 캡처된 요소가 있는지 확인합니다.

표 11. IsCreated 메서드 매개변수

매개변수	설명	데이터 포트 입력 유형	데이터 유형	기본값	필수	메모
돌아가기	요소가 활성 상태인지 여부에 따라 부울 값을 반환합니다.	데이터 출력	부울	해당 사항 없음	해당 사항 없음

텍스트 설정

텍스트를 필드로 설정하려고 시도합니다.

표 12. SetText 메서드 매개변수

매개변수	설명	데이터 포트 입력 유형	데이터 유형	기본값	필수	메모
텍스트	메서드가 필드에서 설정하려고 하는 텍스트를 지정하는 옵션입니다.	데이터 입력	문자열	해당 사항 없음	예	보호된 에뮬레이터 화면에서는 이 방법을 사용할 수 없습니다.

WaitForCreate

커넥터가 일치 규칙을 사용하여 요소가 존재하는지 확인하는 동안 지정한 기간 동안 대기합니다.

표 13. WaitForCreate 메서드 매개변수

매개변수	설명	데이터 포트 입력 유형	데이터 유형	기본값	필수	메모
timeoutinSeconds	커넥터가 일치 규칙을 사용하여 요소가 있는지 확인하는 동안 메서드가 대기하는 시간(초)을 제공하는 옵션입니다.	데이터 입력	정수	30	예
돌아가기	요소를 찾을 수 있는지 여부에 따라 부울 값을 반환합니다.	데이터 출력	부울	해당 사항 없음	해당 사항 없음