[정보처리기사 필기] 인터페이스 설계 - 026. 인터페이스 방법 명세화

1. 인터페이스 방법 명세화의 개념

• 내외부 시스템이 연계하여 작동할 때 인터페이스별 송수신 방법, 송수신 데이터, 오류 식별 및 처리 방안에 대한 내용을 문서로 명확하게 정리하는 것
• 인터페이스별로 송수신 방법을 명세화하기 위해서는 시스템 연계 기술, 인터페이스 통신 유형, 처리 유형, 발생 주기 등에 대한 정보가 필요

2. 시스템 연계 기술

• 개발할 시스템과 내외부 시스템을 연계할 때 사용되는 기술
• 주요 시스템 연계 기술의 종류
  • DB Link : DB에서 제공하는 DB Link 객체를 이용하는 방식
  • API / Open API : 송신 시스템의 데이터베이스에서 데이터를 읽어 와 제공하는 애플리케이션 프로그래밍 인터페이스 프로그램
  • 연계 솔루션 : EAI 서버와 송수신 시스템에 설치하는 클라이언트를 이용하는 방식
  • Socket : 서버는 통신을 위한 소켓을 생성하여 포트를 할당하고 클라이언트의 통신 요청 시 클라이언트와 연결하여 통신하는 네트워크 기술
  • Web Service : 웹 서비스에서 WSDL과 UDDI, SOAP 프로토콜을 이용하여 연계하는 서비스
    • WSDL : 웹서비스와 관련된 서식이나 프로토콜 등을 표준적인 방법으로 기술하고 게시하기 위한 언어
    • UDD : 인터넷에서 전 세계의 비즈니스 업체 목록이 자신의 목록을 등록하기 위한 확장성 생성언어(XML) 기반의 규격
    • SOAP : 웹서비스를 실제로 이용하기 위한 객체 간의 통신 규약

3. 인터페이스 통신 유형

• 개발할 시스템과 내외부 시스템 간 데이터를 송수신하는 형태
• 인터페이스 통신 유형의 종류
  • 단방향 : 시스템에서 거래를 요청만 하고 응답이 없는 방식
  • 동기 : 시스템에서 거래를 요청하고 응답이 올 때까지 대기하는 방식
  • 비동기 : 시스템에서 거래를 요청하고 다른 작업을 수행하다 응답이 오면 처리하는 방식

4. 인터페이스 처리 유형

• 송수신 데이터를 어떤 형태로 처리할 것인지에 대한 방식을 의미
• 인터페이스 처리 유형의 종류
  • 실시간 방식 : 사용자가 요청한 내용을 바로 처리해야 할 때 사용하는 방식
  • 지연 처리 방식 : 데이터를 매건 단위로 처리할 경우 비용이 많이 발생할 때 사용하는 방식
  • 배치 방식 : 대량의 데이터를 처리할 때 사용하는 방식

5. 인터페이스 발생 주기

• 개발할 시스템과 내외부 시스템 간 송수신 데이터가 전송되어 인터페이스가 사용되는 주기
• 업무의 성격과 송수신 데이터 전송량을 고려하여 매일, 수시, 주 1회 등으로 구분

6. 송수신 방법 명세화

• 내외부 인터페이스 목록에 있는 각각의 인터페이스에 대해 연계 방식, 통신 및 처리 유형, 발생 주기 등의 송수신 방법을 정의하고 명세를 작성하는 것

인터페이스 ID

인터페이스 명

송신 시스템

수신 시스템

연계 방식

통신 유형

연계 처리 형태

연계 주기

7. 송수신 데이터 명세화

• 내외부 인터페이스 목록에 있는 각각의 인터페이스에 대해 인터페이스 시 필요한 송수신 데이터에 대한 명세를 작성
• 인터페이스별로 테이블 정의서와 파일 레이아웃에서 연계하고자 하는 테이블 또는 파일 단위로 송수신 데이터에 대한 명세를 작성

인터페이스 ID
송수신 구분
시스템명
업무
서비스명
데이터 항목 (테이블 정의서)
Seq	Field	Key	Type	Size	Null 허용	Description	Condition
1	필드 ID	필드가 키인 경우에 기재		필드의 길이, 바이트 단위		필드의 간단한 설명	암호화 적용여부, 공통 코드 여부 기재

8. 오류 식별 및 처리 방안 명세화

• 내외부 인터페이스 목록에 있는 각각의 인터페이스에 대해 인터페이스 시 발생할 수 있는 오류를 식별하고 오류 처리 방안에 대한 명세를 작성하는 것
• 시스템 및 전송 오류, 연계 프로그램 등에서 정의한 예외 상황 등 대내외 시스템 연계 시 발생할 수 있는 다양한 오류 상황을 식별하고 분류
• 오류 상황에 대해 오류 코드, 오류 메시지, 오류 설명, 해결 방법 등을 명세
• 오류 식별의 연계 매커니즘 구성요소
  • 송신 시스템 : 연계 프로그램으로부터 생성된 데이터를 전송 형식에 맞게 인터페이스 테이블이나 파일로 변환한 후 송신하는 시스템
  • 수신 시스템 : 수신한 인터페이스 테이블이나 파일을 연계 프로그램에서 처리할 수 있는 형식으로 변환한 후 연계 프로그램에 반영하는 시스템
  • 연계 서버 : 송수신 시스템 사이에 위치하여 데이터의 송수신 현황을 모니터링하는 역할을 수행

오류 코드

오류 메시지

설명

해결 방법