주요 모듈 실행 방법

XPLAFORM이 제공하는 3개의 모듈은 사용자가 XPLATFORM이 아닌 다른 프로그램에 의해서 실행됩니다. 이중 2개(XPLATFORMAX, XPLauncher)는 Web Browser에 의하여 실행되며, 1개(XPLATFORM.exe)는 OS의 명령줄에서 실행됩니다.

XPLATFORMAX

XPLATFORMAX는 XPLATFORM Engine을 Web Browser상에서 실행시키기 위한 ActiveX 모듈 입니다.

이 모듈은 다음의 Setup 파일들에 포함되어 있습니다.

XPLATFORMAX는 Web Browser상의 object이므로 element(property, method, event)들을 갖습니다.

여기서는 element들의 개략적인 설명만 합니다.

상세한 설명은 “XPLATFORM Reference Guide”를 참조하세요.

CLASS ID

AcitveX를 위한 Classid는 “43C5FE00-DD32-4792-83DB-19AE4F88F2A6”입니다.

다음은 이 모듈을 활성화하기 위한 HTML code입니다.

<SCRIPT LANGUAGE="javascript">
document.write('<OBJECT ID="XPlatformAXCtrl" CLASSID="CLSID: 43C5FE00-DD32-4792-83DB-19AE4F88F2A6"'
+'"CODEBASE="http://127.0.0.1/XPLATFORM9_XPLauncher.cab#VERSION=2011,10,4,1"  onError="fn_onError()" >'
+ '<PARAM NAME="key" VALUE=" XP_Sample ">'
+ '<PARAM NAME="xadl" VALUE="http://127.0.0.1/XP_Service/ SampleADL.xadl">'
+ '</OBJECT>');

Property

XPLATFORMAX의 Property값을 별도로 정리하면 다음과 같습니다. 필수로 표시된 값은 반드시 지정해야만 XPLATFORM Engine을 구동할 수 있습니다.

Property명

필수

설명

기본값

key

O

서비스의 Key값을 설정합니다.

동일 ADL상의 유일한 값이어야 합니다.

기본값 없음.

xadl

O

서비스의 ADL 경로를 지정합니다.

기본값 없음.

componentpath

X

사용자 PC상에 콤퍼넌트들이 저장될 PATH를 지정합니다.

일반적으로 이 값은 지정하지 않습니다.

기본값="%USERAPP%\TobeSoft\XPLATFORM9\Component\"

%USERAPP%의 값은 Alias 경로를 참조하세요

autosize

X

XPLATFORM의 Size를 Web Browser의 size에 영향 받아 가변적으로 변할지 여부를 지정합니다.

false일경우 Web Browser의 Plugin Width, Height 값이 적용됩니다.

기본값=true

commthreadcount

X

XPLATFORM Engine이 사용하는 통신 Thread 개수를 지정합니다.

사용자의 단말기의 CPU가 여러 개일 때 값을 높게 지정해 주면 좋습니다.이 기능은 통신 처리에만 사용하므로 여러 개의 통신을 동시에 사용하기를 원할 경우 숫자를 높여주면 빠른 응답결과를 얻을 수 있습니다. 그러나, 네트워크 자체가 느린 경우는 숫자를 높여줘도 그 효과를 얻기 어렵습니다.

기본값=5

errorfile

X

XPLATORM Engine이 출력하는 에러정보들이 정의된 파일경로 입니다.지정하지 않을 경우 XPLATFORM Engine의 기본 에러 정보가 출력됩니다.일반적으로 지정하지 않습니다.

기본값 없음

handleflag

X

XPLATFORM 응용프로그램이 종료된 후, exit() event를 발생시킬지 여부를 지정합니다.

지정하지 않을 경우 true가 되어 exit()가 발생합니다.

기본값=true

Commthreadwaittime

X

XPLATFORM 응용프로그램이 사용하는 thread가 아무 일도 하지 않을 경우, 해당 thread가 종료됩니다. 이때 종료 전에 wait할 시간(초)을 설정하는 Property입니다.

usewininet

X

서버와 통신하는 방식을 지정하는 속성으로서 WININET 통신 라이브러리를 사용하여 통신을 할지를 설정하는 Property 입니다

기본값= false

autostart

X

XPLATFORMAX Control이 생성되는 시점에 자동으로 run()을 수행할지의 여부를 결정하는 Property 입니다.

