커넥터 메서드 나열

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

    • 목록 커넥터 메서드는 자동화 워크플로의 일부로 목록 항목에 대한 다양한 작업을 수행합니다. 사용하기 전에 먼저 메서드를 노출해야 합니다.

    추가

    단일 목록 항목을 추가합니다.

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

    표 1. 메서드 매개변수 추가
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    항목 목록 항목의 이름입니다. 의 데이터 객체 없음 예

    추가 목록

    항목 목록을 추가합니다.

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

    표 2. AddList 메서드 매개변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수? 참고 사항
    목록 항목 목록입니다. 의 데이터 객체 없음 예 변수 또는 적절한 구성요소에서 목록 항목을 전달할 수 있습니다.

    포함

    목록 항목이 존재하는지 여부에 따라 부울 값을 반환합니다.

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

    표 3. 메서드 매개변수 포함
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    항목 메서드가 검색하는 목록 항목의 이름입니다. 의 데이터 객체 없음 예
    반환 목록 항목이 발견되면 True를 반환하고, 그렇지 않으면 False를 반환합니다. 데이터 출력 부울 해당 사항 없음 해당 사항 없음

    카운트

    추가된 목록 항목의 총 개수를 반환합니다.

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

    FindByProperty (영문)

    지정된 키와 값을 기준으로 목록 항목을 찾습니다. 이 메서드를 실행하기 전에 하나 이상의 키 값 쌍 목록 항목을 생성해야 합니다.

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

    표 5. FindByProperty 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    소품 키 값 쌍의 키입니다. 의 데이터 문자열 없음 예
    값 키 값 쌍의 값입니다. 의 데이터 문자열 없음 예
    찾음 목록 항목이 발견되면 True를 반환하고, 그렇지 않으면 False를 반환합니다. 데이터 출력 부울 해당 사항 없음 해당 사항 없음
    항목 Found 매개 변수가 True이면 메서드는 목록 항목을 반환합니다. 데이터 출력 객체 해당 사항 없음 해당 사항 없음

    텍스트 찾기

    지정된 필터를 기반으로 목록 항목에서 텍스트 또는 정규 표현식을 찾고 텍스트 및 텍스트 자체의 총 발생 수를 반환합니다.

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

    표 6. FindByProperty 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    SearchText 메서드가 목록 항목에서 검색하는 텍스트입니다. 의 데이터 문자열 없음 예
    찾기자(FindBy) 메서드가 텍스트 또는 정규 표현식을 검색하는지 여부를 나타내는 옵션입니다. 의 데이터 문자열 없음 예
    매치 유형 일치 유형이 다음과 같을지 여부를 나타내는 옵션입니다.
    • 정확히 일치
    • 대/소문자 구분
    • 지정된 문자를 포함합니다.
    		 데이터 입력 문자열 없음 예
    카운트 일치 항목의 총 발생 횟수를 반환합니다. 데이터 출력 정수 해당 사항 없음 해당 사항 없음
    아웃리스트 일치 목록을 반환합니다. 데이터 출력 목록 해당 사항 없음 해당 사항 없음

    항목 가져오기

    인덱스 값을 기준으로 목록 항목을 반환합니다.

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

    표 7. GetItem 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    인덱스 목록 항목의 인덱스 값입니다. 의 데이터 정수 없음 예
    반환 목록 항목을 반환합니다. 데이터 출력 객체 해당 사항 없음 해당 사항 없음

    GetItems

    인덱스 값을 기준으로 목록 항목을 반환합니다. 먼저 인덱스 값을 구성해야 합니다.

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

      데이터 출력 포트는 각 인덱스 값과 함께 작성됩니다. 데이터 출력 포트는 인덱스 값에 해당하는 목록 항목을 반환합니다.

    목록 가져오기

    작성된 모든 목록 항목과 목록을 반환합니다.

    표 8. GetList 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 목록 항목과 목록을 반환합니다. 데이터 출력 배열 없음 해당 사항 없음

    제거

    지정된 목록 항목을 제거합니다.

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

    표 9. GetList 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    항목 메서드가 제거하는 목록 항목입니다. 의 데이터 객체 없음 예

    모두 제거

    추가된 모든 목록 항목을 제거합니다.

    반전

    목록 항목의 인덱스 값 순서를 되돌려 놓습니다.

    SetItems (영문)

    목록 항목의 값을 업데이트합니다. 이 방법을 사용하려면 먼저 메서드를 구성해야 합니다.

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

      포트의 데이터는 각 인덱스 값과 함께 작성됩니다.

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

    표 10. SetItems 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    항목 목록 항목의 값을 허용합니다. 의 데이터 객체 없음 예

    정렬

    목록 항목을 정렬합니다.

    ToArray (영문)

    목록 항목을 배열 형태로 반환합니다. 이 메서드를 실행하기 전에 목록 항목을 두 개 이상 추가해야 합니다.

    표 11. ToArray 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 배열 목록의 형태로 목록 항목을 반환합니다. 데이터 출력 배열 목록 해당 사항 없음 해당 사항 없음