SFTP 활동 작성

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 14분

    • 원격 서버에서 기본 SFTP 명령을 실행하는 활동을 만듭니다.

    시작하기 전에

    필요한 역할: activity_creator 또는 workflow_admin

    이 태스크 정보

    대상 호스트에서 파일 및 디렉토리를 관리하거나 한 SFTP 서버에서 다른 SFTP 서버로 파일을 복사하는 사용자 지정 활동을 만들 수 있습니다. 파일 내용은 MID 서버를 통해 스트리밍되므로 MID 서버 호스트 컴퓨터의 하드 드라이브에 데이터를 저장할 필요가 없습니다.
    주:
    이 활동에는 소스 호스트에서 SFTP 명령을 실행할 수 있는 사용자의 자격 증명이 필요합니다. 활동 팩에 제공된 파일 복사 활동에는 대상 호스트에 액세스하기 위한 별도의 자격 증명이 필요합니다.

    프로시저

    1. 사용자 지정 활동을 생성합니다.
      이 작업은 템플릿을 사용하여 사용자 지정 활동을 생성합니다.
    2. 일반 속성을 설정하고 입력 변수를 만든 후 SFTP 실행 명령을 구성합니다.
      옵션설명
      명령 작성할 활동의 유형입니다. 선택 항목은 다음과 같습니다.
      • 파일 복사
      • 디렉터리 작성
      • 파일 목록 가져오기
      • 파일 또는 디렉터리 제거
      • 파일 또는 디렉토리 이름 바꾸기
      • 파일 특성 설정
      주:
      양식에 표시되는 필드는 선택한 명령에 따라 다릅니다.
      소스 호스트 활동의 대상 파일이 포함된 서버의 이름 또는 IP 주소입니다.
      소스 포트 원본 서버와 통신하는 데 사용할 포트 번호입니다. 기본 포트 번호는 22입니다.
      소스 파일 경로 선택한 명령에 따라 소스 호스트의 파일(/temp/test_data_file.txt) 또는 디렉터리(/temp/test_dir)에 대한 전체 경로입니다. 다음 명령에서 사용할 수 있는 필드:
      • 파일 복사
      • 파일 또는 디렉터리 제거
      • 파일 특성 설정
      소스 디렉터리 소스 파일이 있는 디렉터리의 경로입니다. 다음 명령에서 사용할 수 있는 필드:
      • 디렉터리 작성
      • 파일 목록 가져오기
      소스 파일 파일 전송에 포함할 특정 소스 파일의 이름입니다. 파일 이름을 세미콜론으로 구분합니다. 이 필드는 세미콜론으로 구분된 와일드카드 패턴 목록을 지원합니다. 예: *.txt; a?cd.pdf. 이 필드를 비워 두면 모든 파일이 포함됩니다. 다음 명령에서 사용할 수 있는 필드: 파일 목록 가져오기
      주:
      이 필드의 값이 다른 필드의 옵션에 어떤 영향을 주는지에 대한 자세한 내용은 다음 논리 설명을 참조하십시오.
      디렉터리임 선택 시 파일 경로가 디렉터리임을 지정합니다. 다음 명령에서 사용 가능한 필드: 파일 또는 디렉터리 제거
      소스의 자격 증명 태그 소스 호스트에서 SFTP 명령을 실행하는 데 이 활동에서 사용해야 하는 특정 자격 증명 태그입니다.
      대상의 자격 증명 태그 대상 호스트에서 SFTP 명령을 실행하기 위해 이 활동에서 사용해야 하는 특정 자격 증명 태그입니다. 다음 명령에서 사용할 수 있는 필드: 파일 복사
      제외된 파일 파일 전송에서 제외할 특정 소스 파일의 이름입니다. 활동은 원본 디렉터리 또는 하위 폴더에 있는 다른 모든 파일에 적용됩니다. 파일 이름을 쉼표로 구분합니다. 이 필드는 쉼표로 구분된 와일드카드 패턴 목록을 지원합니다. 예: *.txt, a?cd.pdf.. 다음 명령에서 사용할 수 있는 필드: 파일 목록 가져오기
      주:
      이 필드의 값이 다른 필드의 옵션에 어떤 영향을 주는지에 대한 자세한 내용은 다음 논리 설명을 참조하십시오.
      하위 폴더 포함 선택하면 소스 디렉토리의 하위 폴더에 있는 파일이 포함됩니다. 다음 명령에서 사용할 수 있는 필드: 파일 목록 가져오기
      주:
      선택 항목이 양식의 다른 필드에 어떤 영향을 주는지에 대한 자세한 내용은 다음 논리 설명을 참조하십시오.
      대상 호스트 파일을 전송할 서버의 이름 또는 IP 주소입니다. 다음 명령에서 사용할 수 있는 필드: 파일 복사
      대상 포트 대상 호스트와 통신하는 데 사용할 포트 번호입니다. 기본 포트 번호는 22입니다. 다음 명령에서 사용할 수 있는 필드: 파일 복사
      대상 파일 경로 대상 호스트에 있는 파일의 전체 경로입니다. 다음 명령에서 사용할 수 있는 필드:
      • 파일 복사
      • 파일 또는 디렉토리 이름 바꾸기
      임시 파일 접미사 대상 호스트에 파일이 있는 경우 이 명령을 사용하면 파일 이름에 임시 접미어를 사용할 수 있습니다. 이 필드에 값이 포함되어 있으면 활동은 먼저 이름으로 사용하여 targetFilePath + tempFileSuffix 소스 파일을 대상 호스트의 임시 파일로 복사합니다. 완료되면 활동은 파일 이름을 실제 대상 파일 이름으로 바꿉니다. 이 필드가 비어 있으면 활동은 소스 파일을 대상 파일에 직접 복사하고 덮어씁니다(있는 경우). 다음 명령에서 사용할 수 있는 필드: 파일 복사
      UID 파일 또는 디렉터리에 적용할 사용자 ID 속성입니다. UID 및 GID 값은 쌍으로 함께 설정해야 하며 그렇지 않으면 무시됩니다. UID 및 GID 번호는 파일 목록 가져오기 작업에서 반환되는 내부 값입니다. 일반적으로 파일 목록 가져오기 작업을 먼저 사용하여 파일 및 해당 특성의 목록을 반환합니다. 그런 다음 원본 호스트에서 대상 호스트로 파일을 이동하고 대상 파일에서 원본 파일 속성을 설정할 수 있습니다. 이 흐름은 에 설명되어 있습니다 SFTP 파일 전송 워크플로우. 다음 명령에서 사용 가능한 필드: 파일 속성 설정
      GID 파일 또는 디렉터리에 적용할 그룹 ID 속성입니다. UID 및 GID 값은 쌍으로 함께 설정해야 하며 그렇지 않으면 무시됩니다. UID 및 GID 번호는 파일 목록 가져오기 작업에서 반환되는 내부 값입니다. 일반적으로 파일 목록 가져오기 작업을 먼저 사용하여 파일 및 해당 특성의 목록을 반환합니다. 그런 다음 원본 호스트에서 대상 호스트로 파일을 이동하고 대상 파일에서 원본 파일 속성을 설정할 수 있습니다. 이 흐름은 에 설명되어 있습니다 SFTP 파일 전송 워크플로우. 다음 명령에서 사용 가능한 필드: 파일 속성 설정
      권한 지정된 사용자 및 그룹에 대해 설정할 파일 또는 디렉터리 권한입니다. 이 값은 16877과 같이 정수로 표현해야 하며, 이는 권한을 rwxr-xr-x정의합니다. 권한 번호는 파일 목록 가져오기 작업에서 반환되는 내부 값입니다. 일반적으로 파일 목록 가져오기 작업을 먼저 사용하여 파일 및 해당 특성의 목록을 반환합니다. 그런 다음 원본 호스트에서 대상 호스트로 파일을 이동하고 대상 파일에서 원본 파일 속성을 설정할 수 있습니다. 이 흐름은 에 설명되어 있습니다 SFTP 파일 전송 워크플로우. 다음 명령에서 사용 가능한 필드: 파일 속성 설정
      타임스탬프 접근 파일이나 디렉터리에 마지막으로 액세스했을 때의 타임스탬프를 재정의합니다. 액세스 및 수정 타임스탬프는 쌍으로 함께 설정해야 합니다. 다음 명령에서 사용 가능한 필드: 파일 속성 설정
      수정 타임스탬프 파일 또는 디렉터리가 마지막으로 수정되었을 때의 타임스탬프를 재정의합니다. 액세스 및 수정 타임스탬프는 쌍으로 함께 설정해야 합니다. 다음 명령에서 사용 가능한 필드: 파일 속성 설정
      크기(바이트) 바이트로 표현된 파일의 크기입니다. 다음 명령에서 사용 가능한 필드: 파일 속성 설정
      필요한 MID 서버 역량 소스 및 대상 서버에 연결하기 위한 적절한 MID 서버 역량 을 갖춘 MID 서버.
      시스템은 이 논리를 사용하여 소스 호스트에서 이동할 파일을 결정합니다.
      • 소스 파일 필드가 비어 있으면 시스템은 소스 디렉토리의 모든 파일을 선택합니다. 그렇지 않으면 이름이 필드에 지정된 파일 이름 패턴 중 하나와 일치하는 파일만 선택합니다.
      • 제외된 파일 필드가 비어 있으면 시스템은 아무 것도 제외하지 않습니다. 그렇지 않으면 이름이 필드에 지정된 파일 이름 패턴 중 하나와 일치하는 파일을 제외합니다.
      • 제외 규칙은 포함 규칙보다 우선 순위가 높습니다. 파일 이름이 제외된 파일 필드의 파일 이름 패턴 중 하나와 일치하면 포함 규칙에 관계없이 선택 항목에 포함되지 않습니다.
      • 하위 폴더 포함 확인란의 선택을 취소하면 시스템은 포함하거나 제외할 파일을 소스 디렉터리에서만 찾습니다. 그렇지 않으면 원본 디렉터리와 해당 하위 폴더에서 포함하거나 제외할 파일을 찾습니다.
      주:
      테스트 페이로드의 매개변수 값을 출력 탭의 변수에 자동으로 매핑할 수 있습니다. 자동 매핑 출력 변수의 내용을 참조하십시오.

    다음에 수행할 작업

    SFTP 템플릿 실행 매개변수

    실행 매개변수를 사용하여 전처리 양식에서 입력 프로세스 스크립트를 생성합니다.

    명령 필드에 대한 설명은 다음 문서를 참조하십시오 SFTP 실행 명령 구성.
    주:
    이 테이블의 모든 변수에 executionParam. 접두사를 사용해야 합니다.
    표 1. SFTP 실행 매개변수
    이름 변수 유형 사용법
    명령 command 문자열 이 활동의 기능을 식별합니다. 가능한 명령은 다음과 같습니다.
    • 파일 복사
    • 디렉터리 작성
    • 파일 목록 가져오기
    • 파일 또는 디렉터리 제거
    • 파일 또는 디렉토리 이름 바꾸기
    • 파일 특성 설정
    소스 소스 문자열 소스 호스트를 식별합니다.
    소스 포트 source_port 정수 소스 호스트와 통신하는 데 사용되는 포트를 식별합니다.
    소스 디렉터리 source_directory 문자열 이동할 파일의 소스 디렉터리 경로입니다.
    소스 파일 source_files 문자열 이동할 소스의 파일 이름입니다.
    제외된 파일 excluded_files 문자열 작업에서 제외된 파일을 나열합니다.
    소스 파일 경로 source_file_path 문자열 이동할 소스 파일의 경로입니다.
    대상 호스트 target_host 문자열 대상 호스트를 식별합니다.
    대상 포트 target_port 정수 대상 호스트와 통신하는 데 사용되는 포트를 식별합니다.
    대상 디렉터리 target_directory 문자열 대상 호스트의 대상 디렉터리에 대한 전체 경로입니다.
    대상 파일 경로 target_file_path 문자열 소스 호스트 또는 대상 호스트에 있는 파일 또는 디렉터리의 전체 경로입니다. 예를 들어 이 값은 활동 팩의 파일 이름 바꾸기 또는 디렉터리 활동에 사용됩니다.
    임시 파일 접미사 temp_file_postfix 문자열

    파일을 이동할 때 파일 복사 작업에서 사용하는 임시 파일 이름 확장명입니다. 이 필드에 확장자가 포함되어 있는 경우 소스 파일은 실제 대상 파일로 이름이 바뀌기 전에 를 사용하여 target file name + temp_file_postfix임시 파일로 복사됩니다. 이 필드가 비어 있으면 소스 파일이 대상 파일에 직접 복사됩니다.
    디렉터리임 is_directory 부울 지정된 파일 경로가 디렉터리인지 여부를 나타냅니다.
    하위 폴더 포함 include_subfolders 부울 시스템에서 포함 및 제외할 파일에 대해 소스 디렉터리의 하위 폴더를 조사하는지 여부를 나타냅니다.
    파일 속성 uid file_attribute_uid 정수 파일 또는 디렉터리와 연결된 사용자 ID입니다.
    파일 속성 gid file_attribute_gid 정수 파일 또는 디렉터리와 연결된 그룹 ID입니다.
    파일 특성 권한 file_attribute_permissions 정수 지정된 사용자 및 그룹에 대한 파일 또는 디렉터리 권한입니다.
    파일 속성 atime file_attribute_atime 정수 파일 속성에서 타임 스탬프에 액세스합니다.
    파일 속성 mtime file_attribute_mtime 정수 파일 속성에서 수정 타임스탬프입니다.
    파일 속성 크기 file_attribute_size 정수 파일 크기(바이트)입니다.
    소스 자격 증명 태그 source_credential_tag 문자열 소스 호스트에서 명령을 실행하는 데 사용되는 오케스트레이션 활동에 대한 자격 증명 별칭입니다.
    대상 자격 증명 태그 target_credential_tag 문자열 대상 호스트에서 명령을 실행하는 데 사용되는 자격 증명 태그입니다.
    MID 역량 MID 역량 문자열(쉼표로 구분) 필요한 MID 서버 역량 목록입니다.

    SFTP 후처리 매개변수 및 페이로드 구문 분석

    이러한 매개변수를 사용하여 후처리 스크립트, 페이로드 구문 분석 및 태그 지정을 생성합니다.

    표 2. SFTP 후처리 매개변수
    이름 변수 유형 사용법
    출력 출력 문자열 쿼리에서 반환된 출력 데이터를 포함합니다.
    EccSysId eccSysId 문자열 ECC 큐 입력 메시지와 연결된 참조 ID를 포함합니다.
    오류 메시지 errorMessages 문자열 쿼리에서 반환된 오류 메시지를 포함합니다. 오류 메시지가 반환되지 않는 경우 이 값은 null입니다.
    태그 태그 SSH 명령에서 반환된 태그 값의 해시맵 SSH 명령을 사용하여 출력을 추출하는 데 사용되는 태그를 포함합니다. 태그 출력은 %%tagname%% ... %%와 같이 이중 백분율 기호로 구분됩니다. 다음 형식을 사용하여 명령을 설정합니다.
    %%tagname1%%
