인터페이스 설계 1

인터페이스 요구사항

01. 인터페이스 요구사항

1) 인터페이스(Interface)의 개념

• 서로 다른 두 개의 시스템 사이에서 정보를 주고받는 경계면
• 사물 간 또는 사물과 인간 간의 의사소통이 가능하도록 만들어진 물리적이나 논리적 매개체

2) 시스템 인터페이스의 요구사항

• 시스템 인터페이스는 서로 다른 독립적인 시스템들이 연동을 통해 상호 작용하기 위한 접속 방법이나 규칙을 의미
• 시스템 간의 인터페이스를 통하여 특정 기능(업무)을 수행하기 위해서는 시스템 인터페이스 설계와 개발이 요구됨
• 시스템 인터페이스 요구사항은 인터페이스명, 연계 대상 시스템, 연계 범위, 연계 내용, 연계 방식, 송신 데이터, 인터페이스 주기 등의 고려사항을 명시가나 것
• 인터페이스 대상 시스템 및 기관과 시스템 연동 방안은 사전에 협의해야 함

3) 내, 외부 인터페이스 요구사항

1. 내, 외부 인터페이스 요구사항의 개념

• 회사 내부, 외부에 존재하는 시스템이 연동을 통해 상호 작용하기 위한 접속 방법이나 규칙을 의미
• 인터넷이나 네트워크를 통해 내부, 외부에 존재하는 시스템 간의 요구사항을 수행하기 위해서는 내, 외부 인터페이스 설계와 개발이 필수적

2. 내, 외부 인터페이스 요구사항의 구성 요소

• 내, 외부 인터페이스 이름
• 연계 대상 시스템
• 연게 범위 및 내용
• 연계 방식
• 송신 데이터
• 인터페이스 주기

3. 내, 외부 인터페이스 요구사항 분석

• 요구사항 정의 단계에서 정의된 기능 및 비기능 내, 외부 인터페이스 요구사항을 식별
• 식별된 요구사항을 분류하고, 조직화하여 요구사항 명세서를 구체화하는 작업
• 요구사항 명세서와 개념 모델을 검토하여 상위 수준의 요구사항을 분해하고 적절한 수준으로 상세화
• 요구사항에 대한 중요도를 평가하여 우선순위를 부여함

4) 기능적, 비기능적 요구사항

1. 기능적 요구사항

• 내, 외부 시스템 연계를 통해 수행될 기능과 관련되어 입출력 요구사항
• 내, 외부 시스템 사이의 처리 과정에 대한 요구사항
• 목표 시스템 구현을 위해 소프트웨어가 가져야 하는 기능적 속성에 대한 요구사항

2. 비기능적 요구사항

• 시스템 인터페이스 기능에 관련되지 않는 요구사항
• 시스템 인터페이스 기능의 요구사항을 만족하고 정상적으로 작동하기 위한 시스템 내, 외부의 제약조건에 대한 요구사항
• 응답 시간, 처리량, 사용의 용이성, 신뢰도, 보안성, 운용상의 제약, 안전성에 대한 요구사항
• 행위적 특성이나 시스템 전반과 관련된 요구사항
• 데이터 송수신 시 암호화의 요구사항
• 내용 문서화와 관련된 요구사항

5) 시스템 인터페이스의 요구사항 분석

• 요구사항 정의 단계에서 정의한 기능적 인터페이스 요구사항과 비기능적 인터페이스 요구사항을 상세하게 이해
• 시스템 인터페이스 요구사항을 분류하고 조직화하여 명세를 구체화
• 시스템 인터페이스 요구사항 명세서와 유스케이스 다이어그램과 같은 개념 모델을 검토
• 상위 수준의 시스템 인터페이스 요구사항은 분해하여 적절한 수준으로 상세화
• 누락된 시스템 인터페이스 요구사항을 정의
• 시스템 인터페이스 요구사항의 상대적 중요도를 평가하여 우선순위를 부여
• 시스템 인터페이스의 요구사항 품질과 속성을 도출

6) 시스템 인터페이스의 요구사항 명세서 작성 시 고려사항

