KR_POSTCODE 는 SAP용 주소입력 API 입니다.

다음주소API 화면을 ABAP(or WDA or FPM) 에서 호출 하고 결과를 받을 수 있습니다.

스탠다드 주소 입력 부분을 enhnace 했기 때문에 KR 국가 선택시 서치헬프로 입력할 수 있습니다.

METHOD readme.

---

• 설명서

---

• 배포처: https://github.com/boy0korea/KR_POSTCODE
• 버전: 2.0 (2021.07.09)
• 참고: 다음 우편번호 API - Daum

•   https://postcode.map.daum.net/guide
  

---

• 데모: ZKR_POSTCODE_DEMO

---

SUBMIT zkr_postcode_demo.

---

• 리턴값 설명

---

DATA: ls_addr TYPE zcl_kr_postcode=>ts_addr.

ls_addr-kr60 = 'STREET 필드용 길이 60자'.
ls_addr-kr40 = 'CITY 필드용 길이 40자'.
ls_addr-en60 = 'STREET 필드용 길이 60자'.
ls_addr-en40 = 'CITY 필드용 길이 40자'.
ls_addr-zonecode = '우편번호'.
ls_addr-roadaddress = '도로명 주소 한글'.
ls_addr-roadaddressenglish = '도로명 주소 영문'.
ls_addr-jibunaddress = '(구)지번 주소 한글'.
ls_addr-jibunaddressenglish = '(구)지번 주소 영문'.
" 기타 리턴값은 위 guide 홈페이지에서 확인하세요.
" 60/40 으로 나누는 기준은 CONVERT_JSON_TO_ADDR 메소드에 있는 로직을 참고하세요.
convert_json_to_addr( space ).

---

• 메소드 설명

---

" for FPM
" 시작:
zcl_kr_postcode=>fpm_start2(
    iv_callback_event_id = 'ZKR_POSTCODE'
).
" 종료: iv_callback_event_id 에서 입력한 이벤트 일때 구현하세요.
DATA: io_event TYPE REF TO cl_fpm_event.
io_event->mo_event_data->get_value(
  EXPORTING
    iv_key   = 'IS_ADDR'
  IMPORTING
    ev_value = ls_addr
).
" 데모: ZKR_POSTCODE_DEMO_FPM
DATA: lo_fpm_feeder TYPE REF TO zcl_kr_postcode_demo_fpm_form.


" for WD
" 시작:
zcl_kr_postcode=>wd_start2(
  EXPORTING
    iv_callback_action = 'ZKR_POSTCODE'
    io_view            = wdr_task=>application->focused_view_element->get_view( ) " wd_ths->wd_get_api( )
).
" 종료: iv_callback_action 에서 입력한 ACTION에 구현하세요.
DATA: wdevent TYPE REF TO cl_wd_custom_event.
wdevent->get_data(
  EXPORTING
    name  = 'IS_ADDR'
  IMPORTING
    value = ls_addr
).
" 데모: ZKR_POSTCODE_DEMO_WD


" for SAP GUI
" 시작:
DATA: lo_event_handler TYPE REF TO zif_kr_postcode_event.
zcl_kr_postcode=>gui_start(
  EXPORTING
    io_event_handler = lo_event_handler

•    iv_full_screen   = iv_full_screen
  

•  RECEIVING
  

•    ro_postcode      = ro_postcode
  

  ). " 종료: 이벤트 핸들러의 ON_RETURN 메소드를 구현하세요. lo_event_handler->on_return( is_addr = ls_addr ). " 데모: ZKR_POSTCODE_DEMO_GUI SUBMIT zkr_postcode_demo_gui.

  " search help: ZH_KR_POSTCODE DEFINE sh. PARAMETERS: p_x TYPE ad_pstcd1 MATCHCODE OBJECT zh_kr_postcode. END-OF-DEFINITION.

---

• 기타 설명

---

• " BSP 필요함. ---> 2.0 에서는 필요없음.
• readme_bsp_zkr_postcode( ). " Web Object 업로드 필요함. --> abapGit 사용으로 자동 추가 됨. readme_smw0_zkr_postcode( ).

---

• 버전별 변경 기록

---

• 1.0 (2021.03.30) 최초 공개

• 1.1 (2021.03.31) BSP page에서 상단에 back 버튼 추가

• 1.2 (2021.04.01) 지번주소 60자,40자 필드 추가

• 2.0 (2021.07.09) 스탠다드 주소 입력 부분 enhancement 추가

•              WD 와 FPM 내부팝업 형태로 변경한 version 2 추가
  

  ENDMETHOD. "readme