Java 커넥터 메서드

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

    • Java 커넥터는 커넥터, 화면 및 요소 수준에서 메서드를 노출합니다. 모든 유형의 요소에는 공통된 메서드가 있지만 다른 메서드도 있습니다.

    커넥터 수준 메서드

    시작

    해당 위치에서 Java 응용 프로그램을 시작하고 포커스를 가져옵니다.
    주:
    먼저 이 메서드를 실행해야 합니다.

    매개변수에 대한 입력을 제공하려면 을 참조하십시오 포트 속성 구성.

    표 1. 시작 메서드 매개변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    경로 로컬 드라이브에 있는 Java 응용 프로그램의 경로입니다. 의 데이터 문자열 없음 예
    Arg 경로에 대한 인수입니다. 의 데이터 문자열 없음 아니요

    GetMainWindowHandle (메인 창 핸들 구하기)

    Start 메서드에서 시작한 Java 응용 프로그램의 창 핸들을 반환합니다.

    표 2. GetMainWindowHandle 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 응용 프로그램의 Window 핸들을 반환합니다. 데이터 출력 정수 없음 해당 사항 없음

    GetMainWindowTitle (영문)

    Java 응용 프로그램 창의 제목을 반환합니다.

    표 3. GetMainWindowTitle 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 응용 프로그램의 창 제목을 반환합니다. 데이터 출력 문자열 없음 해당 사항 없음

    메인윈도우 닫기

    기본 Java 애플리케이션 창을 닫습니다.

    종료

    주 Java 애플리케이션 창을 종료합니다.

    화면 수준 메서드

    닫기

    활성 Java 응용 프로그램 창을 닫습니다.

    포커스

    Java 응용 프로그램 창이 최소화되어 있거나 백그라운드에서 실행 중인 경우 메서드는 포커스를 복원합니다.

    GetFields

    Java 애플리케이션의 텍스트 필드에서 데이터를 가져옵니다. 먼저 텍스트 필드를 구성해야 합니다. 구성하려면 다음 단계를 수행합니다.
    1. Java 커넥터 구성 을 클릭하고 하나 이상의 텍스트 필드를 캡처합니다.
    2. 화면 수준 메서드를 노출합니다. 커넥터 방법 사용 문서를 참조하십시오.
    3. 개체 탐색기 창에서 GetFields 메서드를 디자인 화면으로 끌어 옵니다.
    4. 방법 설정 아이콘( 방법 설정 아이콘. )을 클릭합니다.
    5. 하나 이상의 텍스트 필드를 선택합니다.
    6. 텍스트 필드의 데이터 유형을 업데이트합니다.
    7. CHOOSE FORM ELEMENTS 창을 닫으려면 확인을 클릭합니다.

      선택한 각 텍스트 필드에 대해 데이터 출력 포트가 만들어집니다.

    GetFields 메서드는 이제 텍스트 필드에 포함된 데이터를 반환할 수 있습니다.

    GetInstanceCount (영문)

    Java 응용 프로그램이 열려 있는 총 인스턴스 수를 반환합니다.

    표 4. GetInstanceCount 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 Java 응용 프로그램이 열려 있는 총 인스턴스 수를 반환합니다. 데이터 출력 정수 없음 해당 사항 없음

    스크린 샷 구하기

    Java 애플리케이션 화면의 스크린샷을 캡처하고 반환합니다.

    표 5. GetInstanceCount 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 Java 응용 프로그램 화면의 스크린샷을 반환합니다. 데이터 출력 비트맵 없음 해당 사항 없음

    GetWindowHandle (영문)

    Java 애플리케이션 화면 창의 Windows 핸들 번호를 반환합니다.

    표 6. GetInstanceCount 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 Java 애플리케이션 화면 창의 Windows 핸들 번호를 반환합니다. 데이터 출력 정수 없음 해당 사항 없음

    IsCreated (영문)

    구성된 창에 대한 규칙이 일치하는지 여부에 따라 부울 응답을 반환합니다. Java 애플리케이션 화면을 구성할 때 Java 커넥터 창의 일치 규칙 섹션에 구성된 화면과 일치하는 특정 규칙이 표시됩니다. 메서드가 동일한 규칙과 일치합니다.

    매개변수에 대한 입력을 제공하려면 을 참조하십시오 포트 속성 구성.

    표 7. IsCreated 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수? 참고 사항
    MatchAllChildren (모든 어린이) 화면 요소의 규칙을 일치시킨 후 부울 응답을 반환합니다. 의 데이터 부울 없음 아니요 이 매개변수는 하나 이상의 요소를 캡처하는 경우에 적합합니다.
    반환 구성한 Java 애플리케이션 화면의 규칙이 일치하는지 여부에 대한 부울 응답을 반환합니다. 데이터 출력 부울 영 해당 사항 없음

    최대화

    Java 응용 프로그램 창을 최대화합니다.

    최소화

    Java 응용 프로그램 창을 최소화합니다.

    마우스 액션

    Java 응용 프로그램에서 왼쪽 클릭, 마우스 오른쪽 단추 클릭, 가운데 클릭 등 다양한 마우스 장치 작업을 수행합니다.

    매개변수에 대한 입력을 제공하려면 을 참조하십시오 포트 속성 구성.

    표 8. MouseAction 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    작업 마우스 장치 동작을 지정합니다. 의 데이터 마우스 장치 입력 없음 예
    중간을 클릭(ClickMiddle) 가운데 클릭이 수행되는지 여부입니다. 의 데이터 부울 없음 아니요

    크기 조정

    X축과 Y축을 따라 Java 애플리케이션 창의 너비, 높이 및 위치를 변경합니다.

    매개변수에 대한 입력을 제공하려면 을 참조하십시오 포트 속성 구성.

    표 9. 크기 조정 방법 매개변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    xPos X축을 따라 화면에서 창의 위치입니다. 의 데이터 정수 없음 아니요
    와이포스 Y축을 따라 화면에서 창의 위치입니다. 의 데이터 정수 없음 아니요
    너비 창의 너비입니다. 의 데이터 정수 없음 아니요
    높이 창의 높이입니다. 의 데이터 정수 없음 아니요

    재개

    Java 응용 프로그램 창의 원래 크기를 복원합니다. 최대화 및 최소화와 같은 메서드를 실행한 후에 이 메서드를 사용할 수 있습니다.

    SendKeys (영문)

    Java 애플리케이션의 활성 필드로 데이터 또는 키보드 입력을 보냅니다. 예를 들어 문자열 데이터 "RPA" 또는 키보드 입력 [Space]를 전송하여 확인란의 선택을 취소할 수 있습니다.

    매개변수에 대한 입력을 제공하려면 을 참조하십시오 포트 속성 구성.

    표 10. WaitForCreate 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    키 데이터 또는 키보드 입력을 활성 필드로 보냅니다. 의 데이터 문자열 없음 예
    ClearExistingValue (기존 값 지우기) 데이터 또는 키보드 입력을 보내기 전에 활성 필드의 기존 값을 지웁니다. 의 데이터 부울 없음 아니요
    TypeDelay (유형지연) 데이터 또는 키보드 입력을 활성 필드로 보내기 전의 지연을 설정합니다. 의 데이터 정수 없음 아니요

    필드 설정

    Java 애플리케이션 화면에서 캡처한 텍스트 필드 요소에 사용자 지정 텍스트를 설정합니다.

    이 방법을 사용하려면 다음 단계를 수행합니다.
    1. 개체 탐색기에서 SetFields 메서드를 디자인 화면으로 끌어 옵니다.
    2. 방법 설정 아이콘( 방법 설정 아이콘. )을 클릭합니다.
    3. 하나 이상의 텍스트 필드를 선택합니다.
    4. 텍스트 필드의 데이터 유형을 업데이트합니다.
    5. 확인을 클릭합니다.

      선택한 각 텍스트 필드에 대해 입력 데이터 포트가 생성됩니다. Java 애플리케이션의 필드에 설정할 문자열을 전달할 수 있습니다.

      매개변수에 대한 입력을 제공하려면 을 참조하십시오 포트 속성 구성.

    생성 대기(WaitForCreate)

    Java 커넥터에서 구성하는 각 화면은 Java 커넥터 창의 일치 규칙 섹션 아래에 표시되는 몇 가지 규칙으로 식별됩니다. 이 메서드는 구성한 화면의 규칙이 일치하는지 여부에 따라 부울 응답을 반환합니다.

    매개변수에 대한 입력을 제공하려면 을 참조하십시오 포트 속성 구성.

    표 11. WaitForCreate 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    timeoutinSeconds (타임아웃인초) 메서드의 작업 시간이 초과될 때까지의 시간입니다. 의 데이터 정수 없음 아니요
    MatchAllChildren (모든 어린이) 화면 요소의 규칙을 일치시킨 후 부울 응답을 반환합니다. 의 데이터 부울 없음 아니요
    반환 구성한 Java 애플리케이션 화면의 규칙이 일치하는지 여부에 대한 부울 응답을 반환합니다. 데이터 출력 부울 없음 아니요

    요소 수준 메서드

    GetAccessibleActions (영문)

    요소에 대해 수행할 수 있는 작업 목록을 반환합니다. 예를 들어 단추의 경우 Click을 반환합니다.
    표 12. GetText 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 요소에 대해 수행할 수 있는 작업 목록을 반환합니다. 데이터 출력 목록 없음 해당 사항 없음

    GetInstanceCount (영문)

    Java 애플리케이션에서 요소 유형의 총 개수를 반환합니다. 예를 들어, 응용 프로그램에 텍스트 상자가 세 개 있으면 인스턴스 수는 3입니다.

    표 13. GetText 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 응용 프로그램에 있는 요소 유형의 인스턴스 수를 반환합니다. 데이터 출력 정수 없음 해당 사항 없음

    텍스트 가져오기

    Java 응용 프로그램에서 캡처된 텍스트 상자 요소에서 텍스트를 반환합니다. 여러 텍스트 상자에서 여러 텍스트를 캡처하려면 여러 텍스트 상자 요소를 구성해야 합니다.

    표 14. GetText 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    텍스트 Java 응용 프로그램의 텍스트 상자에 포함된 텍스트를 반환합니다. 데이터 출력 문자열 없음 해당 사항 없음

    IsCreated (영문)

    구성한 요소의 규칙이 일치하는지 여부에 따라 부울 응답을 반환합니다.

    표 15. IsCreated 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 구성한 요소의 규칙이 일치하는지 여부에 따라 부울 응답을 반환합니다. 데이터 출력 부울 null 해당 사항 없음

    마우스클릭

    캡처된 요소를 마우스 왼쪽 버튼으로 클릭합니다.

    수행 작업

    요소에서 지정된 작업을 수행합니다. 예를 들어, 버튼을 클릭합니다. 각 요소는 GetAccessibleActions 메서드를 실행하여 가져올 수 있는 일련의 작업을 허용합니다.

    매개변수에 대한 입력을 제공하려면 을 참조하십시오 포트 속성 구성.

    표 16. IsCreated 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수? 참고 사항
    작업 요소에서 수행할 작업을 허용합니다. 의 데이터 문자열 없음 예

    GetAccessibleActions 메서드에서 지정한 형식으로 작업을 정확하게 지정해야 합니다.
    반환 작업이 수행된 경우 True를 반환하고, 그렇지 않으면 False를 반환합니다. 데이터 출력 부울 없음 해당 사항 없음

    SetPassword (암호 설정)

    Java 애플리케이션의 암호 필드에 안전하게 암호 입력을 자동화합니다.

    필드에 입력을 제공하려면 다음 문서를 참조하십시오 포트 속성 구성.
    표 17. SetPassword 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수? 참고 사항
    암호 암호를 보안 문자열로 수락합니다. 데이터 입력 보안 문자열 없음 예 암호를 보안 문자열로 허용하기 때문에 매개변수를 마우스 오른쪽 버튼으로 클릭한 다음 데이터 미리 보기를 클릭할 때만 문자열의 길이가 표시됩니다.
    UseSendKeys (영문) SendKeys는 문자, 숫자 및 기호와 같은 키보드 입력을 응용 프로그램 내의 텍스트 상자로 보내는 데 사용되는 메서드입니다. 데이터 입력 부울 거짓 예
    팁:
    SetPassword 메서드가 암호 필드에 암호를 입력하지 못하면 값을 True로 설정하고 메서드를 다시 실행합니다.