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


---

# KeyValuePair 커넥터 메서드

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

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

Keyvalue 쌍 커넥터 메서드는 키 값 쌍에 대해 다양한 작업을 수행합니다. 자동화 흐름에서 메서드는 다른 메서드 및 구성요소와 연결됩니다. 메서드를 사용하려면 먼저 메서드를 노출해야 합니다.

## 추가 {#keyvaluepair-connector-methods__section_gcb_ftx_4tb}

keyvalue 쌍을 추가합니다.

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

| 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? |
|-|-|-|-|-|-|
| 키 | 키의 이름입니다. | 의 데이터 | 문자열 | 없음 | 예 |
| 값 | 키의 값입니다. | 의 데이터 | 객체 | 없음 | 예 |
| 중복 무시 | 값이 True이면 메서드는 중복 키를 무시합니다. 그렇지 않고 값이 False이면 메서드는 오류 메시지를 반환합니다. | 의 데이터 | 부울 | 없음 | 아니요 |
[표 1. 메서드 매개변수 추가]

{#keyvaluepair-connector-methods__table_l1y_t4r_4tb}

## 지우기 {#keyvaluepair-connector-methods__section_dfq_k5x_4tb}

모든 키 값 쌍을 지웁니다.

## 키(ContainsKey) {#keyvaluepair-connector-methods__section_ips_kvx_4tb}

지정된 키가 있으면 True를 반환하고, 그렇지 않으면 False를 반환합니다.

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

| 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? |
|-|-|-|-|-|-|
| 키 | 키의 이름입니다. | 의 데이터 | 문자열 | 없음 | 예 |
| 반환 | 지정된 키가 있으면 True를 반환하고, 그렇지 않으면 False를 반환합니다. | 데이터 출력 | 부울 | 해당 사항 없음 | 해당 사항 없음 |
[표 2. ContainsKey 메서드 매개 변수]

{#keyvaluepair-connector-methods__table_x4r_svx_4tb}

## 값 포함 {#keyvaluepair-connector-methods__section_h14_cwx_4tb}

지정된 키 값이 있으면 True를 반환하고, 그렇지 않으면 False를 반환합니다.

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

| 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? |
|-|-|-|-|-|-|
| 값 | 키 값의 이름입니다. | 의 데이터 | 문자열 | 없음 | 예 |
| 반환 | 지정된 키 값이 있으면 True를 반환하고, 그렇지 않으면 False를 반환합니다. | 데이터 출력 | 부울 | 해당 사항 없음 | 해당 사항 없음 |
[표 3. ContainsValue 메서드 매개 변수]

{#keyvaluepair-connector-methods__table_wbh_twx_4tb}

## 카운트 {#keyvaluepair-connector-methods__section_odt_xwx_4tb}

keyvalue 쌍의 총 카운트를 반환합니다.  
{#keyvaluepair-connector-methods__table_p3f_bxx_4tb__entry__6}

| 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? |
|-|-|-|-|-|-|
| 반환 | keyvalue 쌍의 총 카운트를 반환합니다. | 데이터 출력 | 정수 | 해당 사항 없음 | 해당 사항 없음 |
[표 4. 카운트 메서드 매개변수]

{#keyvaluepair-connector-methods__table_p3f_bxx_4tb}

## 삭제 {#keyvaluepair-connector-methods__section_knr_qxx_4tb}

지정된 키를 제거합니다.

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

| 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? |
|-|-|-|-|-|-|
| 키 | 키의 이름입니다. | 의 데이터 | 문자열 | 없음 | 예 |
[표 5. 메서드 매개변수 삭제]

{#keyvaluepair-connector-methods__table_php_txx_4tb}

## 항목 가져오기 {#keyvaluepair-connector-methods__section_ush_1yx_4tb}

지정된 키의 값을 반환합니다.

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

| 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? |
|-|-|-|-|-|-|
| 키 | 키의 이름입니다. | 의 데이터 | 문자열 | 없음 | 예 |
| 반환 | 키 값을 반환합니다. | 데이터 출력 | 객체 | 해당 사항 없음 | 해당 사항 없음 |
[표 6. GetItem 메서드 매개 변수]

{#keyvaluepair-connector-methods__table_rjd_2yx_4tb}

## GetItems {#keyvaluepair-connector-methods__section_nkm_4yx_4tb}

여러 키의 값을 반환합니다. 먼저 메서드에서 키를 구성해야 합니다.  
구성하려면 다음 단계를 수행합니다.

1. 방법 설정 아이콘( ![방법 설정 아이콘](). )을 클릭합니다.
2. 키 추가 아이콘( ![키 추가 아이콘](). )을 클릭합니다.
3. 키 이름을 입력합니다.
4. 목록에서 키 데이터 유형을 업데이트합니다.
5. 단계를 반복하여 여러 키 이름을 설정합니다.
6. 확인을 클릭합니다.

   데이터 출력 포트는 설정한 각 키 이름으로 생성됩니다.
{#keyvaluepair-connector-methods__ol_dsq_nzx_4tb}  
{#keyvaluepair-connector-methods__table_k22_21y_4tb__entry__6}

| 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? |
|-|-|-|-|-|-|
| 키 | 키 값을 반환합니다. | 데이터 출력 | 객체 | 해당 사항 없음 | 해당 사항 없음 |
[표 7. GetItems 메서드 매개 변수]

{#keyvaluepair-connector-methods__table_k22_21y_4tb}

## GetItemsByIndex (인덱스별 항목) {#keyvaluepair-connector-methods__section_of3_41y_4tb}

인덱스를 기준으로 키 값을 반환합니다. 먼저 메서드에서 인덱스를 구성해야 합니다.  
구성하려면 다음 단계를 수행합니다.

1. 방법 설정 아이콘( ![방법 설정 아이콘](). )을 클릭합니다.
2. 인덱스 추가 아이콘( ![키 추가 아이콘.]())을 클릭합니다.
3. 키 인덱스를 입력합니다.
4. 목록에서 키 데이터 유형을 업데이트합니다.
5. 단계를 반복하여 여러 키 인덱스를 설정합니다.
6. 확인을 클릭합니다.

   데이터 출력 포트는 설정한 각 키 인덱스와 함께 만들어집니다.
{#keyvaluepair-connector-methods__ol_e1y_bby_4tb}  
{#keyvaluepair-connector-methods__table_irj_mby_4tb__entry__6}

| 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? |
|-|-|-|-|-|-|
| 키 인덱스 | 키 값을 반환합니다. | 데이터 출력 | 객체 | 해당 사항 없음 | 해당 사항 없음 |
[표 8. GetItemsByIndex 메서드 매개 변수]

{#keyvaluepair-connector-methods__table_irj_mby_4tb}

## 텍스트에서 구문 분석(ParseFromText) {#keyvaluepair-connector-methods__section_jbj_fly_4tb}

지정된 텍스트를 키 값 쌍으로 구문 분석합니다. 여러 keyvalue 쌍을 만들 수 있습니다.

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

| 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? |
|-|-|-|-|-|-|
| 텍스트 | 메서드가 구문 분석하는 키와 값으로 구성된 텍스트입니다. | 의 데이터 | 문자열 | 없음 | 예 |
| 항목 구분 기호 | 두 keyvalue 쌍 사이의 구분 기호입니다. | 의 데이터 | 문자열 | 없음 | 예 |
| KeyValueSeparator (키 값 구분 기호) | 키와 값 사이의 구분 기호입니다. | 의 데이터 | 문자열 | 없음 | 예 |
| ClearBefore구문 분석 | 예일 경우 구문 분석하기 전에 기존 keyvalue 쌍을 지웁니다. | 의 데이터 | 부울 | 없음 | 아니요 |
[표 9. ParseFromText 메서드 매개 변수]

{#keyvaluepair-connector-methods__table_vs2_xly_4tb}

## 반전 {#keyvaluepair-connector-methods__section_oyx_mny_4tb}

키 인덱스를 되돌립니다.  
팁:  
메서드를 실행한 후 GetItemsByIndex 메서드를 실행하여 출력을 볼 수 있습니다.

## 데이터 설정 {#keyvaluepair-connector-methods__section_o1v_try_4tb}

정보가 필요합니다.

## SetItem {#keyvaluepair-connector-methods__section_a5c_vry_4tb}

키 값을 업데이트합니다.

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

| 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? |
|-|-|-|-|-|-|
| 키 | 키의 이름입니다. | 의 데이터 | 문자열 | 없음 | 예 |
| 값 | 키의 업데이트된 값입니다. | 의 데이터 | 객체 | 없음 | 예 |
[표 10. SetItem 메서드 매개 변수]

{#keyvaluepair-connector-methods__table_v4f_dsy_4tb}  
팁:  
GetItemsByIndex 메서드를 실행하여 업데이트된 값을 테스트합니다.

## SetItems (영문) {#keyvaluepair-connector-methods__section_il5_jsy_4tb}

지정된 키의 값을 업데이트합니다. 먼저 메서드에서 키를 구성해야 합니다.  
키를 구성하려면 다음 단계를 수행합니다.

1. 방법 설정 아이콘( ![방법 설정 아이콘](). )을 클릭합니다.
2. 키 추가 아이콘( ![키 추가 아이콘](). )을 클릭합니다.
3. 키 이름을 입력합니다.
4. 목록에서 키 데이터 유형을 업데이트합니다.
5. 단계를 반복하여 여러 키 이름을 설정합니다.
6. 확인을 클릭합니다.

   포트의 데이터는 설정한 각 키 이름으로 생성됩니다.
{#keyvaluepair-connector-methods__ol_epq_tsy_4tb}

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

| 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? |
|-|-|-|-|-|-|
| 키 | 키의 업데이트된 값입니다. | 의 데이터 | 객체 | 없음 | 예 |
[표 11. SetItems 메서드 매개 변수]

{#keyvaluepair-connector-methods__table_ug5_zsy_4tb}  
팁:  
GetItemsByIndex 메서드를 실행하여 업데이트된 값을 테스트합니다.

## SetItemsByIndex (영문) {#keyvaluepair-connector-methods__section_t3c_sty_4tb}

지정된 인덱스를 기반으로 키 값을 업데이트합니다. 먼저 메서드에서 인덱스를 구성해야 합니다.  
인덱스를 구성하려면 다음 단계를 수행합니다.

1. 방법 설정 아이콘( ![방법 설정 아이콘](). )을 클릭합니다.
2. 인덱스 추가 아이콘( ![키 추가 아이콘.]())을 클릭합니다.
3. 키 인덱스를 입력합니다.
4. 목록에서 키 데이터 유형을 업데이트합니다.
5. 단계를 반복하여 여러 키 인덱스를 설정합니다.
6. 확인을 클릭합니다.

   Data in port는 설정한 각 키 인덱스와 함께 생성됩니다.
{#keyvaluepair-connector-methods__ol_izp_m5y_4tb}  
{#keyvaluepair-connector-methods__table_emr_p5y_4tb__entry__6}

| 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? |
|-|-|-|-|-|-|
| 키 인덱스 | 키의 인덱스입니다. | 의 데이터 | 객체 | 없음 | 예 |
[표 12. SetItemsByIndex 메서드 매개 변수]

{#keyvaluepair-connector-methods__table_emr_p5y_4tb}  
팁:  
GetItemsByIndex 메서드를 실행하여 업데이트된 값을 테스트합니다.

## ToJSON {#keyvaluepair-connector-methods__section_nds_gvy_4tb}

키 값 쌍을 JSON 형식으로 렌더링합니다.

## 텍스트 {#keyvaluepair-connector-methods__section_pnh_4vy_4tb}

키 값 쌍을 텍스트 형식으로 렌더링합니다.

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

| 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? |
|-|-|-|-|-|-|
| ValuesOnly (값만) | True이면 메서드는 키 값만 렌더링하고, 그렇지 않으면 keyvalue 쌍을 렌더링합니다. | 의 데이터 | 부울 | 없음 | 아니요 |
| 반환 | keyvalue 쌍을 텍스트 형식으로 반환합니다. | 데이터 출력 | 문자열 | 해당 사항 없음 | 해당 사항 없음 |
[표 13. ToText 메서드 매개변수]

{#keyvaluepair-connector-methods__table_xsf_vvy_4tb}