FTP 파일 넣기 활동

FTP 파일 넣기 활동은 런타임 동안 오케스트레이션의 변수에서 데이터를 가져와 파일에 배치한 후 FTP 서버에 연결하여 지정된 디렉토리 위치에 파일을 배치합니다.

FTP 파일 넣기 활동 사용 예는 시작하기 안내서를 참조하십시오.

전송 중단

런타임에서 FTP 파일 넣기 활동이 수행하는 파일 전송은 트랜잭션이 아니므로 보증할 수 없습니다. 예를 들어, 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. 점검 목록에서 전달 규칙 태스크를 선택하십시오. 전달 규칙 분할창이 표시됩니다. FTP 엔드포인트에 보안을 사용하지 않는 경우, 텍스트로 전송(ASCII)2진으로 전송(BINARY) 옵션을 사용합니다. FTP 엔드포인트에 보안을 사용하는 경우에는 파일 전송 유형이 항상 2진입니다.
  2. 다음 옵션 중 하나에서 통합 어플라이언스와 FTP 서버 간의 파일 전송 유형을 선택하십시오.
    • 텍스트(ASCII)로 전송 - 이 옵션은 HTML, XML, 기타 텍스트 파일과 같은 파일의 전송에 사용됩니다. 필요에 따라 행 끝이 변환되고 다른 텍스트 파일 변환이 뒤따릅니다.
      경고:
      이 옵션을 2진 파일에 사용하면 데이터가 손실될 수 있습니다.
    • 2진(BINARY)으로 전송 - 이 옵션은 2진 파일 전송에 사용됩니다. 통합 어플라이언스는 이 옵션을 사용하여 변환 없이 데이터를 전송합니다.

활동 구성

  1. 점검 목록에서 구성 태스크를 선택하십시오. 구성 분할창이 표시됩니다.
  2. 다음 표에 설명된 대로 이 분할창의 필드를 구성하십시오.
    표 1.
    필드 설명
    저장
    파일 이름 이 활동에는 이 필드가 사용되지 않습니다. 입력 맵핑 태스크의 filename 입력 매개변수를 사용하여 출력 파일의 이름을 지정합니다.
    디렉토리 위치 통합 어플라이언스가 이 활동에서 생성된 파일을 배치하는 FTP 서버의 디렉토리를 지정합니다. 다음 옵션 중 하나를 사용하여 디렉토리를 지정할 수 있습니다.
    • 필드를 클릭하거나 다음 디렉토리 경로 중 하나를 입력하여 디렉토리 경로를 직접 입력하십시오.
      • 상대 디렉토리 경로(예: /output.). 이 경우 FTP 서버에 연결하는 사용자 계정에 FTP 홈이 구성된 것으로 가정합니다. 자세한 정보는 "참고"를 참조하십시오.)
      • 전체 디렉토리 경로(예를 들어, UNIX 시스템의 경우 /home/user/output)
    • 찾아보기...를 클릭하여 사용 가능한 디렉토리의 드롭 다운 목록을 채우십시오. 드롭 다운 목록에서 해당 디렉토리를 선택하십시오.
    참고: UNIX: UNIX 시스템의 FTP 서버에 연결할 때 상대 디렉토리 경로를 지정하는 경우, FTP 서버에 연결하는 사용자 계정에 대해 /etc/password 파일에 FTP 홈 디렉토리가 올바르게 지정되었는지 확인하십시오.
    유형 파일의 컨텐츠를 읽는 방법(2진 데이터 또는 인코딩된 텍스트)을 지정합니다. 텍스트 옵션이 선택되면 다음 옵션 중 하나를 사용하여 인코딩 유형을 설정하십시오.
    • 인코딩 유형 드롭 다운 목록에서 기본 인코딩 유형 중 하나를 선택하십시오. 
    • 인코딩 필드를 클릭하여 직접 인코딩 유형을 입력하십시오.
    참고: 일부 2바이트 문자는 SHIFT-JIS 인코딩을 사용하여 변환되지 않습니다. 자세한 정보는 Shift-JIS 인코딩 사용을 참조하십시오.
     
    주의: ASCII 모드에서 FTP 엔드포인트와 데이터를 송수신하는 동안 텍스트 파일을 검색하고 텍스트 데이터를 조작하는 엔드포인트의 텍스트 파일을 FTP 서버에 배치할 때 FTP 활동에 텍스트로 전송(ASCII) 옵션을 지정해야 합니다. 예를 들어, 메인프레임 및 DOS FTP 엔드포인트는 ASCII 모드로 데이터를 전달할 때 ASCII 데이터를 조작합니다.
    예를 들어, 오케스트레이션이 FTP 디렉토리 폴 활동을 사용하여 ASCII 파일을 검색하고 FTP 파일 넣기 활동을 사용하여 메인프레임 FTP 서버에 ASCII 파일을 배치하는 경우 Studio의 다음 태스크에서 옵션을 지정해야 합니다.
    • FTP 디렉토리 폴 활동의 구성 태스크에서 유형 필드에 텍스트 옵션을 선택하십시오.
    • FTP 디렉토리 폴 활동의 전달 규칙 태스크에서 파일 전송 유형 필드에 텍스트로 전송(ASCII) 옵션을 선택하십시오.
    • FTP 파일 넣기 활동의 구성 태스크에서 유형 필드에 텍스트 옵션을 선택하십시오.
    • FTP 파일 넣기 활동의 전달 규칙 태스크에서 파일 전송 유형 필드에 텍스트로 전송(ASCII) 옵션을 선택하십시오.
    옵션 - 다음 옵션 중 하나를 선택하여 지정된 출력 디렉토리에 이미 동일한 이름의 파일이 있는 경우의 동작을 정의하십시오.
    중복 파일 이름이 있는 경우 기존 파일 겹쳐쓰기 파일이 이미 있는 경우 원래 파일의 컨텐츠를 활동에서 리턴된 새 데이터로 대체하도록 지정합니다.
    기존 파일에 추가 파일이 이미 있는 경우 원래 데이터를 파일에 보존하고 파일 끝에 활동에서 리턴된 새 데이터를 추가하도록 지정합니다.
    중복 이름을 사용하는 파일이 발견된 경우 오류 발생 파일이 이미 있는 경우 파일의 원래 데이터를 보존하고 오류를 발행한 후 활동에서 리턴된 새 데이터로 아무 작업도 수행하지 않는 것으로 지정합니다.
    참고: 이 옵션을 선택하면 FTP 파일 넣기 활동이 파일을 업로드하기 전에 서버에 파일이 있는지 확인합니다. 일부 FTP 서버에서는 파일을 업로드하기 전에 파일이 있는지 확인하는 권한이 없을 수도 있습니다. 이를 블라인드 FTP라고도 합니다. 이러한 경우에는 중복 이름을 사용하는 파일이 발견될 경우 오류 발생 옵션을 선택했더라도 파일을 겹쳐씁니다.