• 시스템 인터페이스별로 연계 방식과 연계 유형, 연계 주기를 식별할 수 있도록 작성
• 교환되는 데이터에 대한 정보를 식별할 수 있도록 작성
• 시스템 인터페이스에 필요한 보안이나 통신 네트워크 환경을 작성
• 업무 담당자와 정보 기술 담당자 정보를 확인할 수 있도록 함

---

02. 인터페이스 요구사항 검증

1) 인터페이스 요구사항 검증(Verification)의 개념

• 인터페이스 요구사항 명세서에 사용자의 요구가 올바르게 기술되었는지에 대해 검토하고 베이스라인으로 설정하는 활동
• 인터페이스 요구사항 명세서의 오류가 개발 단계나 운영되고 있는 상태에서 발견된다면 오류 수정 및 재 작업 비용이 많이 소요되느모 프로젝트에서 인터페이스 요구사항 검증이 중요함
• 인터페이스 요구사항 검증은 인터페이스 요구사항 검토 계획을 수립하고 고객과 분석가 등 다양한 이해관계자들과 함께 다양한 시각에서 공식적으로 검토하고 승인해야 함

2) 인터페이스 요구사항 검증 절차

1. 인터페이스 요구사항 검토 계획 수립

• 품질 관리자 또는 프로젝트 관리자와 같이 품질 관리 담당자가 인터페이스 요구사항 검토 기준과 검토 방법, 검토 일정과 참여자 등을 포함한 이터페이스 요구사항 검토 계획을 수립
• 인터페이스 요구사항 검증의 경우, 기술 아키텍처 전문가 또는 인터페이스 전문가가 참여하여 인터페이스 요구사항 점검 방법과 점검 내용 등을 결정

2. 인터페이스 요구사항 명세서 검토와 오류 수정

• 인터페이스 요구사항 검토 계획 수립 시 선정한 검토 방법과 검토 기준에 따라 인터페이스 요구사항 명세서를 검토하는 과정
• 인터페이스 요구사항 검토에 참여한 참여자들은 명세서가 명세 표준을 준수하고 있는지, 인터페이스 요구사항 명세서 내에 기술된 용어는 일관성과 표준성, 이해 용이성을 가졌는지 검증
• 명세서에 기술된 인터페이스 요구사항 내용은 서로 상충하지 않았는지 등을 검토하고 인터페이스 요구사항 명세서를 수정하도록 피드백

3. 인터페이스 요구사항 베이스라인 설정

• 인터페이스 요구사항 검토를 통해 검증된 인터페이스 요구사항을 공식적으로 승인하고 소프트웨어 설계와 구현을 할 수 있도록 인터페이스 요구사항 명세서의 베이스라인을 설정
• 베이스라인 설정 이후 인터페이스 요구사항은 공식적인 변경 통제 절차로만 변경할 수 있음

3) 인터페이스 요구사항 품질 평가 항목별 측정 방법

1. 기능 완전성
   • X = (도출된 기능 요구사항의 수) / (전체 사용자 기능 요구사항의 수)
2. 품질 완전성
   • X = (도출된 비기능 요구사항의 수) / (전체 사용자 비기능 요구사항의 수)
3. 기능 정확성
   • X = (논리적으로 정확하게 기술한 기능 요구사항의 수) / (도출된 세부 기능 요구사항의 수)
4. 품질 정확성
   • X = (논리적으로 정확하게 기술한 비기능 요구사항의 수) / (도출된 세부 비기능 요구사항의 수)
5. 요구사항 일관성
   • X = 1 - (연관된 요구사항 간 충돌 건수) / (도출된 요구사항 내 연관 건수)

---

03. 인터페이스 시스템 식별

1) 인터페이스 송신 시스템

• 연계할 데이터를 데이터베이스와 응용 프로그램으로부터 연계 테이블이나 파일 형태로 만들어 송신하는 시스템

단계	단계별 작업	식별 대상
1	연계 데이터 생성, 추출	연계 프로그램, 로그 테이블/파일
2	코드 매핑 및 데이터 변환	연계 프로그램, 로그 테이블/파일, 코드 매핑 테이블
3	인터페이스 테이블/파일 생성	연계 프로그램, 로그 테이블/파일, 인터페이스 테이블/파일
4	로그 기록	연계 프로그램, 로그 테이블/파일
5	연계 서버 또는 송신 Adapter	연계 서버

2) 인터페이스 수신 시스템

