넥사크로플랫폼이 제공하는 3개의 모듈 중 2개(NexacroAX, NexacroLauncherAX)는 웹브라우저에 의해 실행되며, 1개(nexacro.exe)는 윈도우 명령 프롬프트에서 실행됩니다.
NexacroAX
NexacroAX는 넥사크로플랫폼 엔진을 웹브라우저상에서 실행시키기 위한 ActiveX 모듈 입니다.
이 모듈은 다음의 Setup 파일들에 포함되어 있습니다.
nexacro14_SetupDeveloper.exe
nexacro14_SetupEngine.exe
nexacro14_SetupEngine.cab
NexacroAX는 웹브라우저상의 오브젝트이므로 필요한 요소(속성, 메소드, 이벤트)를 가지고 있습니다. 여기에서는 각 요소에 대한 개략적인 설명만 합니다.
CLASS ID
AcitveX를 위한 Classid는 “6DB5422D-536F-4B80-B32C-16BEA0971512”입니다.
다음은 이 모듈을 활성화하기 위한 HTML 코드입니다.
<SCRIPT LANGUAGE="javascript"> document.write('<OBJECT ID="nexacroLauncher" ' + 'CLASSID="CLSID:6DB5422D-536F-4B80-B32C-16BEA0971512"' + '"CODEBASE="./nexacro14_Launcher.cab#VERSION=2014,5,27,1" ' + 'onError="fn_onError()" >' + '</OBJECT>');
속성
NexacroAX의 속성값을 정리하면 다음과 같습니다. 필수로 표시된 값은 반드시 지정해야만 넥사크로플랫폼 엔진을 구동할 수 있습니다.
속성 | 필수여부 | 설명 |
---|---|---|
기본값 | ||
key | O | 서비스 Key값을 설정합니다. 같은 ADL 내에서 유일한 값이어야 합니다. |
기본값 없음. | ||
xadl | O | 변환된 서비스 ADL 자바스크립트 파일 경로를 지정합니다. |
기본값 없음. | ||
componentpath | X | 사용자 PC상에 컴포넌트들이 저장될 경로를 지정합니다. 일반적으로 이 값은 지정하지 않습니다. |
기본값="%USERAPP%\nexacro\14\Component\" %USERAPP%의 값은 “부록 A. Alias 경로”를 참조하세요 | ||
autosize | X | 넥사크로플랫폼 애플리케이션의 크기가 웹브라우저 크기에 따라 가변적으로 변할지 여부를 지정합니다. false 일 경우 웹브라우저의 Plugin Width, Height 값이 적용됩니다. |
기본값=true | ||
commthreadcount | X | 넥사크로플랫폼 엔진이 사용하는 통신 쓰레드 개수를 지정합니다. 사용자의 단말기의 CPU가 여러 개일 때 값을 높게 지정해 주면 좋습니다. 이 기능은 통신 처리에만 사용하므로 여러 개의 통신을 동시에 사용하기를 원할 경우 숫자를 높여주면 빠른 응답결과를 얻을 수 있습니다. 그러나, 네트워크 자체가 느린 경우는 숫자를 높여줘도 그 효과를 얻기 어렵습니다. |
기본값=5 | ||
errorfile | X | 넥사크로플랫폼 엔진이 출력하는 에러정보들이 정의된 파일경로 입니다. 지정하지 않을 경우 넥사크로플랫폼 엔진의 기본 에러 정보가 출력됩니다.일반적으로 지정하지 않습니다. |
기본값 없음 | ||
handleflag | X | 넥사크로플랫폼 애플리케이션이 종료된 후, exit() 이벤트를 발생시킬지 여부를 지정합니다. 지정하지 않을 경우 true가 되어 exit() 이벤트가 발생합니다. |
기본값=true | ||
Commthreadwaittime | X | 넥사크로플랫폼 애플리케이션이 사용하는 쓰레드가 아무 일도 하지 않을 경우, 해당 쓰레드가 종료됩니다. 이때 종료 전에 대기할 시간(초)을 설정할 수 있습니다. |
usewininet | X | 서버와 통신하는 방식을 지정하는 속성으로서 WININET 통신 라이브러리를 사용하여 통신을 할지 여부를 설정할 수 있습니다. |
기본값= false | ||
autostart | X | NexacroAX Control이 생성되는 시점에 자동으로 run() 메소드를 수행할지의 여부를 설정할 수 있습니다. |
기본값=false |
메소드
NexacroAX가 실행할 수 있는 메소드들을 개략적으로 정리하면 아래와 같습니다.
메소드 | 설명 |
---|---|
callscript | NexacroAX에서 구동중인 넥사크로플랫폼 엔진의 스크립트 메소드를 수행하기 위한 메소드입니다. |
getvariablevalue | NexacroAX에서 넥사크로플랫폼 엔진의 GlobalVariable의 변수값을 얻어오는 메소드입니다. |
run | NexacroAX가 넥사크로플랫폼 엔진을 실행하는 메소드입니다. |
setvariablevalue | NexacroAX에서 넥사크로플랫폼 엔진의 GlobalVariable의 변수값을 설정하는 메소드입니다. |
stop | 플러그인이 넥사크로플랫폼의 모든 Manager들을 중지시키는 메소드입니다. |
quit | 플러그인이 ADL을 로딩하고 수행을 시작하는 메소드입니다. |
addWebInfo | 현재 브라우저의 쿠키정보를 자동으로 globalvariable의 cookie변수에 추가해주는 메소드입니다. |
이벤트
NexacroAX에서 발생하는 이벤트들을 별도로 정리하면 다음과 같습니다.
이벤트 | 설명 |
---|---|
addlog | • 넥사크로플랫폼 스크립트에서 trace 메소드를 실행했을 때 발생하는 이벤트입니다. • 넥사크로플랫폼 스크립트에서 trace 메소드의 인자 값이 그대로 이벤트 인자 값으로 적용됩니다. |
beforeexit | • 넥사크로플랫폼 엔진 종료 직전에 발생하는 이벤트입니다. • beforeexit 이벤트 다음에 exit 이벤트가 발생됩니다. beforeexit 이벤트에서 handledflag 인자값을 false로 설정하면 exit 이벤트가 발생되지 않습니다. 즉, 종료되지 않습니다. • 넥사크로플랫폼 스크립트에서 exit 함수를 호출했을 때 발생하며, application의 onbeforeexit 이벤트 발생 후 NexacroAX에서 beforeexit 가 발생합니다. |
communication | 넥사크로플랫폼의 통신을 시작할 때와 끝날 때에 발생하는 이벤트입니다. |
error | NexacroAX를 로딩하거나 넥사크로플랫폼 엔진 실행중에 에러가 발생하면 발생하는 이벤트입니다. |
exit | • 넥사크로플랫폼 엔진이 종료될 때, 발생하는 이벤트입니다. • beforeexit 이벤트의 영향을 받습니다. |
load | • 넥사크로플랫폼 엔진의 초기 로딩이 완료된 후, 발생하는 이벤트입니다. • 넥사크로플랫폼 스크립트에서는 onload 이벤트가 발생합니다. • loadtypedefinition > loadingglobalvariables > load 순으로 이벤트가 발생합니다. |
loadingglobalvariables | • GlobalVariables 에 포함된 오브젝트들이 생성한 후에 발생하는 이벤트입니다. Dataset, form의 URL은 로딩하기 전이므로 이벤트 안에서 로딩에 필요한 정보를 추가, 수정하면 변경된 값으로 로딩됩니다. • 넥사크로플랫폼 스크립트에서는 application의 onloadingglobalvariables 이벤트가 발생합니다. |
loadtypedefinition | • TypeDefinition에 등록된 컴포넌트들의 로딩을 완료한 후 발생하는 이벤트입니다. 컴포넌트들의 배포도 완료했음을 의미합니다. • 넥사크로플랫폼 스크립트에서는 application의 onloadtypedefinition 이벤트가 발생합니다. |
usernotify | • 넥사크로플랫폼 스크립트에서 userNotify 메소드를 호출하는 경우 플러그인에서 발생하는 이벤트입니다. • 넥사크로플랫폼 스크립트에서 userNotify 메소드의 인자 값이 그대로 이벤트 인자 값으로 적용됩니다. |
Launcher
Launcher는 넥사크로플랫폼 엔진을 러너(runner)로 실행하기 위한 ActiveX 모듈입니다.
이 모듈은 다음의 Setup 파일들에 포함되어 있습니다.
nexacro14_SetupDeveloper.exe
nexacro14_SetupEngine.exe
nexacro14_SetupEngine.cab
nexacro14_Launcher.cab
Launcher는 웹브라우저 오브젝트로 관련된 요소(속성, 메소드, 이벤트)를 가지고 있습니다.
여기서는 각 요소의 개략적인 내용만 설명합니다.
CLASS ID
AcitveX를 위한 Classid는 “A7969122-0BB8-452A-93C9-72641B76CFB7”입니다.
다음은 이 모듈을 활성화하기 위한 HTML code입니다.
<SCRIPT LANGUAGE="javascript"> document.write('<OBJECT ID="nexacroLauncher" ' + 'CLASSID="CLSID:A7969122-0BB8-452A-93C9-72641B76CFB7" ' + '"CODEBASE="./nexacro14_Launcher.cab#VERSION=2014,7,11,2" ' + 'onError="fn_onError()">' + '</OBJECT>');
속성
Launcher의 속성값을 별도로 정리하면 다음과 같습니다. 필수로 표시된 값은 반드시 지정해야만 넥사크로플랫폼 엔진을 구동할 수 있습니다.
속성 | 필수 | 설명 |
---|---|---|
기본값 | ||
Key | O | 서비스의 Key값을 설정합니다. 같은 ADL 내에서 유일한 값이어야 합니다. |
기본값 없음. | ||
Xadl | O | 변환된 서비스 ADL 자바스크립트 파일 경로를 지정합니다. |
기본값 없음. | ||
commthreadcount | X | 넥사크로플랫폼 엔진이 사용하는 통신 쓰레드 개수를 지정합니다. 사용자의 단말기의 CPU가 여러 개일 때 값을 높게 지정해 주면 좋습니다. 이 기능은 통신 처리에만 사용하므로 여러 개의 통신을 동시에 사용하기를 원할 경우 숫자를 높여주면 빠른 응답결과를 얻을 수 있습니다. 그러나, 네트워크 자체가 느린 경우는 숫자를 높여줘도 그 효과를 얻기 어렵습니다. |
기본값=5 | ||
componentpath | X | 사용자 PC상에 컴포넌트들이 저장될 경로를 지정합니다. 일반적으로 이 값은 지정하지 않습니다. |
기본값="%USERAPP%\nexacro\14\Component\" %USERAPP%의 값은 “부록 A. Alias 경로”를 참조하세요 | ||
errorfile | X | 넥사크로플랫폼 엔진이 출력하는 에러정보들이 정의된 파일경로 입니다. 지정하지 않을 경우 넥사크로플랫폼 엔진의 기본 에러 정보가 출력됩니다. 일반적으로 지정하지 않습니다. |
기본값 없음 | ||
globalvalue | X | 넥사크로플랫폼 엔진이 구동될 때 globalvariable에 추가될 변수를 설정하는 속성입니다 |
기본값 없음 | ||
loadingimage | X | 넥사크로플랫폼 엔진이 화면이나 데이터 로딩 시 보여주는 이미지를 설정하는 속성입니다. 서버 상의 경로를 지정하면 직접 내려받은 후 설정된 설정된 ComponentPath아래에 저장합니다. |
기본값 없음 | ||
splashimage | X | 넥사크로플랫폼 엔진이 로딩되는 동안 보여줄 스플래시 이미지(Splash Image)의 경로를 지정합니다. 지정하지 않을 경우 넥사크로플랫폼 기본이미지가 출력됩니다. 이 이미지는 화면의 중앙에 표시됩니다. 이 이미지는 넥사크로플랫폼 엔진이 로딩되는 동안만 출력됩니다. |
기본값 없음 | ||
onlyone | Key와 XADL 값을 동일한 인스턴스를 하나만 띄울 것인지에 대한 여부를 설정하는 속성입니다. | |
Default : false | ||
commthreadwaittime | 넥사크로플랫폼 애플리케이션이 사용하는 쓰레드가 아무 일도 하지 않을 경우, 해당 쓰레드가 종료됩니다. 이때 종료 전에 대기할 시간(초)을 설정하는 속성입니다. | |
enginesetupkey | 실행경로로 사용할 특정 버젼의 넥사크로플랫폼 ProductKey 값을 지정하는 속성입니다. 사이트에서 별도 작성한 Setup 모듈을 사용하는 경우, Setup을 만들때 부여되는 Product Key를 속성값으로 설정하면 고정된 경로로 인해 Launcher에서 런타임 실행이 불가능했던 문제를 해결할 수 있습니다. |
메소드
Launcher가 실행할 수 있는 메소드들을 개략적으로 정리하면 아래와 같습니다.
메소드 | 설명 |
---|---|
launch | 넥사크로플랫폼 엔진을 전용 브라우저로 실행하는 메소드입니다. |
makeshortcut | 단축아이콘을 생성하는 메소드입니다. |
isexistshortcut | 입력받은 인자에 해당하는 바로가기 아이콘이 존재하는지 확인하는 메소드입니다. |
getEngineVersion | 시스템에 설치된 엔진 키에 해당하는 엔진 설치 버젼을 가져오는 메소드입니다. |
download | 애플리케이션 실행시 사용되는 자원을 다운로드 하는 메소드입니다. |
deleteshortcut | 바로가기 아이콘을 삭제하는 메소드입니다. |
addWebInfo | 현재 브라우저의 쿠키정보를 자동으로 globalvariable의 cookie 변수에 추가해주는 메소드입니다. |
이벤트
Launcher에서 발생하는 이벤트들을 별도로 정리하면 다음과 같습니다.
이벤트 | 설명 |
---|---|
error | Laucher실행 중에 에러가 생겼을때 발생하는 이벤트입니다. |
nexacro.exe
넥사크로플랫폼 엔진은 윈도우 명령 프롬프트에서 직접 실행할 수 있습니다. 주로 단축아이콘을 사용하며, 실행파일인 nexacro.exe을 여러 가지 옵션을 지정해 실행할 수 있습니다.
nexacro.exe –option1 option1_value –option2 option2_value … -optionN –optionN_value
실행옵션
다음은 실행옵션에 대한 상세한 내용을 설명한 것이다.
실행옵션 | 값 | 설명 |
---|---|---|
X (필수) | 경로명(string) | 변환된 서비스 ADL 자바스크립트 파일 경로를 지정합니다. |
K (필수) | KEY명(string) | 서비스의 Key값을 설정합니다. 같은 ADL 내에서 유일한 값이어야 합니다. |
C | 경로명(string) | 사용자 단말기에서 컴포넌트가 설치된 경로를 지정합니다. 지정하지 않는 경우 "%USERAPP%\nexacro\14\Component\"로 지정됩니다. %USERAPP%의 값은 “부록 Alias 경로”를 참조하세요 |
SP | 경로명(string) | 스플래시 이미지(Splash Image)의 경로를 지정합니다. 지정하지 않을 경우 넥사크로플랫폼 기본이미지가 출력됩니다. 이 이미지는 화면의 중앙에 표시됩니다. 이 이미지는 넥사크로플랫폼 엔진이 Loading되는 동안만 출력됩니다. |
LF | 위치값(int) | 애플리케이션의 초기 실행시 LEFT 위치를 지정합니다. 최초 화면의 MainFrame에 적용됩니다. |
TP | 위치값(int) | 애플리케이션의 초기 실행 TOP 위치를 지정합니다. 최초 화면의 MainFrame에 적용됩니다. |
WD | 크기(int) | 애플리케이션의 초기 실행 WIDTH를 지정합니다. 최초 화면의 MainFrame에 적용됩니다. |
HT | 크기(int) | 애플리케이션의 초기 실행 HEIGHT를 지정합니다. 최초 화면의 MainFrame에 적용됩니다. |
ERR | 경로명(string) | 에러코드 값을 정의한 “errordefine.xml” 화일의 경로를 지정합니다. 넥사크로플랫폼 엔진이 출력하는 에러정보를 변경할 때 사용합니다. 지정하지 않을 경우 넥사크로플랫폼 엔진의 기본 에러 정보가 출력됩니다. |
THR | 개수(int) | 엔진 내부 통신 및 기타 매니저들의 쓰레드 수를 지정한다. 지정하지 않는 경우 5가 됩니다. 사용자의 단말기가 고사양인 경우 값을 높게 지정해 주면 좋습니다. |
TW | 시간(int) | 넥사크로플랫폼 런타임의 통신 쓰레드가 대기할 시간을 지정합니다 |
LG | 경로명(string) | LoadingImage를 설정 할 수 있는 경로를 지정합니다. |
OO | 여부(bool) | 동일한 Key, XADL로 런타임 엔진이 띄워진 경우 런타임 엔진을 하나만 띄우도록 할 지 여부를 설정합니다. |
GF | 파일명(string) | Launcher에서 GlobalVariable을 설정한 경우 넥사크로플랫폼으로 값을 전달하기 위해 사용하는 임시 파일명입니다. 넥사크로플랫폼이 올라올 때 읽고 삭제합니다. Launcher를 사용하지 않고 직접 입력하는 경우에는 정상동작 하지 않을수 있습니다. |
V | Variable문자열(string) | 런타임 엔진을 띄울 때 Global변수에 추가할 변수리스트를 설정합니다. 변수명:타입=값 변수명:타입=값 형식으로 입력합니다. 구분자는 스페이스로 합니다. 즉“A:s=b C:g=d E=f” 형태가 됩니다. 통신시 Cookie로 사용될 변수는 타입에 s, 일반 변수는 타입을 쓰지 않거나 g로 표기합니다. |
SIE | 여부(bool) | adl 로딩시 에러가 발생하는 경우 에러 메시지 박스를 띄우고 종료할지 여부를 지정합니다. |
CT | 시간초(int) | 초기 네트워크가 연결되어 있는지 체크하는 Timeout을 설정합니다. 네트웍이 연결되어 있는지 여부를 애플리케이션이 구동되기 전에 체크합니다.Timeout 시간동안 네트워크가 연결되어 있지 않으면 자동 종료됩니다. |
SCR | 스크린 ID 문자열(string) | LayoutManager에서 사용하기 위한 ScreenID를 설정합니다. |
nexacro.exe 파일 경로
nexacro.exe 파일은 “nexacro14_SetupEngine.cab” 또는 “nexacro14_SetupEngine.exe”으로 설치됩니다.
설치경로는 MS Windows인 경우 아래와 같습니다.
%PROGRAMFILES%\nexacro\14\nexacro.exe