FTP 파일 나열 활동

FTP 파일 나열 활동은 런타임 동안 FTP 서버에 연결하고 지정된 정규식을 사용하여 지정된 디렉토리 위치에서 파일 목록을 생성합니다. FTP 파일 목록 활동은 directoryListing 또는 fileListing 출력 매개변수를 사용하여 오케스트레이션에 파일 목록을 리턴합니다.

파일만 나열(NLST) 선택란을 지우면 디렉토리 권한, 시간소인 및 소유권을 포함하는 전체 디렉토리 목록이 directoryListing 출력 매개변수에 단일 문자열로 리턴됩니다. 전체 디렉토리 목록이 문자열로 리턴되면 플랫 파일 읽기 활동에 플랫 파일 스키마를 사용하여 디렉토리 목록을 구문 분석해야 합니다. 파일만 나열(NLST) 선택란을 선택하고 FTP 파일 나열 활동이 해당 FTP 서버의 디렉토리 목록 형식을 지원하는 경우, fileListing 출력 매개변수에는 파일 이름의 반복 구조만 리턴됩니다. 파일 이름의 반복 구조가 리턴되면 디렉토리 목록을 구문 분석하지 않아도 되며 For Each 또는 While 루프 활동을 사용하여 목록을 반복할 수 있습니다.

경우에 따라 FTP 디렉토리에 있는 파일 세트를 처리하기 위해 FTP 파일 목록 활동은 FTP 파일 가져오기, FTP 파일 배치, FTP 파일 삭제FTP 파일 이름 바꾸기 활동을 함께 사용해야 합니다. 그러나 다른 경우에는 FTP 디렉토리 폴 활동만 사용할 수 있습니다.

FTP 파일 나열 활동과 FTP 파일 가져오기, FTP 파일 배치, FTP 파일 삭제FTP 파일 이름 바꾸기 활동을 함께 사용하면 다음과 같은 경우 FTP 디렉토리에 있는 파일 세트를 처리할 수 있습니다.

기호 링크

런타임 동안 FTP 파일 나열 활동의 기호 링크에 대한 지원을 결정하는 요소는 다음과 같습니다. 특정 운영 체제에서 특정 FTP 서버에 대한 특정 기호 링크 지원을 판별하려면 운영 체제 및 FTP 서버 문서를 참조하십시오.

Microsoft FTP 엔드포인트로 서브디렉토리 처리

Microsoft IIS(Internet Information Services) FTP 엔드포인트의 경우, 서브디렉토리와 서브디렉토리 내 파일 처리 시 FTP 파일 나열 활동의 런타임 동작은 다음 예와 같이 활동의 구성 태스크에서 이름 지정된 파일 필드에 지정된 정규식에 따라 다릅니다.

오케스트레이션에 FTP 파일 나열 활동 추가

  1. 오케스트레이션을 작성하거나 여십시오. 오케스트레이션의 그래픽 표시가 나타납니다.
  2. 활동 탭을 선택하고 FTP 폴더를 펼치십시오.
  3. 파일 나열 활동을 오케스트레이션으로 끌어오십시오.
  4. 활동을 선택하십시오. 점검 목록이 표시됩니다.

