---
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


---

# IBM 개인 통신 에뮬레이터 메서드

# IBM 개인 통신 에뮬레이터 메서드 {#ariaid-title1}

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

IBM 개인 통신 에뮬레이터 메서드를 사용하여 개인 통신 에뮬레이터에서 다양한 자동화 작업을 수행할 수 있습니다IBM.

## 화면 수준 메서드 {#pcomm-terminal-methods__section_dkr_1db_51c}

화면 수준 메서드를 사용하여 에뮬레이터 화면에서 자동화 작업을 수행합니다. 예를 들어 화면에서 명령을 시뮬레이션하거나 화면에서 텍스트를 가져올 수 있습니다.

## 필드 텍스트 가져오기 {#pcomm-terminal-methods__section_xqk_wfb_51c}

지정한 행과 열 번호로 필드를 식별한 후 필드에 포함된 텍스트를 반환합니다. 지정하는 행과 열은 필드의 시작점입니다. 이 메서드는 전체 필드를 식별한 다음 필드의 텍스트를 반환합니다. 다음 예에서 `H` 는 필드의 첫 번째 문자이자 시작점이고 `호스트 OS :` 는 필드의 전체 텍스트입니다.

{#pcomm-terminal-methods__table_ubn_ggb_51c__entry__7}

| 매개변수 | 설명 | 데이터 포트 입력 유형 | 데이터 유형 | 기본값 | 필수 | 참고 사항 |
|-|-|-|-|-|-|-|
| 행 | 필드를 식별하는 필드 행 번호입니다. | 데이터 입력 | 정수 | 해당 사항 없음 | 예 |   |
| 열 | 필드를 식별하는 필드 열 번호입니다. | 데이터 입력 | 정수 | 해당 사항 없음 | 예 |   |
| 반환 | 필드에 텍스트를 반환합니다. | 데이터 출력 | 문자열 | 해당 사항 없음 | 해당 사항 없음 |   |
[표 1. GetFieldText 메서드 매개 변수]

{#pcomm-terminal-methods__table_ubn_ggb_51c}

## GetTextFromRect (영문) {#pcomm-terminal-methods__section_u4c_mhb_51c}

화면에서 정의한 사각형 영역의 모든 필드에 텍스트를 반환합니다. 시작 및 종료 행과 열 번호를 제공하여 영역을 정의합니다. 이 메서드는 첫 번째 필드와 마지막 필드를 찾아 식별하고 해당 영역 내의 모든 필드에 있는 모든 텍스트를 반환합니다. 다음 예제에서는 정의한 영역을 보여 줍니다.

{#pcomm-terminal-methods__table_e4p_x4b_51c__entry__7}

| 매개변수 | 설명 | 데이터 포트 입력 유형 | 데이터 유형 | 기본값 | 필수 | 참고 사항 |
|-|-|-|-|-|-|-|
| 시작 행 | 사각형 영역에 있는 첫 번째 필드의 첫 번째 문자를 나타내는 행 번호입니다. | 데이터 입력 | 정수 | 해당 사항 없음 | 예 |   |
| StartCol | 사각형 영역에 있는 첫 번째 필드의 첫 번째 문자를 포함하는 열 번호입니다. | 데이터 입력 | 정수 | 해당 사항 없음 | 예 |   |
| EndRow(끝행) | 사각형 영역에 있는 마지막 필드의 마지막 문자가 포함된 행 번호입니다. | 데이터 입력 | 정수 | 해당 사항 없음 | 예 |   |
| EndCol | 사각형 영역에 있는 마지막 필드의 마지막 문자를 포함하는 열 번호입니다. | 데이터 입력 | 정수 | 해당 사항 없음 | 예 |   |
| 반환 | 사각형 영역 내의 모든 필드에서 텍스트를 반환합니다. | 데이터 출력 | 문자열 | 해당 사항 없음 | 해당 사항 없음 |   |
[표 2. GetTextFromRect 메서드 매개 변수]

{#pcomm-terminal-methods__table_e4p_x4b_51c}

## IsCreated (영문) {#pcomm-terminal-methods__section_whb_jsc_51c}

화면 일치 규칙에 따라 에뮬레이터 화면이 존재하는지, 사용자의 입력을 수락할 수 있는지 확인합니다. 확인 후 메서드는 적절한 부울 값을 반환합니다.

{#pcomm-terminal-methods__table_scg_qsc_51c__entry__7}

| 매개변수 | 설명 | 데이터 포트 입력 유형 | 데이터 유형 | 기본값 | 필수 | 참고 사항 |
|-|-|-|-|-|-|-|
| MatchAllChildren (모든 어린이) | 캡처한 하위 요소를 일치시켜 에뮬레이터 화면을 찾는 옵션입니다. | 데이터 입력 | 부울 | 거짓 | 예 | 경고: 이 옵션을 사용하면 메서드 속도가 느려질 수 있습니다. |
| 반환 | 화면 일치 규칙에 따라 에뮬레이터 화면이 존재하는지 여부에 따라 부울 값을 반환하고 사용자의 입력을 수락할 수 있습니다. | 데이터 출력 | 부울 | 해당 사항 없음 | 해당 사항 없음 |   |
[표 3. IsCreated 메서드 매개 변수]

{#pcomm-terminal-methods__table_scg_qsc_51c}

## SearchText {#pcomm-terminal-methods__section_uvz_rtc_51c}

지정한 텍스트의 첫 번째 문자를 포함하는 행과 열의 번호를 반환합니다. 예를 들어, 문자열 `emulator`를 지정하면 이 메서드는 `단어 emulator` 의 시작점( `e`)의 행과 열 번호를 반환합니다.  
주:  
여러 필드에 걸쳐 있는 텍스트를 제공하는 경우 메서드가 단일 필드의 텍스트만 지원하기 때문에 Row 및 Col 포트는 0을 반환합니다.

{#pcomm-terminal-methods__table_lhf_vtc_51c__entry__7}

| 매개변수 | 설명 | 데이터 포트 입력 유형 | 데이터 유형 | 기본값 | 필수 | 참고 사항 |
|-|-|-|-|-|-|-|
| 텍스트 | 메서드가 검색하는 텍스트입니다. | 데이터 입력 | 문자열 | 해당 사항 없음 | 예 | 지정하는 텍스트는 사용하는 에뮬레이터에 따라 대/소문자를 구분할 수 있습니다. |
| 행 | 지정한 텍스트의 첫 번째 문자가 있는 행 번호입니다. | 데이터 출력 | 정수 | 해당 사항 없음 | 해당 사항 없음 | 지정한 텍스트가 여러 행과 열에 있는 경우 메서드는 텍스트가 포함된 첫 번째 행과 열을 반환합니다. |
| 열 | 지정한 텍스트의 첫 번째 문자가 있는 열 번호입니다. | 데이터 출력 | 정수 | 해당 사항 없음 | 해당 사항 없음 | 지정한 텍스트가 여러 행과 열에 있는 경우 메서드는 텍스트가 포함된 첫 번째 행과 열을 반환합니다. |
[표 4. SearchText 메서드 매개 변수]

{#pcomm-terminal-methods__table_lhf_vtc_51c}

## SendKeys (영문) {#pcomm-terminal-methods__section_zwz_z21_w1c}

에뮬레이터 화면의 마우스 장치 위치에서 키보드로 입력하는 키 입력을 시뮬레이션합니다. 예를 들어 화면에서 \[enter\] 키 입력을 시뮬레이션할 수 있습니다.

{#pcomm-terminal-methods__table_qwx_cdc_w1c__entry__7}

| 매개변수 | 설명 | 데이터 포트 입력 유형 | 데이터 유형 | 기본값 | 필수 | 참고 사항 |
|-|-|-|-|-|-|-|
| 키 | 키보드에서 입력하는 키 입력입니다. | 데이터 입력 | 문자열 | 없음 | 예 | 팁: 키 입력에 대한 자세한 내용은 해당 터미널 에뮬레이터 설명서를 참조하십시오. |
[표 5. SendKeys 메서드 매개 변수]

{#pcomm-terminal-methods__table_qwx_cdc_w1c}

## SendKeysSecure (영문) {#pcomm-terminal-methods__section_jvn_pr4_w1c}

에뮬레이터 화면의 마우스 장치 위치에서 보안 문자열인 키 입력을 시뮬레이션합니다.

{#pcomm-terminal-methods__table_ews_ps4_w1c__entry__7}

| 매개변수 | 설명 | 데이터 포트 입력 유형 | 데이터 유형 | 기본값 | 필수 | 참고 사항 |
|-|-|-|-|-|-|-|
| 키 | 보안 문자열로 입력하는 키 입력입니다. | 데이터 입력 | 보안 문자열 | 없음 | 예 | 팁: 키 입력에 대한 자세한 내용은 해당 터미널 에뮬레이터 설명서를 참조하십시오. |
[표 6. SendKeysSecure 메서드 매개 변수]

{#pcomm-terminal-methods__table_ews_ps4_w1c}

## SetCursorPosition (커서 위치 설정) {#pcomm-terminal-methods__section_yrg_y5c_51c}

지정한 행과 열 번호로 마우스 장치를 설정하려고 시도합니다.

{#pcomm-terminal-methods__table_pxr_dvc_51c__entry__7}

| 매개변수 | 설명 | 데이터 포트 입력 유형 | 데이터 유형 | 기본값 | 필수 | 참고 사항 |
|-|-|-|-|-|-|-|
| 행 | 메서드가 화면에서 마우스 장치를 설정하려고 시도하는 기준이 되는 행 번호를 제공하는 옵션입니다. | 데이터 입력 | 정수 | 해당 사항 없음 | 해당 사항 없음 | 행 번호는 양수여야 하며 에뮬레이터 화면 크기 내에 있어야 합니다. 예를 들어 화면 크기가 24X80인 경우 행에 제공할 수 있는 최대값은 24입니다. |
| 열 | 메서드가 화면에서 마우스 장치를 설정하려고 시도하는 기준이 되는 행 번호를 제공하는 옵션입니다. | 데이터 입력 | 정수 | 해당 사항 없음 | 해당 사항 없음 | 열 번호는 양수여야 하며 에뮬레이터 화면 크기 내에 있어야 합니다. 예를 들어 화면 크기가 24X80인 경우 열에 제공할 수 있는 최대값은 80입니다. |
[표 7. SetCursorPosition 메서드 매개 변수]

{#pcomm-terminal-methods__table_pxr_dvc_51c}

## 생성 대기(WaitForCreate) {#pcomm-terminal-methods__section_ykp_lvc_51c}

커넥터가 화면 일치 규칙을 사용하여 화면이 있는지 확인하는 동안 사용자가 지정한 기간 동안 대기합니다.

{#pcomm-terminal-methods__table_trs_cwc_51c__entry__7}

| 매개변수 | 설명 | 데이터 포트 입력 유형 | 데이터 유형 | 기본값 | 필수 | 참고 사항 |
|-|-|-|-|-|-|-|
| timeoutinSeconds (타임아웃인초) | 커넥터가 화면 일치 규칙을 사용하여 화면이 있는지 확인하는 동안 메서드가 대기하는 시간(초)을 제공하는 옵션입니다. | 데이터 입력 | 정수 | 30 | 예 |   |
| MatchAllChildren (모든 어린이) | 화면이 있는지 확인하기 위해 캡처한 모든 화면 요소를 일치시키는 옵션입니다. | 데이터 입력 | 부울 | 거짓 | 예 | 경고: 이 옵션을 사용하면 메서드 실행이 지연될 수 있습니다. |
| 반환 | 에뮬레이터 화면을 찾았는지 여부에 따라 부울 값을 반환합니다. | 데이터 출력 | 부울 | 해당 사항 없음 | 해당 사항 없음 |   |
[표 8. WaitForCreate 메서드 매개 변수]

{#pcomm-terminal-methods__table_trs_cwc_51c}

## 요소 수준 메서드 {#pcomm-terminal-methods__section_ph5_pzh_51c}

요소 수준 메서드는 터미널 커넥터 화면에서 추가하는 에뮬레이터 화면 요소에서 자동화 작업을 수행합니다. 화면 요소를 필드나 테이블로 추가할 수 있습니다.

## GetAsTable {#pcomm-terminal-methods__section_gsf_jb3_51c}

데이터 테이블 객체로 캡처한 텍스트를 반환합니다. 화면에서 테이블로 데이터를 캡처할 때 이 방법을 사용합니다. 그러나 필드로 캡처하는 데이터에 대해 이 방법을 사용할 수도 있습니다. 데이터를 테이블로 캡처하는 방법에 대한 자세한 내용은 을 참조하십시오 [IBM 개인 통신 에뮬레이터 구성](https://servicenow-prod.fluidtopics.net/ur35ynkWp_OxoCIspPe6sQ "IBM PCOMM 에뮬레이터 화면과 해당 요소를 캡처하여 에서 개인 통신(PCOMM) 에뮬레이터 RPA 데스크톱 디자인 스튜디오 를 구성합니다. 화면을 캡처한 후 screen 및 element 메서드를 사용하여 화면과 요소에 대한 작업을 자동화할 수 있습니다.").

{#pcomm-terminal-methods__table_i1k_yb3_51c__entry__7}

| 매개변수 | 설명 | 데이터 포트 입력 유형 | 데이터 유형 | 기본값 | 필수 | 참고 사항 |
|-|-|-|-|-|-|-|
| 반환 | 터미널 화면에서 캡처한 텍스트를 데이터 테이블 객체로 반환합니다. | 데이터 출력 | 데이터 테이블 | 해당 사항 없음 | 해당 사항 없음 | 테이블을 보려면 매개변수를 마우스 오른쪽 버튼으로 클릭하고 데이터 미리 보기를 선택합니다. |
[표 9. GetAsTable 메서드 매개 변수]

{#pcomm-terminal-methods__table_i1k_yb3_51c}

## 텍스트 가져오기 {#pcomm-terminal-methods__section_jrs_gc3_51c}

에뮬레이터 화면에서 캡처한 필드에 텍스트를 반환합니다. 캡처한 테이블에 대해 이 메서드를 사용하면 사각형의 첫 번째 필드에 텍스트가 반환됩니다.

{#pcomm-terminal-methods__table_umt_jc3_51c__entry__7}

| 매개변수 | 설명 | 데이터 포트 입력 유형 | 데이터 유형 | 기본값 | 필수? | 참고 사항 |
|-|-|-|-|-|-|-|
| 반환 | 캡처한 필드에서 텍스트를 반환합니다. | 데이터 출력 | 문자열 | 해당 사항 없음 | 해당 사항 없음 |   |
[표 10. GetText 메서드 매개 변수]

{#pcomm-terminal-methods__table_umt_jc3_51c}

## IsCreated (영문) {#pcomm-terminal-methods__section_nyk_nc3_51c}

규칙을 일치시키고 캡처된 요소가 있는지 확인합니다.

{#pcomm-terminal-methods__table_oyk_nc3_51c__entry__7}

| 매개변수 | 설명 | 데이터 포트 입력 유형 | 데이터 유형 | 기본값 | 필수 | 참고 사항 |
|-|-|-|-|-|-|-|
| 반환 | 요소가 활성 상태인지 여부에 따라 부울 값을 반환합니다. | 데이터 출력 | 부울 | 해당 사항 없음 | 해당 사항 없음 |   |
[표 11. IsCreated 메서드 매개 변수]

{#pcomm-terminal-methods__table_oyk_nc3_51c}

## SetText {#pcomm-terminal-methods__section_cnd_tc3_51c}

필드에 텍스트를 설정하려고 시도합니다.

{#pcomm-terminal-methods__table_xrt_5c3_51c__entry__7}

| 매개변수 | 설명 | 데이터 포트 입력 유형 | 데이터 유형 | 기본값 | 필수 | 참고 사항 |
|-|-|-|-|-|-|-|
| 텍스트 | 메서드가 필드에서 설정하려고 시도하는 텍스트를 지정하는 옵션입니다. | 데이터 입력 | 문자열 | 해당 사항 없음 | 예 | 보호된 에뮬레이터 화면에서는 이 메서드를 사용할 수 없습니다. |
[표 12. SetText 메서드 매개 변수]

{#pcomm-terminal-methods__table_xrt_5c3_51c}

## 생성 대기(WaitForCreate) {#pcomm-terminal-methods__section_z1s_yl3_51c}

커넥터가 일치 규칙을 사용하여 요소가 있는지 확인하는 동안 사용자가 지정한 기간 동안 대기합니다.

{#pcomm-terminal-methods__table_abs_yl3_51c__entry__7}

| 매개변수 | 설명 | 데이터 포트 입력 유형 | 데이터 유형 | 기본값 | 필수 | 참고 사항 |
|-|-|-|-|-|-|-|
| timeoutinSeconds (타임아웃인초) | 커넥터가 일치 규칙을 사용하여 요소가 존재하는지 여부를 찾는 동안 메서드가 대기하는 시간(초)을 제공하는 옵션입니다. | 데이터 입력 | 정수 | 30 | 예 |   |
| 반환 | 요소를 찾았는지 여부에 따라 부울 값을 반환합니다. | 데이터 출력 | 부울 | 해당 사항 없음 | 해당 사항 없음 |   |
[표 13. WaitForCreate 메서드 매개 변수]

{#pcomm-terminal-methods__table_abs_yl3_51c}