Java 커넥터 메서드

커넥터 수준 메서드

시작

해당 위치에서 Java 응용 프로그램을 시작하고 포커스를 가져옵니다.

주:

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

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

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

GetMainWindowHandle (영문)

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

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

GetMainWindowTitle (영문)

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

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

메인 창 닫기

기본 Java 응용 프로그램 창을 닫습니다.

종료

주 Java 응용 프로그램 창을 종료합니다.

화면 수준 메서드

닫기

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

포커스

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

GetFields

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

Java 커넥터 구성 그리고 하나 이상의 텍스트 필드를 캡처합니다.
화면 수준 메서드를 노출합니다. 커넥터 방법 사용 문서를 참조하십시오.
개체 탐색기 창에서 GetFields 메서드를 디자인 화면으로 끌어 옵니다.
방법 설정 아이콘( )을 클릭합니다.
하나 이상의 텍스트 필드를 선택합니다.
텍스트 필드의 데이터 형식을 업데이트합니다.
CHOOSE FORM ELEMENTS 창을 닫으려면 OK를 클릭합니다.
선택한 각 텍스트 필드에 대해 데이터 출력 포트가 만들어집니다.

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

GetInstanceCount (인스턴스 수 얻음)

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

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

스크린 샷 가져오기

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

표 5. GetInstanceCount 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?	메모
다시 이동	Java 애플리케이션 화면의 스크린샷을 반환합니다.	데이터 출력	비트맵	없음	해당 사항 없음

GetWindowHandle (창 핸들 얻기)

Java 응용 프로그램 화면 창의 Windows 핸들 번호를 반환합니다.

표 6. GetInstanceCount 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?	메모
다시 이동	Java 응용 프로그램 화면 창의 Windows 핸들 번호를 반환합니다.	데이터 출력	정수	없음	해당 사항 없음

IsCreated입니다

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

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

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

최대화

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

최소화

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

마우스 액션

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

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

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

크기 조정

X 및 Y 축을 따라 Java 응용 프로그램 창의 너비, 높이 및 위치를 변경합니다.

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

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

재개

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

Sendkeys

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

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

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

SetFields (영문)

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

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

개체 탐색기에서 SetFields 메서드를 디자인 화면으로 끌어 옵니다.
방법 설정 아이콘( )을 클릭합니다.
하나 이상의 텍스트 필드를 선택합니다.
텍스트 필드의 데이터 형식을 업데이트합니다.
확인을 클릭합니다.
선택한 각 텍스트 필드에 대해 Data In 포트가 생성됩니다. Java 애플리케이션의 필드에 설정할 문자열을 전달할 수 있습니다.

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

작성 대기

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

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

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

요소 수준 메서드

GetAccessibleActions (영문)

요소에 대해 수행할 수 있는 작업 목록을 반환합니다. 예를 들어 단추의 경우 Click을 반환합니다.

표 12. GetText 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?	메모
다시 이동	요소에 대해 수행할 수 있는 작업 목록을 반환합니다.	데이터 출력	목록	없음	해당 사항 없음

GetInstanceCount (인스턴스 수 얻음)

Java 응용 프로그램에 있는 요소 유형의 총 카운트를 반환합니다. 예를 들어 응용 프로그램에 텍스트 상자가 세 개 있는 경우 인스턴스 수는 3입니다.

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

Gettext

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

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

IsCreated입니다

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

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

마우스클릭

캡처된 요소에 마우스 왼쪽 버튼을 클릭합니다.

작업 수행

요소에 대해 지정된 작업을 수행합니다. 예를 들어 버튼을 클릭합니다. 각 요소에서는 GetAccessibleActions 메서드를 실행하여 가져올 수 있는 작업 집합을 사용할 수 있습니다.

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

표 16. IsCreated 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?	메모
작업	요소에 대해 수행할 작업을 허용합니다.	의 데이터	문자열	없음	예	GetAccessibleActions 메서드에서 지정한 형식으로 작업을 정확하게 지정해야 합니다.
다시 이동	작업이 수행된 경우 True를 반환하고, 그렇지 않으면 False를 반환합니다.	데이터 출력	부울	없음	해당 사항 없음

SetPassword(암호 설정)

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

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

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