FTP 엔드포인트 작성, 선택 또는 편집

  1. 점검 목록에서 엔드포인트 선택 태스크를 클릭하고 다음 조치 중 하나를 선택하십시오.
    • 기존 엔드포인트를 선택하십시오.
      1. 찾아보기를 선택하십시오. 프로젝트 탐색기가 표시됩니다.
        주의: 디렉토리 구조가 원래 FTP 엔드포인트와 다른 새 FTP 엔드포인트를 지정하면 런타임 동안 오케스트레이션 작업이 실패할 수 있습니다. 원래 지정된 FTP 서버의 디렉토리 구조와 일치하는 새 FTP 서버를 지정하거나 아래 "활동 구성" 프로시저의 설명대로 찾아보기를 클릭하여 디렉토리 위치 필드의 구성된 디렉토리를 변경해야 합니다.
      2. 기존 엔드포인트를 선택하고 확인을 클릭하십시오. "활동 구성" 프로시저로 건너뛰십시오.
    • 기존 엔드포인트를 선택하고 편집하십시오.
      1. 찾아보기를 선택하십시오. 프로젝트 탐색기가 표시됩니다.
      2. 기존 엔드포인트를 선택하고 확인을 클릭하십시오.
        주의: 디렉토리 구조가 원래 FTP 엔드포인트와 다른 새 FTP 엔드포인트를 지정하면 런타임 동안 오케스트레이션 작업이 실패할 수 있습니다. 원래 지정된 FTP 서버의 디렉토리 구조와 일치하는 새 FTP 서버를 지정하거나 아래 "활동 구성" 프로시저의 설명대로 찾아보기를 클릭하여 디렉토리 위치 필드의 구성된 디렉토리를 변경해야 합니다.
      3. 편집을 클릭하십시오. 엔드포인트 편집 분할창이 표시됩니다.
    • 새로 작성을 선택하여 새 엔드포인트를 작성하십시오. 엔드포인트 작성 분할창이 표시됩니다.
  2. FTP 엔드포인트를 작성 또는 편집하십시오(FTP 엔드포인트 작성 또는 편집).

활동 구성

  1. 점검 목록에서 구성 태스크를 선택하십시오. 구성 분할창이 표시됩니다.
  2. 다음 표에 설명된 대로 이 분할창에 모든 필드를 구성하십시오.
    표 2.
    필드 설명
    디렉토리 위치 통합 어플라이언스가 지정된 파일을 삭제하는 FTP 서버의 디렉토리를 지정합니다. 다음 옵션 중 하나를 사용하여 디렉토리를 지정할 수 있습니다.
    • 필드를 클릭하거나 다음 디렉토리 경로 중 하나를 입력하여 디렉토리 경로를 직접 입력합니다.
      • 상대 디렉토리 경로(예: /process). 이 경우 FTP 서버에 연결하는 사용자 계정에 FTP 홈이 구성된 것으로 가정합니다. 자세한 정보는 아래 노트를 참조하십시오.
      • 전체 디렉토리 경로(예를 들어, UNIX 시스템의 경우 /home/user/process)
    • 찾아보기...를 클릭하여 사용 가능한 디렉토리의 드롭 다운 목록을 채우십시오. 드롭 다운 목록에서 해당 디렉토리를 선택하십시오.
    주: UNIX: UNIX 시스템의 FTP 서버에 연결할 때 상대 디렉토리 경로를 지정하는 경우, FTP 서버에 연결하는 사용자 계정에 대해 /etc/password 파일에 FTP 홈 디렉토리가 올바르게 지정되었는지 확인하십시오.
    이름 지정된 파일 FTP 서버에서 가져올 파일 이름을 정의하는 패턴 또는 정규식을 지정합니다. 정규식 처리는 FTP 서버가 수행합니다. 자세한 정보는 정규식에 대한 FTP 서버 문서를 참조하십시오. 일반적으로 FTP 서버가 정규식에서 지원하는 와일드카드는 다음과 같습니다.
    • * - 문자가 없거나 하나 이상의 문자
    • ? - 문자가 없거나 하나의 문자
    주: 정규식 처리는 FTP 서버에서 수행되므로 대소문자 구분은 FTP 서버가 판별합니다. FTP 서버가 대소문자를 구분하는 경우에는 FTP 디렉토리 폴 활동이 수행하는 파일 일치 또한 대소문자를 구분합니다.
    파일만 나열(NLST) 파일만 나열(NLST) 선택란은 런타임 동안 테스트 단추가 리턴하는 디렉토리 목록 유형을 결정합니다. 또한 이 선택란은 fileListing 또는 directoryListing 출력 매개변수가 출력 맵핑 태스크에 표시되고 런타임 동안 활동으로 리턴되는지 여부를 정의합니다.
    • 파일만 나열(NLST) 선택란을 선택하고 테스트 단추를 클릭하면 다음 목록 예제와 같이 파일 이름만 리턴됩니다.
      bidAcmeInc.txtbidBudgetManufacture.txtbidCrankCo.txtbidSamAndSons.txtbidWidgetRUs.txt
      또한 파일만 나열(NLST) 선택란을 선택하면 fileListing 출력 매개변수가 출력 맵핑 태스크에 나열됩니다. 런타임 동안에는 fileListing 출력 매개변수의 fileNames 보고 노드에 fileName 세트가 리턴됩니다. 이 예제의 경우, fileListing/fileName 반복 요소의 첫 번째 인스턴스는 bidAcmeInc.txt이고 fileListing/fileName 반복 요소의 두 번째 인스턴스는 bidBudgetManufacture.txt입니다.
    • 파일만 나열(NLST) 선택란을 지우고 테스트 단추를 클릭하면 다음 목록 예제와 같이 디렉토리 권한, 시간소인 및 소유권을 포함하는 전체 디렉토리 목록이 리턴됩니다.
      -rw-r--r--   1 551
           551
                 65
      May  3 11:39 bidAcmeInc.txt-rw-r--r--   1 551
           551
                 43
      May  3 11:39 bidBudgetManufacture.txt-rw-r--r--   1 551
           551
                  0
      May  3 11:39 bidCrankCo.txt-rw-r--r--   1 551
           551
                 73
      May  3 11:39 bidSamAndSons.txt-rw-r--r--   1 551      551            33 May  3 11:39 bidWidgetRUs.txt
      또한 파일만 나열(NLST) 선택란을 선택하면 directoryListing 출력 매개변수가 출력 맵핑 태스크에 나열됩니다. 런타임 동안 전체 디렉토리 목록은 단일 문자열로 제공되며 directoryListing 출력 매개변수를 사용하여 리턴됩니다.

