설정

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에 정의된 파일에이전트 사이트의 경로에 파일명의 경로를 합쳐서 결정된다.

  • 소스파일: 소스의 파일명을 설정한다. 파일명은 Path를 포함한 경로를 정의한다.

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

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

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

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

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

  • 타겟파일: 타겟의 파일명을 설정한다. 파일명은 Path를 포함한 경로를 정의한다.

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

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

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

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

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

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

2.1.4. 인터셉터

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

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

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

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

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

동적 값 설정방법

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

필드명 인터페이스 항목

srcPath

소스파일

srcSite

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

srcAgentId

소스파일에이전트

targetPath

타겟파일

targetSite

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

targetAgentId

타겟파일에이전트

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

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

Copyright© Bankwareglobal All Rights Reserved.