3.제품별 지원 기능

Edit

3.1넥사크로플랫폼 17

3.1.117.1 이후 버전 사용 시 주의 사항

LauncherService 1.1.0.17 미만 버전 사용 시 globalvalue 속성값을 처리하지 못하는 오류가 있습니다. 배포 페이지에서 LauncherService 버전을 확인하고 1.1.0.17 이상 버전으로 업데이트할 수 있도록 가이드해야 합니다.

// 런처서비스 버전 정보 체크
function checkUpdateLauncher() {
    if (xhrObject.readyState == 4 || xhrObject.reqType == 2) {
        if (xhrObject.status == 200 || xhrObject.reqType == 2 && launcher_response(xhrObject.responseText)) {
 
            //1. getlauncherversion 런처서비스 버전 정보
            var resultJson = JSON.parse(xhrObject.responseText);
            strLocLuncherVer = resultJson.value["getlauncherversion"].productversion;
 
            //2. 설치 되어 있는 버전 보다 상위 값이면 TPL_LauncherDownload() 호출
            if (strLauncherVersion > strLocLuncherVer) {
                TPL_LauncherDownload("update");
            } else {
                //nexacro 실행..
            }
        }
    }
}
 
// 배포 페이지에서 메세지 셋팅 후 download_TPLSvc() 호출
function TPL_LauncherDownload(str) {
    var msg = "설치 되지 않았습니다.";
    if (str == "update") { msg = "업데이트 되었습니다."; }
    var contents = "TPLSvc가 " + msg + " TPLSvc를 다운로드 후 설치를 진행해 주시기 바랍니다.";
 
    var divCon = document.getElementById("errorDiv")
    divCon.innerHTML = "<H3>" + contents + "</H3>";
    document.location = download_TPLSvc("newlanucher");
}
 
var strLauncherFileName = "TPLSvc_Setup.exe";
 
// 런처서비스 다운로드 
function download_TPLSvc(type) {
    if (type == "newlanucher") {
        // 서버 경로의 TPLSvc_Setup.exe 다운로드
        var downURL = strServerPath + strDownloadPath + "/" + strLauncherFileName;
        return downURL;
    }
}

3.1.2속성

Property

default

Data Type

설명

key

없음

string

필수속성입니다.

서비스의 Key값을 설정

동일 start.json 상의 유일한 값이어야 함

bjson

없음

string

필수속성입니다.

서비스의 start.json 경로를 지정

globalvalue

없음

string

넥사크로플랫폼 Engine이 구동될 때 globalvariable에 추가될 변수를 설정

splashimage

없음

string

넥사크로플랫폼 Engine이 Loading되는 동안 보여줄 스플래시 이미지 경로를 지정

지정하지 않을 경우 넥사크로플랫폼 기본이미지가 출력되며, 이미지는 화면의 중앙에 표시됨

onlyone

false

boolean

key와 bjson 값에 매칭되는 Instance를 하나만 띄울 것인지에 대한 여부를 설정

screenid

없음

string

앱이 실행되는 Screen ID를 설정

enginesetupkey

없음

string

필수속성입니다.

실행경로로 사용할 특정 버전의 넥사크로플랫폼 ProductKey 값을 지정.

사이트에서 별도 작성한 Setup Module을 사용하는 경우, 이 Property에 Setup을 만들 때 부여되는 Product Key를 설정함. 설정하지 않을 경우 서비스가 제대로 동작하지 않을 수 있음

setupresource


boolean

SetupResource.zip 파일을 내려받는 기능의 사용 여부를 설정

1.1.0.9 이후 버전부터 지원

속성값에 특수문자가 포함된 경우 예기치 못한 결과가 발생할 수 있습니다.

key, bjson 속성값에 세미콜론(;) 또는 ".Run" 문자열이 포함된 경우 보안상 문제가 될 수 있어 해당 문자열을 삭제하여 처리합니다 (1.1.0.12 이후 버전부터 적용됩니다).

key, bjson 속성값에 콤마(,), TAB 문자(\t), 개행(\n, \r) 또는 ". Run" 처럼 점(.)과 "run" 문자열 사이의 공백문자가 포함된 경우 보안상 문제가 될 수 있어 해당 문자열을 삭제하여 처리합니다 (1.1.0.16 이후 버전부터 적용됩니다).

splashimage 속성에 다음 확장자를 가진 파일은 지정할 수 없습니다 (1.1.0.16 이후 버전부터 적용됩니다).

bat, bin, cmd, com, cpl, exe, gadget, inf1, ins, inx, isu, job, jse, lnk, msc, msi, msp, mst, paf, pif, ps1, reg, rgs, scr, sct, shb, shs, u3p, vb, vbe, vbs, vbscript, js, ws, wsf, wsh, dll, hta

3.1.3메소드

Method

Result

Parameter

Description

launch

없음

없음

넥사크로플랫폼 Engine을 NRE로 실행시킴.

makeshortcut

없음

