Barcodescanner 디바이스API 가이드 프로그램

개요

Barcodescanner API 가이드 프로그램은 Barcodescanner API 실행환경을 활용하여 하이브리드 앱을 개발하시는 분들이 디바이스 기기에서 Barcodescanner을 통하여 바코드, QR코드등 정보를 확인 할 수 있는 기능을 구현하는 데 참고 및 활용 할 수 있는 가이드 앱입니다.

특징

본 가이드 프로그램 에서는 바코드, QR코드등의 정보 조회 기능의 활용을 가이드 할 수 있도록 QR코드 및 바코드 인식하기, 정보 서버에 전송하기, 인식결과 서버 조회 를 제공하고 있다.

기능흐름도

전제 조건

구분 내용
Local 디바이스 개발 환경 Xcode 8.0 (8A218a), Cordova 6.4.0
서버 사이드 개발 환경 전자정부표준프레임워크 개발환경3.6
Mash up Open API 연계 N/A
테스트 디바이스 iPhone 6 , iPad Air
테스트 플랫폼 iOS 9.3, iOS 10.0
추가 라이브러리 적용N/A

제약사항

구분 내용
지원 디바이스 및 플랫폼나침반 정보 조회의 시각적 효과를 위해 나침반 형태의 이미지 회전을 제공하고 있어,가로 모드로 보기 시 화면이 잘려 보이는 경우가 발생할 수 있어 디바이스 API 가이드 프로그램 실행 시 가로보기 모드는 자동변환 되지 않도록 설정하고 테스트 하는것이 좋다.
크로스 도메인 사용폰갭에서 특정 외부 도메인이나 외부 도메인의 하위 도메인을 사용해야할 경우,[Project_Name]/Supproting Files/config.xml에서 <access origin=“ExternalHosts”/> 항목에 외부 도메인 주소를 추가 설정해야 외부 도메인에 접속할 수 있다.
라이선스N/A

설명

Barcodescanner API 가이드 프로그램은 크게 QR코드 및 바코드 인식하기, 인식결과 조회
기능으로 구성되어 있다.(관련기능 부분참조)

Device Application

관련 소스

유형대상소스명비고
CSSassets/www/css/egovframwork/mbl/hyb/Barcodescanner.css BarcodescannerAPI 가이드 프로그램 주요 Cascading Style Sheets
IMAGE assets/www/images/egovframwork/mbl/hyb/ BarcodescannerAPI 가이드 프로그램 주요 Image 폴더
JS assets/www/js/egovframwork/mbl/hyb/barcodescanner.js BarcodescannerAPI 가이드 프로그램 주요 JavaScript
HTMLassets/www/Barcodescanner.htmlBarcodescannerAPI 메인 페이지
HTMLassets/www/intro.htmlBarcodescannerAPI Intro 페이지
HTMLassets/www/license.htmlBarcodescannerAPI 라이센스 페이지
HTMLassets/www/overview.htmlBarcodescannerAPI 기능설명 페이지
RES [Project_Name]/Resources/ BarcodescannerAPI 가이드 프로그램 주요 Resource 폴더
PLIST[Project_Name]/Resources/[Project_Name]-Info.plistiOS 어플리케이션 설정 파일

활용 API

Barcodescanner
  • QR코드, 바코드 등의 관련 정보를 조회한다.
	scanformats = result.format;
	scanContents = result.text;
	result.cancelled;
변수설명비고
formatQR코드 및 바코드의 유형을 반환한다.
textQR코드 및 바코드 데이터의 텍스트을 반환한다.
cancelledQR코드 및 바코드의 형태를 사용자가 검색을 취소여부를 반환한다.

Server Application

관련 소스

유형대상소스명비고
Controlleregovframework.hyb.mbl.bar.web.EgovBarcodescannerDeviceAPIController.javaBarcodescannerAPI 가이드 프로그램 Controller Class
Serviceegovframework.hyb.mbl.bar.service.EgovBarcodescannerAPIService.javaBarcodescannerAPI 가이드 프로그램 Service Class
ServiceImplegovframework.hyb.mbl.bar.service.impl.EgovBarcodescannerDeviceAPIServiceImpl.javaBarcodescannerAPI 가이드 프로그램 ServiceImpl Class
VOegovframework.hyb.mbl.bar.service.BarcodescannerAPIVO.javaBarcodescannerAPI 가이드 프로그램 VO Class
DAOegovframework.hyb.mbl.bar.service.impl.BarcodescannerDeviceAPIDAO.javaBarcodescannerAPI 가이드 프로그램 Dao Class
QUERY XMLresources/egovframework/sqlmap/hyb/mbl/bar/EgovBarcodescannerAPIGuide_SQL_xxx.xmlBarcodescannerAPI 가이드 프로그램 QUERY XML

관련 테이블

테이블명테이블명(영문)비고
바코드스캐너barcode_infoBarcodescanner 정보 관리

테이블 정의서

  • Barcodescanner
