도로명 주소찾기, 우편번호관리

개요

도로명주소 안내시스템( https://www.juso.go.kr/ ) 연계를 통해 우편번호와 주소를 관리하고 도로명 찾기 기능을 팝업창으로 제공하여 우편번호 및 주소 등록 시 활용 할 수 있도록 하고 팝업화면을 호출할 수 있는 활용 예시를 제공한다.

설명

패키지 참조 관계

우편번호 패키지는 요소기술의 공통 패키지(cmm)에 대해서만 직접적인 함수적 참조 관계를 가진다.

• 패키지 간 참조 관계 : 시스템관리 Package Dependency

관련소스

관련테이블

환경설정

우편번호 엑셀파일 등록 기능을 활용하기 위하여 필요한 항목 및 그 환경 설정은 다음과 같다.

context-excel.xml

    <bean id="excelZipService"	class="egovframework.rte.fdl.excel.impl.EgovExcelServiceImpl">
       <property name="propertyPath" value="excelInfo.xml" />
       <property name="mapClass" value="egovframework.com.sym.ccm.zip.service.impl.EgovCcmExcelZipMapping" />
       <property name="sqlMapClient" ref="egov.sqlMapClient" />
    </bean>
 
    <bean id="excelRdnmadZipService"	class="egovframework.rte.fdl.excel.impl.EgovExcelServiceImpl">
        <property name="propertyPath" value="excelInfo.xml" />
        <property name="mapClass" value="egovframework.com.sym.ccm.zip.service.impl.EgovCcmExcelRdnmadZipMapping" />
        <property name="sqlMapClient" ref="egov.sqlMapClient" />
    </bean>

우편번호 엑셀 파일을 등록하기 위하여 실행환경의 엑셀서비스 구현 클래스를 등록하여 사용한다. 우편번호 등록을 위한 맵핑 클래스를 등록한다.

context-common.xml

<!-- custom multi file resolver -->    
<bean id="local.MultiCommonsMultipartResolver"
  class="egovframework.com.cmm.web.EgovMultipartResolver">
    <property name="maxUploadSize" value="100000000" />
    <property name="maxInMemorySize" value="100000000" />
</bean>
 
<!-- choose one from above and alias it to the name Spring expects -->
<alias name="local.MultiCommonsMultipartResolver" alias="multipartResolver" />

우편번호 엑셀 파일을 등록하기 위하여 파일 등록 처리를 사용한다.

관련기능

우편번호 관련기능은 우편번호 주소찾기, 우편번호관리는 우편번호 찾기, 우편번호 목록조회, 우편번호 등록, 우편번호 엑셀파일 등록, 우편번호 수정, 우편번호 상세조회 기능으로 구분된다. 도로명 관련기능은 도로명 주소찾기, 도로명관리는 도로명 찾기, 도로명 목록조회, 도로명 등록, 도로명 엑셀파일 등록, 도로명 수정, 도로명 상세조회 기능으로 구분된다.

우편번호, 도로명 찾기

비즈니스 규칙

우편번호 찾기 팝업 호출을 위하여 상기 환경설정까지 완료한 후 다음사항을 적용한다.

관련코드

N/A

관련화면 및 수행매뉴얼

도로명 주소연계 서비스의 우편번호/도로명 찾기 팝업 호출을 위하여 EgovAdressPop.jsp 를 해당 페이지(EgovCcmZipRegist.jsp)에서 호출 한다.

function goAddSearch() {
    var pop = window.open("<c:url value='/sym/ccm/zip/EgovAdressPop.do' />","pop","width=570,height=420, 
    scrollbars=yes, resizable=yes"); 
}

우편번호/도로명 주소를 사용할 값을 폼에 입력 후 위 샘플 소스처럼 호출 하여 사용한다. 우편번호는 5자리를 받고, ‘-‘를 생략하여 받는다.

조회: 조회하기 위해서는 상단의 검색창에 검색문자를 입력 후

버튼을 클릭한다.

우편번호/도로명 목록조회

비즈니스 규칙

우편번호/도로명 목록은 페이지 당 10건씩 조회되며 페이징은 10페이지씩 이루어진다. 검색조건은 우편번호, 시도명, 시군구명, 읍면동명, 리건물명, 상세건물명(도로명)에 대해서 수행된다.

관련코드

N/A

관련화면 및 수행매뉴얼

페이지 당 검색 범위를 변경하고자 하는 경우 context-properties.xml 파일의 pageUnit, pageSize를 변경한다.(단 해당 설정은 전체 공통서비스 기능에 영향을 미친다.)

조회: 조회하기 위해서는 상단의 검색조건을 선택 후 해당하는 검색문자를 입력 후 조회 버튼을 클릭한다. 일반주소 등록: 등록하기 위해서는 상단의 등록버튼을 통해서 우편번호 일반주소 등록 페이지로 이동한다. 도로명주소 등록: 등록하기 위해서는 상단의 등록버튼을 통해서 우편번호 도로명주소 등록 페이지로 이동한다. 일반주소 엑셀파일 등록: 우편번호 엑셀 파일의 양식을 이용하여 우편번호를 등록할 수 있는 페이지로 이동한다. 도로명주소 엑셀파일 등록: 우편번호 엑셀 파일의 양식을 이용하여 우편번호를 등록할 수 있는 페이지로 이동한다. 목록클릭: 우편번호 상세조회 화면으로 이동한다.

조회: 조회하기 위해서는 상단의 검색조건을 선택 후 해당하는 검색문자를 입력 후 조회 버튼을 클릭한다. 일반주소 등록: 등록하기 위해서는 상단의 등록버튼을 통해서 우편번호 일반주소 등록 페이지로 이동한다. 도로명주소 등록: 등록하기 위해서는 상단의 등록버튼을 통해서 우편번호 도로명주소 등록 페이지로 이동한다. 일반주소 엑셀파일 등록: 우편번호 엑셀 파일의 양식을 이용하여 우편번호를 등록할 수 있는 페이지로 이동한다. 도로명주소 엑셀파일 등록: 우편번호 엑셀 파일의 양식을 이용하여 우편번호를 등록할 수 있는 페이지로 이동한다. 목록클릭: 도로명 주소 상세조회 화면으로 이동한다.

우편번호 등록

비즈니스 규칙

우편번호에 대한 상세내용을 등록한다. 등록이 성공하면 우편번호 목록 화면으로 이동한다.

관련코드

N/A

관련화면 및 수행매뉴얼

목록: 우편번호 목록 화면으로 이동한다. 저장: 입력한 우편번호 정보들이 저장 처리된다.

목록: 도로명 주소 목록 화면으로 이동한다. 저장: 입력한 도로명 정보들이 저장 처리된다.

우편번호 엑셀파일 등록

비즈니스 규칙

등록이 성공하면 우편번호 목록 화면으로 이동한다.

관련코드

N/A

관련화면 및 수행매뉴얼

다음의 우편번호 엑셀 파일의 양식을 이용하여 우편번호를 등록한다.

주소 목록 업로드 양식

우편번호 및 주소 참고사이트

도로명코드 엑셀양식 참조자료

도로명주소안내 사이트에서 대표지번으로 다운받으면 txt파일로 내려받게 된다.(’|’(파이프) 구분자로 한 텍스트 포멧임)

도로명주소 엑셀양식에 맞추어서 넣으면 된다.

※ 일변번호는 중복을 피하기 위한 일련번호로 1번부터 중복없이 순서대로 입력한다.

우편번호/도로명 엑셀등록

목록: 우편번호 목록 화면으로 이동한다. 저장: 엑셀양식으로 입력한 우편번호 정보들이 저장 처리된다.

목록: 도로명 목록 화면으로 이동한다. 저장: 엑셀양식으로 입력한 도로명 정보들이 저장 처리된다.

우편번호 수정

비즈니스 규칙

수정이 성공하면 우편번호 목록 화면으로 이동한다.

관련코드

N/A

관련화면 및 수행매뉴얼

저장: 수정된 정보들이 저장 처리된다. 목록: 우편번호 목록 화면으로 이동한다.

저장: 수정된 정보들이 저장 처리된다. 목록: 도로명 목록 화면으로 이동한다.

우편번호/도로명 상세 조회

비즈니스 규칙

상세조회에는 삭제 처리가 포함되어 있고 삭제가 성공하면 우편번호 목록 화면으로 이동한다.

관련코드

N/A

관련화면 및 수행매뉴얼

수정: 수정버튼 클릭 시 우편번호 수정 화면으로 이동한다. 삭제: 삭제버튼 클릭 시 삭제여부를 확인하는 메시지를 보여주고 삭제처리를 할 수 있다. 목록: 우편번호 목록 화면으로 이동한다.

수정: 수정버튼 클릭 시 도로명 주소 수정 화면으로 이동한다. 삭제: 삭제버튼 클릭 시 삭제여부를 확인하는 메시지를 보여주고 삭제처리를 할 수 있다. 목록: 도로명 주소 목록 화면으로 이동한다.

참고자료

실행환경 참조 : excel