본문으로 건너뛰기

설정

AP to DB 인터페이스는 전문에 SQL의 입력값을 전송하고, 인터페이스에 정의되어있는 SQL을 수행하여 DB에 반영한다. AP to DB를 등록하기 위한 절차는 다음과 같다.

1. 전문레이아웃 등록​

AP에서 인터페이스를 호출할 때 데이터를 주고받기 위해 요청전문레이아웃과 응답전문레이아웃을 등록해야 한다.

요청전문레이아웃​

전문레이아웃의 필드명과 SQL의 bind변수명을 동일하게 설정한다.

응답전문레이아웃​

- Select의 경우(단건)​

Select의 조건으로 사용되는 bind변수명과 요청전문레이아웃의 필드명이 동일해야 하고, Select의 결과컬럼명과 응답전문레이아웃의 필드명이 동일해야 한다.

- INST_CD
- USE_YN
- LAST_CHNG_DTM
- LAST_CHNG_GUID
- BLOB_DATA
- succYn: SQL 실행결과
- msgCtnt: SQL 실행오류 발생 시 오류메시지

- Select의 경우(다건)​

다건 Select의 경우에는 리스트처리가 필요하므로 parent레이아웃, sub레이아웃 2개의 레이아웃 등록이 필요하다.

  • sub레이아웃은(APtoDBresSub) Select의 결과 rows들을 의미한다. 위의 예시로 아래컬럼들로 필드를 구성한다.
- INST_CD
- USE_YN
- LAST_CHNG_DTM
- LAST_CHNG_GUID
- BLOB_DATA
  • parent레이아웃은(APtoDBresSelectList) 해당 거래의 전체적인 결과값, 상태등을 의미한다.
- succYn: SQL 실행결과
- rsltCnt: SQL 실행결과로 처리된 건수
- msgCtnt: SQL 실행오류 발생 시 오류메시지
- sub레이아웃(APtoDBresSub)

이때, 해당 건수만큼 리스트 사이즈가 만들어지도록 Array참고필드명을 rsltCnt로 설정한다.

- Insert/Update/Delete의 경우​

SQL의 결과데이터는 처리건수이므로 아래의 필드로 응답전문레이아웃에 등록한다.

- rsltCnt: SQL의 실행결과로 처리된 건수
- succYn: SQL 실행결과
- msgCtnt: SQL 실행오류 발생 시 오류메시지

2. 인터페이스 등록​

인터페이스 관리 > 온라인인터페이스를 이용하여 등록한다. 인터페이스ID, 인터페이스명은 인터페이스를 식별할 수 있는 값으로 설정한다. 각 구성항목에 대한 설명은 다음과 같다.

구성항목​

☑ 기본정보​

  • 인터페이스방식 : APtoDB
  • 송신시스템코드 : 송신시스템의 시스템코드
  • 송신업무코드 : 송신시스템의 업무코드
  • 적용일자 : 해당 인터페이스를 적용할 날짜. 당일부터 실행하고자 하는 경우, 오늘 이전 날짜를 등록한다.
  • 요청플로우 : 요청처리 시 사용될 플로우

☑ 전문정보​

  • 요청전문레이아웃 : 송신시스템의 요청전문 레이아웃
  • 응답전문레이아웃 : 수신시스템의 응답전문 레이아웃

☑ 추가정보​

  • 요청사용자프로그램 : 대내시스템의 대상서비스 또는 대외기관에 서비스를 요청하기 전에 특별한 처리가 필요한 경우 설정한다.
  • 거래제어구분 : 수신서비스의 장애 등의 사유로 인터페이스의 거래를 제어하고 싶은 경우에 사용된다. 거래제어가 되면 수신서비스로 전달되지 않고, 설정값에 따라 무응답처리나 에러응답처리를 할 수 있다. 에러응답프로그램은 엔진설정 시 정의된다.
  • 타임아웃시간(초) : 응답이 오지 않는 경우 타임아웃처리를 위한 시간설정

☑ From To​

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

☑ SQL Query​

  • 처리SQL : 전달된 데이터를 처리할 SQL