AntBot Studio > Activity > 흐름제어 > 반복문 > ForEach-파일
정의 (Description)
- 이 Activity는 특정 디렉토리 내의 모든 하위 파일을 순회하며 반복 작업을 수행할 수 있도록 합니다.
각 반복에서 파일 정보를 변수에 저장하며, 이를 활용하여 추가적인 처리를 수행할 수 있습니다.
Tip
- 기존
ForEach
Activity와 동일한 방식으로 동작하지만,ForEach-파일
은 특정 디렉토리 내의 파일만을 대상으로 반복합니다. - 별도의 필터링 옵션을 제공하여 특정 패턴의 디렉토리만 선택할 수 있습니다.
- 하위 디렉토리 포함 여부를 설정하여 재귀적으로 탐색할 수도 있습니다.
- 디렉토리 순서를 지정할 수 있어 이름순, 생성일순 등으로 정렬 가능합니다.
- 기존
속성 (Properties)
항목 | 설명 | 데이터타입 | 기본값 | 설정가능옵션 | |
---|---|---|---|---|---|
Common | |||||
Activity이름 | 해당 Activity의 이름을 설정합니다. - 기본값은 Activity명이며, 사용자가 직접 변경할 수 있습니다. |
String | ForEach-디렉토리 | ||
Input Common | |||||
정렬방법 | 디렉토리 내 파일을 순회하는 순서를 설정합니다. | Combobox | 이름 오름차순 | 이름 오름차순, 이름 내림차순, 생성일 오름차순, 생성일 내림차순, 수정일 오름차순, 수정일 내림차순 | |
필터 | 특정 패턴(예: "*", "*.txt")의 파일명을 가진 항목을 선택하도록 설정합니다. | String | * | *(애스터리스크, Asterisk)를 이용한 필터 조건 | |
하위디렉토리포함여부 | 체크하면 모든 하위 디렉토리를 재귀적으로 탐색합니다. | Checkbox | Off | On, Off | |
Output | |||||
Index | 반복 횟수를 0부터 시작하는 현재 index값을 반환 받을 변수를 설정합니다. | Int32 | Null |
액티비티 사용 예시 (Example Usage)
- 'ForEach-파일' 액티비티를 사용하여 로그 메세지를 출력해보는 예시
파일 탐색 조건 설정
a. 탐색할 디렉토리 경로 설정
- 예시 : 바탕화면 내
Antbot
디렉토리 경로 설정 - 설명 :
- 탐색할 디렉토리 경로를 직접 입력하거나, 변수(예: directoryPath)를 활용하여 설정할 수 있습니다.
- 우측 폴더 아이콘을 클릭하면 폴더 찾아보기를 통해 원하는 폴더를 직접 선택할 수도 있습니다.
b. 속성 값 설정
[Input Common > 정렬방법]
- 예시 :
이름 오름차순
- 설명 : 디렉토리 내 파일을 순회하는 순서를 설정합니다.
[Input Common > 필터]
- 예시 :
AntBot*
- 설명 : 특정 패턴(예: *, *.txt)을 입력하여 필터링할 수 있으며, *(애스터리스크) 기반의 조건만 지원됩니다. 미 입력 시, 전체 탐색됩니다.
- 예시 : 바탕화면 내
임시 변수를 활용한 로그 남기기
[임시 변수 설정]
- 예시 :
File
- 설명 : 기본적으로
File
로 설정되며, 별도의 변수 생성 없이 사용할 수 있습니다. 이 임시 변수는 사용자가 원하는 대로 변경할 수 있으며, 반복문을 통해 탐색된 각 파일 정보가 자동으로 저장됩니다. 이를 활용하면 파일의 다양한 속성을 조회할 수 있습니다.
- 예시 :
실행 후 결과 확인