목차

협업 - 주소록

개요

주소록 서비스는 시스템에 속한 다른 사용자의 정보를 조회하여 사용자의 주소록에 등록하거나,
자신의 주소록을 개인별, 부서별, 회사별로 공개하여 다른 사용자가 활용할 수 있도록 하는 기능을 제공한다.
주소록을 활용하는 방법은 직접 등록하여 활용하는 방법과 다른 사용자가 부서 및 회사 공개로 지정하여 등록한 주소록을 조회한 후 활용하는 방법이 있다.
주소록에 대한 수정 및 삭제는 자신이 등록한 주소록에 대해서만 가능하다.

주소록 등록 시에는 Validator Rule을 통해 필수항목에 대한 조건을 검사하며,
Validator Rule은 Valator-rules.xml과 미리 정의된 컴포넌트 Validator xml을 통해 적용된다.

주소록 서비스는 HTML5, jQuery와 함께 jQM(jQuery Mobile)을 바탕으로 개발된 모바일 공통 컴포넌트이다.
자세한 사항은 모바일 실행환경 가이드를 통해 안내되고 있다.

컴포넌트와 관련된 css로는 기본적으로 적용되는 EgovMobile.css와 함께 egovBoard.css, ussCommon.css가 사용된다.
또한 공통으로 지원하고 있는 jAlert가 사용되고 있으며, 아래와 같은 js 파일에 정의되어 있다.

지원대상

본 컴포넌트는 모바일 디바이스에서 사용 가능한 브라우저를 대상으로 개발 및 테스트를 완료하였으며
PC용 브라우저와 mobile용 브라우저의 HTML5, CSS3 에 대한 지원이 상이함으로 개발, 적용 시에 주의가 필요하다.

개발 및 테스트를 위해 갤럭시S2, 갤럭시S, 갤럭시탭, iPad2, iPhone4 등의 모바일 기기와
Android 기본 브라우저, Firefox, Safari, Opera Mobile 등의 모바일 브라우저를 사용하였다.

Android

테스트 디바이스로는 갤럭시S, 갤럭시S2, 갤럭시탭을 사용하였으며,
브라우저는 Android 기본 브라우저, Firefox(6.xx), Opera Mobile 브라우저를 사용하였다.

하지만, Opera Mobile의 경우에는 색상 및 이벤트 처리에 일부 문제가 발생하여 3종지원 브라우저 대상에서 제외되었다.

iOS

테스트 디바이스로는 iPhone4, iPad2를 사용하였다.

기능흐름도

설명

주소록 기능은 크게 주소록을 생성하는 주소록등록 기능, 사용자가 등록한 주소록과 공개되어 열람가능한 주소록을 조회할수 있는 주소록 목록조회 기능, 사용자가 등록한 주소록을 조회하고 수정할수 있는 주소록 조회수정 기능의 3가지 기능을 제공한다.

관련 클래스다이어그램

관련소스
유형대상소스비고
Controlleregovframework.com.cop.adb.web.EgovAdressBookController.java주소록 관리를 위한 컨트롤러 클래스
Controlleregovframework.mbl.com.cop.adb.web.EgovMblAdressBookController.java모바일 주소록 관리를 위한 컨트롤러 클래스
Serviceegovframework.com.cop.adb.service.EgovAdressBookService.java주소록 관리를 위한 서비스 인터페이스
ServiceImplegovframework.com.cop.adb.service.impl.EgovAdressBookServiceImpl.java주소록 관리를 위한 서비스 구현 클래스
VOegovframework.com.cop.adb.service.AdressBook.java주소록 관리를 위한 모델 클래스
VOegovframework.com.cop.adb.service.AdressBookUser.java주소록구성원 관리를 위한 모델 클래스
VOegovframework.com.cop.adb.service.AdressBookVO.java주소록 관리를 위한 VO 클래스
DAOegovframework.com.cop.adb.service.impl.AdressBookDAO.java주소록 관리를 위한 데이터처리 클래스
JSP/WEB-INF/jsp/egovframework/com/cop/adb/EgovAdressBookRegist.jsp.jsp주소록 등록을 위한 jsp페이지
JSP/WEB-INF/jsp/egovframework/com/cop/adb/EgovAdressBookUpdt.jsp.jsp생성된 주소록 수정을 위한 jsp페이지
JSP/WEB-INF/jsp/egovframework/com/cop/adb/EgovAdressBookList.jsp.jsp조회가능한 주소록 조회를 위한 jsp페이지
JSP/WEB-INF/jsp/egovframework/com/cop/adb/EgovMyAdressBookPopup.jsp주소록구성원을 조회 등록시키기 위한 팝업 jsp페이지
JSP/WEB-INF/jsp/egovframework/com/cop/adb/EgovAdressBookMainList.jsp마이페이지 구성을 위한 목록 jsp페이지
JSP/WEB-INF/jsp/egovframework/mbl/com/cop/adb/EgovAdressBookRegist.jsp.jsp주소록 등록을 위한 모바일 jsp페이지
JSP/WEB-INF/jsp/egovframework/mbl/com/cop/adb/EgovAdressBookUpdt.jsp.jsp생성된 주소록 수정을 위한 모바일 jsp페이지
JSP/WEB-INF/jsp/egovframework/mbl/com/cop/adb/EgovAdressBookList.jsp.jsp조회가능한 주소록 조회를 위한 모바일 jsp페이지
JSP/WEB-INF/jsp/egovframework/mbl/com/cop/adb/EgovMyAdressBookPopup.jsp주소록구성원을 조회 등록시키기 위한 팝업 모바일 jsp페이지
Query XMLresources/egovframework/sqlmap/com/cop/adb/EgovNcrd_SQL.xml주소록 관리를 Query 파일
관련테이블
테이블명테이블명(영문)비고
주소록정보속성COMTNADBK주소록의 속성정보를 관리
주소록구성원속성COMTNADBKUSER주소록의 사용정보를 관리

