--- 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 --- # 커넥터 메서드 나열 # 커넥터 메서드 나열 {#ariaid-title1} * 릴리스 버전: Xanadu * * 업데이트 날짜 2024년 08월 01일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 4분 목록 커넥터 메서드는 자동화 워크플로의 일부로 목록 항목에 대한 다양한 작업을 수행합니다. 사용하기 전에 먼저 메서드를 노출해야 합니다. ## 추가 {#list-connector-methods__section_e4d_y5q_4tb} 단일 목록 항목을 추가합니다. 매개변수에 대한 입력을 제공하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다."). {#list-connector-methods__table_wpx_2wj_4tb__entry__6} | 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? | |-|-|-|-|-|-| | 항목 | 목록 항목의 이름입니다. | 의 데이터 | 객체 | 없음 | 예 | [표 1. 메서드 매개변수 추가] {#list-connector-methods__table_wpx_2wj_4tb} ## 추가 목록 {#list-connector-methods__section_gvd_hvq_4tb} 항목 목록을 추가합니다. 매개변수에 대한 입력을 제공하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다."). {#list-connector-methods__table_jsz_mvq_4tb__entry__7} | 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? | 참고 사항 | |-|-|-|-|-|-|-| | 목록 | 항목 목록입니다. | 의 데이터 | 객체 | 없음 | 예 | 변수 또는 적절한 구성요소에서 목록 항목을 전달할 수 있습니다. | [표 2. AddList 메서드 매개변수] {#list-connector-methods__table_jsz_mvq_4tb} ## 포함 {#list-connector-methods__section_mrr_5yq_4tb} 목록 항목이 존재하는지 여부에 따라 부울 값을 반환합니다. 매개변수에 대한 입력을 제공하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다."). {#list-connector-methods__table_j5t_czq_4tb__entry__6} | 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? | |-|-|-|-|-|-| | 항목 | 메서드가 검색하는 목록 항목의 이름입니다. | 의 데이터 | 객체 | 없음 | 예 | | 반환 | 목록 항목이 발견되면 True를 반환하고, 그렇지 않으면 False를 반환합니다. | 데이터 출력 | 부울 | 해당 사항 없음 | 해당 사항 없음 | [표 3. 메서드 매개변수 포함] {#list-connector-methods__table_j5t_czq_4tb} ## 카운트 {#list-connector-methods__section_mf2_mzq_4tb} 추가된 목록 항목의 총 개수를 반환합니다. {#list-connector-methods__table_os3_rzq_4tb__entry__6} | 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? | |-|-|-|-|-|-| | 반환 | 추가된 목록 항목의 총 개수를 반환합니다. | 데이터 출력 | 정수 | 해당 사항 없음 | 해당 사항 없음 | [표 4. 카운트 메서드 매개변수] {#list-connector-methods__table_os3_rzq_4tb} ## FindByProperty (영문) {#list-connector-methods__section_sl5_wzq_4tb} 지정된 키와 값을 기준으로 목록 항목을 찾습니다. 이 메서드를 실행하기 전에 하나 이상의 키 값 쌍 목록 항목을 생성해야 합니다. 매개변수에 대한 입력을 제공하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다."). {#list-connector-methods__table_mnd_y1r_4tb__entry__6} | 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? | |-|-|-|-|-|-| | 소품 | 키 값 쌍의 키입니다. | 의 데이터 | 문자열 | 없음 | 예 | | 값 | 키 값 쌍의 값입니다. | 의 데이터 | 문자열 | 없음 | 예 | | 찾음 | 목록 항목이 발견되면 True를 반환하고, 그렇지 않으면 False를 반환합니다. | 데이터 출력 | 부울 | 해당 사항 없음 | 해당 사항 없음 | | 항목 | Found 매개 변수가 True이면 메서드는 목록 항목을 반환합니다. | 데이터 출력 | 객체 | 해당 사항 없음 | 해당 사항 없음 | [표 5. FindByProperty 메서드 매개 변수] {#list-connector-methods__table_mnd_y1r_4tb} ## 텍스트 찾기 {#list-connector-methods__section_abs_vdr_4tb} 지정된 필터를 기반으로 목록 항목에서 텍스트 또는 정규 표현식을 찾고 텍스트 및 텍스트 자체의 총 발생 수를 반환합니다. 매개변수에 대한 입력을 제공하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다."). {#list-connector-methods__table_tjd_l2r_4tb__entry__6} | 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? | |-|-|-|-|-|-| | SearchText | 메서드가 목록 항목에서 검색하는 텍스트입니다. | 의 데이터 | 문자열 | 없음 | 예 | | 찾기자(FindBy) | 메서드가 텍스트 또는 정규 표현식을 검색하는지 여부를 나타내는 옵션입니다. | 의 데이터 | 문자열 | 없음 | 예 | | 매치 유형 | 일치 유형이 다음과 같을지 여부를 나타내는 옵션입니다. * 정확히 일치 * 대/소문자 구분 * 지정된 문자를 포함합니다. {#list-connector-methods__ul_ddc_4gr_4tb} | 데이터 입력 | 문자열 | 없음 | 예 | | 카운트 | 일치 항목의 총 발생 횟수를 반환합니다. | 데이터 출력 | 정수 | 해당 사항 없음 | 해당 사항 없음 | | 아웃리스트 | 일치 목록을 반환합니다. | 데이터 출력 | 목록 | 해당 사항 없음 | 해당 사항 없음 | [표 6. FindByProperty 메서드 매개 변수] {#list-connector-methods__table_tjd_l2r_4tb} ## 항목 가져오기 {#list-connector-methods__section_umn_44r_4tb} 인덱스 값을 기준으로 목록 항목을 반환합니다. 매개변수에 대한 입력을 제공하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다."). {#list-connector-methods__table_l1y_t4r_4tb__entry__6} | 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? | |-|-|-|-|-|-| | 인덱스 | 목록 항목의 인덱스 값입니다. | 의 데이터 | 정수 | 없음 | 예 | | 반환 | 목록 항목을 반환합니다. | 데이터 출력 | 객체 | 해당 사항 없음 | 해당 사항 없음 | [표 7. GetItem 메서드 매개 변수] {#list-connector-methods__table_l1y_t4r_4tb} ## GetItems {#list-connector-methods__section_nks_3pr_4tb} 인덱스 값을 기준으로 목록 항목을 반환합니다. 먼저 인덱스 값을 구성해야 합니다. 구성하려면 다음 단계를 수행합니다. 1. 방법 설정 아이콘( ![방법 설정 아이콘](). )을 클릭합니다. 2. 색인 추가 아이콘( ![색인 추가 아이콘.]())을 클릭합니다. 3. 인덱스 값을 입력합니다. 4. 인덱스 값의 데이터 유형을 업데이트합니다. 5. 이 단계를 반복하여 인덱스 값을 더 추가합니다. 6. 확인을 클릭합니다. 데이터 출력 포트는 각 인덱스 값과 함께 작성됩니다. 데이터 출력 포트는 인덱스 값에 해당하는 목록 항목을 반환합니다. {#list-connector-methods__ol_u52_xpr_4tb} ## 목록 가져오기 {#list-connector-methods__section_n4g_rrr_4tb} 작성된 모든 목록 항목과 목록을 반환합니다. {#list-connector-methods__table_hc4_xrr_4tb__entry__6} | 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? | |-|-|-|-|-|-| | 반환 | 목록 항목과 목록을 반환합니다. | 데이터 출력 | 배열 | 없음 | 해당 사항 없음 | [표 8. GetList 메서드 매개 변수] {#list-connector-methods__table_hc4_xrr_4tb} ## 제거 {#list-connector-methods__section_bzj_psr_4tb} 지정된 목록 항목을 제거합니다. 매개변수에 대한 입력을 제공하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다."). {#list-connector-methods__table_hxd_vsr_4tb__entry__6} | 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? | |-|-|-|-|-|-| | 항목 | 메서드가 제거하는 목록 항목입니다. | 의 데이터 | 객체 | 없음 | 예 | [표 9. GetList 메서드 매개 변수] {#list-connector-methods__table_hxd_vsr_4tb} ## 모두 제거 {#list-connector-methods__section_mbr_btr_4tb} 추가된 모든 목록 항목을 제거합니다. ## 반전 {#list-connector-methods__section_wcc_htr_4tb} 목록 항목의 인덱스 값 순서를 되돌려 놓습니다. ## SetItems (영문) {#list-connector-methods__section_cwd_25r_4tb} 목록 항목의 값을 업데이트합니다. 이 방법을 사용하려면 먼저 메서드를 구성해야 합니다. 구성하려면 다음 단계를 수행합니다. 1. 방법 설정 아이콘( ![방법 설정 아이콘](). )을 클릭합니다. 2. 색인 추가 아이콘( ![색인 추가 아이콘.]())을 클릭합니다. 3. 인덱스 값을 입력합니다. 4. 인덱스 값의 데이터 유형을 업데이트합니다. 5. 이 단계를 반복하여 인덱스 값을 더 추가합니다. 6. 확인을 클릭합니다. 포트의 데이터는 각 인덱스 값과 함께 작성됩니다. {#list-connector-methods__ol_e2j_q5r_4tb} 매개변수에 대한 입력을 제공하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다."). {#list-connector-methods__table_u3j_55r_4tb__entry__6} | 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? | |-|-|-|-|-|-| | 항목 | 목록 항목의 값을 허용합니다. | 의 데이터 | 객체 | 없음 | 예 | [표 10. SetItems 메서드 매개 변수] {#list-connector-methods__table_u3j_55r_4tb} ## 정렬 {#list-connector-methods__section_tlv_4wr_4tb} 목록 항목을 정렬합니다. ## ToArray (영문) {#list-connector-methods__section_pvj_kjs_4tb} 목록 항목을 배열 형태로 반환합니다. 이 메서드를 실행하기 전에 목록 항목을 두 개 이상 추가해야 합니다. {#list-connector-methods__table_ncv_5js_4tb__entry__6} | 매개변수 | 설명 | 데이터 포트 유형 | 데이터 유형 | 기본값 | 필수? | |-|-|-|-|-|-| | 반환 | 배열 목록의 형태로 목록 항목을 반환합니다. | 데이터 출력 | 배열 목록 | 해당 사항 없음 | 해당 사항 없음 | [표 11. ToArray 메서드 매개 변수] {#list-connector-methods__table_ncv_5js_4tb}