기본값=false

Method

XPLATFORMAX가 실행할 수 있는 method들을 개략적으로 정리하면 아래와 같습니다.

Method명

설명

callscript()

XPLATFORMAX에서 구동중인 XPLATFORM Engine의 스크립트의 Method를 수행하기 위한 Method 입니다.

getvariablevalue()

XPLATFORMAX에서 XPLATFORM Engine의 GlobalVariable의 변수값을 얻어오는 Method입니다.

run()

XPLATFORMAX가 XPLATFORM Engine을 실행하는 Method입니다.

setvariablevalue()

XPLATFORMAX에서 XPLATFORM Engine의 GlobalVariable의 변수값을 설정하는 Method입니다.

stop()

PlugIn이 XPLATFORM의 모든 Manager들을 중지시키는 Method입니다.

quit()

Plugin이 ADL을 로딩하고 수행을 시작하는 Method입니다.

addWebInfo

현재 브라우저의 쿠키정보를 자동으로 globalvariable의 cookie변수에 추가해주는 Method 입니다.

Event

XPLATFORMAX에서 발생하는 Event들을 별도로 정리하면 다음과 같습니다.

Event명

설명

addlog()

  • XPLATFORM Script에서 trace()함수를 실행했을 때 발생하는 Event입니다.

  • XPLATFORM Script에서 trace() 함수의 인자 값이 그대로 event 의 인자 값으로 적용됩니다.

beforeexit()

  • XPALTFORM Engine종료 직전에 발생하는 Event입니다.

  • beforeexit Event후 exit Event가 발생됩니다. beforeexit 이벤트에서 handledflag값을 false로 설정하면 exit 이벤트가 발생되지 않습니다. 즉, 종료되지 않습니다.

  • XPLATFORM Script에서 exit 함수를 호출했을 때 발생하며, application의 onbeforeexit 이벤트 발생 후 XPLATFORMAX에서 beforeexit 가 발생합니다.

communication()

  • XPLATFORM의 통신을 시작할 때와 끝날 때에 발생하는 Event입니다.

error()

  • XPLATFORMAX loading중에 또는 XPLATFORM Engine실행중에 에러가 발생하면 발생하는 Event입니다.

exit()

  • XPALTFORM Engine이 종료될 때, 발생하는 Event입니다.

  • beforeexit() event의 영향을 받습니다.

load()

  • XPALTFORM Engine의 초기 loading이 완료된 후, 발생하는 Event입니다.

  • XPALTFORM Script에서는 onload event 가 발생합니다.

  • loadtypedefinition loadingglobalvariables load 순으로 event가 발생합니다.

loadingglobalvariables()

  • GlobalVariables 들의 Object들이 생성한 후에 발생하는 Event입니다.

  • Dataset, form의 URL은 로딩하기 전이므로 이벤트 안에서 로딩에 필요한 정보를 추가, 수정하면 변경된 값으로 로딩됩니다.

  • XPLATFORM Script에서도 application의 onloadingglobalvariables event가 발생합니다.

loadtypedefinition()

  • TypeDefinition에 등록된 콤퍼넌트들의 로딩을 완료한 후 발생하는 Event 입니다.

  • 컴포넌트들의 배포도 완료했음을 의미합니다.

  • XPLATFORM Script에서도 application의 onloadtypedefinition event가 발생합니다.

usernotify()

  • XPALTFORM Script에서 userNotify () 함수를 호출하는 경우 PlugIn에서 발생하는 Event입니다.

  • XPALTFORM Script에서 userNotify () 함수의 인자 값이 그대로 event 의 인자 값으로 적용됩니다.

XPLauncher

XPLauncher는 XPLATFORM Engine을 전용Browser로 실행하기 위한 ActiveX 모듈입니다.

이 모듈은 다음의 Setup 파일들에 포함되어 있습니다.

XPLauncher는 Web Browser상의 object이므로 element(property, method, event)들을 갖습니다.

여기서는 element들의 개략적인 설명만 합니다.

상세한 설명은 “XPLATFORM Reference Guide”를 참조하세요.

CLASS ID

AcitveX를 위한 Classid는 “A30D5481-7381-4dd9-B0F4-0D1D37449E97”입니다.

다음은 이 모듈을 활성화하기 위한 HTML code입니다.