재시도 옵션 지정

  1. 점검 목록에서 재시도 태스크를 선택하십시오. 재시도 분할창이 표시됩니다.
  2. FTP 서버에 연결하는 데 사용할 재시도 옵션을 구성하십시오. 다음 표에는 FTP 서버에 연결하는 데 사용되는 재시도 옵션이 정의되어 있습니다.
    표 3.
    필드 설명
    재시도  
    1) 각 재시도 사이에 ___초 동안 대기합니다. FTP 서버에 대한 연결 설정을 시도하기 전에 통합 어플라이언스가 대기하는 시간(초)
    2) 실패 전에 ___번 연결을 시도합니다. 오류가 발생하기 전에 통합 어플라이언스가 FTP 서버에 연결을 설정하려고 시도하는 최대 재시도 횟수를 지정합니다.

    FTP 파일 나열 활동으로 시작되는 오케스트레이션이 배치된 상태에서 통합 어플라이언스가 지정된 FTP 서버에 연결할 수 없는 경우, 통합 어플라이언스는 재시도 횟수 값에 도달할 때까지 시스템 로그에 연결 오류를 경고로 로그합니다. 재시도 횟수에 도달하면 통합 어플라이언스가 시스템 로그에 오류를 로그하고, 연결 오류 횟수가 0으로 재설정되며, FTP 서버에 연결을 설정하려고 계속 시도합니다.

    예를 들어, 재시도 횟수를 3으로 설정한 경우 첫 번째, 두 번째 및 세 번째 연결 오류가 시스템 로그에 경고로 나타납니다. 통합 어플라이언스는 네 번째 연결 오류를 오류로 로그하고 연결 오류 횟수를 0으로 재설정합니다. 따라서 다섯 번째 연결 오류는 시스템 로그에 경고로 표시됩니다. 통합 어플라이언스는 FTP 서버에 연결을 설정하려고 계속 시도합니다.

