설정
인터페이스 관리 > 배치인터페이스에서 등록한다. 인터페이스ID, 인터페이스명은 인터페이스를 식별할 수 있는 값으로 설정한다.각 구성항목에 대한 설명은 다음과 같다.
구성항목
☑ 기본정보
- 인터페이스방식 : File to File(Agent)
- 중복처리 : File전송 시 수신시스템에 해당 파일이 이미 존재할 때의 정책
- 전후처리프로그램ID : 배치 수행전후에 실행할 커스터마이징 프로그램
☑ 스케줄정보
실행할 스케줄 정보. 해당 스케줄 정보는 노드관리 > 스케줄인스턴스관계정보에 등록되어야 실제로 실행된다.
☑ From To
- 소스에이전트그룹사용여부 : 소스에이전트그룹을 사용할 것인지 선택한다.
사용이라면 에이전트그룹ID,사용안함이라면 데이터소스ID를 설정한다. 가용 에이전트를 로드밸런싱하기 위해 사용한다. (현재 라운드로빈만 지원) - 소스파일에이전트ID : 소스 파일에이전트가 접속할 수 있는 정보가 등록된 파일에이전트을 선택한다.
- 소스파일에이전트사이트명 : 파일의 Full Path는 파일에이전트의
application.yml에 정의된 파일에이전트 사이트의 경로에 파일명의 경로를 합쳐서 결정된다. - 소스파일 : Source의 파일명을 설정한다. 파일명은 Path를 포함한 경로를 정의한다.
- 백업소스파일에이전트ID : 소스파일에이전트 장애 시 백업할 정보가 등록된 파일에이전트을 선택한다.
- 소스전송완료확인확장자명 : 파일에이전트는 소스에서 타겟으로 파일을 전송하기 이전에, 소스에이전트에서 '소스파일+소스전송완료확인확장자명'의 파일이 존재하는지 먼저 확인한다. 해당 파일이 없으면 파일이 전송되지 않는다. (소스파일이 쓰여지고있는 상황에 파일이 전송되는것을 방지하기 위한 용도)
- 타겟에이전트그룹사용여부 : 타겟에이전트그룹을 사용할 것인지 선택한다.
사용이라면 에이전트그룹ID,사용안함이라면 데이터소스ID를 설정한다. 가용 에이전트를 로드밸런싱하기 위해 사용한다. (현재 라운드로빈만 지원) - 타겟파일에이전트ID : 타겟 파일에이전트가 접속할 수 있는 정보가 등록된 파일에이전트을 선택한다.
- 타겟파일에이전트사이트명 : 파일의 Full Path는 파일에이전트의
application.yml에 정의된 파일에이전트 사이트의 경로에 파일명의 경로를 합쳐서 결정된다. - 타겟파일 : Target의 파일명을 설정한다. 파일명은 Path를 포함한 경로를 정의한다.
- 백업타겟파일에이전트ID : 타겟파일에이전트 장애 시 백업할 정보가 등록된 파일에이전트을 선택한다.
- 전송완료확인확장자명 : 파일 수신이 완료되면 완료여부를 나타내기 위해 Done 파일을 생성하는데, 이때 사용할 파일의 확장자명을 정의한다.
- 타겟에이전트그룹전송방식: 타겟에이전트그룹사용여부가
사용일때 선택할 수 있다.전체면 에이전트 그룹내 활성화 여부가활성화인 모든 에이전트들에게 파일을 전송한다. (1:N)라운드로빈이면 에이전트 그룹내 활성화여부가 '활성화'인 에이전트들 중 1개를 라운드로빈으로 선정한다.
정보
소스파일, 타겟파일 항목은 Path Expression을 통해 동적으로 경로를 변경할 수 있다.
☑ 인터셉터
- From : 송신 에이전트에서 파일을 송신 시, 선후처리에서 호출할 프로그램
- To : 수신 에이전트에서 파일을 수신 시, 선후처리에서 호출할 프로그램
- 인터페이스파라미터 : 호출되는 프로그램에 전달할 파라미터. 인터페이스 파라미터는 한번 정의하면 소스(From)와 타겟(To) 인터셉터 프로그램에 전달된다.
- 공통 파라미터 선택 : File to File(Agent) 방식의 배치 인터페이스에서 공통으로 사용할 파라미터 정보
정보
인터셉터에서 호출할 프로그램은 Spring Bean으로 작성한다.
APtoBatch사용 시 동적 파라미터 적용방법
요청전문레이아웃 등록
FiletoFile 거래 시 전문에 해당 파라미터가 존재하면 해당 값이 적용되고, 없다면
배치인터페이스에서 정의한 값이 적용된다.