감시 폴더 만들기 또는 구성 create-or-configure-a-watched-folder

화면 왼쪽 상단에서 Adobe Experience Manager 아이콘을 선택합니다.

도구 > Forms > 감시 폴더 구성을 선택합니다. 이미 구성된 감시 폴더의 목록이 표시됩니다.

새로 만들기 ​를 선택합니다. 감시 폴더를 만드는 데 필요한 필드 목록이 표시됩니다.

• 이름: 감시 폴더를 식별합니다. 이름에는 영숫자만 사용하십시오.

• 경로: 감시 폴더 위치를 지정합니다. 클러스터된 환경에서 이 설정은 클러스터의 다른 노드에서 AEM을 실행하는 모든 사용자가 액세스할 수 있는 공유 네트워크 폴더를 가리켜야 합니다.

• 다음을 사용하여 파일 처리: 시작할 프로세스 유형. 워크플로우, 스크립트 또는 서비스를 지정할 수 있습니다.

• 서비스 이름/스크립트 경로/워크플로 경로: 필드의 동작은 다음을 사용하여 파일 처리 필드에 지정된 값을 기반으로 합니다. 다음 값을 지정할 수 있습니다.

  • 워크플로우에 대해 실행할 워크플로우 모델을 지정합니다. 예: /etc/workflow/models/<workflow_name>/jcr:content/model
  • 스크립트에 대해 실행할 스크립트의 JCR 경로를 지정합니다. 예: /etc/watchfolder/test/testScript.ecma
  • 서비스의 경우 OSGi 서비스를 찾는 데 사용되는 필터를 지정합니다. 이 서비스는 com.adobe.aemfd.watchfolder.service.api.ContentProcessor 인터페이스의 구현으로 등록됩니다. 예를 들어 다음 코드는 사용자 지정(foo=bar) 속성이 있는 ContentProcessor 인터페이스의 사용자 지정 구현입니다.

@Component(metatype = true, immediate = true, label = "WF Test Service", description = "WF Test Service")
@Service(value = {OutputWriter.class, ContentProcessor.class})
@Property(name = "foo", value = "bar")
public class OutputWriter implements ContentProcessor {

• 출력 파일 패턴: 감시 폴더에서 출력 파일 및 폴더의 이름과 위치를 결정하는 데 사용하는 패턴의 세미콜론(;)으로 구분된 목록을 지정합니다. 파일 패턴에 대한 자세한 내용은 파일 패턴 정보를 참조하십시오.

고급 ​을 선택합니다. 고급 탭에는 더 많은 필드가 포함되어 있습니다. 이러한 필드는 대부분 기본값이 포함되어 있습니다.

• 페이로드 매퍼 필터: 감시 폴더를 만들면 감시 대상 폴더 내에 폴더 구조가 만들어집니다. 폴더 구조에는 단계, 결과, 유지, 입력 및 실패 폴더가 있습니다. 폴더 구조는 워크플로우에 대한 입력 페이로드의 역할을 하며 워크플로우의 출력을 수락할 수 있습니다. 필요한 경우 실패 지점을 나열할 수도 있습니다. 페이로드의 구조가 감시 폴더의 구조와 다릅니다. 감시 폴더의 구조를 페이로드에 매핑하는 사용자 지정 스크립트를 작성할 수 있습니다. 이러한 스크립트를 페이로드 매퍼 필터라고 합니다. 두 가지 기본 페이로드 매퍼 구현을 사용할 수 있습니다. 사용자 지정 구현이 없는 경우 기본 구현 중 하나를 사용하십시오.

  • 기본 매퍼: 기본 페이로드 매퍼를 사용하여 감시 폴더의 입력 및 출력 내용을 페이로드의 개별 입력 및 출력 폴더에 유지합니다.
  • 단순 파일 기반 페이로드 매퍼: 단순 파일 기반 페이로드 매퍼를 사용하여 입력 및 출력 내용을 페이로드 폴더에 직접 보관합니다. 기본 매퍼와 같은 추가 계층은 생성되지 않습니다.

• 실행 모드: 워크플로 실행에 허용된 실행 모드를 쉼표로 구분한 목록을 지정하십시오.

• 다음 시간 이후에 준비된 파일 시간 초과: 처리를 위해 이미 선택된 입력 파일/폴더가 시간 초과로 처리되고 오류로 표시될 때까지 대기할 시간(초)을 지정합니다. 시간 제한 메커니즘은 이 속성의 값이 양수인 경우에만 활성화됩니다.

• 스로틀 시 시간 초과된 스테이지 파일 삭제: 활성화된 경우, 감시 폴더에 대해 스로틀링이 설정되어 있을 때만 시간 초과된 스테이지 파일 삭제 메커니즘이 활성화됩니다.

• 다음 간격 후 입력 폴더 검색: 감시 폴더에서 입력을 검색하는 시간 간격(초)을 지정합니다. 스로틀 설정을 사용하지 않으면 폴링 간격이 평균 작업을 처리하는 시간보다 길어야 합니다. 그렇지 않으면 시스템이 오버로드될 수 있습니다. 간격 값은 1보다 크거나 같아야 합니다.

• 파일 패턴 제외: 감시 폴더에서 검색하고 가져올 파일과 폴더를 결정하는 데 사용하는 세미콜론(;)으로 구분된 패턴 목록을 지정합니다. 지정된 패턴의 파일 또는 폴더는 처리를 위해 스캔되지 않습니다. 파일 패턴에 대한 자세한 내용은 파일 패턴 정보를 참조하십시오.

• 파일 패턴 포함: 감시 폴더에서 검색하고 가져올 폴더 및 파일을 결정하는 데 사용하는 세미콜론(;)으로 구분된 패턴 목록을 지정합니다. 예를 들어, [파일 패턴 포함]이 input*이면 input*와 일치하는 모든 파일과 폴더가 선택됩니다. 기본값은 *이며 모든 파일과 폴더를 나타냅니다. 파일 패턴에 대한 자세한 내용은 파일 패턴 정보를 참조하십시오.

• 대기 시간: 폴더 또는 파일을 만든 후 스캔하기 전에 대기할 시간(밀리초)을 지정합니다. 예를 들어 대기 시간이 3,600,000밀리초(1시간)이고 1분 전에 파일을 만든 경우 59분 이상 경과하면 이 파일이 선택됩니다. 기본값은 0입니다.

