Table of Contents

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-파일' 액티비티를 사용하여 로그 메세지를 출력해보는 예시
    1. 파일 탐색 조건 설정

      a. 탐색할 디렉토리 경로 설정

      • 예시 : 바탕화면 내 Antbot 디렉토리 경로 설정
      • 설명 :
        • 탐색할 디렉토리 경로를 직접 입력하거나, 변수(예: directoryPath)를 활용하여 설정할 수 있습니다.
        • 우측 폴더 아이콘을 클릭하면 폴더 찾아보기를 통해 원하는 폴더를 직접 선택할 수도 있습니다.
      b. 속성 값 설정

      [Input Common > 정렬방법]

      • 예시 : 이름 오름차순
      • 설명 : 디렉토리 내 파일을 순회하는 순서를 설정합니다.

      [Input Common > 필터]

      • 예시 : AntBot*
      • 설명 : 특정 패턴(예: *, *.txt)을 입력하여 필터링할 수 있으며, *(애스터리스크) 기반의 조건만 지원됩니다. 미 입력 시, 전체 탐색됩니다.
    2. 임시 변수를 활용한 로그 남기기

      [임시 변수 설정]

      • 예시 : File
      • 설명 : 기본적으로 File로 설정되며, 별도의 변수 생성 없이 사용할 수 있습니다. 이 임시 변수는 사용자가 원하는 대로 변경할 수 있으며, 반복문을 통해 탐색된 각 파일 정보가 자동으로 저장됩니다. 이를 활용하면 파일의 다양한 속성을 조회할 수 있습니다.
    3. 실행 후 결과 확인

## 추가 관련 데이터 | 항목명 | 값 | | --- | --- | | 원본 매뉴얼 URL | /AntBot%20Studio/Activity/7.%20흐름제어/반복문/ForEach-파일/ktds.AntBot.Activities.BasicLib.ForEachFileInDirectory.ForEachFileInDirectoryActivity.html | | 패키지명 | ktds.AntBot.Activities.BasicLib.ForEachFileInDirectory.ForEachFileInDirectoryActivity | | 매뉴얼 ID | ktds.AntBot.Activities.BasicLib.ForEachFileInDirectory.ForEachFileInDirectoryActivity |