KeyValuePair 커넥터 메서드

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 5분

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

    추가

    keyvalue 쌍을 추가합니다.

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

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

    지우기

    모든 키 값 쌍을 지웁니다.

    ContainsKey

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

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

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

    ContainsValue

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

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

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

    카운트

    keyvalue 쌍의 총 수를 반환합니다.

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

    삭제

    지정된 키를 제거합니다.

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

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

    항목 가져오기

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

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

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

    항목 가져오기

    여러 키의 값을 반환합니다. 먼저 메서드에서 키를 구성해야 합니다.

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

      설정한 각 키 이름으로 데이터 출력 포트가 생성됩니다.

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

    GetItemsByIndex

    인덱스를 기반으로 키 값을 반환합니다. 먼저 메서드에서 인덱스를 구성해야 합니다.

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

      데이터 출력 포트는 설정한 각 키 인덱스로 생성됩니다.

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

    텍스트에서 구문 분석

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

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

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

    반전

    키 인덱스를 반전시킵니다.
    팁:
    메서드를 실행한 후 GetItemsByIndex 메서드를 실행하여 출력을 볼 수 있습니다.

    데이터 설정

    정보가 필요합니다.

    항목 설정

    키 값을 업데이트합니다.

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

    표 10. SetItem 메서드 매개변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수입니까?
    키 키의 이름입니다. 의 데이터 문자열 안 함 예
    값 키의 업데이트된 값입니다. 의 데이터 객체 안 함 예
    팁:
    GetItemsByIndex 메서드를 실행하여 업데이트된 값을 테스트합니다.

    항목 설정

    지정된 키의 값을 업데이트합니다. 먼저 메서드에서 키를 구성해야 합니다.

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

      설정한 각 키 이름으로 데이터 입력 포트가 생성됩니다.

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

    표 11. SetItems 메서드 매개변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수입니까?
    키 키의 업데이트된 값입니다. 의 데이터 객체 안 함 예
    팁:
    GetItemsByIndex 메서드를 실행하여 업데이트된 값을 테스트합니다.

    SetItemsByIndex

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

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

      데이터 입력 포트는 설정한 각 키 인덱스로 생성됩니다.

    표 12. SetItemsByIndex 메서드 매개변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수입니까?
    키 인덱스 키의 인덱스입니다. 의 데이터 객체 안 함 예
    팁:
    GetItemsByIndex 메서드를 실행하여 업데이트된 값을 테스트합니다.

    ToJSON

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

    대상 텍스트

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

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

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