본문으로 건너뛰기

설정

인터페이스 등록 절차는 AP to AP와 중복되는 부분은 제외하고 나머지에 대해서만 설명한다.

1. 전문레이아웃 등록

송수신에 사용되는 전문레이아웃을 등록한다.

2. SAF 큐정보 등록

SAF 큐 정보는 SAF 전문을 저장하고 저장되어 있는 SAF 전문을 처리하는 방법에 대한 정보로써, SAF 큐 정보 등록은 온라인 인터페이스에서 APtoSAF를 선택하면 설정 가능한 SAF 큐 정보 팝업을 이용하여 등록한다.

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

구성항목

☑ 기본정보

  • 토픽명 : SAF 전문을 저장할 큐명을 등록한다. EAI에서는 Kafka를 SAF 큐로 사용하는데, Kafka의 토픽명을 의미한다.
  • 파티션수 : SAF 큐로 EAI에서는 Kafka를 사용하는데 Kafka의 파티션 수를 의미한다. 파티션 수는 SAF 큐에 SAF 전문을 저장하거나 SAF 전문을 수신시스템에 전송하기 위한 스레드 수를 결정한다.
  • SAF큐서버정보 : SAF 큐 시스템에 접속하기 위한 접속 정보를 등록한다. EX. localhost:9092

☑ 추가정보

  • 대기시간 : 하나의 SAF 전문을 처리하고 다음 SAF 전문을 처리하기 전에 대기할 시간을 등록한다.
  • 인스턴스ID : 수신시스템에 SAF 전문을 전송하기 위한 인스턴스를 등록한다. 인스턴스를 등록하면 등록된 인스턴스에서 해당 SAF 전문을 처리하고, 등록하지 않으면 SAF 전문을 저장하는 인스턴스에서 전송도 같이 처리한다.
정보

EAI는 SAF 거래용 큐로 Kafka를 사용한다. SAF 큐정보에 큐 정보를 등록해도 Kafka에는 해당 큐가 생성되지 않으므로, SAF 큐정보에 큐 정보를 등록하면 반드시 Kafka에 등록한 정보와 동일하게 큐를 생성해주어야 한다.

3. 인터페이스 등록

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

구성항목

☑ 기본정보

  • 인터페이스방식 : APtoSAF
  • 송신시스템코드 : 송신시스템의 시스템코드
  • 송신업무코드 : 송신시스템의 업무코드
  • 수신시스템코드 : 수신시스템의 시스템코드
  • 수신업무코드 : 수신시스템의 업무코드
  • 적용일자 : 해당 인터페이스를 적용할 날짜. 당일부터 실행하고자 하는 경우, 오늘 이전 날짜를 등록한다.
  • 서비스코드 : 호출 시 동일 URL을 사용하고, 공통부의 서비스코드를 사용하는 방식에서 공통부의 서비스코드의 값을 등록한다. 기본설정관리 > 시스템별업무에서 서비스호출구분코드가 URL방식이면 대신 컨텍스트URL을 설정할 수 있는데, 이는 URL 단위로 호출하는 방식일 때 호출 URL을 정의한다.
  • 응답여부 : SAF 전문 저장 후에 송신시스템에 응답할 것인지 유무를 설정한다. 응답으로 설정하면 송신시스템에 응답전문을 전송하고, 무응답으로 설정하면 HTTP 상태코드를 정상이면 200, 에러이면 500으로 응답한다.
  • SAF큐ID : 해당 인터페이스의 SAF 전문 저장을 위한 SAF 큐를 등록한다.
  • 요청플로우 : 요청처리 시 사용될 플로우를 설정한다.

☑ 전문정보

  • 요청전문레이아웃 : 송신시스템의 요청전문 레이아웃
  • 요청공통부전문변환 : 요청전문의 공통헤더부를 변환하기 위한 변환정보

☑ 추가정보

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

4. 전문변환 등록

송수신의 전문 레이아웃이 달라 전문변환이 필요한 경우 전문변환정보를 등록한다.