strShortCutName

strIconPath

strIconTargetPath

strPosition

bAllUser

단축아이콘을 생성함.

- strShortCutName:바로가기 아이콘명

- strIconPath: 바로가기 아이콘 파일을 내려받을 수 있는 서버 경로

- strIconTargetPath: 바로가기 아이콘을 내려받은 로컬 경로 (alias 허용)

- strPosition: 바로가기 생성위치

"startmenu"/ "startup" / "programs" / "desktop" 중 택일함

잘못된 값이 들어오면 "desktop"으로 처리함

- bAllUser :전체 사용자가 사용할 수 있도록 생성할지에 대한 여부(default는 false)

isexistshortcut

boolean

strShortcutName

strPosition

bAllUser

입력받은 인자에 해당하는 바로가기 아이콘이 존재하는지 확인.

- strShortCutName:바로가기 아이콘명

- strPosition: 바로가기 생성위치

"startmenu"/ "startup" / "programs" / "desktop" 중 택일함

잘못된 값이 들어오면 "desktop"으로 처리함

- bAllUser :전체 사용자가 사용할 수 있도록 생성할지에 대한 여부(default는 false)

getengineversion

string

strEngineKeyName

시스템에 설치된 엔진 키에 해당하는 엔진 설치 버전을 가져옴.

strEngineKeyName: Engine Setup Key

download

없음


앱 실행 시 사용되는 자원을 다운로드.

deleteshortcut

boolean

strShortcutName

strPosition

bAllUser

바로가기 아이콘을 삭제.

- strShortCutName:바로가기 아이콘명

- strPosition: 바로가기 생성위치

"startmenu"/ "startup" / "programs" / "desktop" 중 택일함

잘못된 값이 들어오면 "desktop"으로 처리함

- bAllUser :전체 사용자가 사용할 수 있도록 생성할지에 대한 여부(default는 false)

addWebInfo

없음

strCookie

현재 브라우저의 쿠키정보를 자동으로 globalvariable의 cookie변수에 추가.

strCookie: 브라우저의 쿠키정보

downloadresource


param

SetupResource.zip 파일이 위치한 서버 경로를 지정

1.1.0.9 이후 버전부터 지원

메소드 파라미터값에 특수문자가 포함된 경우 예기치 못한 결과가 발생할 수 있습니다.

makeshortcut 메소드 실행 시 문자열로 전달되는 파라미터값에 세미콜론(;) 또는 ".Run" 문자열이 포함된 경우 보안상 문제가 될 수 있어 해당 문자열을 삭제하여 처리합니다 (1.1.0.15 이후 버전부터 적용됩니다).

makeshortcut, deleteshortcut, isexistshortcut 메소드 실행 시 문자열로 전달되는 파라미터값(strShortCutName)에 세미콜론(;), 콤마(,), TAB 문자(\t), 개행(\n, \r) 또는 ". Run" 처럼 점(.)과 "run" 문자열 사이의 공백문자가 포함된 경우 보안상 문제가 될 수 있어 해당 문자열을 삭제하여 처리합니다 (1.1.0.16 이후 버전부터 적용됩니다).

3.1.4이벤트

Event

parameter

Occurs

error

nError

strMsg

런처 서비스 실행 중에 에러가 발생하면 세팅되는 이벤트

- nError: 에러코드

- strMsg: 에러 메시지

Error Code

Error Message

Description

102

Not exist key. Please input key.

key 값을 설정하지 않은 경우

103

Not exist bootstrap.Please input bootstrap.

bjson 값을 설정하지 않은 경우

104

Fail to download.

이미지 파일을 내려받을 수 없는 경우

105

Fail to load config file.

nexacro.xml 파일을 읽을 수 없는 경우

106

Fail to write config file.

nexacro.xml 파일을 기록할 수 없는 경우

3.1.5참고

디지털 서명을 유지한 상태로 설치 파일을 배포

SetupRuntime.exe 설치 파일을 실행하기 전에 SetupResource.zip 파일을 사용자 PC에 먼저 내려받아야 합니다.

디지털 서명을 유지한 상태로 설치 파일을 배포하는 방식은 런처서비스 버전 1.1.0.9 이후 버전부터 지원합니다.

setupresource 속성 설정

런처 서비스 구동을 위한 setproperty 함수에서 setupresource 속성값을 아래와 같이 true로 설정합니다.

objNexacro.action = 'setproperty';
if (action_sub == 'basic') {
    objNexacro.value = {
        "key": strKey,
        "bjson": strBjson,
        "splashimage": strSplashImage,
        "componentpath": strComponentPath,
        "loadingimage": strLoadingImage,
        "globalvalue": strGlobalValue,
        "onlyone": bOnlyone,
        "splashmessage": 'none',
        "setupresource": 'true',
        "enginesetupkey": strEnginesetupKey
    };
}

downloadresource 메소드 설정

