FTP 파일 이름 바꾸기 활동

FTP 파일 이름 바꾸기 활동을 사용하면 런타임 동안 파일의 이름을 바꾸고 및/또는 파일을 다른 디렉토리로 이동할 수 있습니다.

다음 지원 사례에는 FTP 파일 이름 바꾸기 활동이 이름을 바꾸는 디렉토리가 나와 있습니다. FTP 파일 이름 바꾸기 활동을 사용하는 프로젝트 예제는 디렉토리 목록 구문 분석 예제(디렉토리 목록 구문 분석 예제)를 참조하십시오.

기호 링크

FTP 파일 이름 바꾸기 활동은 다음과 같은 경우 디렉토리에 대한 기호 링크를 지원합니다. 특정 운영 체제에서 특정 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. 다음 표에 설명된 대로 이 분할창의 필드를 구성하십시오.
    표 1.
    필드 설명
    이름 바꾸기  
    이름 지정된 파일 이 활동에는 이 필드가 사용되지 않습니다. 입력 맵핑 태스크의 fromFilename 입력 매개변수를 사용하여 이름을 바꿀 파일의 이름을 지정합니다.
    가져올 디렉토리 통합 어플라이언스가 지정된 파일을 삭제하는 FTP 서버의 디렉토리를 지정합니다. 다음 옵션 중 하나를 사용하여 디렉토리를 지정할 수 있습니다.
    • 필드를 클릭하거나 다음 디렉토리 경로 중 하나를 입력하여 디렉토리 경로를 직접 입력합니다.
      • 상대 디렉토리 경로(예: /process). 이 경우 FTP 서버에 연결하는 사용자 계정에 FTP 홈이 구성된 것으로 가정합니다. 자세한 정보는 아래 노트를 참조하십시오.
      • 전체 디렉토리 경로(예를 들어, UNIX 시스템의 경우 /home/user/process)
    • 찾아보기...를 클릭하여 사용 가능한 디렉토리의 드롭 다운 목록을 채우십시오. 드롭 다운 목록에서 해당 디렉토리를 선택하십시오.
    주: UNIX: UNIX 시스템의 FTP 서버에 연결할 때 상대 디렉토리 경로를 지정하는 경우, FTP 서버에 연결하는 사용자 계정에 대해 /etc/password 파일에 FTP 홈 디렉토리가 올바르게 지정되었는지 확인하십시오.
    새 경로 이 활동에는 이 필드가 사용되지 않습니다. 새 FTP 서버의 새 파일 이름과 새 디렉토리를 포함하는 전체 경로를 지정합니다. 통합 어플라이언스는 입력 맵핑 태스크의 toPath 입력 매개변수를 사용하여 이동한 파일을 이 경로에 배치합니다.
    주: UNIX: UNIX 시스템의 FTP 서버에 연결할 때 상대 디렉토리 경로를 지정하는 경우, FTP 서버에 연결하는 사용자 계정에 대해 /etc/password 파일에 FTP 홈 디렉토리가 올바르게 지정되었는지 확인하십시오.
    옵션 - 다음 옵션 중 하나를 선택하여 지정된 출력 디렉토리에 이미 동일한 이름의 기존 파일이 있는 경우의 동작을 정의하십시오.
    중복 파일 이름이 있는 경우 기존 파일 겹쳐쓰기 파일이 이미 있는 경우 원래 파일의 컨텐츠를 활동에서 리턴된 새 데이터로 대체하도록 지정합니다.
    중복 이름을 사용하는 파일이 발견된 경우 오류 발생 파일이 이미 있는 경우 파일의 원래 데이터를 보존하고 오류를 발행한 후 활동에서 리턴된 새 데이터로 아무 작업도 수행하지 않는 것으로 지정합니다.

재시도 옵션 지정

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

    FTP 파일 이름 바꾸기 활동이 포함된 오케스트레이션을 배치한 상태에서 통합 어플라이언스가 지정된 FTP 서버에 연결할 수 없는 경우, 통합 어플라이언스는 재시도 횟수 값에 도달할 때까지 시스템 및 오케스트레이션 로그에 연결 오류를 경고로 로그합니다. 재시도 횟수에 도달하면 통합 어플라이언스가 시스템 및 오케스트레이션 로그에 오류를 로그하고 현재 오케스트레이션 작업 처리를 중지합니다.

    예를 들어, 재시도 횟수를 3으로 설정한 경우 첫 번째, 두 번째 및 세 번째 연결 오류가 시스템 로그에 경고로 나타납니다. 통합 어플라이언스가 네 번째 연결 오류를 오류로 로그하고 현재 오케스트레이션 작업 처리를 중지합니다.

활동의 입력 맵핑

  1. 점검 목록에서 입력 맵핑 태스크를 선택하십시오. 재시도 분할창이 표시됩니다. 활동의 입력 매개변수가 활동으로 분할창에 표시됩니다.
  2. 다음 입력 매개변수에는 변수를 맵핑해야 합니다.
    • fromFilename - 이 매개변수는 동일한 조치에서 이름을 바꿀 파일의 원래 이름을 지정합니다.
    • toPath - 이 매개변수는 이름 바꾸기 조치에서 새 디렉토리 이름과 파일의 새 이름을 포함하는 경로를 지정합니다. 예를 들어, fileNewName.txt 파일 이름을 사용하여 FTP 서버 루트의 /output 디렉토리로 파일이 이동되도록 지정하려면 toPath/output/fileNewName.txt 값을 지정하십시오.

      다른 모든 입력 매개변수는 선택적입니다. 맵핑에 대한 일반 지시사항은 맵 작성을 참조하십시오.  

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

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

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

      표 3.
      입력 매개변수 이름/노드 설명 대체되는 구성 태스크의 설정
      fromDirectory 통합 어플라이언스가 파일 목록을 가져오는 FTP 서버의 디렉토리를 지정합니다. directory 입력 매개변수는 구성 태스크의 디렉토리 위치 필드를 대체합니다.
      overwrite 통합 어플라이언스가 엔드포인트와의 연결을 설정하려고 시도하는 시간과 엔드포인트가 연결 요청에 응답하는 시간 사이에 제한시간이 초과되기 전의 시간(초)을 지정합니다. FTP 파일 나열 활동의 경우에는 통합 어플라이언스가 제한시간이 초과되기 전에 FTP 서버와의 연결 설정을 시도하는 시간입니다. connection 입력 매개변수의 timeout 노드는 FTP 엔드포인트의 엔드포인트에 연결을 설정 중인 경우 {0}초 후에 제한시간 초과됩니다. 필드를 대체합니다.
      connection/timeout FTP 서버의 호스트 이름 또는 IP 주소를 지정합니다. connection 입력 매개변수의 timeout 노드는 FTP 엔드포인트의 엔드포인트에 연결을 설정 중인 경우 {0}초 후에 제한시간 초과됩니다. 필드를 대체합니다. 
      connection/host 지정된 호스트 이름의 포트 번호를 지정합니다. FTP 트래픽의 표준 포트는 21입니다. SFTP 트래픽의 기본 포트는 22입니다. 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 루프 활동을 사용하여 목록을 반복할 수 있습니다.