  이 설정은 파일 또는 폴더의 모든 콘텐츠가 입력 폴더에 복사되도록 하는 데 유용합니다. 예를 들어 처리할 대형 파일이 있고 파일을 다운로드하는 데 10분이 걸리는 경우 대기 시간을 10*60 *1000밀리초로 설정합니다. 이 간격은 감시 폴더가 10분이 되지 않은 경우 파일을 스캔하지 못하도록 합니다.

• 다음보다 오래된 결과 삭제: 지정한 값보다 오래된 파일 및 폴더를 삭제하기 전에 대기할 시간(일 수)을 지정합니다. 이 설정은 결과 폴더가 꽉 차지 않도록 하는 데 유용합니다. -1일 값은 결과 폴더를 삭제하지 않음을 나타냅니다. 기본값은 -1입니다.

• 결과 폴더 이름: 결과를 저장할 폴더의 이름을 지정합니다. 결과가 이 폴더에 표시되지 않으면 실패 폴더를 확인하십시오. 읽기 전용 파일은 처리되지 않고 실패 폴더에 저장됩니다. 다음 파일 패턴을 사용하여 절대 경로 또는 상대 경로를 사용할 수 있습니다.

  • %F = 파일 이름 접두사
  • %E = 파일 이름 확장명
  • %Y = 연도(전체)
  • %y = 연도(마지막 두 자리)
  • %M = 월
  • %D = 일
  • %d = 일(연 기준)
  • %H = 시간(24시간 시계)
  • %h = 시간(12시간 시계)
  • %m = 분
  • %s = 초
  • %l = 밀리초
  • %R = 난수(0-9 사이)
  • %P = 프로세스 또는 작업 ID
  • 예를 들어, 2009년 7월 17일 오후 8시이고 C:/Test/WF0/failure/%Y/%M/%D/%H/를 지정한 경우 결과 폴더는 C:/Test/WF0/failure/2009/07/17/20입니다.
  • 경로가 절대적이 아니라 상대적이면 폴더가 감시 폴더 내에 만들어집니다. 기본값은 감시 폴더 내의 결과 폴더인 result/%Y/%M/%D/입니다. 파일 패턴에 대한 자세한 내용은 파일 패턴 정보를 참조하십시오.

• 실패 폴더 이름: 실패한 파일을 저장할 폴더를 지정하십시오. 이 위치는 항상 감시 폴더를 기준으로 합니다. 결과 폴더에 설명된 대로 파일 패턴을 사용할 수 있습니다.

• 폴더 이름 유지: 검사 및 픽업 후 파일이 저장되는 폴더를 지정합니다. 경로는 절대 디렉토리, 상대 디렉토리 또는 null 디렉토리일 수 있습니다. 결과 폴더에 설명된 대로 파일 패턴을 사용할 수 있습니다. 기본값은 preserve/%Y/%M/%D/입니다.

• 일괄 처리 크기: 검사당 선택할 파일 또는 폴더 수를 지정합니다. 시스템의 과부하를 방지합니다. 한 번에 너무 많은 파일을 스캔하면 충돌이 발생할 수 있습니다. 기본값은 2입니다.

  스캔 간격이 작으면 스레드에서 종종 입력 폴더를 스캔합니다. 감시 폴더에 파일이 자주 드롭되는 경우 스캔 간격을 작게 유지해야 합니다. 파일을 자주 삭제하지 않는 경우 다른 서비스가 스레드를 사용할 수 있도록 스캔 간격을 크게 사용합니다.

• 스로틀 사용: 이 옵션을 활성화하면 지정된 시간에 AEM Forms에서 처리하는 감시 폴더 작업 수가 제한됩니다. 배치 크기 값은 최대 작업 수를 결정합니다. 자세한 내용은 조절을 참조하십시오.

• 유사한 이름으로 기존 파일 덮어쓰기: True로 설정하면 결과 폴더의 파일을 덮어쓰고 폴더를 유지합니다. False로 설정하면 이름에 숫자 인덱스 접미사가 있는 파일과 폴더가 사용됩니다. 기본값은 False입니다.

• 실패 시 파일 유지: True로 설정하면 오류가 있는 경우 입력 파일이 유지됩니다. 기본값은 true입니다.

• 패턴을 가진 파일 포함: 감시 폴더가 검사하고 가져올 폴더와 파일을 결정하는 데 사용하는 패턴의 세미콜론(;) 구분 목록을 지정합니다. 예를 들어, [파일 패턴 포함]을 입력하면 입력과 일치하는 모든 파일과 폴더가 선택됩니다. 자세한 내용은 관리 도움말을 참조하세요.

• 비동기적으로 감시 폴더 호출: 호출 유형을 비동기 또는 동기화로 식별합니다. 기본값은 비동기입니다. 비동기식은 수명이 긴 프로세스에 대해 권장되는 반면, 동기식은 수명이 짧은 프로세스에 대해 권장됩니다.

• 감시 폴더 사용: 이 옵션을 사용하면 감시 폴더가 사용됩니다. 기본값은 True입니다.