start.json, SetupResource.zip 파일이 위치한 서버 경로를 인자값으로 설정합니다. downloadresource 메소드가 실행되면 설정된 경로에서 SetupResource.zip 파일을 "%USERAPP%SetupResource"경로에 내려받습니다.

else if (action == 'downloadresource') {
    objNexacro.value = {
        "downloadresource": {
            "param": ["http://127.0.0.1:8080/test/"]
        }
    };

downloadresource 메소드 실행 이후에 SetupRuntime.exe 파일을 내려받는 스크립트가 동작하도록 합니다.

3.2넥사크로플랫폼 14

넥사크로플랫폼 14는 LauncherService 1.1.0.21 이후 버전부터 지원합니다.

3.2.1속성

Property

default

Data Type

설명

key

없음

string

필수속성입니다.

서비스의 Key값을 설정

동일 start.json 상의 유일한 값이어야 함

bjson

없음

string

필수속성입니다.

서비스의 start.json 경로를 지정

globalvalue

없음

string

넥사크로플랫폼 Engine이 구동될 때 globalvariable에 추가될 변수를 설정

splashimage

없음

string

넥사크로플랫폼 Engine이 Loading되는 동안 보여줄 스플래시 이미지 경로를 지정

지정하지 않을 경우 넥사크로플랫폼 기본이미지가 출력되며, 이미지는 화면의 중앙에 표시됨

속성값을 "none"으로 설정하면 이미지를 표시하지 않음

onlyone

false

boolean

key와 bjson 값에 매칭되는 Instance를 하나만 띄울 것인지에 대한 여부를 설정

version

없음

string

넥사크로플랫폼 14 동작 버전 지정

입력할 수 있는 값은 "14"

screenid

없음

string

Application이 실행되는 Screen ID를 설정

enginesetupkey

없음

string

필수속성입니다.

실행경로로 사용할 특정 버전의 넥사크로플랫폼 ProductKey 값을 지정.

사이트에서 별도 작성한 Setup Module을 사용하는 경우, 이 Property에 Setup을 만들 때 부여되는 Product Key를 설정함. 설정하지 않을 경우 서비스가 제대로 동작하지 않을 수 있음

속성값에 특수문자가 포함된 경우 예기치 못한 결과가 발생할 수 있습니다.

key, bjson 속성값에 세미콜론(;) 또는 ".Run" 문자열이 포함된 경우 보안상 문제가 될 수 있어 해당 문자열을 삭제하여 처리합니다.

key, bjson 속성값에 콤마(,), TAB 문자(\t), 개행(\n, \r) 또는 ". Run" 처럼 점(.)과 "run" 문자열 사이의 공백문자가 포함된 경우 보안상 문제가 될 수 있어 해당 문자열을 삭제하여 처리합니다.

splashimage 속성에 다음 확장자를 가진 파일은 지정할 수 없습니다.

bat, bin, cmd, com, cpl, exe, gadget, inf1, ins, inx, isu, job, jse, lnk, msc, msi, msp, mst, paf, pif, ps1, reg, rgs, scr, sct, shb, shs, u3p, vb, vbe, vbs, vbscript, js, ws, wsf, wsh, dll, hta

3.2.2메소드

Method

Result

Parameter

Description

launch

없음

없음

넥사크로플랫폼 Engine을 NRE로 실행시킴.

makeshortcut

없음

strShortCutName

strIconPath

strIconTargetPath

strPosition

bAllUser

단축아이콘을 생성함.

- strShortCutName:바로가기 아이콘명

- strIconPath: 바로가기 아이콘 파일을 내려받을 수 있는 서버 경로

- strIconTargetPath: 바로가기 아이콘을 내려받은 로컬 경로 (alias 허용)

- strPosition: 바로가기 생성위치

"startmenu"/ "startup" / "programs" / "desktop" 중 택일함

잘못된 값이 들어오면 "desktop"으로 처리함

- bAllUser :전체 사용자가 사용할 수 있도록 생성할지에 대한 여부(default는 false)

isexistshortcut

boolean

strShortcutName

strPosition

bAllUser

입력받은 인자에 해당하는 바로가기 아이콘이 존재하는지 확인.

- strShortCutName:바로가기 아이콘명

- strPosition: 바로가기 생성위치

"startmenu"/ "startup" / "programs" / "desktop" 중 택일함

잘못된 값이 들어오면 "desktop"으로 처리함

- bAllUser :전체 사용자가 사용할 수 있도록 생성할지에 대한 여부(default는 false)

getengineversion

string

strEngineKeyName

시스템에 설치된 엔진 키에 해당하는 엔진 설치 버전을 가져옴.

strEngineKeyName: Engine Setup Key

download

없음


Application 실행 시 사용되는 자원을 다운로드.

deleteshortcut

boolean

strShortcutName

strPosition

bAllUser

바로가기 아이콘을 삭제.

- strShortCutName:바로가기 아이콘명

- strPosition: 바로가기 생성위치

"startmenu"/ "startup" / "programs" / "desktop" 중 택일함

잘못된 값이 들어오면 "desktop"으로 처리함

- bAllUser :전체 사용자가 사용할 수 있도록 생성할지에 대한 여부(default는 false)

addWebInfo

없음

strCookie

현재 브라우저의 쿠키정보를 자동으로 globalvariable의 cookie변수에 추가.

strCookie: 브라우저의 쿠키정보

메소드 파라미터값에 특수문자가 포함된 경우 예기치 못한 결과가 발생할 수 있습니다.

makeshortcut 메소드 실행 시 문자열로 전달되는 파라미터값에 세미콜론(;) 또는 ".Run" 문자열이 포함된 경우 보안상 문제가 될 수 있어 해당 문자열을 삭제하여 처리합니다.

makeshortcut, deleteshortcut, isexistshortcut 메소드 실행 시 문자열로 전달되는 파라미터값(strShortCutName)에 세미콜론(;), 콤마(,), TAB 문자(\t), 개행(\n, \r) 또는 ". Run" 처럼 점(.)과 "run" 문자열 사이의 공백문자가 포함된 경우 보안상 문제가 될 수 있어 해당 문자열을 삭제하여 처리합니다.

3.2.3이벤트

Event

parameter

Occurs

error

nError

strMsg

런처 서비스 실행 중에 에러가 발생하면 세팅되는 이벤트

- nError: 에러코드

- strMsg: 에러 메시지

Error Code

Error Message

Description

102

Not exist key. Please input key.

key 값을 설정하지 않은 경우

103

Not exist bootstrap.Please input bootstrap.

bjson 값을 설정하지 않은 경우

104

Fail to download.

이미지 파일을 내려받을 수 없는 경우

105

Fail to load config file.

nexacro.xml 파일을 읽을 수 없는 경우

106

Fail to write config file.

nexacro.xml 파일을 기록할 수 없는 경우

3.3엑스플랫폼

3.3.1속성

Property

default

Data Type

설명

key

없음

string

필수속성입니다.

서비스의 Key값을 설정.

동일 ADL상의 유일한 값이어야 함.

xadl

없음

string

필수속성입니다.

서비스의 ADL 경로를 지정.

commthreadcount

0

int

엑스플랫폼 Engine이 사용하는 통신 Thread 개수를 지정.

이 기능은 통신 처리에만 사용하므로 여러 개의 통신을 동시에 사용하기를 원할 경우 숫자를 높여주면 빠른 응답 결과를 얻을 수 있음. 그러나 네트워크 자체가 느린 경우는 숫자를 높여줘도 그 효과를 얻기 어려움.

componentpath

설명참고

string

사용자 PC상에 컴포넌트가 저장될 PATH를 지정.

="%USERAPP%\TobeSoft\XPLATFORM\9.2.1\Component\

errorfile

없음

string

엑스플랫폼 Engine이 출력하는 에러정보들이 정의된 파일경로. 일반적으로 지정하지 않음.

globalvalue

없음

string

엑스플랫폼 Engine이 구동될 때 globalvariable에 추가될 변수를 설정.

loadingimage

없음

string

엑스플랫폼 Engine이 화면, Data 로딩 시 보여주는 이미지를 설정.

서버 경로가 입력되는 경우는 직접 내려받은 후, 설정된 componentpath아래에 저장.

splashimage

없음

string

엑스플랫폼 Engine이 Loading되는 동안 보여줄 스플래시 이미지 경로를 지정.

지정하지 않을 경우 엑스플랫폼 기본이미지가 출력되며, 이미지는 화면의 중앙에 표시됨.

onlyone

false

boolean

key와 xadl 값에 매칭되는 Instance를 하나만 띄울 것인지에 대한 여부를 설정.

commthreadwaittime

-1

Int

엑스플랫폼 응용프로그램이 사용하는 thread가 아무 일도 하지 않을 경우, 해당 thread가 종료됨. 이때 종료 전에 wait할 시간(초)을 설정하는 속성.

enginesetupkey

없음

string

실행경로로 사용할 특정 버전의 엑스플랫폼 ProductKey 값을 지정.

사이트에서 별도 작성한 Setup Module을 사용하는 경우, 이 Property에 Setup을 만들 때 부여되는 Product Key를 설정하면 고정된 경로로 인하여 Launcher에서 Runtime 실행이 불가능했던 문제를 해결할 수 있음.

splashmessage

없음

없음

스플래시 이미지를 사용할 때 메시지 출력 여부를 지정하는 속성.

Version

없음

String

엑스플랫폼 버전을 지정.

입력 가능한 값은 "9.2" / "9.2.1" 입니다.

mobilemode

false

boolean

mobilemode 설정을 위한 속성

true : 모바일 모드(안드로이드/WinCE)로 설정합니다.

false : 일반 윈도우 애플리케이션 모드로 설정합니다.

자세한 내용은 제품 도움말을 참고하세요.

Runtime > Plugins > XPLauncher > Property

속성값에 특수문자가 포함된 경우 예기치 못한 결과가 발생할 수 있습니다.

key, xadl, componentpath 속성값에 세미콜론(;) 또는 ".Run" 문자열이 포함된 경우 보안상 문제가 될 수 있어 해당 문자열을 삭제하여 처리합니다 (1.1.0.12 이후 버전부터 적용됩니다).

key, xadl, componentpath 속성값에 콤마(,), TAB 문자(\t), 개행(\n, \r) 또는 ". Run" 처럼 점(.)과 "run" 문자열 사이의 공백문자가 포함된 경우 보안상 문제가 될 수 있어 해당 문자열을 삭제하여 처리합니다 (1.1.0.16 이후 버전부터 적용됩니다).

splashimage, loadingimage 속성에 다음 확장자를 가진 파일은 지정할 수 없습니다 (1.1.0.16 이후 버전부터 적용됩니다).

bat, bin, cmd, com, cpl, exe, gadget, inf1, ins, inx, isu, job, jse, lnk, msc, msi, msp, mst, paf, pif, ps1, reg, rgs, scr, sct, shb, shs, u3p, vb, vbe, vbs, vbscript, js, ws, wsf, wsh, dll, hta

3.3.2메소드

Method

Result

Parameter

Description

launch

없음

없음

엑스플랫폼 Engine을 전용 Browser로 실행시킴.

makeshortcut

없음

strShortCutName strIconPath

strPosition

bAllUser

단축아이콘을 생성함.

- strShortCutName:바로가기 아이콘명

- strIconPath: 바로가기 아이콘의 경로

- strPosition: 바로가기 생성위치

"startmenu"/ "startup" / "programs" / "desktop" 중 택일함

잘못된 값이 들어오면 "desktop"으로 처리함

- bAllUser :전체 사용자가 사용할 수 있도록 생성할지에 대한 여부(default는 false)

isexistshortcut

boolean

strShortcutName

strPosition

bAllUser

입력받은 인자에 해당하는 바로가기 아이콘이 존재하는지 확인.

- strShortCutName:바로가기 아이콘명

- strPosition: 바로가기 생성위치

"startmenu"/ "startup" / "programs" / "desktop" 중 택일함

잘못된 값이 들어오면 "desktop"으로 처리함

- bAllUser :전체 사용자가 사용할 수 있도록 생성할지에 대한 여부(default는 false)

getengineversion

string

strEngineKeyName

시스템에 설치된 엔진 키에 해당하는 엔진 설치 버전을 가져옴.

strEngineKeyName: 엑스플랫폼 설치키

download

없음


Application 실행 시 사용되는 자원을 다운로드.

deleteshortcut

boolean

strShortcutName

strPosition

bAllUser

바로가기 아이콘을 삭제.

- strShortCutName:바로가기 아이콘명

- strPosition: 바로가기 생성위치

"startmenu"/ "startup" / "programs" / "desktop" 중 택일함

잘못된 값이 들어오면 "desktop"으로 처리함

- bAllUser :전체 사용자가 사용할 수 있도록 생성할지에 대한 여부(default는 false)

addWebInfo

없음

strCookie

현재 브라우저의 쿠키정보를 자동으로 globalvariable의 cookie변수에 추가.

strCookie: 브라우저의 쿠키정보

메소드 파라미터값에 특수문자가 포함된 경우 예기치 못한 결과가 발생할 수 있습니다.

makeshortcut 메소드 실행 시 문자열로 전달되는 파라미터값에 세미콜론(;) 또는 ".Run" 문자열이 포함된 경우 해당 문자열을 삭제하여 처리합니다 (1.1.0.15 이후 버전부터 적용됩니다).

makeshortcut, deleteshortcut, isexistshortcut 메소드 실행 시 문자열로 전달되는 파라미터값(strShortCutName)에 세미콜론(;), 콤마(,), TAB 문자(\t), 개행(\n, \r) 또는 ". Run" 처럼 점(.)과 "run" 문자열 사이의 공백문자가 포함된 경우 보안상 문제가 될 수 있어 해당 문자열을 삭제하여 처리합니다 (1.1.0.16 이후 버전부터 적용됩니다).

addWebInfo 메소드를 제외한 로컬 서버 기반 런처에서 지원하는 모든 메소드는 XPLauncher와 같습니다. addWebInfo 메소드는 런처 서비스가 웹브라우저 내에 위치하지 않기 때문에 파라미터로 쿠키를 받는 형태로 변경됐습니다.

자세한 내용은 제품 도움말을 참고하세요.

Runtime > Plugins > XPLauncher > Method

3.3.3이벤트

Event

parameter

Occurs

error

nError

strMsg

런처 서비스 실행 중에 에러가 발생하면 세팅되는 이벤트

- nError: 에러코드

- strMsg: 에러 메시지

자세한 내용은 제품 도움말을 참고하세요.

Runtime > Plugins > XPLauncher > Event

3.4마이플랫폼 지원 기능

런처 서비스에서 지원하는 속성, 메소드, 이벤트는 MiUpdater(MiInstraller)와 같습니다.

3.4.1속성

Property

default

R

Data Type

설명

DeviceType

WIN32


string

필수속성입니다.

배포 대상이 되는 장치를 지정하는 값.

DeviceType의 값에 따라 설치 경로, 실행 정보 등이 변경 됨.

WIN32U : 마이플랫폼 UNICODE 버전

WIN32: 마이플랫폼 ANSI버전

Version

3.0


string

필수속성입니다.

마이플랫폼의 제품 버전

(3.0, 3.1, 3.1L, 3.11, 3.2)

마이플랫폼 3.x버전에 대해 지원합니다.

대상이 되는 파일의 경로, 실행 시 설정값 등이 Version에 따라 설정됨.

Key


string

필수속성입니다.

마이플랫폼으로 운영할 서비스의 Key.

Key값은 마이플랫폼으로 특정 서비스에 접근할 때 필요한 모든 기본 정보의 저장소를 구분하기 위한 값임.

(StartXML, ComponentPath등 대부분 정보가 Key값별로 Registry에 저장됨.)

SiteKey



string

고객사별 Key값 중복을 방지하기 위한 고유값.

TOBESOFT에서 발급됩니다.

Site별 Key로 SiteKey가 있는 경우 사용하게 되면 Registry의 Key값이 생성될 때 반영됨. 주로 회사 외부로 공개되는 서비스 사이트를 개발할 때 사용.

UpdateURL


string

필수속성입니다.

Update Info File의 URL.

배포 작업을 위해 UpdateURL이 필요.

입력하지 않는다면 기존에 설정된 값을 사용함.

StartXML


string

필수속성입니다.

마이플랫폼에서 사용할 StartXML의 URL 또는 파일 경로.

입력하지 않는다면 기존에 설정된 값을 사용함.

ComponentPath

""

string

마이플랫폼용 Component의 경로.

Alias를 사용해 입력할 수 있음.

단, Alias로 %COMPOENT%는 사용하지 않아야 함.

마이플랫폼의 Component경로는 고객사 별로 설정할 것을 권장.

Windows VISTA의 OS에서의 권한문제를 해결하기 위해서는 %USERAPP%하위의 경로로 설정해야 함.

(ex) %USERAPP%\TOBESOFT\MiPlatform320U\Component\

Left

-1

(Center)

LONG

마이플랫폼을 구동할 때 좌측의 좌표.

입력하지 않는다면 기존에 설정된 값을 사용함.

Top

-1

(Center)

LONG

마이플랫폼을 구동할 때 상단의 좌표.

입력하지 않는다면 기존에 설정된 값을 사용함.

Width

800

string

마이플랫폼을 구동할 때 너비.

숫자 또는 “max”를 사용할 수 있음.

“max”를 지정하면 전체 화면으로 인식.

입력하지 않는다면 기존에 설정된 값을 사용함.

Height

600

string

마이플랫폼을 구동할 때 높이.

숫자 또는 “max”를 사용할 수 있음.

“max”를 지정하면 전체 화면으로 인식함.

입력하지 않는다면 기존에 설정된 값을 사용함.

OnlyOne

False

boolean

마이플랫폼을 Key와 Version당 하나만 구동되도록 할지 여부,

마이플랫폼 전용 브라우저를 사용하는 경우에만 적용.

입력하지 않는다면 기존에 설정된 값을 사용함.

Resource


string

마이플랫폼에서 사용되는 Resource 파일 경로.

파일 이름만 있는 경우에는 ComponentPath경로에서 파일을 찾음.

마이플랫폼의 Resource는 XML형태로 제작된 정보 값임.

입력하지 않는다면 기존에 설정된 값을 사용함.

GlobalVal


string

마이플랫폼과 연동 작업을 위해 할당된 변수.

마이플랫폼에서 “GetReg()” API를 사용해 접근할 수 있음.

입력하지 않는다면 기존에 설정된 값을 사용함.

Launch

True


boolean

Update를 실행한 후 마이플랫폼의 실행 여부.

ReInstall

False


boolean

기존의 배포 상태를 무시할지 여부.

ReInstall이 TRUE로 설정되면 기록된 버전 정보 파일을 무시함.

그러나 “system::”을 사용했다면 기존에 설치된 파일을 참조할 가능성이 있음.

UResource

""

string

MiUpdater가 사용한 Resource 파일경로.

MiUpdater의 입력 인자 중 –URES를 참조.

입력하지 않는다면 기존에 설정된 값을 사용함.

Retry

2

LONG

마이플랫폼에서 통신 연결 재시도 할 횟수.

입력하지 않는다면 기존에 설정된 값을 사용함.

TimeOut

30

LONG

마이플랫폼에서 통신 연결 대기시간(초).

입력하지 않는다면 기존에 설정된 값을 사용함.

PreVersionCompare

False


boolean

Update Info File의 버전과 Update Info File에 설정된 Update List File의 버전 비교 여부.

통신 사용량에 민감한 PDA에서 주로 사용되는 기능이며, PreVersion Compare를 사용시 Update Info File의 세심한 관리가 필요함.

ExistVersionUpCnt() 함수 또는 StartDownlaod()를 호출하기 전에 설정 해야 함.

Update Info File만을 받는 것으로 업데이트 여부를 확인할 수 있음.

StartImage


string

마이플랫폼용 Splash화면에 표시될 이미지 파일의 경로.

Splash 화면은 마이플랫폼에서 StartXML을 로딩하기 전까지 표시됨.

기본적으로 마이플랫폼의 내장 이미지가 사용되며, 별도로 지정시 해당 이미지가 사용됨.

지정된 Image의 크기에 맞도록 splash화면의 크기가 변경됨.

경로는 %alias%형태로 입력할 수 있음.

입력하지 않는다면 기존에 설정된 값을 사용함.

Scroll

False

boolean

MDI에서 MDI Client영역(바탕화면)에 Scroll 사용 여부.

SDI에서는 지원되지 않음.

입력하지 않는다면 기존에 설정된 값을 사용함.

UBKImage


string

MiUpdater의 배경화면 Image

NotLaunchForErr

False


boolean

에러가 발생했을 때 MiUpdater에서마이플랫폼 실행 여부.

MiUpdater를 사용할 경우만 이용됨.

MiUpdater의 “-NLE”옵션을 참고.

UpdateKillMiplatform

CONFIRM


string

MiInstaller가 배포 작업을 시작할 때 대상버전의 마이플랫폼을 어떻게 처리할지 여부와 업데이트 도중 복사에 실패한 File의 처리 방법을 함.

이 기능은 MSI형태의 패키지에는 적용되지 않으며 MSI형태의 패키지는 MSIEXEC의 기능에 따라 동작.

CONFIRM : 기본값. Update시작 시점에서 OnConfirm을 발생하며 2번째 인자의 값에 따라서 대상 버전의 마이플랫폼을 강제 종료하거나, 무시하고 진행.

KILL : Update 시작 시점에서 OnConfirm을 발생하지 않고, 대상 버전의 마이플랫폼을 강제 종료 하고 진행.

NOKILL : Update 시작 시점에서 OnConfirm을 발생하지 않고, 대상 버전의 마이플랫폼을 종료하지 않고 진행합니다. 또한 중간에 복사에 실패한 경우 재 부팅후 복사가 진행되도록 조치후 진행.( NLE옵션을 TRUE로 주는 경우 NOKILL이면서 복사에 실패한 기록이 있다면 마이플랫폼이 Launch되지 않음.)

R 컬럼에 O 표시가 되어 있는 속성은 레지스트리에 설정값이 기록됩니다.

3.4.2메소드

Method

Result

Parameter

Description

StartDownload

없음


MiInstaller에 배포 작업을 하도록 하는 함수.

MiInstaller는 해당 명령을 받으면 배포를 시작하게 됨.

Stop

없음


다운로드를 멈추는 함수.

Run

없음


마이플랫폼을 실행하는 함수.

DeviceType 및 Version에 따라 실행할 전용 브라우저가 자동으로 선택됨.

ExistVersionUpCnt

boolean


배포 필요성을 확인하는 함수.

배포가 필요하다면 true가, 배포할 대상이 없다면 false가 Reuslt로 전달됨.

PerVersionCompare Property에 따라 동작이 달라질 수 있음.

통상적으로 true인 경우 StartDownload()를 실행하고 false인경우 페이지 전환 또는 Run()을 실행하도록 스크립트를 작성.

MakeShortCut

없음

strExeName

strCommand

strShortcutName

strIConPath

strPos

바로가기를 사용자 장치에 생성하는 함수.

strExeName: 바로가기의 대상이 되는 실행 파일명. 경로를 포함하여 입력해야 합니다. alias형태를 사용 가능.

strCommand: 대상 실행 파일이 실행될 때 입력될 인자값.

strShortcutName: 바로가기 이름.

strIConPath: 바로가기의 아이콘 파일.

Windows에서 허용하는 파일(.ico, .dll, .exe)을 사용할 수 있으며 여러개의 이미지가 있다면 첫번째 아이콘이 사용됩니다. 전체 경로를 입력해야 하며, alias형태의 경로를 사용할 수 있음.

strPos: 바로가기가 생성될 위치.

다음 4가지 예약어가 사용 가능함.

Startmenu -시작메뉴

desktop -바탕화면(Default)

StartUp – 모든 프로그램에 시작 프로그램

Programs – 모든 프로그램

예약어로 제외한 경로 이외에는 사용이 불가.

키워드의 하위경로에 바로가기를 생성하기 위해서는 “예약어:하위경로”의 입력할 수 있음.

ex) “Programs:MiPlatform\Demo”