재시도 옵션 지정

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

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

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

활동의 입력 맵핑

  1. 점검 목록에서 입력 맵핑 태스크를 선택하십시오. 재시도 분할창이 표시됩니다. 활동의 입력 매개변수가 활동으로 분할창에 표시됩니다.
  2. 활동의 모든 입력 매개변수는 맵핑할 필요는 없습니다. 필수 매개변수는 다음과 같습니다.
    • 파일 이름
    • 데이터
기타 모든 매개변수는 선택사항입니다. 맵핑에 대한 지시사항은 맵핑 작성을 참조하십시오. 

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

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

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

표 3.
입력 매개변수 이름/노드 설명 대체되는 구성 태스크의 설정
directory 통합 어플라이언스가 이 활동에서 생성된 파일을 배치하는 FTP 서버의 디렉토리를 지정합니다. directory 입력 매개변수는 구성 태스크의 디렉토리 위치 필드를 대체합니다.
encoding 발신 데이터가 파일에 기록되는 방식을 지정합니다.
  • 인코딩이 필요하지 않은 경우에는 binary 문자열을 지정하십시오.
  • 인코딩이 필요한 경우에는 발신 데이터를 인코딩하는 데 사용해야 하는 인코딩 유형을 지정하십시오(예: UTF-8, US-ASCII, ISO_8859-1, EBCDIC-US 또는 SHIFT-JIS).
encoding 입력 매개변수는 구성 태스크의 유형 필드에 지정된 인코딩을 대체하지만 구성 태스크의 유형 필드에서 2진 옵션을 선택한 경우에는 인코딩 입력 매개변수로 지정한 인코딩이 무시됩니다.
overwrite 지정된 출력 디렉토리에 이미 동일한 이름의 기존 파일이 있는 경우 동작을 지정합니다. 다음 값 중 하나를 지정하십시오.
  • y - 파일이 이미 있는 경우 원래 파일의 컨텐츠를 활동에서 리턴된 새 데이터로 대체하도록 지정합니다.
  • a - 파일이 이미 있는 경우 원래 데이터를 파일에 보존하고 파일 끝에 활동에서 리턴된 새 데이터를 추가하도록 지정합니다.
  • n - 파일이 이미 있는 경우 원래 데이터를 파일에 보존하고 활동에서 리턴된 새 데이터로 아무 작업도 수행하지 않는 것으로 지정합니다.
overwrite 입력 매개변수는 구성 태스크의 옵션 필드를 겹쳐씁니다.
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 엔드포인트의 비밀번호 필드를 대체합니다.



피드백 | 주의사항


시간소인 아이콘 마지막 업데이트 날짜: 2013년 11월 6일 수요일