output1 line 1
output1 line 2
…
%%

%%tagname2%%
output2 line 1
output2 line 2
…
%%
    반환되는 태그는 각 키 앞에 tagname 이 추가된 태그가 있는 JavaScript 해시 맵 객체입니다.
    {"__text__": "", 
"tagtagname1":"output1 line1\noutput1 line2\n", 
"tagtagname2":"output2 line1\noutput2 line2\n"}

    SFTP 실행 명령 구성

    생성한 입력 변수를 사용하여 오케스트레이션이 SFTP 대상에서 실행하는 명령을 구성합니다.

    시작하기 전에

    명령 실행 단계로 진행하기 전에 입력 양식에 필요한 입력 변수를 생성합니다.

    필요한 역할: activity_creator, admin

    주:
    워크플로우 컨텍스트에서 활동을 실행하지 않고도 MID 서버와 대상 간의 JDBC 연결을 테스트할 수 있습니다. 자세한 내용은 테스트 템플릿 출력을 참조하십시오.

    프로시저

    1. 입력 목록에서 변수를 끌어와 명령 필드에 놓습니다.
      시스템은 명령에 적합한 구문으로 변수의 형식을 지정합니다.
      그림 1. SFTP 실행 명령
      이 예시에서는 디렉토리 작성 명령이 명령 필드에 표시됩니다.
    2. 테이블에 표시된 필드를 모두 채우십시오.
      표 3. SFTP 명령 필드
      필드 설명 명령
      명령 작성할 활동의 유형입니다. 선택 항목은 다음과 같습니다.
      • 파일 복사
      • 디렉터리 작성
      • 파일 목록 가져오기
      • 파일 또는 디렉터리 제거
      • 파일 또는 디렉토리 이름 바꾸기
      • 파일 특성 설정
      주:
      선택한 명령에 따라 양식에 표시되는 필드가 달라집니다.
      		 모두
      소스 호스트 활동의 대상 파일이 포함된 서버의 이름 또는 IP 주소입니다. 모두
      소스 포트 원본 서버와 통신하는 데 사용할 포트 번호입니다. 기본 포트 번호는 22입니다. 모두
      소스 파일 경로 소스 호스트의 파일에 대한 전체 경로입니다.
      • 파일 복사
      • 파일 또는 디렉터리 제거
      • 파일 특성 설정
      소스 디렉터리 소스 파일이 있는 디렉터리의 경로입니다.
      • 디렉터리 작성
      • 파일 목록 가져오기
      소스 파일 관리 작업에 포함할 특정 소스 파일의 이름입니다. 이 목록의 파일 이름을 세미콜론으로 구분합니다. 이 필드는 와일드카드 사용을 지원합니다. 이 필드를 비워 두면 모든 파일이 포함됩니다. 이 필드의 값이 다른 필드의 옵션에 의해 영향을 받는 방식에 대한 자세한 내용은 테이블 아래의 섹션을 참조하십시오. 파일 목록 가져오기
      디렉터리임 지정된 파일 경로가 디렉터리인지 여부를 결정하는 확인란입니다. 파일 또는 디렉터리 제거
      소스의 자격 증명 태그 오케스트레이션 활동에 대한 특정 자격 증명 별칭 이 활동은 소스 호스트에서 SFTP 명령을 실행하는 데 사용해야 합니다. 모두
      대상의 자격 증명 태그 대상 호스트에서 SFTP 명령을 실행하기 위해 이 활동에서 사용해야 하는 특정 자격 증명 태그입니다. 파일 복사
      제외된 파일 관리 동작에서 제외할 특정 소스 파일의 이름. 활동은 원본 디렉터리 또는 하위 폴더에 있는 다른 모든 파일에 적용됩니다. 이 목록의 파일 이름을 세미콜론으로 구분합니다. 이 필드는 와일드카드 사용을 지원합니다. 이 필드의 값이 다른 필드의 옵션에 의해 영향을 받는 방식에 대한 자세한 내용은 테이블 아래의 섹션을 참조하십시오. 파일 목록 가져오기
      하위 폴더 포함 원본 디렉터리의 하위 폴더에서 파일을 관리하는 확인란입니다. 선택 항목이 양식의 다른 필드에 미치는 영향에 대한 자세한 내용은 테이블 아래의 섹션을 참조하십시오. 파일 목록 가져오기
      대상 호스트 파일을 전송할 서버의 이름 또는 IP 주소입니다. 파일 복사
      대상 포트 대상 호스트와 통신하는 데 사용할 포트 번호입니다. 기본 포트 번호는 22입니다. 파일 복사
      대상 파일 경로 대상 호스트에 있는 파일의 전체 경로입니다.
      • 파일 복사
      • 파일 또는 디렉토리 이름 바꾸기
      임시 파일 접미사 파일이 대상 호스트에 이미 있는 경우 파일 이름에 사용할 임시 접미사입니다. 이 필드에 값이 포함되어 있으면 활동은 중복 대상 파일(있는 경우)을 삭제한 다음, 해당 이름을 사용하여 targetFilePath + tempFileSuffix 소스 파일을 임시 파일에 복사합니다. 완료되면 활동은 파일 이름을 실제 대상 파일 이름으로 바꿉니다. 이 필드가 비어 있으면 활동은 소스 파일을 대상 파일에 직접 복사하고 이미 있는 경우 덮어씁니다. 파일 복사
      UID 파일 또는 디렉터리에 적용할 사용자 ID 속성입니다. UID 및 GID 값은 쌍으로 함께 설정해야 하며 그렇지 않으면 무시됩니다. 파일 특성 설정
      GID 파일 또는 디렉터리에 적용할 그룹 ID 속성입니다. UID 및 GID 값은 쌍으로 함께 설정해야 하며 그렇지 않으면 무시됩니다. 파일 특성 설정
      권한 지정된 사용자 및 그룹에 대해 설정할 파일 또는 디렉터리 권한입니다. 이 값은 16877과 같이 정수로 표현해야 하며, 이는 권한을 rwxr-xr-x정의합니다. 권한 번호는 파일 목록 가져오기 작업에서 반환되는 내부 값입니다. 일반적으로 파일 목록 가져오기 작업을 먼저 사용하여 파일 및 해당 특성의 목록을 반환합니다. 그런 다음 원본 호스트에서 대상 호스트로 파일을 이동하고 대상 파일에서 원본 파일 속성을 설정할 수 있습니다. 이것은 에서 SFTP 파일 전송 워크플로우입증됩니다. 파일 특성 설정
      타임스탬프 접근 파일이나 디렉터리에 마지막으로 액세스했을 때의 타임스탬프를 재정의합니다. 액세스 및 수정 타임스탬프는 쌍으로 함께 설정해야 합니다. 파일 특성 설정
      수정 타임스탬프 파일 또는 디렉터리가 마지막으로 수정되었을 때의 타임스탬프를 재정의합니다. 액세스 및 수정 타임스탬프는 쌍으로 함께 설정해야 합니다. 파일 특성 설정
      크기(바이트) 바이트로 표현된 파일의 크기입니다. 파일 특성 설정
      필요한 MID 서버 역량 소스 및 대상 서버에 연결하기 위한 적절한 MID 서버 역량 을 갖춘 MID 서버. 기본적으로 시스템은 SSH MID 서버를 선택합니다. 모두
      시스템은 이 논리를 사용하여 소스 호스트에서 이동할 파일을 결정합니다.
      • 소스 파일 필드가 비어 있으면 시스템은 소스 디렉토리의 모든 파일을 선택합니다. 그렇지 않으면 이름이 필드에 지정된 파일 이름 패턴 중 하나와 일치하는 파일만 선택합니다.
      • 제외된 파일 필드가 비어 있으면 시스템은 아무 것도 제외하지 않습니다. 그렇지 않으면 이름이 필드에 지정된 파일 이름 패턴 중 하나와 일치하는 파일을 제외합니다.
      • 제외 규칙은 포함 규칙보다 우선 순위가 높습니다. 이름이 제외된 파일 필드의 파일 이름 패턴 중 하나와 일치하는 파일은 포함 규칙에 의해 선택되더라도 선택 항목에 포함되지 않습니다.
      • 하위 폴더 포함 확인란의 선택을 취소하면 시스템은 포함하거나 제외할 파일을 소스 디렉터리에서만 찾습니다. 그렇지 않으면 원본 디렉터리와 해당 하위 폴더에서 포함하거나 제외할 파일을 찾습니다.
    3. 저장을 클릭합니다.
    4. 계속을 클릭하여 출력 단계로 이동합니다.