Java 커넥터 메서드

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

커넥터 수준 메서드

시작

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

주:

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

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

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

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

GetMainWindowHandle

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

표 2. GetMainWindowHandle 메서드 매개변수

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

GetMainWindowTitle

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

표 3. GetMainWindowTitle 메서드 매개변수

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

메인 창 닫기

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

종료

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

화면 수준 메서드

닫기

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

초점

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

GetFields

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

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

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

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

GetInstanceCount

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

표 4. GetInstanceCount 메서드 매개 변수

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

스크린샷 받기

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

표 5. GetInstanceCount 메서드 매개 변수

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

GetWindowHandle

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

표 6. GetInstanceCount 메서드 매개 변수

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

IsCreated

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

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

표 7. IsCreated 메서드 매개변수

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

최대화

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

최소화

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

마우스 액션

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

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

표 8. MouseAction 메서드 매개변수

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

크기 조정

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

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

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

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

재개

Java 애플리케이션 창의 원래 크기를 복원합니다. Maximize 및 Minimize와 같은 메서드를 실행한 후에 메서드를 사용할 수 있습니다.

Send키

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

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

표 10. WaitForCreate 메서드 매개변수

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

SetFields

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

이 방법을 사용하려면 다음 단계를 수행합니다.

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

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

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

WaitForCreate

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

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

표 11. WaitForCreate 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시간 초과	메서드의 작업 시간이 초과된 후의 시간입니다.	의 데이터	정수	안 함	아니요
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를 반환합니다.	데이터 출력	부울	안 함	해당 사항 없음

암호 설정

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

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

표 17. SetPassword 메서드 매개변수

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