KeyValuePair 커넥터 메서드

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 5분

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

    추가

    keyvalue 쌍을 추가합니다.

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

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

    지우기

    모든 키 값 쌍을 지웁니다.

    키(ContainsKey)

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

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

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

    값 포함

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

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

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

    카운트

    keyvalue 쌍의 총 카운트를 반환합니다.

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

    삭제

    지정된 키를 제거합니다.

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

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

    항목 가져오기

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

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

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

    GetItems

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

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

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

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

    GetItemsByIndex (인덱스별 항목)

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

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

      데이터 출력 포트는 설정한 각 키 인덱스와 함께 만들어집니다.

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

    텍스트에서 구문 분석(ParseFromText)

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

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

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

    반전

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

    데이터 설정

    정보가 필요합니다.

    SetItem

    키 값을 업데이트합니다.

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

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

    SetItems (영문)

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

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

      포트의 데이터는 설정한 각 키 이름으로 생성됩니다.

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

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

    SetItemsByIndex (영문)

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

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

      Data in port는 설정한 각 키 인덱스와 함께 생성됩니다.

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

    ToJSON

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

    텍스트

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

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

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