IsUACEnabled

boolean


Windows UAC옵션 상태를 확인하는 함수.True이면 UAC기능이 설정되어 있음.

False이면 Windows VISTA 하위버전이거나, UAC기능이 해제된 경우임.

IsElevatedProcess

boolean


Windows VISTA이상에서 UAC옵션 활성시 현재 Process가 관리자 권한 획득 여부를 확인하는 함수.

True이면 관리자 권한을 획득한 상태임.

False이면 Windows VISTA 하위버전 이거나, 관리자 권한을 획득하지 않은 상태임.

관리자 권한 획득한 경우(IsElevatedProcess = true)

1. 사용자 id가 Administrator인 경우.

2. 관리자권한 계정으로 로긴하여 process기동시‘관리자권한획득실행’을 했을 경우

IsMiPlatformRunning

boolean


데이트 대상 버전의 마이플랫폼의 Process가 있는지 여부를 확인하는 함수.

True가 되돌려진 경우, 마이플랫폼이 실행중인 상태임. 다만, 업데이터에서 실행중인 Process의 Key가 현재 대상 Key와 일치여부를 확인하지 않음.

False가 되돌려진 경우 마이플랫폼이 실행중인 상태가 아님.

Windows VISTA이상에서 관리자 권한으로 실행된 마이플랫폼에 대해서는 기능이 정상 동작하지 않을 수 있음.

