반복자 관련 조건

루프 반복자는 하나의 루프 내의 현재 반복을 추적하는 변수입니다. 이는 루프가 실행되는 횟수를 제어하고 각 반복 중에 목록이나 배열의 요소에 액세스하는 데 사용됩니다.

예를 들어, 항목 목록을 반복하는 경우 루프 반복자는 루프가 완료될 때까지 각 항목에 하나씩 액세스할 수 있게 해줍니다. 루프 패키지는 루프 반복을 제어하기 위해 여러 가지 반복자 조건을 제공합니다.
표 1. 루프 반복자
반복자 설명
CSV/TXT의 각 행 대상 지정된 CSV 또는 텍스트 파일의 각 행을 대상으로 일련의 작업을 반복하고 현재 행의 값을 기록 변수에 지정합니다. CSV/TXT의 각 행 대상 반복자 사용 항목을 참조하십시오.
데이터 테이블의 각 행 대상 지정된 테이블의 각 행을 대상으로 일련의 작업을 반복하고 현재 행의 값을 기록 변수에 지정합니다. 테이블의 각 행에 대해 반복자 사용 항목을 참조하십시오.
SQL 쿼리 데이터 세트의 각 행 대상 지정된 SQL 쿼리 데이터세트의 각 행을 대상으로 일련의 작업을 반복하고 현재 행의 값을 기록 변수에 지정합니다. 데이터베이스와의 연결을 설정하는 데 이용한 세션 이름을 제시합니다.
사전의 각 키 대상 지정된 사전 변수의 각 키에 대해 작업 세트를 반복하고 현재 키의 이름을 변수에 지정합니다.
주: bot이 사전 > Put 작업이 포함된 루프 작업을 실행하면, bot은 사전에 있는 원래 항목 수만 반복하며, Put 작업을 사용하여 삽입된 항목은 무시합니다.
사전의 각 값 대상 지정된 사전 변수의 각 값을 대상으로 일련의 작업을 반복하고 현재 값을 변수에 지정합니다. 이 변수 형식은 다양한 하위 유형(String, Number, Boolean 등)을 포함할 수 있으므로 작업을 구성할 때 변수를 신속하게 생성하면 그 변수는 Any 유형을 취할 수 있습니다.
주: bot이 사전 > Put 작업이 포함된 루프 작업을 실행하면, bot은 사전에 있는 원래 항목 수만 반복하며, Put 작업을 사용하여 삽입된 항목은 무시합니다.
사서함의 각 메일 대상 지정된 사서함의 각 이메일을 대상으로 일련의 작업을 반복합니다. 사서함의 각 메일에 대한 반복자 사용 항목을 참조하십시오.
워크시트의 각 행 대상(Excel 기본 또는 Excel 고급) 워크시트의 데이터 내 데이터가 포함된 각 행을 대상으로 일련의 작업을 반복하고 현재 행의 값을 기록 변수에 지정합니다. Excel 기본 또는 Excel 고급 워크시트를 여는 데 이용한 세션 이름을 제공합니다. 작업 반복 대상을 모든 행, 지정된 행 또는 지정된 셀 범위로 지정할 수 있습니다. 현재 행을 이 변수에 지정 목록에서 기록 변수를 선택하거나 새 변수를 생성합니다. 기록 변수 항목을 참조하십시오.
이 반복자는 문자열 데이터 유형으로 셀 값을 검색합니다. 이는 숫자, 백분율, 통화, 과학 및 날짜를 포함한 Excel 셀 형식을 지원합니다. 예를 들어, 통화 값을 가진 셀의 값은 테이블 또는 기록 변수로 전달될 때 통화 기호를 그대로 유지합니다.
  • 문자열이 아닌 작업을 수행하려면 값을 변환해야 합니다.
  • Excel 고급에서, 루프 반복자를 워크시트의 각 행 대상으로 선택할 경우에는, 읽기 옵션으로 보이는 텍스트를 읽을 것인지 또는 셀 값을 읽을 것인지 선택할 수 있습니다.

    예를 들어, 셀의 콘텐츠가 70%인 경우 셀 값 읽기 옵션은 % 형식은 무시하고 값을 70으로 읽는 반면, 보이는 텍스트 읽기 옵션은 내용을 70%로 읽게 됩니다.

    Recommendation: 보이는 텍스트를 읽는 것보다 더 나은 결과를 얻으려면 셀 값을 읽는 데에 셀 값 읽기 옵션을 이용합니다.