No컬럼ID컬럼명타입길이NULL
1SN일련번호NUMERIC11NotNull
2CODE_TYPE바코드 종류VARCHAR45NotNull
3CODE_TEXT바코드 데이터의 텍스트VARCHAR45Null
4USEYN활성화여부VARCHAR45Null
5CODE_DT등록일자VARCHAR45Null

ERD

환경설정

Barcodescanner API 가이드 프로그램에서 제공하는 모바일 Barcodescanner의 정보 조회 기능을 활용하기 위하여 필요한 항목 및 그 환경 설정은 다음과 같다.

Barcodescanner Application

Cordova.plist

Plugin
    <feature name="Battery">
        <param name="ios-package" value="CDVBattery"/>
    </feature>
    <feature name="InterfaceAPI">
        <param name="ios-package" value="EgovInterface"/>
    </feature>
ExternalHosts
    <access origin="ExternalHosts"/>
[Project_Name]/eGovModule/EGovComModule.h
#define kSERVER_URL     @"Server_URL"

Server Application

resource/egovframework/sqlmap/sql-map-config_[DB명].xml

<sqlMap resource="egovframework/sqlmap/hyb/mbl/bar/EgovBarcodescannerAPIGuide_SQL_[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 정보조회 화면

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();

}

관련 화면 및 수행매뉴얼

ActionURLController methodQueryID
Barcodescanner 정보 등록/bar/addBarcodescannerDeviceInfo.doinsertDeviceInfo“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 += "<li><h3>CodeType : " + codeType + "</h3>";
            list_html += "<p><strong>CodeText : " + codeText + "</strong></p>";
            list_html += "<p>Date : " + sndDt + "</p></li>";
        });
        
        console.log("BarcodescanneAPIGuide fn_egov_move_BarcodescanneList request Completed");
        
        var theList = $('#BarcodeInfoList');
        theList.html(list_html);
        $.mobile.changePage("#BarcodescannerList", "slide", false, false);
        theList.listview("refresh");
        detailScroll.refresh();
        listScroll.refresh();
        
    });    
}

관련 화면 및 수행매뉴얼

ActionURLController methodQueryID
Barcodescanner 정보 목록 조회/bar/BarcodescannerInfoList.doselectBarcodescannerList“barcodescannerDeviceAPIDAO.selectBarcodescannerDevcieList”
Barcodescanner 정보목록 조회 화면

디바이스 정보 조회 : 디바이스 정보 조회를 요청한다.
목록 : 디바이스 정보 목록 페이지를 호출한다.
삭제 : 디바이스 정보를 삭제한다.

컴파일 디버깅 배포

컴파일

Device Applicaton 컴파일 방법

  • 왼쪽 상단의 삼각형 버튼을 클릭하면 가이드 프로그램이 빌드되어 아이폰 디바이스에 설치 된다.

  • 빌드가 성공하면 아래와 같은 어플리케이션 실행화면을 확인 할 수 있다.

Server Applicaton 컴파일 방법

  • 서버사이드 가이드 프로그램의 실행은 프로젝트를 마우스 오른쪽 버튼을 클릭 한후 Run As>Run On Server 버튼을 통해 실행 할 수 있다.

  • 빌드가 성공적으로 수행 되면 이클립스의 콘솔 창에서 'Server Startup in xxx ms' 메시지를 확인 할 수 있다.

디버깅

디바이스 어플리케이션에서 발생한 오류 내용 확인 및 디버깅을 위해서는 폰갭 프레임워크에서 제공하는 console.log를 이용할 수 있다. console.log 함수는 자바스크립트 구문에서 사용할 수 있는 디버그 코드로 이클립스 및 Xcode에서 확인 할 수 있다.

  • 실제 콘솔 로그 예
function fn_egov_network_check(doCheck)
{
    console.log('DeviceAPIGuide fn_egov_network_check');
    var networkState = navigator.network.connection.type;
    ...
}
  • xCode 콘솔 창


Barcodescanner 디바이스 API 가이드 프로그램 에서는 디버깅을 위하여 다음과 같이 콘솔 정보를 출력한다.

배포

Barcodescanner 디바이스 API 가이드 다운로드 : Click

참고자료

  • Cordova 플러그인 정보 : cordova plugin add cordova-plugin-barcodescannerClick
 
egovframework/hyb3.9/guide/ios/barcodescanner.txt · 마지막 수정: 2023/12/21 05:21 (외부 편집기)
 
이 위키의 내용은 다음의 라이센스에 따릅니다 :CC Attribution-Noncommercial-Share Alike 3.0 Unported
전자정부 표준프레임워크 라이센스(바로가기)

전자정부 표준프레임워크 활용의 안정성 보장을 위해 위험성을 지속적으로 모니터링하고 있으나, 오픈소스의 특성상 문제가 발생할 수 있습니다.
전자정부 표준프레임워크는 Apache 2.0 라이선스를 따르고 있는 오픈소스 프로그램입니다. Apache 2.0 라이선스에 따라 표준프레임워크를 활용하여 발생된 업무중단, 컴퓨터 고장 또는 오동작으로 인한 손해 등에 대해서 책임이 없습니다.
Recent changes RSS feed CC Attribution-Noncommercial-Share Alike 3.0 Unported Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki