---
sourceDocument: Xanadu 애플리케이션과의 통합 생성
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/integrate-applications

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu 애플리케이션과의 통합 생성

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Java 커넥터 메서드

# Java 커넥터 메서드 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 8분

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

## 커넥터 수준 메서드 {#java-connector-methods__section_qbh_klh_ntb}

## 시작 {#java-connector-methods__section_sk4_cxh_ntb}

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

매개변수에 대한 입력을 제공하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다.").  
{#java-connector-methods__table_vbt_5zy_mtb__entry__6}

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

{#java-connector-methods__table_vbt_5zy_mtb}

## GetMainWindowHandle (메인 창 핸들 구하기) {#java-connector-methods__section_xwq_jyh_ntb}

Start 메서드에서 시작한 Java 응용 프로그램의 창 핸들을 반환합니다.  
{#java-connector-methods__table_rqj_tyh_ntb__entry__6}

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

{#java-connector-methods__table_rqj_tyh_ntb}

## GetMainWindowTitle (영문) {#java-connector-methods__section_idb_rc3_ntb}

Java 응용 프로그램 창의 제목을 반환합니다.  
{#java-connector-methods__table_hcn_vc3_ntb__entry__6}

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

{#java-connector-methods__table_hcn_vc3_ntb}

## 메인윈도우 닫기 {#java-connector-methods__section_imk_qlh_ntb}

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

## 종료 {#java-connector-methods__section_s1s_dd3_ntb}

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

## 화면 수준 메서드 {#java-connector-methods__section_crj_pq3_ntb}

## 닫기 {#java-connector-methods__section_cl5_5q3_ntb}

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

## 포커스 {#java-connector-methods__section_vvv_vq3_ntb}

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

## GetFields {#java-connector-methods__section_b2r_dr3_ntb}

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

1. [Java 커넥터 구성](https://servicenow-prod.fluidtopics.net/l8TIgG4XMxJEWYCpr_3btg "자동화가 수행될 Java 애플리케이션 화면과 요소를 설정하도록 Java 커넥터를 구성합니다. 설정 후 커넥터, 화면 및 요소 수준에서 메서드를 노출할 수 있습니다.") 을 클릭하고 하나 이상의 텍스트 필드를 캡처합니다.
2. 화면 수준 메서드를 노출합니다. [커넥터 방법 사용](https://servicenow-prod.fluidtopics.net/Zjz8nplFK4z582_R247qRQ "커넥터 내에서 메서드를 노출한 다음 사용하여 커넥터가 수행할 수 있는 모든 작업을 수행합니다.") 문서를 참조하십시오.
3. 개체 탐색기 창에서 GetFields 메서드를 디자인 화면으로 끌어 옵니다.
4. 방법 설정 아이콘( ![방법 설정 아이콘](). )을 클릭합니다.
5. 하나 이상의 텍스트 필드를 선택합니다.
6. 텍스트 필드의 데이터 유형을 업데이트합니다.
7. CHOOSE FORM ELEMENTS 창을 닫으려면 확인을 클릭합니다.

   선택한 각 텍스트 필드에 대해 데이터 출력 포트가 만들어집니다.
{#java-connector-methods__ol_p5d_2jn_ntb}

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

## GetInstanceCount (영문) {#java-connector-methods__section_awc_xmn_ntb}

Java 응용 프로그램이 열려 있는 총 인스턴스 수를 반환합니다.  
{#java-connector-methods__table_wmd_knn_ntb__entry__6}

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

{#java-connector-methods__table_wmd_knn_ntb}

## 스크린 샷 구하기 {#java-connector-methods__section_yqf_snn_ntb}

Java 애플리케이션 화면의 스크린샷을 캡처하고 반환합니다.  
{#java-connector-methods__table_ex3_14n_ntb__entry__6}

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

{#java-connector-methods__table_ex3_14n_ntb}

## GetWindowHandle (영문) {#java-connector-methods__section_vbl_24n_ntb}

Java 애플리케이션 화면 창의 Windows 핸들 번호를 반환합니다.  
{#java-connector-methods__table_lqh_k4n_ntb__entry__6}

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

{#java-connector-methods__table_lqh_k4n_ntb}

## IsCreated (영문) {#java-connector-methods__section_r2p_n4n_ntb}

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

매개변수에 대한 입력을 제공하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다.").  
{#java-connector-methods__table_fyl_4rn_ntb__entry__7}

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

{#java-connector-methods__table_fyl_4rn_ntb}

## 최대화 {#java-connector-methods__section_m22_hsn_ntb}

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

## 최소화 {#java-connector-methods__section_utg_3sn_ntb}

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

## 마우스 액션 {#java-connector-methods__section_tyh_zsn_ntb}

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

매개변수에 대한 입력을 제공하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다.").  
{#java-connector-methods__table_o2h_pbj_4tb__entry__6}

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

{#java-connector-methods__table_o2h_pbj_4tb}

## 크기 조정 {#java-connector-methods__section_wkg_xtn_ntb}

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

매개변수에 대한 입력을 제공하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다.").  
{#java-connector-methods__table_c1j_g5n_ntb__entry__6}

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

{#java-connector-methods__table_c1j_g5n_ntb}

## 재개 {#java-connector-methods__section_gxy_czn_ntb}

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

## SendKeys (영문) {#java-connector-methods__section_ggj_qzn_ntb}

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

매개변수에 대한 입력을 제공하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다.").  
{#java-connector-methods__table_jsm_rdj_4tb__entry__6}

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

{#java-connector-methods__table_jsm_rdj_4tb}

## 필드 설정 {#java-connector-methods__section_pbn_t14_ntb}

Java 애플리케이션 화면에서 캡처한 텍스트 필드 요소에 사용자 지정 텍스트를 설정합니다.  
이 방법을 사용하려면 다음 단계를 수행합니다.

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

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

   매개변수에 대한 입력을 제공하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다.").
{#java-connector-methods__ol_fhp_db4_ntb}

## 생성 대기(WaitForCreate) {#java-connector-methods__section_wjj_xb4_ntb}

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

매개변수에 대한 입력을 제공하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다.").  
{#java-connector-methods__table_tyw_hc4_ntb__entry__6}

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

{#java-connector-methods__table_tyw_hc4_ntb}

## 요소 수준 메서드 {#java-connector-methods__section_rmv_rtp_ntb}

## GetAccessibleActions (영문) {#java-connector-methods__section_zpq_t1c_4tb}

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

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

{#java-connector-methods__table_t5k_thj_4tb}

## GetInstanceCount (영문) {#java-connector-methods__section_yzx_mbc_4tb}

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

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

{#java-connector-methods__table_bxd_v3j_4tb}

## 텍스트 가져오기 {#java-connector-methods__section_k14_kcc_4tb}

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

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

{#java-connector-methods__table_akh_pcc_4tb}

## IsCreated (영문) {#java-connector-methods__section_qbp_dlc_4tb}

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

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

{#java-connector-methods__table_xzk_lmc_4tb}

## 마우스클릭 {#java-connector-methods__section_zf2_yvc_4tb}

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

## 수행 작업 {#java-connector-methods__section_c3s_swc_4tb}

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

매개변수에 대한 입력을 제공하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다.").  
{#java-connector-methods__table_wpx_2wj_4tb__entry__7}

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

{#java-connector-methods__table_wpx_2wj_4tb}

## SetPassword (암호 설정) {#java-connector-methods__section_c2b_zss_vzb}

Java 애플리케이션의 암호 필드에 안전하게 암호 입력을 자동화합니다.  
필드에 입력을 제공하려면 다음 문서를 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다.").{#java-connector-methods__table_jrs_nts_vzb__entry__7}

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

{#java-connector-methods__table_jrs_nts_vzb}