AliasToRealPath

String

strAliasPath

Alias로 되어 있는 경로의 실제 경로값을 구하는 함수.

Alias로 되어 있는 파일경로를 실제 파일 경로로 변경함. 다만 사용전에 Device/Version등을 설정해야 정상적으로 변환이 가능.

strAliasPath : Alias로 설정된 경로

ex) %UserApp%TobeSoft\Demo\

IsAdministratorsGroup

boolean


현재 실행하는 프로세스의 계정이 Admin 권한으로 실행되고 있는지 검사함.

Vista이상 버전의 경우 권한 상승의 과정이 있을경우 상승 전에는 false, 상승 후에는 true의 값을 얻게 됨.

메소드 파라미터값에 특수문자가 포함된 경우 예기치 못한 결과가 발생할 수 있습니다.

MakeShortCut 메소드 실행 시 문자열로 전달되는 파라미터값에 세미콜론(;) 또는 ".Run" 문자열이 포함된 경우 해당 문자열을 삭제하여 처리합니다 (1.1.0.15 이후 버전부터 적용됩니다).

3.4.3이벤트

Event

parameter

Occurs

OnError

DownFileName

ErrorCode

ErrorMsg

MiInstaller에서 배포 작업 중 에러가 발생한 시점에서 발생하는 Event.