활동의 입력 맵핑

  1. 점검 목록에서 입력 맵핑 태스크를 선택하십시오. 재시도 분할창이 표시됩니다. 활동의 입력 매개변수가 활동으로 분할창에 표시됩니다.
  2. FTP 파일 나열 활동의 입력 매개변수를 맵핑할 수도 있습니다. FTP 파일 나열 활동에는 다음과 같은 선택적 입력 매개변수가 있습니다.
    • directory
    • connection

    다음 표에 나열된 입력 매개변수가 입력 맵핑 분할창의 활동으로 분할창에 표시되지 않으면 도구 모음 메뉴에서 > 선택적 매개변수 표시를 선택하거나 활동으로 분할창에서 마우스 오른쪽 단추를 클릭하고 선택적 매개변수 표시 옵션을 선택하십시오. 도구 모음 메뉴에서 > 선택적 매개변수 표시 옵션을 선택할 수 없는 경우 입력 맵핑 분할창에서 노드를 클릭하여 이 옵션을 활성화하십시오.

    다음 표에 정의된 입력 매개변수를 사용하여, 런타임 동안 점검 목록구성엔드포인트 선택 태스크에 동적으로 지정한 설정을 선택적으로 대체할 수 있습니다.

    예를 들어, FTP 서버에서 통합 어플라이언스가 파일 목록을 가져오는 디렉토리는 구성 태스크에서 input 디렉토리로 설정할 수 있습니다. 런타임 동안 디렉토리 이름 inputXMLdirectory 입력 매개변수를 사용하여 활동으로 전달할 수 있습니다. 런타임 동안 동적으로 지정된 디렉토리 이름은 구성 분할창에서 지정된 원래 설정을 대체합니다. 이 예제에서는 파일 목록이 inputXML 디렉토리에서 생성됩니다.

표 4.
입력 매개변수 이름/노드 설명 대체되는 구성 태스크의 설정
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 엔드포인트의 비밀번호 필드를 대체합니다.

활동의 출력 맵핑

  1. 점검 목록에서 출력 맵핑 태스크를 선택하십시오. directoryListing 또는 fileListing 출력 매개변수는 활동에서 분할창에 표시됩니다.
  2. directoryListing 또는 fileListing 출력 매개변수를 변수로 맵핑하십시오. 맵핑에 대한 지시사항은 맵핑 작성을 참조하십시오.

FTP 파일 나열 활동은 런타임 동안 directoryListing 또는 fileListing 출력 매개변수를 사용하여 오케스트레이션으로 파일 목록을 리턴합니다.

구성 태스크에서 파일만 나열(NLST) 선택란을 지우면 디렉토리 권한, 시간소인 및 소유권을 포함하는 전체 디렉토리 목록이 directoryListing 출력 매개변수에 단일 문자열로 리턴됩니다. 전체 디렉토리 목록이 문자열로 리턴되면 플랫 파일 읽기 활동에 플랫 파일 스키마를 사용하여 디렉토리 목록을 구문 분석해야 합니다. 플랫 파일 스키마는 플랫 파일 스키마 편집기를 사용하여 작성할 수 있습니다. 플랫 파일 스키마를 사용하여 디렉토리 목록을 구문 분석하는 오케스트레이션 예제는 디렉토리 목록 구문 분석 예제(디렉토리 목록 구문 분석 예제)를 참조하십시오.

파일만 나열(NLST) 선택란을 선택하고 FTP 파일 나열 활동이 해당 FTP 서버의 디렉토리 목록 형식을 지원하는 경우, fileListing 출력 매개변수에는 파일 이름의 반복 구조만 리턴됩니다. 파일 이름의 반복 구조가 리턴되면 디렉토리 목록을 구문 분석하지 않아도 되며 For Each 또는 While 루프 활동을 사용하여 목록을 반복할 수 있습니다.