Rocket BlueZone 에뮬레이터 메서드

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 7분

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

    화면 수준 메서드

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

    필드 텍스트 가져오기

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

    필드의 첫 글자와 필드에 전체 텍스트를 표시하는 화면입니다.

    매개 변수가 있는 GetFieldText 메서드입니다.

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

    GetTextFromRect (영문)

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

    첫 번째 필드의 첫 번째 셀과 마지막 필드의 마지막 셀을 표시하도록 정의한 영역입니다.

    GetTextFromRect 메서드 이미지입니다.

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

    IsCreated (영문)

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

    IsCreated 메서드를 사용할 수 있습니다.

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

    SearchText

    지정한 텍스트의 첫 번째 문자를 포함하는 행과 열의 번호를 반환합니다. 예를 들어, 문자열 emulator를 지정하면 이 메서드는 단어 emulator 의 시작점( e)의 행과 열 번호를 반환합니다.
    주:
    여러 필드에 걸쳐 있는 텍스트를 제공하는 경우 메서드가 단일 필드의 텍스트만 지원하기 때문에 Row 및 Col 포트는 0을 반환합니다.
    SearchText 메소드를 사용할 수 있습니다.
    표 4. SearchText 메서드 매개 변수
    매개변수 설명 데이터 포트 입력 유형 데이터 유형 기본값 필수 참고 사항
    텍스트 메서드가 검색하는 텍스트입니다. 데이터 입력 문자열 해당 사항 없음 예 지정하는 텍스트는 사용하는 에뮬레이터에 따라 대/소문자를 구분할 수 있습니다.
    행 지정한 텍스트의 첫 번째 문자가 있는 행 번호입니다. 데이터 출력 정수 해당 사항 없음 해당 사항 없음 지정한 텍스트가 여러 행과 열에 있는 경우 메서드는 텍스트가 포함된 첫 번째 행과 열을 반환합니다.
    열 지정한 텍스트의 첫 번째 문자가 있는 열 번호입니다. 데이터 출력 정수 해당 사항 없음 해당 사항 없음 지정한 텍스트가 여러 행과 열에 있는 경우 메서드는 텍스트가 포함된 첫 번째 행과 열을 반환합니다.

    SendKeys (영문)

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

    SendKeys 메서드를 사용할 수 있습니다.

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

    SendKeysSecure (영문)

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

    SendKeysSecure 메서드를 사용할 수 있습니다.

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

    SetCursorPosition (커서 위치 설정)

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

    SetCursorPosition 메서드를 사용할 수 있습니다.

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

    생성 대기(WaitForCreate)

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

    WaitForCreate 메서드를 사용할 수 있습니다.

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

    요소 수준 메서드

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

    GetAsTable

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

    GetAsTable 메서드를 사용할 수 있습니다.

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

    텍스트 가져오기

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

    GetText 메서드를 사용할 수 있습니다.

    표 10. GetText 메서드 매개 변수
    매개변수 설명 데이터 포트 입력 유형 데이터 유형 기본값 필수? 참고 사항
    반환 캡처한 필드에서 텍스트를 반환합니다. 데이터 출력 문자열 해당 사항 없음 해당 사항 없음

    IsCreated (영문)

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

    IsCreated 메서드를 사용할 수 있습니다.

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

    SetText

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

    SetText 메서드를 사용할 수 있습니다.

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

    생성 대기(WaitForCreate)

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

    WaitForCreate 메서드를 사용할 수 있습니다.

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