사용법

본 장에서는 BXI Tool을 실행하고 실행된 상태를 확인하는 방법에 관해 설명한다.

1. 기본 사용법

BXI Tool은 fat jar 방식이므로 간단한 명령어를 통하여 실행가능하다.

java -jar bxi.tool-{version}.jar logging 						# 로그파일 -> DB
java -jar bxi.tool-{version}.jar omm							# BXM OMM -> BXI 전문
java -jar bxi.tool-{version}.jar genKey [plain-text]			# 키 생성
java -jar bxi.tool-{version}.jar encrypt [plain-text] 			# 암호화
java -jar bxi.tool-{version}.jar decrypt [encrypted-text] 		# 복호화

2. 로그 파일 업로드

거래 처리과정에서 생성된 파일로그를 DB에 업로드한다.

2.1. 업로드 대상 파일

  • errorLog: 온라인 거래 처리과정에서 발생한 에러 로그

  • imageLog: 온라인 거래의 송수신 로그

  • txLog: 온라인 거래별 처리 상태정보가 저장되는 거래 로그

  • stctsLog: 온라인 거래 처리에 대한 통계 로그

  • restStctsLog: 온라인 거래 처리에 대한 REST 통계 로그

모든 대상 로그 파일명은 .log로 끝나야 한다. 디렉터리를 지정하여 실행 시, 해당 디렉터리 내의 .log인 파일에 대해 업로드한다.

2.2. 설정

정상적인 실행을 위해 필요한 설정 작업은 다음과 같다.

2.2.1. application.yml 설정

config/application.yml
...
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3314/fep?autoReconnect=true&serverTimezone=UTC
    username: bxi
    password: bxi

tool:
  logging:
    dir: /home/bxi/tool/logging
...

2.2.2. 로그 파일 위치

tool.logging.dir 항목에 설정한 경로에 DB에 업로드할 파일들을 위치시킨다.

2.3. 실행

java -jar bxi.tool-{version}.jar logging
logging

2.3.1. 출력 로그

  • process: 커밋단위로 한번에 처리되는 건수

  • success: 커밋단위로 한번에 처리되는 건수 중 성공 건수 다.(insert, update를 포함한다.)

  • ignore: 커밋단위로 한번에 처리되는 건수 중 무시된 건수

  • error: 커밋단위로 한번에 처리되는 건수 중 에러가 발생한 건수

2.3.2. 완료 파일 이동

로그 파일은 처리 결과에 따라 success 또는 fail 디렉터리에 이동된다.

  • success: 정상적으로 업로드된 파일이 저장된다.

  • fail: 처리 중 오류가 발생한 로그가 저장된다. 해당 데이터는 재처리 하기 전에 실제 데이터를 확인해야 한다.

통계 로그를 처리하는 도중에 오류가 발생해 일부만 처리된 경우, 재처리 시 중복 처리되는 통계 데이터로 인하여 통계가 왜곡될 수 있으므로 유의한다.

3. Omm 임포트

BXM의 전문 형식인 Omm을 BXI에서 사용하는 전문 형태로 변환하여 관련 테이블에 임포트한다.

3.1. Omm 예시

 OMM hi.generalinsurance.systeminterfaces.refine.entity.GIIR0100VO
 <description="공통VO">
 {
 String titmTranCd<length=9 description="트랜잭션코드">;
 String titmTgmCat<length=1 description="전문 구분">;
 String titmTgmTotLgth<length=5 description="전체전문길이">;
 String titmTgmClsfcnCd<length=4 description="전문종별코드">;
 String titmDlCat<length=6 description="거래구분코드">;
 String titmDataCat<length=1 description="자료구분">;
 String titmIspOrgCd<length=3 description="보험사기관ID">;
 String titmLnkBasCat<length=2 description="대외연계 구분">;
 String titmAfcrCd<length=3 description="제휴기관ID">;
 String titmTrrvCat<length=1 description="송수신FLAG">;
 String titmFinaOrgTgmTr<length=14 description="금융기관전문전송일시">;
 String titmIspTgmTrDtm<length=14 description="보험회사전문전송일시">;
 String titmFinaOrgTgmNo<length=8 description="금융기관 전문일련번호">;
 String titmIspTgmNo<length=8 description="보험사 전문일련번호">;
 String titmRspCd<length=4 description="응답코드">;
 String titmMsgCd<length=100 description="응답메시지">;
 String titmFiller<length=50 description="FILLER">;
 }

3.2. 설정

정상적인 실행을 위해 필요한 설정 작업은 다음과 같다.

3.2.1. application.yml 설정

config/application.yml
...
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3314/fep?autoReconnect=true&serverTimezone=UTC
    username: bxi
    password: bxi

tool:
  omm:
    tenant-id: 000
    dir: /home/bxi/tool/omm
...

3.2.2. Omm 파일 위치

tool.omm.dir 항목에 설정한 경로에 DB에 업로드할 파일들을 위치시킨다.

3.3. 실행

java -jar bxi.tool-{version}.jar omm
omm

4. 암복호화

평문을 암호화하거나, 암호문을 복호화한다.

4.1. 실행

java -jar bxi.tool-{version}.jar encrypt  [평문]
java -jar bxi.tool-{version}.jar decrypt  [암호문]

5. 보안키 생성

Tool에서 제공하는 키 이외에 다른 키를 사용하고 싶은 경우, 직접 키를 생성할 수 있다.

5.1. 실행

java -jar bxi.tool-{version}.jar genKey [평문]

생성된 보안키를 사용하려면 엔진의 config/security.key, 엔진, 웹어드민에 일괄적용해야 한다.

입력 평문 길이는 반드시 16, 24, 32 bytes중 하나여야 한다.

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

Copyright© Bankwareglobal All Rights Reserved.