설정

File to File(Agent) 인터페이스는 EAI가 호출할 소스 파일 Agent와 파일을 수신 받은 타겟 파일 Agent를 설정해야한다.

1. 파일에이전트정보 등록

파일을 송수신할 파일 Agent 정보를 등록해야한다. 이를 위해 인터페이스관리 > 파일에이전트정보 화면에서 해당 정보를 등록한다. 관련된 자세한 정보는 파일에이전트정보를 참조한다.

2. 인터페이스 등록

File to File(Agent) 인터페이스 등록은 인터페이스관리 > 배치인터페이스 화면에서 등록한다. 인터페이스ID, 인터페이스명은 인터페이스를 식별할 수 있는 값으로 설정한다.

각 구성항목에 대한 설명은 다음과 같다.

2.1. 구성항목

2.1.1. 기본정보

  • 인터페이스방식: File to File(Agent)

  • 중복처리: 파일 전송 시 해당 파일이 이미 존재할 때의 정책

  • 전후처리프로그램ID: 배치 수행전후에 실행할 커스터마이징 프로그램

2.1.2. 스케줄정보

실행할 스케줄 정보. 해당 스케줄 정보는 노드관리 > 스케줄인스턴스관계정보 화면에 등록되어야 실제로 실행된다.

2.1.3. From To

  • 소스에이전트그룹사용여부: 소스에이전트그룹을 사용할 것인지 선택한다. 사용이라면 에이전트그룹ID, 사용안함이라면 에이전트ID를 설정한다. 가용 에이전트를 로드밸런싱하기 위해 사용한다. (현재 라운드로빈만 지원)

  • 소스파일에이전트ID: 소스 파일에이전트가 접속할 수 있는 정보가 등록된 파일에이전트을 선택한다.

  • 소스파일에이전트사이트명: 파일의 Full Path는 파일에이전트의 application.yml에 정의된 파일에이전트 사이트의 경로에 파일명의 경로를 합쳐서 결정된다.

  • 소스파일: 소스의 파일명을 설정한다. 절대/상대경로 모두 지원한다. 정규식을 사용한 다중전송기능을 지원한다. 온디맨드방식인 경우 전문레이아웃에 정의된 값에 따라 replace기능도 가능하다. ex) source/${custom1}/test.txt → source/abc/test.txt

  • 백업소스파일에이전트ID: 소스파일에이전트 장애 시 백업할 파일에이전트을 선택한다.

  • 소스전송완료확인확장자명: 소스 에이전트는 타겟으로 파일을 전송하기 전에, 소스에서 '소스파일+소스전송완료확인확장자명' 파일의 존재 여부를 확인한다. 해당 파일이 없으면 파일 전송이 이루어지지 않는다. 이 과정은 소스파일이 작성 중인 상황에서 파일이 전송되는 것을 방지하기 위한 목적이다.

  • 소스백업여부: 거래 완료 후, 소스파일을 백업할지 여부를 설정한다. 사용인 경우에만 소스백업경로를 입력할 수 있다.

  • 소스백업경로: 거래 완료 후, 해당 소스파일을 옮길 디렉토리를 설정한다. 절대/상대경로 모두 지원한다. 입력된 경로중 존재하지않는 디렉토리가 있다면 생성한다. 온디맨드 replace기능을 지원한다.

  • 타겟에이전트그룹사용여부: 타겟에이전트그룹을 사용할 것인지 선택한다. 사용이라면 에이전트그룹ID, 사용안함이라면 에이전트ID를 설정한다. 가용 에이전트를 로드밸런싱하기 위해 사용한다. (현재 라운드로빈만 지원)

  • 타겟파일에이전트ID: 타겟 파일에이전트가 접속할 수 있는 정보가 등록된 파일에이전트을 선택한다.

  • 타겟파일에이전트사이트명: 파일의 Full Path는 파일에이전트의 application.yml에 정의된 파일에이전트 사이트의 경로에 파일명의 경로를 합쳐서 결정된다.

  • 타겟파일(경로): 타겟의 파일명을 설정한다. 절대/상대경로 모두 지원한다. 다중전송시에는 디렉토리명으로 끝나야한다. 온디맨드 replace기능을 지원한다.

  • 백업타겟파일에이전트ID: 타겟파일에이전트 장애 시 백업할 파일에이전트을 선택한다.

  • 전송완료확인확장자명: 파일 수신이 완료되면 완료 여부를 나타내기 위해 Done 파일을 생성한다. 이때 사용할 파일의 확장자명을 정의한다.

  • 타겟에이전트그룹전송방식: 타겟에이전트그룹사용여부가 사용일 때 선택할 수 있다.

    • 전체: 에이전트 그룹 내 활성화 여부가 '활성화’인 모든 에이전트들에게 파일을 전송한다. (1:N)

    • 라운드로빈: 에이전트 그룹 내 활성화 여부가 '활성화’인 에이전트들 중 하나를 라운드로빈 방식으로 선정하여 파일을 전송한다.

소스백업은 복사가 아닌 이동의 형태이므로 백업 후, 원본소스파일은 사라지게 되므로 주의한다.

소스파일, 타겟파일 항목은 Path Expression을 통해 동적으로 경로를 변경할 수 있다.

소스파일 예시

source/2025/{^test.\.txt$} (O)
source/2025/test-ftp.
(X)
source/${custom1}/test.txt (O)
source/20* (X)
source/${date:now-24h:yyyyMMdd}/test-ftp.txt (O) source/${date:now-24h:yyyyMMdd}/
{^test.\.txt$} (O) source/${date:now-24h:yyyyMMdd}/${custom1}/${custom2}/#{^test.\.txt$} (O)

2.1.4. 인터셉터

  • From: 소스 에이전트에서 파일 송신 전후에 실행할 커스터마이징 프로그램

  • To: 타겟 에이전트에서 파일 수신 전후에 실행할 커스터마이징 프로그램

  • Before-script: 소스, 타겟 에이전트에서 파일 송수신 전에 실행될 쉘스크립트. 스크립트명 인자.. 로 입력한다. ex) test.sh 123 abc 2025

  • After-script: 소스, 타겟 에이전트에서 파일 송수신 전에 실행될 쉘스크립트

  • 인터페이스파라미터: 소스/타겟 파일에이전트에 전달할 파라미터

  • 공통 파라미터 선택: File to File(Agent) 방식의 모든 배치 인터페이스에 공통으로 사용할 인터페이스 파라미터

인터셉터에서 호출할 프로그램은 Spring Bean으로 작성한다.

동적 값 설정방법

AP to Batch에서 실행하고자 하는 인터페이스의 유형이 File to File(Agent)인 경우, AP로 요청받은 전문의 값을 이용해 인터페이스 항목에 동적으로 설정할 수 있다. 값이 존재하지 않을 경우 인터페이스에 정의된 항목을 사용한다.

필드명 인터페이스 항목

srcPath

소스파일

srcSite

소스파일에이전트사이트명

srcAgentId

소스파일에이전트

targetPath

타겟파일(경로)

targetSite

타겟파일에이전트사이트명

targetAgentId

타겟파일에이전트

srcBackupPath

소스백업경로

어떠한 필드값

사용자커스텀 필드명. 소스파일, 타겟파일(경로), 백업경로에 replace.

AP to Batch 요청전문레이아웃에 위 필드를 추가하여 사용한다.

request layout
SWLab Bankware Global
  • 전체
  • BXM
  • BXCM
  • BXCP
  • BXI
제품 선택 시 더 정확한 매뉴얼 가이드를 제공해드립니다.

Copyright© Bankwareglobal All Rights Reserved.