• 수신한 연계 테이블이나 파일의 데이터를 수신 시스템에서 관리하는 데이터 형식에 맞게 변환
• 수신한 데이터를 데이터베이스에 저장하거나 응용 프로그램에서 활용할 수 있도록 제공하는 시스템

단계	단계별 작업	식별 대상
1	연계 서버 또는 수신 Adapter	연계 서버
2	인터페이스 테이블/파일 생성	연계 프로그램, 로그 테이블/파일, 인터페이스 테이블/파일
3	코드 매핑 및 데이터 변환	연계 프로그램, 로그 테이블/파일, 코드 매핑 테이블
4	로그 기록	연계 프로그램, 로그 테이블/파일
5	연계 데이터 반영	연계 프로그램, 로그 테이블/파일

3) 인터페이스 중계 시스템

• 송수신 시스템 사이에서 데이터를 송수신하고 송수신 현황을 감시하는 시스템
• 연계 데이터의 보안 강화나 다중 플랫폼 지원 등이 가능함

4) 인터페이스 시스템 분류 체계

1. 인터페이스 시스템 분류 체계의 개념

• 조직에서 사용하고 있는 시스템 분류 체계를 바탕으로 인터페이스 시스템의 식별자를 정의함
• 인터페이스 시스템은 일반적으로 조직의 업무를 대, 중, 소로 파악하고 상위 시스템과 하위 시스템을 구분
• 인터페이스 시스템을 구분할 필요가 없는 경우는 대분류를 기준으로 시스템을 식별하고 업무 대분류명을 시스템명으로 사용할 수 있음

5) 인터페이스 시스템 식별 정보

• 조직 내부나 외부의 연계를 위해 송수신 시스템에 대한 상세 식별 정보가 필요함

식별 정보	상세 식별 정보
조직 구분	내부 시스템과 외부 시스템을 구분
조직명	외부 시스템인 경우에 조직명을 그대로 사용함
시스템	시스템의 업무, 위치 정보를 부여
네트워크	속도, 신호 방식, 제약조건 등을 부여
Port	접속에 필요한 Port 정보를 부여
Login 정보	로그인 ID와 암호를 부여
DB 정보	DBMS의 종류, DBMS의 로그인 정보를 부여
담당자	시스템 담당자 연락처를 부여

6) 인터페이스 식별 대상 데이터

• 전문 공통부는 인터페이스 표준 항목을 포함
• 전문 개별부는 업무 처리에 필요한 데이터를 포함
• 전문 종료부는 전송 데이터의 끝을 표시하는 문자를 포함
• 송수신 시스템 사이에서 교환되는 데이터는 규격화된 표준 형식에 따라 송수신함
• 송수신 시스템 간에 전송되는 표준 항목과 업무 처리용 데이터 및 공통 코드 정보는 빠짐없이 식별하고 인터페이스 명세서를 작성함

7) 인터페이스 표준 항목(공통 항목)

1. 시스템 공통부

• 시스템 간 연동 시 필요한 공통 정보
• 인터페이스 ID와 전송 시스템 정보, 서비스 코드 정보, 응답 결과 정보, 장애 정보 등으로 구성
• 공통적으로 사용되는 코드 정보는 공통 코드로 추출하고 시스템에서 공통으로 관리함

2. 거래 공통부

• 연동 처리 시 필요한 직원 정보와 승인자 정보, 기기 정보, 매체 정보, 테스트 정도 등으로 구성

8) 인터페이스 송수신 데이터 항목

• 인터페이스 송수신 시스템이 업무를 수행하는 데 사용하는 데이터
• 인터페이스 송수신 데이터 항목과 순서가 인터페이스별로 다름
• 인터페이스 송수신 데이터를 식별하여 연계 데이터 항복과 매핑 정의, SQL문의 설계를 할 수 있음
• 인터페이스 송수신 데이터의 식별은 요구사항에 나타난 주요 정보 항목을 기반으로 테이블과 항목 등의 데이터베이스 산출물을 확인함
• 업무 담당자 인터뷰와 확인 과정을 통해서 송수신 데이터 항목(개별 항목)을 정의
• 공통 코드 항목(연계 시스템 콛, 상태 코드, 오류 코드 등)에 대해 코드값과 코드명, 코드 설명 정보 등을 공통 코드로 관리해야 함