환경설정

본 기능은 전자정부 표준프레임워크 실행환경의 ID Generation 기능을 활용하여 구성되어 있다.

관련 설정 사항

  CREATE TABLE COMTECOPSEQ ( table_name varchar(16) NOT NULL, 
  		   next_id DECIMAL(30) NOT NULL,
  		   PRIMARY KEY (table_name));
  INSERT INTO COMTECOPSEQ VALUES('ADBK_ID','0');
  INSERT INTO COMTECOPSEQ VALUES('ADBKUSER_ID','0');
 

사용방법

주소록 목록조회

비즈니스 규칙

- 검색조건을 지정하여 목록을 조회 할 수 있다.
- 등록버튼을 클릭하여 주소록 등록 화면으로 이동할 수 있다.
- X(삭제) 이미지를 클릭하여 주소록을 삭제할 수 있다.

주소록 목록조회 화면으로 이동하기 위한 URL은 다음과 같다.

/cop/adb/adbkList.mdo

관련코드

N/A

관련화면 및 수행매뉴얼

기능URLControllermethod화면(JSP)
목록조회/cop/adb/selectAdbkList.mdoEgovMblAdressBookControllerselectAdressBookList…/cop/adb/EgovAdressBookList.jsp

주소록 목록은 페이지당 10건씩 조회되며 페이징은 1페이지씩 이루어진다.
검색 조건은 주소록명, 공개범위, 등록자명을 사용한다.

주소록을 삭제하기 위해서는 목록에 생성되어 있는 X(삭제) 이미지를 클릭하면 된다.
단, 주소록을 작성한 등록자와 현재의 사용자가 일치될 때에만 X(삭제) 이미지가 표시된다.

홈: 홈 화면으로 이동한다.
등록 : 주소록 등록 화면으로 이동한다.
검색: 주소록정보를 조회하기 위해서는 상단의 검색조건을 선택하고 해당하는 검색문자를 입력 후 검색 버튼을 클릭한다.
목록클릭 : 주소록 상세조회 화면으로 이동한다.
X(삭제) 이미지 : 삭제여부를 확인하는 메세지를 보여주고 주소록에 대한 내용을 삭제처리 한다.


주소록등록

비즈니스 규칙

주소록에 대한 주소록명과 공개범위, 구성원 등을 선택하여 주소록을 등록하며, 등록이 성공되면 주소록 목록조회 화면으로 이동한다.
등록시에 입력하는 구성원 정보는 주소록구성원 조회팝업 화면을 통하여 검색 후 선택할 수 있다.

주소록을 등록하기 위한 화면으로 이동하는 URL은 다음과 같다.

/cop/adb/addAdbkInf.mdo

관련코드

N/A

관련화면 및 수행매뉴얼

기능URLControllermethod화면(JSP)
등록/cop/adb/registAdbkInf.mdoEgovMblAdressBookControllerregistadbk…/cop/adb/EgovAdressBookRegist.jsp

공개범위가 부서인 경우는 같은 부서원들에게, 공개범위가 회사인 경우에는 같은 회사원들에게 주소록의 내용이 공개되어 볼 수 있게 된다.

뒤로 : 주소록 목록조회 화면으로 이동한다.
등록 : 해당 주소록을 등록 처리한다.
목록 : 주소록 목록조회 화면으로 이동한다.


주소록 조회수정

비즈니스 규칙

주소록에 대한 상세내용을 변경한 뒤 수정 버튼을 누르면 주소록 정보가 수정되고 주소록 목록조회 화면으로 이동한다.
수정시에 입력하는 구성원 정보는 주소록구성원 조회팝업 화면을 통하여 검색 후 선택할 수 있다.

주소록을 수정하기 위한 화면으로 이동하는 URL은 다음과 같다.

/cop/adb/updateAdbkInf.mdo

관련코드

N/A

관련화면 및 수행매뉴얼

기능URLControllermethod화면(JSP)
수정/cop/adb/UpdateAdressBook.mdoEgovMblAdressBookControllerUpdateAdressBook…/cop/adb/EgovAdbkUpdt.jsp

뒤로 : 주소록 상세조회 화면으로 이동한다.
수정 : 해당 주소록을 수정 처리한다.
목록 : 주소록 목록조회 화면으로 이동한다.


주소록구성원 조회팝업

비즈니스 규칙

사전에 등록된 사용자를 조회하여 주소록 구성원으로 선택하고 등록시킬수 있다.

주소록구성원 조회팝업 화면으로 이동하는 URL은 다음과 같다.

/cop/adb/openPopup.mdo

관련코드

N/A

관련화면 및 수행매뉴얼

기능URLControllermethod화면(JSP)
조회팝업/cop/adb/selectManList.mdoEgovMblAdressBookControllerselectUserList…/cop/adb/EgovAdressBookPopup.jsp

뒤로 : 주소록 등록 화면 또는 주소록 수정 화면으로 이동한다.
검색 : 사용자정보를 조회하기 위해서는 상단의 검색조건을 선택하고 해당하는 검색문자를 입력 후 검색 버튼을 클릭한다.
목록 클릭 : 해당 사용자가 주소록의 구성원에 추가된다.

참고자료