<SCRIPT LANGUAGE="javascript">
document.write('<OBJECT ID="XPlatformAXCtrl" CLASSID="CLSID: A30D5481-7381-4dd9-B0F4-0D1D37449E97"'
+'"CODEBASE="http://127.0.0.1/XPLATFORM9_XPLauncher.cab#VERSION=2011,10,28,1"  onError="fn_onError()" >'
+ '<PARAM NAME="key" VALUE=" XP_Sample ">'
+ '<PARAM NAME="xadl" VALUE="http://127.0.0.1/XP_Service/ SampleADL.xadl">'
+ '</OBJECT>');

Property

XPLauncher의 Property값을 별도로 정리하면 다음과 같습니다. 필수로 표시된 값은 반드시 지정해야만 XPLATFORM Engine을 구동할 수 있습니다.

Property명

필수

설명

기본값

Key

O

서비스의 Key값을 설정합니다.

동일 ADL상의 유일한 값이어야 합니다.

기본값 없음.

Xadl

O

서비스의 ADL 경로를 지정합니다.

기본값 없음.

commthreadcount

X

XPLATFORM Engine이 사용하는 통신 Thread 개수를 지정합니다.

사용자의 단말기의 CPU가 여러 개일 때 값을 높게 지정해 주면 좋습니다.

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

기본값=5

componentpath

X

사용자 PC상에 콤퍼넌트들이 저장될 PATH를 지정합니다.

일반적으로 이 값은 지정하지 않습니다.

기본값="%USERAPP%\TobeSoft\XPLATFORM\9.2\Component\"

%USERAPP%의 값은 Alias 경로를 참조하세요

errorfile

X

XPLATORM Engine이 출력하는 에러정보들이 정의된 파일경로 입니다.

지정하지 않을 경우 XPLATFORM Engine의 기본 에러 정보가 출력됩니다.

일반적으로 지정하지 않습니다.

기본값 없음

globalvalue

X

XPLATFORM Engine이 구동될 때 globalvariable에 추가될 변수를 설정하는 Property입니다

기본값 없음

loadingimage

X

XPLATFORM Engine이 화면, Data 로딩시 보여주는 이미지를 설정하는 Property입니다.

서버 경로가 입력되는 경우는 직접 다운 로드 한 후, 설정된 ComponentPath아래에 저장합니다.

기본값 없음

splashimage

X

XPLATFORM Engine이 Loading되는 동안 보여줄 Splash Image의 경로를 지정합니다.

지정하지 않을 경우 XPLATFORM기본이미지가 출력됩니다.

이 이미지는 화면의 중앙에 표시됩니다.

이 이미지는 XPLATFORM Engine이 Loading되는 동안만 출력됩니다.

기본값 없음

onlyone


Key와 XADL 값을 동일한 Instance를 하나만 띄울 것인지에 대한 여부를 설정하는 Property입니다.


Default : false

commthreadwaittime


XPLATFORM 응용프로그램이 사용하는 thread가 아무 일도 하지 않을 경우, 해당 thread가 종료됩니다. 이때 종료 전에 wait할 시간(초)을 설정하는 Property입니다.

enginesetupkey


실행경로로 사용할 특정 버젼의 XPLATFORM ProductKey 값을 지정하는 Property 입니다.

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

Method

XPLauncher가 실행할 수 있는 method들을 개략적으로 정리하면 아래와 같습니다.

Method명

설명

launch()

XPLATFORM Engine을 전용 Browser로 실행시킵니다.

makeshortcut()

단축아이콘을 생성합니다.

isexistshortcut

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

getEngineVersion

시스템에 설치된 엔진 키에 해당하는 엔진 설치 버젼을 가져오는 Method 입니다.

download

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

deleteshortcut

바로가기 아이콘을 삭제하는 Method 입니다.

addWebInfo

현재 브라우저의 쿠키정보를 자동으로 globalvariable의 cookie변수에 추가해주는 Method 입니다.

Event

XPLauncher에서 발생하는 Event들을 별도로 정리하면 다음과 같습니다.

Event명

설명

error()

XLaucher실행 중에 에러가 발생하면, 발생하는 Event입니다.

XPLATFORM.exe(V9.2변경)

XPLATFORM Engine은 MS Windows상의 명령줄에서 직접 실행할 수 있다. 주로 단축아이콘을 사용하는데, 실행파일 XPLATFORM.exe을 여러 가지 option으로 실행할 수 있다.

실행 Syntax

