Java 커넥터 메서드

Java 커넥터는 커넥터, 화면 및 요소 수준에서 메서드를 노출합니다. 모든 유형의 요소에는 공통 방법이 있지만 방법도 다릅니다.

커넥터 수준 메서드

시작

해당 위치에서 Java 애플리케이션을 시작하고 포커스를 가져옵니다.

주:

먼저 이 메서드를 실행해야 합니다.

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

표 1. 메서드 매개변수 시작

매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수입니까?
경로	로컬 드라이브의 Java 애플리케이션에 대한 경로입니다.	의 데이터	문자열	안 함	예
평균	경로에 대한 인수입니다.	의 데이터	문자열	안 함	아니요

GetMainWindowHandle

Start 메서드에서 시작하는 Java 애플리케이션의 창 핸들을 반환합니다.

표 2. GetMainWindowHandle 메서드 매개 변수

매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수입니까?
돌아가기	애플리케이션의 창 핸들을 반환합니다.	데이터 출력	정수	안 함	해당 사항 없음

GetMainWindowTitle

Java 애플리케이션 창의 제목을 반환합니다.

표 3. GetMainWindowTitle 메서드 매개 변수

매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수입니까?
돌아가기	애플리케이션 창의 제목을 반환합니다.	데이터 출력	문자열	안 함	해당 사항 없음

MainWindow 닫기

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

종료

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

화면 수준 메서드

닫기

활성 Java 애플리케이션 창을 닫습니다.

Focus

Java 애플리케이션 창이 최소화되거나 백그라운드에서 실행 중인 경우 메서드는 포커스를 복원합니다.

필드 가져오기

Java 애플리케이션의 텍스트 필드에서 데이터를 가져옵니다. 먼저 텍스트 필드를 구성해야 합니다. 구성하려면 다음 단계를 수행합니다.

1. Java 커넥터 구성 및 하나 이상의 텍스트 필드를 캡처합니다.
2. 화면 수준 메서드를 노출합니다. 커넥터 방법 사용 문서를 참조하십시오.
3. 개체 탐색기 창에서 GetFields 메서드를 디자인 화면으로 끕니다.
4. 메서드 설정 아이콘( )을 클릭합니다.
5. 텍스트 필드를 하나 이상 선택합니다.
6. 텍스트 필드의 데이터 유형을 업데이트합니다.
7. 양식 요소 선택 창을 닫으려면 확인을 클릭합니다.

   선택한 각 텍스트 필드에 대해 데이터 출력 포트가 생성됩니다.

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

GetInstanceCount

열려 있는 Java 애플리케이션의 총 인스턴스 수를 반환합니다.

표 4. GetInstanceCount 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수입니까?
돌아가기	열려 있는 Java 애플리케이션의 총 인스턴스 수를 반환합니다.	데이터 출력	정수	안 함	해당 사항 없음

GetScreenShot

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

표 5. GetInstanceCount 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수입니까?
돌아가기	Java 애플리케이션 화면의 스크린샷을 반환합니다.	데이터 출력	비트맵	안 함	해당 사항 없음

GetWindowHandle

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

표 6. GetInstanceCount 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수입니까?
돌아가기	Java 애플리케이션 화면 창의 핸들 번호를 반환 Windows 합니다.	데이터 출력	정수	안 함	해당 사항 없음

IsCreated됨

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

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

표 7. IsCreated 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수입니까?	메모
MatchAllChildren 일치	화면 요소의 규칙과 일치한 후 부울 응답을 반환합니다.	의 데이터	부울	안 함	아니요	이 매개변수는 하나 이상의 요소를 캡처하는 경우에 관련이 있습니다.
돌아가기	구성한 Java 애플리케이션 화면의 규칙이 일치하는지 여부에 대한 부울 응답을 반환합니다.	데이터 출력	부울	null	해당 사항 없음

최대화

Java 애플리케이션 창을 최대화합니다.

최소화

Java 애플리케이션 창을 최소화합니다.

마우스 액션

Java 애플리케이션에서 왼쪽 클릭, 오른쪽 클릭, 가운데 클릭 등 다양한 마우스 장치 작업을 수행합니다.

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

표 8. MouseAction 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수입니까?
작업	마우스 장치 작업을 지정합니다.	의 데이터	마우스 장치 입력	안 함	예
가운데 클릭	가운데 클릭이 수행되는지 여부입니다.	의 데이터	부울	안 함	아니요

크기 조정

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

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

표 9. 크기 조정 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수입니까?
xPos	X축을 기준으로 화면에서 창의 위치입니다.	의 데이터	정수	안 함	아니요
yPo	Y축을 따른 화면의 창 위치입니다.	의 데이터	정수	안 함	아니요
너비	창의 너비입니다.	의 데이터	정수	안 함	아니요
높이	창의 높이입니다.	의 데이터	정수	안 함	아니요

재개

Java 애플리케이션 창의 원래 치수를 복원합니다. 최대화 및 최소화와 같은 메서드를 실행한 후에 이 메서드를 사용할 수 있습니다.

Send키

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

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

표 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 메서드에서 지정한 형식으로 작업을 정확하게 지정해야 합니다.
돌아가기	작업이 수행되면 예를 반환하고, 그렇지 않으면 아니오를 반환합니다.	데이터 출력	부울	안 함	해당 사항 없음

암호 설정

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

필드에 입력을 제공하려면 다음 문서를 참조하십시오 포트 속성 구성.

표 17. SetPassword 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수입니까?	메모
암호	암호를 보안 문자열로 허용합니다.	데이터 입력	보안 문자열	안 함	예	암호를 보안 문자열로 허용하므로 매개변수를 마우스 오른쪽 버튼으로 클릭한 다음 데이터 미리 보기를 클릭할 때만 문자열의 길이가 표시됩니다.
UseSendKeys	SendKeys는 문자, 숫자 및 기호와 같은 키보드 입력을 애플리케이션 내부의 텍스트 상자로 보내는 데 사용되는 메서드입니다.	데이터 입력	부울	아니오	예	팁: SetPassword 메서드가 암호 필드에 암호를 입력하지 못하면 값을 True로 설정하고 메서드를 다시 실행합니다.