Table of Contents

AntBot Studio > Activity > 흐름제어 > 반복문 > ForEach-디렉토리

정의 (Description)

  • 이 Activity는 특정 디렉토리 내의 모든 하위 디렉토리를 순회하며 반복 작업을 수행할 수 있도록 합니다. 각 반복에서 디렉토리 정보를 변수에 저장하며, 이를 활용하여 추가적인 처리를 수행할 수 있습니다.
    Tip
    • 기존 ForEach Activity와 동일한 방식으로 동작하지만, ForEach-디렉토리특정 디렉토리 내의 폴더만을 대상으로 반복합니다.
    • 별도의 필터링 옵션을 제공하여 특정 패턴의 디렉토리만 선택할 수 있습니다.
    • 하위 디렉토리 포함 여부를 설정하여 재귀적으로 탐색할 수도 있습니다.
    • 디렉토리 순서를 지정할 수 있어 이름순, 생성일순 등으로 정렬 가능합니다.

속성 (Properties)

항목 설명 데이터타입 기본값 설정가능옵션
Common
Activity이름 해당 Activity의 이름을 설정합니다.
- 기본값은 Activity명이며, 사용자가 직접 변경할 수 있습니다.
String ForEach-디렉토리
Input Common
정렬방법 디렉토리를 순회하는 순서를 설정합니다. Combobox 이름 오름차순 이름 오름차순, 이름 내림차순, 생성일 오름차순, 생성일 내림차순, 수정일 오름차순, 수정일 내림차순
필터 특정 패턴(예: "*", "AntBot*")의 디렉토리 명을 가진 항목만 선택하도록 설정합니다. 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. 임시 변수를 활용한 로그 남기기

      [임시 변수 설정]

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

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