다음은 option을 사용한 실행 예이다.

XPLATFORM.exe –option1 option1_value –option2 option2_value … -optionN –optionN_value

실행 option

다음은 option들을 설명한 것이다.

실행옵션

설명

X

(필수)

경로명(string)

ADL 문서의 경로를 지정합니다.

K

(필수)

KEY명(string)

서비스의 Key값을 설정합니다.

url상의 서비스들중 유일한 값이어야 합니다

C

경로명(string)

사용자 단말기에서 컴포넌트가 설치된 경로를 지정합니다.

지정하지 않는 경우

"%USERAPP%\TobeSoft\XPLATFORM9\9.2\Component\"로

지정됩니다.

%USERAPP%의 값은 “Alias 경로”를 참조하세요

SP

경로명(string)

Splash Image의 경로를 지정합니다.

지정하지 않을 경우 XPLATFORM기본이미지가 출력됩니다.

이 이미지는 화면의 중앙에 표시됩니다.

이 이미지는 EXPLATFORM Engine이 Loading되는 동안만 출력됩니다.

LF

위치값(int)

Application 의 초기실행 LEFT 위치를 지정합니다.

최초화면의 MainFrame에 적용됩니다.

TP

위치값(int)

Application 의 초기실행 TOP 위치를 지정합니다.

최초 화면의 MainFrame에 적용됩니다.

WD

크기(int)

Application 의 초기실행 WIDTH를 지정합니다.

최초 화면의 MainFrame에 적용됩니다.

HT

크기(int)

Application 의 초기실행 HEIGHT를 지정합니다.

최초 화면의 MainFrame에 적용됩니다.

ERR

경로명(string)

에러코드 값을 정의한 “errordefine.xml” 화일의 경로를 지정합니다.

XPLATORM Engine이 출력하는 에러정보를 변경할 때 사용합니다.

지정하지 않을 경우 XPLATFORM Engine의 기본 에러 정보가 출력됩니다.

THR

개수(int)

엔진 내부 통신 및 기타 매니저들의 쓰레드 수를 지정한다.

지정하지 않는 경우 5가 됩니다.

사용자의 단말기가 고사양인 경우 값을 높게 지정해 주면 좋습니다.

TW

시간(int)

XPLATFORM Runtime의 통신thread가 wait할 시간을 지정합니다

LG

경로명(string)

LoadingImage를 설정 할 수 있는 경로를 지정합니다.

OO

여부(bool)

동일한 Key, XADL로 Runtime Engine이 띄워진 경우 Runtime Engine을 하나만 띄우도록 할 지 여부를 설정합니다.

GF

파일명(string)

Launcher에서 GlobalVariable을 설정한 경우 XPLATFORM으로 값을 전달하기 위해 사용하는 Temp파일명입니다. XPLATFORM이 올라올 때 읽고 삭제합니다. Launcher를 사용하지 않고 직접 입력하는 경우에는 정상동작 하지 않을수 있습니다.

V

Variable문자열(string)

Runtime Engine을 띄울 때 Global변수에 추가할 변수리스트를 설정합니다.

변수명:타입=값 변수명:타입=값 형식으로 입력합니다. 구분자는 스페이스로 합니다. 즉“A:s=b C:g=d E=f” 형태가 됩니다. 통신시 Cookie로 사용될 변수는 타입에 s, 일반 변수는 타입을 쓰지 않거나 g로 표기합니다.

SIE

여부(bool)

adl 로딩시 에러가 발생하는 경우 에러 메시지 박스를 띄우고 종료할지 여부를 지정합니다.

CT

시간초(int)

초기 네트웍이 연결되어 있는지 체크하는 Timeout을 설정합니다. 네트웍이 연결되어 있는지 여부를 Application이 구동되기 전에 체크합니다.Timeout 시간동안 네트웍이 연결되어 있지 않으면 자동 종료됩니다.

SCR

(V9.2추가)

스크린 ID 문자열

(string)

LayoutManager에서 사용하기 위한 ScreenID를 설정합니다.

XPLATFORM.exe 파일 경로

XPLATFORM.exe 파일은 “XPLATFORM9_SetupEngine.cab” 또는 “XPLATFORM9_SetupEngine.exe”으로 설치됩니다.

설치경로는 MS Windows인 경우 아래와 같습니다.

\Program Files\TOBESOFT\XPLATFORM\9.2\XPLATFORM.exe