DownFileName: 에러 발생 시 DownFileName

ErrorCode: 실행 중 에러 코드

ErrorMsg: ErrorCode에 해당하는 메시지

OnStartDownLoad

ConfigFileName

DownFileName

Type

TotalCnt

CurIndex(0부터시작)

MiInstaller에서 작업시작을 알리는 Event.

Type에 따라 작업의 내용이 달라짐.

ConfigFileName: 처리중인 버전 정보 파일의 이름.

(Update Info File 또는 Update List File의 이름)

DownFileName: 처리중인 파일의 이름

Type: 작업의 형태.(숫자로 출력됨)

1 : EVENTCONFIG : 배포 작업 시작

2 : EVENTGETVERSIONCNT : 버전 정보 비교 시작

3 : EVENTDOWNLOAD : 설치 대상 파일 다운로드 시작

4 : EVENTDISTRIBUTE : 설치 작업 진행 시작

TotalCnt: 전체 작업 예정 개수

CurIndex: 작업목록에서 작업중인 파일의 Index.

OnEndDownLoad

ConfigFileName

DownFileName

Type

TotalCnt

CurIndex(0부터 시작)

MiInstaller에서 작업끝을 알리는 Event.

ConfigFileName: 처리중인 버전 정보 파일의 이름.

(Update Info File 또는 Update List File의 이름.)

DownFileName: 처리중인 파일의 이름

Type: 작업의 형태.(숫자로 출력됨)

1 : EVENTCONFIG : 배포 작업 종료

2 : EVENTGETVERSIONCNT : 버전 정보 비교 완료

3 : EVENTDOWNLOAD : 설치 대상 파일 다운로드 완료

4 : EVENTDISTRIBUTE : 설치 작업 진행 완료

TotalCnt: 전체 작업 예정 개수

CurIndex: 작업목록에서 작업중인 파일의 Index.

OnProgress

DownFileName

Progress

ProgressMax

StatusText

파일 다운로드 진행 상태를 알려주는 Event.

DownFileName: 현재 다운로드하는 파일 이름

Progress: 다운로드 진행 상태 값(숫자)

ProgressMax: 다운로드 진행 상태의 최댓값(숫자)

StatusText: 상태 정보 (문자열)