FTP 파일 나열 활동은 런타임 동안 FTP 서버에 연결하고 지정된 정규식을 사용하여 지정된 디렉토리 위치에서 파일 목록을 생성합니다. FTP 파일 목록 활동은 directoryListing 또는 fileListing 출력 매개변수를 사용하여 오케스트레이션에 파일 목록을 리턴합니다.
파일만 나열(NLST) 선택란을 지우면 디렉토리 권한, 시간소인 및 소유권을 포함하는 전체 디렉토리 목록이 directoryListing 출력 매개변수에 단일 문자열로 리턴됩니다. 전체 디렉토리 목록이 문자열로 리턴되면 플랫 파일 읽기 활동에 플랫 파일 스키마를 사용하여 디렉토리 목록을 구문 분석해야 합니다. 파일만 나열(NLST) 선택란을 선택하고 FTP 파일 나열 활동이 해당 FTP 서버의 디렉토리 목록 형식을 지원하는 경우, fileListing 출력 매개변수에는 파일 이름의 반복 구조만 리턴됩니다. 파일 이름의 반복 구조가 리턴되면 디렉토리 목록을 구문 분석하지 않아도 되며 For Each 또는 While 루프 활동을 사용하여 목록을 반복할 수 있습니다.
경우에 따라 FTP 디렉토리에 있는 파일 세트를 처리하기 위해 FTP 파일 목록 활동은 FTP 파일 가져오기, FTP 파일 배치, FTP 파일 삭제 및 FTP 파일 이름 바꾸기 활동을 함께 사용해야 합니다. 그러나 다른 경우에는 FTP 디렉토리 폴 활동만 사용할 수 있습니다.
기호 링크 대상... | 하드 기호 링크 | 소프트 기호 링크 | 노트 |
---|---|---|---|
파일 | 지원되지 않음 | 지원되지 않음 | FTP 파일 나열 활동은 파일에 대한 기호 링크를 파일로 해석하지 않으므로 런타임에서 FTP 파일 나열 활동이 파일에 대한 기호 링크를 처리하지 않습니다. |
디렉토리 | 지원됨 | 지원됨 |
필드 | 설명 |
---|---|
디렉토리 위치 | 통합 어플라이언스가 지정된 파일을
삭제하는 FTP 서버의 디렉토리를 지정합니다. 다음
옵션 중 하나를 사용하여 디렉토리를 지정할 수 있습니다.
주: UNIX: UNIX 시스템의 FTP
서버에 연결할 때 상대 디렉토리 경로를 지정하는 경우, FTP 서버에
연결하는 사용자 계정에 대해 /etc/password
파일에 FTP 홈 디렉토리가 올바르게 지정되었는지 확인하십시오.
|
이름 지정된 파일 | FTP 서버에서 가져올 파일 이름을
정의하는 패턴 또는 정규식을 지정합니다. 정규식
처리는 FTP 서버가 수행합니다. 자세한 정보는 정규식에
대한 FTP 서버 문서를 참조하십시오. 일반적으로 FTP
서버가 정규식에서 지원하는 와일드카드는 다음과 같습니다.
주: 정규식 처리는
FTP 서버에서 수행되므로 대소문자 구분은 FTP 서버가 판별합니다.
FTP 서버가 대소문자를 구분하는 경우에는 FTP 디렉토리 폴 활동이 수행하는 파일 일치 또한 대소문자를 구분합니다.
|
파일만 나열(NLST) | 파일만 나열(NLST)
선택란은 런타임 동안 테스트 단추가 리턴하는 디렉토리 목록 유형을
결정합니다. 또한 이 선택란은
fileListing 또는 directoryListing
출력 매개변수가 출력 맵핑 태스크에 표시되고
런타임 동안 활동으로 리턴되는지 여부를 정의합니다.
|
필드 | 설명 |
---|---|
재시도 | |
1) 각 재시도 사이에 ___초 동안 대기합니다. | FTP 서버에 대한 연결 설정을 시도하기 전에 통합 어플라이언스가 대기하는 시간(초) |
2) 실패 전에 ___번 연결을 시도합니다. | 오류가 발생하기 전에
통합 어플라이언스가 FTP 서버에 연결을 설정하려고
시도하는 최대 재시도 횟수를 지정합니다. FTP 파일 나열 활동으로 시작되는 오케스트레이션이 배치된 상태에서 통합 어플라이언스가 지정된 FTP 서버에 연결할 수 없는 경우, 통합 어플라이언스는 재시도 횟수 값에 도달할 때까지 시스템 로그에 연결 오류를 경고로 로그합니다. 재시도 횟수에 도달하면 통합 어플라이언스가 시스템 로그에 오류를 로그하고, 연결 오류 횟수가 0으로 재설정되며, FTP 서버에 연결을 설정하려고 계속 시도합니다. 예를 들어, 재시도 횟수를 3으로 설정한 경우 첫 번째, 두 번째 및 세 번째 연결 오류가 시스템 로그에 경고로 나타납니다. 통합 어플라이언스는 네 번째 연결 오류를 오류로 로그하고 연결 오류 횟수를 0으로 재설정합니다. 따라서 다섯 번째 연결 오류는 시스템 로그에 경고로 표시됩니다. 통합 어플라이언스는 FTP 서버에 연결을 설정하려고 계속 시도합니다. |
다음 표에 나열된 입력 매개변수가 입력 맵핑 분할창의 활동으로 분할창에 표시되지 않으면 도구 모음 메뉴에서 선택적 매개변수 표시 옵션을 선택하십시오. 도구 모음 메뉴에서 옵션을 선택할 수 없는 경우 입력 맵핑 분할창에서 노드를 클릭하여 이 옵션을 활성화하십시오.
를 선택하거나 활동으로 분할창에서 마우스 오른쪽 단추를 클릭하고다음 표에 정의된 입력 매개변수를 사용하여, 런타임 동안 점검 목록의 구성 및 엔드포인트 선택 태스크에 동적으로 지정한 설정을 선택적으로 대체할 수 있습니다.
예를 들어, FTP 서버에서 통합 어플라이언스가 파일 목록을 가져오는 디렉토리는 구성 태스크에서 input 디렉토리로 설정할 수 있습니다. 런타임 동안 디렉토리 이름 inputXML은 directory 입력 매개변수를 사용하여 활동으로 전달할 수 있습니다. 런타임 동안 동적으로 지정된 디렉토리 이름은 구성 분할창에서 지정된 원래 설정을 대체합니다. 이 예제에서는 파일 목록이 inputXML 디렉토리에서 생성됩니다.
입력 매개변수 이름/노드 | 설명 | 대체되는 구성 태스크의 설정 |
---|---|---|
directory | 통합 어플라이언스가 이 활동에서 생성된 파일을 배치하는 FTP 서버의 디렉토리를 지정합니다. | directory 입력 매개변수는 구성 태스크의 디렉토리 위치 필드를 대체합니다. |
connection/timeout | 통합 어플라이언스가 엔드포인트와의 연결을 설정하려고 시도하는 시간과 엔드포인트가 연결 요청에 응답하는 시간 사이에 제한시간이 초과되기 전의 시간(초)을 지정합니다. FTP 파일 삭제 활동의 경우에는 통합 어플라이언스가 제한시간이 초과되기 전에 FTP 서버와의 연결 설정을 시도하는 시간입니다. | connection 입력 매개변수의 timeout 노드는 FTP 엔드포인트의 엔드포인트에 연결을 설정 중인 경우 {0}초 후에 제한시간 초과됩니다. 필드를 대체합니다. |
connection/host | FTP 서버의 호스트 이름 또는 IP 주소를 지정합니다. | connection 입력 매개변수의 host 노드는 FTP 엔드포인트의 호스트 이름 필드를 대체합니다. |
connection/port | 지정된 호스트 이름의 포트 번호를 지정합니다. FTP 트래픽의 표준 포트는 21입니다. SFTP 트래픽의 기본 포트는 22입니다. | connection 입력 매개변수의 port 노드는 FTP 엔드포인트의 포트 필드를 대체합니다. |
connection/username | FTP 서버에 연결하는 데 사용되는 계정의 사용자 이름을 지정합니다. | connection 입력 매개변수의 username 노드는 FTP 엔드포인트의 사용자 이름 필드를 대체합니다. |
connection/password | FTP 서버에 연결하는 데 사용되는 계정의 비밀번호를 지정합니다. | connection 입력 매개변수의 password 노드는 FTP 엔드포인트의 비밀번호 필드를 대체합니다. |
FTP 파일 나열 활동은 런타임 동안 directoryListing 또는 fileListing 출력 매개변수를 사용하여 오케스트레이션으로 파일 목록을 리턴합니다.
구성 태스크에서 파일만 나열(NLST) 선택란을 지우면 디렉토리 권한, 시간소인 및 소유권을 포함하는 전체 디렉토리 목록이 directoryListing 출력 매개변수에 단일 문자열로 리턴됩니다. 전체 디렉토리 목록이 문자열로 리턴되면 플랫 파일 읽기 활동에 플랫 파일 스키마를 사용하여 디렉토리 목록을 구문 분석해야 합니다. 플랫 파일 스키마는 플랫 파일 스키마 편집기를 사용하여 작성할 수 있습니다. 플랫 파일 스키마를 사용하여 디렉토리 목록을 구문 분석하는 오케스트레이션 예제는 디렉토리 목록 구문 분석 예제(디렉토리 목록 구문 분석 예제)를 참조하십시오.
파일만 나열(NLST) 선택란을 선택하고 FTP 파일 나열 활동이 해당 FTP 서버의 디렉토리 목록 형식을 지원하는 경우, fileListing 출력 매개변수에는 파일 이름의 반복 구조만 리턴됩니다. 파일 이름의 반복 구조가 리턴되면 디렉토리 목록을 구문 분석하지 않아도 되며 For Each 또는 While 루프 활동을 사용하여 목록을 반복할 수 있습니다.