Excel 고급 패키지를 사용하여 Microsoft Excel 세션을 공유하기 위한 글로벌 세션 옵션은 이 옵션과 함께 사용할 수 없습니다.

대체 솔루션: 여러 셀 가져오기 작업을 사용하여 데이터를 datatable 변수에 저장한 다음 데이터 테이블 옵션을 선택한 상태에서 루프 패키지를 사용합니다.
폴더 내 각 파일 대상 지정된 폴더의 각 파일을 대상으로 일련의 작업을 반복하고 현재 파일의 속성을 두 개의 키가 포함된 사전 변수에 지정합니다 name 키에는 파일 이름이 있고 extension 키에는 파일 확장명이 있습니다.

파일 확장명이 다른 파일을 열려면 변수 옵션을 사용하여 폴더 경로, 파일 이름, 파일 확장명을 지정합니다. 먼저, 폴더 경로 $sFolder$에 대한 변수를 작성합니다. 그런 다음 폴더 경로에 있는 파일의 경우 파일 이름 $name$에 대한 변수와 파일 확장명 $extension$에 대한 변수를 각각 하나씩 두 개 만듭니다. 파일을 열려면 변수를 $sFolder$\$name$.$extension$와 같은 문자열로 결합합니다. 확장명이 다른 파일 유형과 다른 열기 옵션으로 작업하려면 조건부 로직을 추가할 수 있습니다.

폴더 내 각 폴더 대상 지정된 폴더의 각 폴더를 대상으로 일련의 작업을 반복하고 현재 폴더 이름을 문자열 변수에 지정합니다.

모든 하위 폴더 포함 옵션을 사용하여 숨겨진 폴더를 포함하고 폴더 내의 각 하위 폴더를 재귀적으로 반복합니다.
목록 내 각 항목 대상 지정된 목록의 각 항목을 대상으로 일련의 작업을 반복하고 현재 항목을 변수에 지정합니다. 작업의 반복 대상을 목록 내 모든 항목으로 할 것인지, 또는 목록 내 항목의 범위를 지정할 것인지 지정할 수 있습니다. 이 변수 형식은 다양한 하위 유형(문자열, 숫자, 부울, 등)을 포함할 수 있으므로 작업을 구성할 때 변수를 신속하게 생성하면 그 변수는 모든 유형을 취할 수 있습니다.
주: 목록 내 인덱스는 0부터 시작합니다. 예를 들어, 목록의 세 번째 위치에서 여섯 번째 위치까지의 항목에 대해 작업을 반복하려면, 해당 필드에 2와 5를 지정해야 합니다.
n회 적용 지정된 횟수만큼 컨테이너에서 작업을 반복합니다. 반복 횟수를 숫자 변수에 지정할 수 있습니다.
레코드 내 각 변수 대상 지정된 레코드의 각 값을 대상으로 작업을 반복하고 현재 값을 변수에 지정합니다. 이 변수 형식은 다양한 하위 유형(String, Number, Boolean 등)을 포함할 수 있으므로 작업을 구성할 때 변수를 신속하게 생성하면 그 변수는 Any 유형을 취할 수 있습니다.
캘린더 내 각 회의 대상 지정된 달력 내 각 회의를 대상으로 일련의 작업을 반복하려면 이 옵션을 이용합니다. 루프에서 Microsoft 365 Calendar 작업 사용 항목을 참조하십시오.
워크시트의 각 행 대상(Microsoft 365 Excel) 워크시트에서 데이터를 포함하고 있는 각 행을 대상으로 일련의 작업을 반복합니다.
  • 워크시트를 여는 데 이용한 세션 이름을 제공합니다.
  • 작업 반복 대상을 모든 행으로 할지, 지정된 행으로 할지 지정합니다.
  • 현재 행의 값을 기록 변수에 지정할 수 있습니다.
(워크로드) 대기열의 각 작업 항목에 대해 대기열의 각 작업 항목에 대해 일련의 작업을 반복하고 작업 항목을 기록 변수에 할당합니다. 기록 변수는 workitemId, workitemValues, workitemMetadata, 세 가지 수정된 핵심 값을 반환합니다. 대기열의 각 작업 항목에 대해 반복자 사용 항목을 참조하십시오.
XML 데이터 세트의 각 노드 대상 XML 데이터세트의 각 노드를 대상으로 일련의 작업을 반복하고 현재 노드를 문자열 변수에 지정합니다. XML 파일을 여는 데 이용한 세션 이름을 제공합니다.