scanformats = result.format;
scanContents = result.text;
result.cancelled;
^변수^설명^비고^
|format|QR코드 및 바코드의 유형을 반환한다.| |
|text|QR코드 및 바코드 데이터의 텍스트을 반환한다.| |
|cancelled|QR코드 및 바코드의 형태를 사용자가 검색을 취소여부를 반환한다.| |
==== Server Application ====
=== 관련 소스 ===
^유형^대상소스명^비고^
|Controller|egovframework.hyb.mbl.bar.web.EgovBarcodescannerDeviceAPIController.java|BarcodescannerAPI 가이드 프로그램 Controller Class|
|Service|egovframework.hyb.mbl.bar.service.EgovBarcodescannerAPIService.java|BarcodescannerAPI 가이드 프로그램 Service Class|
|ServiceImpl|egovframework.hyb.mbl.bar.service.impl.EgovBarcodescannerDeviceAPIServiceImpl.java|BarcodescannerAPI 가이드 프로그램 ServiceImpl Class|
|VO|egovframework.hyb.mbl.bar.service.BarcodescannerAPIVO.java|BarcodescannerAPI 가이드 프로그램 VO Class|
|DAO|egovframework.hyb.mbl.bar.service.impl.BarcodescannerDeviceAPIDAO.java|BarcodescannerAPI 가이드 프로그램 Dao Class|
|QUERY XML|resources/egovframework/sqlmap/hyb/mbl/bar/EgovBarcodescannerAPIGuide_SQL_xxx.xml|BarcodescannerAPI 가이드 프로그램 QUERY XML|
=== 관련 테이블 ===
^테이블명^테이블명(영문)^비고^
|바코드스캐너|barcode_info|Barcodescanner 정보 관리|
=== 테이블 정의서 ===
* Barcodescanner
^No^컬럼ID^컬럼명^타입^길이^NULL^
|1|SN|일련번호|NUMERIC|11|NotNull|
|2|CODE_TYPE|바코드 종류|VARCHAR|45|NotNull|
|3|CODE_TEXT|바코드 데이터의 텍스트|VARCHAR|45|Null|
|4|USEYN|활성화여부|VARCHAR|45|Null|
|5|CODE_DT|등록일자|VARCHAR|45|Null|
=== ERD ===
{{:egovframework:hyb3.6:guide:mbl:newapi_erd.jpg?990|}}
===== 환경설정 =====
Barcodescanner API 가이드 프로그램에서 제공하는 모바일 Barcodescanner의 정보 조회 기능을 활용하기 위하여 필요한 항목 및 그 환경 설정은 다음과 같다.
==== Barcodescanner Application ====
=== res/xml/config.xml ===
=== res/values/serverinfo.xml ===
http://192.168.100.222:8080/DeviceAPIGuideTotal_Web_V1.7.1
=== AndroidManifest.xml ===
==== Server Application ====
=== resource/egovframework/sqlmap/sql-map-config_[DB명].xml ===
===== 관련기능 =====
BarcodescannerAPI 가이드 프로그램은 크게 Barcodescanner이용으로 QR코드 및 바코드의 정보 조회 기능과 조회된 메타 정보를 서버에 전송하고 조회할수 있는 기능으로 구성되어 있다.
==== Barcodescanner 정보 조회하기 ====
=== 관련 코드 ===
== Barcodescanner 정보 VO ==
/** Barcodescanner 정보 VO */
var BarcodescannerAPIVO = {
sn : "",
codeType : "",
codeText : "",
useYn : "",
sndDt : ""
}
== Barcodescanner 정보 화면 표시 ==
function fn_egov_load_BarcodescannerInfo() {
$('.scannerInfo:eq(0)').html(scanformats);
$('.scannerInfo:eq(1)').html(scanContents);
$.mobile.changePage('#BarcodescannerInfo', 'slide', false, false);
}
=== 관련 화면 및 수행매뉴얼 ===
^Barcodescanner 정보조회 화면^
|{{:egovframework:hyb3.6:guide:mbl:barcodescanner:barcodescanner_2.jpeg?320|}}|
Formats: QR코드 및 바코드 유형 \\
Contents : QR코드 및 바코드의 텍스트 정보 \\
==== Barcodescanner 정보 서버에 전송하기 ====
=== 비즈니스 규칙 ===
* Barcodescanner 정보의 서버 전송은 InterfaceAPI를 이용한다.
=== 관련 코드 ===
== Barcodescanner 정보 등록==
function fn_egov_save_BarcodescannerInfo() {
useYn = "Y";
var url = "/bar/addBarcodescannerDeviceInfo.do";
var formats = $(".scannerInfo:eq(0)").text();
var contents = $(".scannerInfo:eq(1)").text();
nowdate = new Date();
var date_str = nowdate.getFullYear() + "-" + (nowdate.getMonth() + 1) + "-"
+ nowdate.getDate();
var params = {
codeType : formats,
codeText : contents,
useYn : useYn,
sndDt : date_str
};
window.plugins.EgovInterface.request(url, params, function(jsondata) {
console.log("jsondata > " + jsondata);
if (jsondata.resultState == "OK") {
console.log("send ok");
} else {
$("#alert_dialog").click(function() {
jAlert('데이터 전송 중 오류가 발생 했습니다.', '전송 오류', 'c');
});
}
}, function(result) {
alert("error > " + result);
});
console.log("BarcodescannerDevice fn_egov_save_BarcodescannerInfo request Completed");
$.mobile.changePage("#main", "slide", false, false);
detailScroll.refresh();
}
=== 관련 화면 및 수행매뉴얼 ===
^Action^URL^Controller method^QueryID^
|Barcodescanner 정보 등록|/bar/addBarcodescannerDeviceInfo.do|insertDeviceInfo|"barcodescannerDeviceAPIDAO.insertBarcodescannerDevcie"|
정보 업로드: Barcodescanner 정보를 서버로 업로드 한다.
==== Barcodescanner 정보 목록 조회하기 ====
=== 관련 코드 ===
== Barcodescanner 정보 목록 조회 ==
function fn_egov_move_BarcodescanneList() {
var url = "/bar/BarcodescannerInfoList.do";
var accept_type = "json";
var params = {useYn : "Y" };
// get the data from server
window.plugins.EgovInterface.request(url, params, function(jsonData) {
var list_html = "";
$(jsonData["BarcodescannerInfoList"]).each(function(idx,obj){
var sn = obj.sn;
var codeType = obj.codeType;
var codeText = obj.codeText;
var sndDt = obj.sndDt;
list_html += "CodeType : " + codeType + "
";
list_html += "CodeText : " + codeText + "
";
list_html += "Date : " + sndDt + "
=== 관련 화면 및 수행매뉴얼 ===
^Action^URL^Controller method^QueryID^
|Barcodescanner 정보 목록 조회|/bar/BarcodescannerInfoList.do|selectBarcodescannerList|"barcodescannerDeviceAPIDAO.selectBarcodescannerDevcieList"|
^Barcodescanner 정보목록 조회 화면^
|{{:egovframework:hyb3.6:guide:mbl:barcodescanner:barcodescanner_5.jpeg?320|}}|
디바이스 정보 조회 : 디바이스 정보 조회를 요청한다.\\
목록 : 디바이스 정보 목록 페이지를 호출한다.\\
삭제 : 디바이스 정보를 삭제한다.
===== 컴파일 디버깅 배포 =====
==== 컴파일 ====
=== DevicdInfoAPI Device Applicaton 컴파일 방법 ===
* 프로젝트 선택 > 오른쪽 클릭 > Run As > Android Application
{{:egovframework:hyb:guide:add:카메라_컴파일1.png?740|}}
* 상단의 메뉴 > Run As > Android Application
{{:egovframework:hyb:guide:add:카메라_컴파일2.png?740|}}
* 실행할 타겟 선택 > 에뮬레이터, 디바이스(디버깅모드)
{{:egovframework:hyb:guide:add:디바이스컴파일.png?740|}}
* 디바이스를 이용한 실행 화면
{{:egovframework:hyb3.6:guide:mbl:barcodescanner:barcodescanner_ma.jpeg?320|}}
=== DeviceInfoAPI Server Applicaton 컴파일 방법 ===
* BarcodescannerAPI 서버사이드 가이드 프로그램의 실행은 프로젝트를 마우스 오른쪽 버튼을 클릭 한후 Run As>Run On Server 버튼을 통해 실행 할 수 있다.
{{:egovframework:hyb:guide:ios:서버실행.png?640|}}
* 빌드가 성공적으로 수행 되면 이클립스의 콘솔 창에서 'Server Startup in xxx ms' 메시지를 확인 할 수 있다.
{{:egovframework:hyb:guide:add:서버실행결과_콘솔.png?840|}}
==== 디버깅 ====
Barcodescanner 어플리케이션에서 발생한 오류 내용 확인 및 디버깅을 위해서는 폰갭 프레임워크에서 제공하는 console.log를 이용할 수 있다. console.log 함수는 자바스크립트 구문에서 사용할 수 있는 디버그 코드로 이클립스 및 Xcode에서 확인 할 수 있다.
console.log의 작성 방법의 예시는 다음과 같다.
function fn_egov_network_check(doCheck)
{
console.log('DeviceAPIGuide fn_egov_network_check');
var networkState = navigator.network.connection.type;
...
}
디버깅 코드가 실행 되면 아래와 같은 메시지를 개발도구의 콘솔 메시지 창에서 볼 수 있다.
{{:egovframework:hyb:guide:add:FileReadWriteconsolelog.png|}}
Barcodescanner API 가이드 프로그램 에서는 디버깅을 콘솔 정보를 출력한다.
==== 배포 ====
Barcodescanner API 가이드 다운로드 : [[http://www.egovframe.go.kr/cop/bbs/selectBoardArticle.do?bbsId=BBSMSTR_000000000161&nttId=1283&menu=3&submenu=9|Click]] \\
===== 참고자료 =====
* Cordova 플러그인 정보 : cordova plugin add cordova-plugin-barcodescanner[[https://www.npmjs.com/package/cordova-plugin-barcodescanner|Click]] \\