개요

넥사크로로 만든 애플리케이션의 기본 정보와 초기 생성 시 주어지는 환경정보를 다루는 기본이 되는 오브젝트입니다.

지원 환경

속성

all

Application 에 등록된 모든 오브젝트를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법 설정

var objApp = nexacro.getApplication() ;
var objItem0 = objApp.all[0] ;

참고

- all 속성을 사용하면 Application 에 속한 mainframe, Variables, DataSet, Objects 정보에 접근할 수 있습니다.

- all 속성은 Collection 접근방식을 사용할 수 있습니다.
  Application.all[0], Application.all["MainFrame"], Application.all.length 등의 방법을 사용합니다.

licenseurl

라이선스 정보를 가지고 있는 파일의 경로를 설정하는 속성입니다.

지원 환경

속성 타입

문법

application.licenseurl

문법 설정

var objApp = nexacro.getApplication() ;
alert(objApp.licenseurl);

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- 라이선스 경로가 서버인 경우에는 ADL과 같은 도메인 경로(D Class까지)만 허용합니다.

mainframe

Application 하위에 속한 MainFrame 을 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법 설정

var objApp = nexacro.getApplication() ;
var objMainframe = objApp.mainframe ;

참고

- MainFrame 의 ID 를 사용하여 접근할 수 있습니다.

name

Application 의 이름을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

참고

- 넥사크로 스튜디오에서 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.

screenid

Application 이 실행되는 스크린의 ID 를 설정하는 속성입니다.

지원 환경

속성 타입

문법

application.screenid

문법 설정

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- 동일 프로젝트에서 하나의 스크린 ID는 하나의 Application 에만 등록될 수 있습니다.

trays

Application 에 등록된 Tray 오브젝트의 정보를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법 설정

var objApp = nexacro.getApplication() ;
var objTray0 = objApp.trays[0] ;

참고

- trays 속성은 Collection 접근방식을 사용할 수 있습니다.
  objApp.trays[0], objApp.trays["Tray00"], objApp.trays.length 등의 방법을 사용합니다.

version

Application 의 버전을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

var objApp = nexacro.getApplication() ;
objApp.version = "4.0";

메서드

addEventHandler

Application 의 특정 이벤트에 핸들러 함수를 추가하는 메소드입니다.

지원 환경

문법

Application.addEventHandler( strEventID, objFunc, objTarget )

파라미터

this.application_onload = function(obj:nexacro.Application,e:nexacro.LoadEventInfo) { // 수행할 스크립트 };

var objApp = nexacro.getApplication() ; 
var nIndex = objApp.addEventHandler( "onload", this.application_onload, this);

반환

addEventHandlerLookup

함수를 검색하여 Application 의 특정 이벤트에 핸들러 함수로 추가하는 메소드입니다.

지원 환경

문법

Application.addEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

this.application_onload = function(obj:nexacro.Application,e:nexacro.LoadEventInfo) { // 수행할 스크립트 };

var objApp = nexacro.getApplication() ; 
var nIndex = objApp.addEventHandlerLookup( "onload", "application_onload", this);

반환

참고

- strFunc 이름의 함수를 objTarget 영역부터 상위로 올라가며 검색합니다.
  검색된 함수가 있다면 이벤트에 핸들러 함수로 추가합니다.

addTray

동적으로 생성한 Tray 를 Application 에 추가하는 메소드입니다.

지원 환경

문법

Application.addTray(strTrayID, objTray)

파라미터

var objApp = nexacro.getApplication() ;
var objTray = new Tray("Tray00", objApp);

objTray.init("Tray00", "information", "Tray Tooltip");
var nIndex = objApp.addTray("Tray00", objTray);
objTray.show();

반환

참고

- trays 속성을 통해 현재 등록되어 있는 Tray 들을 확인할 수 있습니다.

addVariable

Application 의 AppVariables 영역에 변수를 추가하는 메소드입니다.

지원 환경

문법

Application.addVariable( strID, varValue )

파라미터

var objApp = nexacro.getApplication();
var nSucc;
nSucc = objApp.addVariable("aa", "test1");
nSucc = objApp.addVariable("aa", "test1");

반환

참고

- AppVariables 영역에 이미 존재하는 변수명일 경우에는 메소드가 수행되지 않습니다.

- Environment 영역에 변수를 추가하기 위해서는 setEnvironmentVariable() 메소드를 사용하여야 합니다.

- 통신 시 사용되는 Cookie 를 추가하기 위해서는 setCookieVariable() 메소드를 사용하여야 합니다.

활용 예제

• 스크립트로 Dataset 생성하기

alert

Application 의 경고 대화상자를 표시하는 메소드입니다.

지원 환경

문법

Application.alert( strText )

파라미터

var objApp = nexacro.getApplication() ;
objApp.alert( "warning" );

참고

- 현재 활성화되어 있는 Form 의 중앙에 대화상자를 표시합니다.

활용 예제

• 경고, 확인 대화상자 띄우기

cancelTransaction

진행중인 트렌젝션을 중지 시키는 메소드입니다.

지원 환경

문법

cancelTransaction( [strSvcID] )

파라미터

참고

- Sync 로 동작되는 트렌잭션에는 적용되지 않습니다.

clearEventHandler

특정 이벤트에 등록된 핸들러 함수를 모두 제거하는 메소드입니다

지원 환경

문법

Application.clearEventHandler( strEventID )

파라미터

var objApp = nexacro.getApplication();
var nCnt = objApp.clearEventHandler( "onload" );

반환

참고

- 특정 핸들러 함수만 제거하려면 removeEventHandler() 메소드를 사용하시기 바랍니다.

confirm

Application 의 선택 대화상자를 표시하는 메소드입니다.

지원 환경

문법

Application.confirm( strText [,strCaption [,strType]] )

파라미터

var objApp = nexacro.getApplication() ;
var bOK;
bOK = objApp.confirm( "Please check it carefully." );
bOK = objApp.confirm( "Please check it carefully." , "TitleTest");
bOK = objApp.confirm( "Please check it carefully." , "TitleTest", "error" );

반환

참고

- 현재 활성화되어 있는 Form 의 중앙에 대화상자를 표시합니다.

exit

실행중인 넥사크로 어플리케이션을 종료시키는 메소드입니다.

지원 환경

문법

Application.exit()

파라미터

var objApp = nexacro.getApplication() ;
objApp.exit() ;

참고

- exit() 메소드 이후에 정의된 스크립트까지 실행하고 어플리케이션을 종료합니다.
   단, exit() 메소드 이후 스크립트에 정의된 alert(), confirm() 메소드는 실행되지 않습니다.


◆ WRE 제약

- 애플리케이션을 외부 페이지 링크 또는 window.open 함수로 열지 않고 직접 브라우저 주소창에 URL을 입력하고 실행할 때 발생하는 제약사항입니다.

- 스크립트에서 exit 메소드 실행 시 열려있는 Form이 종료되고 실행 중인 넥사크로 애플리케이션을 종료시키지만 현재 브라우저 탭은 닫히지 않으며 콘솔에 스크립트 에러가 표시됩니다.

- 브라우저 탭은 닫히지 않지만 애플리케이션 종료 요청은 처리되기 때문에 exit 메소드 실행 시 onexit, onbeforeexit 이벤트가 발생합니다.

findEventHandler

Application 의 특정 이벤트에서 핸들러 함수를 찾아 인덱스를 반환하는 메소드입니다.

지원 환경

문법

Application.findEventHandler( strEventID, objFunc, objTarget )

파라미터

this.application_onload = function(obj:nexacro.Application,e:nexacro.LoadEventInfo) { // 수행할 스크립트 };

var objApp = nexacro.getApplication() ; 
var nIndex = objApp.findEventHandler( "onload", this.application_onload, this);

반환

참고

- 이벤트에 등록된 핸들러 함수의 인덱스는 "0"부터 시작합니다.

getActiveForm

Application 에서 현재 활성화된 Form 객체를 반환하는 메소드입니다.

지원 환경

문법

Application.getActiveForm()

파라미터

var objApp = nexacro.getApplication() ; 
var objForm = objApp.getActiveForm() ;

반환

활용 예제

• 활성화된 화면(Form) 이름(ID) 속성 정보 얻기

getActiveFrame

Application 에서 현재 활성화된 Frame 객체를 반환하는 메소드입니다.

지원 환경

문법

Application.getActiveFrame()

파라미터

var objApp = nexacro.getApplication() ;
var objForm = objApp.getActiveFrame() ;

반환

참고

모달, 모덜리스 자식프레임을 포함하여 현재 포커스를 가진 프레임이 반환됩니다.

프레임세트내 프레임이 활성화된 경우, 활성화된 폼을 담고 있는 프레임이 반환됩니다.

getEventHandler

Application 의 특정 이벤트에서 지정된 인덱스에 해당하는 핸들러 함수를 반환하는 메소드입니다.

지원 환경

문법

Application.getEventHandler( strEventID, nIdx )

파라미터

var objApp = nexacro.getApplication();
var objFunc = objApp.getEventHandler( "onload", 0 );

반환

insertEventHandler

Application 의 특정 이벤트에 핸들러 함수를 지정한 위치에 삽입하는 메소드입니다.

지원 환경

문법

Application.insertEventHandler( strEventID, nIndex, objFunc, objTarget )

파라미터

this.application_onload = function(obj:nexacro.Application,e:nexacro.LoadEventInfo) { // 수행할 스크립트 };

var objApp = nexacro.getApplication() ; 
var nIndex = objApp.insertEventHandler( "onload", 0, this.application_onload, this);

반환

참고

- 첫번째 핸들러 함수의 인덱스는 0 입니다.

isExistVariable

Application 의 AppVariables 영역에 특정 변수의 존재여부를 반환하는 메소드입니다.

지원 환경

문법

Application.isExistVariable( strID );

파라미터

var objApp = nexacro.getApplication();
var bExist = objApp.isExistVariable("aa");

반환

lookup

인수로 전달된 오브젝트를 Application 전체를 대상으로 검색하여 반환하는 메소드입니다.

지원 환경

문법

Application.lookup( strObjectID )

파라미터

반환

removeEventHandler

Application 의 특정 이벤트에서 핸들러 함수를 제거하는 메소드입니다.

지원 환경

문법

Application.removeEventHandler( strEventID, objFunc, objTarget )

파라미터

this.application_onload = function(obj:nexacro.Application,e:nexacro.LoadEventInfo) { // 수행할 스크립트 };

var objApp = nexacro.getApplication() ; 
var nIndex = objApp.removeEventHandler( "onload", this.application_onload, this);

반환

참고

- 추가된 핸들러 함수를 모두 제거하려면 clearEventHandler() 메소드를 사용하시기 바랍니다.

removeEventHandlerLookup

Application 의 특정 이벤트에서 검색된 함수와 동일한 핸들러 함수를 제거하는 메소드입니다.

지원 환경

문법

Application.removeEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

this.application_onload = function(obj:nexacro.Application,e:nexacro.LoadEventInfo) { // 수행할 스크립트 };

var objApp = nexacro.getApplication() ; 
var nIndex = objApp.removeEventHandlerLookup( "onload", "application_onload", this );

반환

참고

- 핸들러 함수가 제거되면 핸들러 함수의 인덱스가 "0" 번부터 재조정됩니다.

- 이벤트에 등록된 핸들러 함수를 모두 제거하려면 clearEventHandler() 메소드를 사용하여야 합니다.

removeTray

Application 의 trays 속성에 등록된 Tray 오브젝트를 삭제하는 메소드입니다.

지원 환경

문법

application.removeTray([strID]);

파라미터

var objApp = nexacro.getApplication();

objApp.removeTray("Tray00");
objApp.removeTray();

removeVariable

Application 의 AppVariables 영역에서 변수를 제거하는 메소드입니다.

지원 환경

문법

Application.removeVariable( strID )

파라미터

var objApp = nexacro.getApplication() ;
objApp.removeVariable("aa") ;

참고

- Environment 영역에 있는 변수를 제거하기 위해서는 removeEnvironmentVariable() 메소드를 사용하여야 합니다.

- 통신 시 사용되는 Cookie 를 제거하기 위해서는 removeCookieVariable() 메소드를 사용하여야 합니다.

setEventHandler

Application 의 특정 이벤트에서 첫번째 핸들러 함수를 변경하는 메소드입니다.

지원 환경

문법

Application.setEventHandler( strEventID, objFunc, objTarget )

파라미터

this.application_onload = function(obj:nexacro.Application,e:nexacro.LoadEventInfo) { // 수행할 스크립트 };

var objApp = nexacro.getApplication() ; 
var nIndex = objApp.setEventHandler( "onload", this.application_onload, this);

반환

참고

- 인덱스가 "0"번인 핸들러 함수를 새로운 함수로 대체합니다.

- 인덱스가 "0"번인 핸들러 함수가 없다면 "0"번 인덱스에 새로운 함수를 핸들러 함수로 추가합니다.

setEventHandlerLookup

Application 의 특정 이벤트에서 첫번째 핸들러 함수를 검색된 함수로 변경하는 메소드입니다.

지원 환경

문법

Application.setEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

this.application_onload = function(obj:nexacro.Application,e:nexacro.LoadEventInfo) { // 수행할 스크립트 };

var objApp = nexacro.getApplication() ; 
var nIndex = objApp.setEventHandlerLookup( "onload", "application_onload", this);

반환

참고

- 인덱스가 "0"번인 핸들러 함수를 검색된 함수로 대체합니다.

- 인덱스가 "0"번인 핸들러 함수가 없다면 "0"번 인덱스에 검색된 함수를 핸들러 함수로 추가합니다.

setVariable

Application 의 AppVariables 영역에 변수를 추가 또는 값을 설정하는 메소드입니다.

지원 환경

문법

Application.setVariable( strID, varValue )

파라미터

var objApp = nexacro.getApplication() ;
var nSucc = objApp.setVariable("aa", "test1");

반환

참고

- AppVariables 영역에 이미 존재하는 변수명일 경우에는 값을 변경합니다.

- Environment 영역에 변수를 추가하기 위해서는 setEnvironmentVariable() 메소드를 사용하여야 합니다.

- 통신 시 사용되는 Cookie 를 추가하기 위해서는 setCookieVariable() 메소드를 사용하여야 합니다.

trace

추적 로그를 남기는 메소드입니다.

지원 환경

문법

Application.trace( strLog )

파라미터

var objApp = nexacro.getApplication() ;
objApp.trace( "Check - first position" ) ;

참고

- trace() 메소드로 출력할 수 있는 로그의 최대 길이는 브라우저 버전 및 종류에 따라 달라질 수 있습니다.

transaction

Application 영역에 정의된 Dataset 의 데이터를 갱신하기 위한 서비스를 호출하고, 트랜잭션이 완료되면 콜백함수을 실행하는 메소드입니다.

지원 환경

문법

Application.transaction(strSvcID,strURL,strInDatasets,strOutDatasets,strArgument[, strCallbackFunc[,bAsync[,nDataType[,bCompress]]]])

파라미터

var objApp = nexacro.getApplication() ;
objApp.transaction( "MyService01" ,"DataSrv::samplexml.jsp","input1=Dataset02","Dataset03=output1","a=b","callbackFunction" );
objApp.transaction( "MyService01" ,"DataSrv::samplexml.jsp","input1=Dataset02","Dataset03=output1","a=b","callbackFunction",false,1,false );

const req = objApp.transaction("MyService01","DataSrv::samplexml.jsp","input1=Dataset02","Dataset03=output","a=b");
if(req) 
{
    req.then(res => { 
        objApp.callbackFunction(res);
    })
    .catch(err => trace(err));
}

async function loadData(app) 
{
    try {
        await app.transaction("MyService01","DataSrv::samplexml.jsp","input1=Dataset02","Dataset03=output","a=b");
        trace("after transaction message");
     } catch (err) {
        trace(err);
    }
}

this.Button00_onclick = function(obj:nexacro.Button,e:nexacro.ClickEventInfo)
{
    var objApp = nexacro.getApplication() ;
    loadData(objApp );
}

반환

참고

- Application 과 Form 에 정의된 transaction() 메소드는 기본적인 기능은 동일하지만 DataSet 과 콜백함수를 찾는 영역이 다릅니다.
  > Application 의 transaction() 메소드는 DataSet 과 콜백함수가 Application 영역에 정의되어 있어야 합니다.
  > 반면 Form 의 transaction() 메소드는 Form 영역에서 DataSet 과 콜백함수를 우선적으로 검색하지만,
  > Form 영역에 DataSet 과 콜백함수가 정의되어 있지 않으면 상위 영역으로 검색을 확장시킵니다.
  > Form 이 Container Component 에 연결되어 있으면 상위 컴포넌트도 검색 영역에 포함됩니다.
  > Form 영역에서 strInDatasets, strOutDatasets 파라미터 설정 시 "."을 포함한 형식을 사용하는 경우에는 상위 영역으로 검색을 확장하지 않습니다.

- 트랜잭션은 기본적으로 비동기 방식으로 동작합니다.
   예외적으로 strURL 에 로컬 경로를 설정하는 경우에는 bAsync 옵션과 무관하게 동기(Sync) 방식으로 동작합니다.

- strInDatasets 의 추가 옵션
   strInDatasets 에 각각의 DataSet ID 뒤에 ":U", ":A", ":N" 의 옵션을 붙일 수 있습니다.
  > ":U" 는 갱신된 정보만을 보냅니다.
  > ":A" 는 모든 정보를 보냅니다.
  > ":N" 은 현재 삭제한 데이터를 제외한 정보를 Normal 상태로 보냅니다. 지정하지 않은 DataSet 은 Normal 로 동작합니다.

- strOutDatasets 관련 주의사항
   strOutDatasets 으로 입력받는 DataSet 은 Datasetid.load() 와 마찬가지로 
   기존에 가진 열/레코드 대신 수신받은 DataSet 의 열/레코드로 모두 변경됩니다.

- strCallbackFunc 에 관한 주의사항
   strCallbackFunc 를 "Transaction_Callback" 으로 설정할 경우,
   해당 Application 영역에는 반드시 this.transaction_Callback = function(strSvcID, nErrorCode, strErrorMag) 이 존재해야 합니다.
   이 콜백 함수는 위와 같은 형태이며, 콜백 함수의 strSvcID 는 입력된 strSvcID 와 동일합니다.

- 트랜잭션 수행 후 서버로 부터 전달된 파라미터가 있을 경우 처리되는 사항
  > 파라미터의 변수명을 Application > Environment 영역 순서로 찾아 처음 일치하는 영역의 변수값만 업데이트합니다.
     전체 영역에서 일치하는 변수가 없을 경우에는 전달된 파라미터값이 무시됩니다.

- 트랜잭션 수행 후 서버로 부터 전달된 Return XML 의 ErrorCode 파라미터 관련 주의사항
  > ErrorCode 가 0 미만의 음수이면 트랜잭션이 실패로 처리되고, Input DataSet 의 상태와 바인딩된 컴포넌트는 리드로(redraw) 되지 않습니다.
     단, Environment 의 datasetloadtype 속성값이 "errorallow" 인 경우는 Output DataSet 에 데이터를 로드합니다.
  > ErrorCode 가 0 이상이면 트랜잭션이 성공으로 처리되고, Input DataSet 의 상태는 "Normal" 로 변경되며 바인딩된 컴포넌트는 리드로(redraw) 됩니다.
  > 서버로 부터 전달된 데이터가 없을 경우 (서버에서 HttpPlatformResponse 자체를 실행하지 않음)에는
     ErrorCode 는 -1 값으로, ErrorMsg 는 "Stream Data is null!" 값으로 설정된 후 콜백 함수가 호출됩니다.

- 통신을 강제로 중지시키는 방법
   트랜잭션 처리 중이라도 ESC 키를 누르면 통신을 강제로 중지시킬 수 있습니다.

- Get/Post 방식관련 참고사항  
   1. strArgument 와 strInDatasets 이 "" 이고, Environment 의 Cookies 영역에 변수가 없으면 GET 방식으로 동작합니다.
   2. strArgument 나 strInDatasets 에 값이 있거나 Environment 의 Cookies 영역에 변수가 있으면 POST로 동작합니다.
   3. 위 1번의 상태에서 addcookietovariable 값이 "true" 이면 서버와의 첫 통신시에는 GET 방식으로 동작하고 이후부터는 서버에서 유입되는
      Cookie 의 유무에 따라 Cookie 가 있으면 POST, 없으면 GET 방식으로 동작합니다.
     (addcookietovariable 값이 "true"이면 Cookie 가 Environment 의 Cookies 영역에 변수로 자동 추가 되기 때문.)

- 서버로부터 데이터를 Chunked 방식으로 여러번에 걸쳐서 받을 경우 progressload 속성으로 데이터를 로드하는 방식을 설정할 수 있습니다.
   자세한 내용은 "Dataset > progressload" 항목을 참고하시기 바랍니다.

- 넥사크로 스튜디오를 사용해 넥사크로를 실행했을 때 트랜잭션을 수행하면 CacheLevel 의 설정과 상관없이 "none" 으로 동작합니다.

- SSV 타입 참고사항
   > 넥사크로 Web 버전 과 Mobile 버전 연동을 위하여 CSV 포맷을 확장하여 사용합니다.
   > 확장내역 : RowType 추가, 구분자 변경(콤마 -> US, 줄바꿈(CR/LF) -> RS)
   > Empty String 과 undefined 의 구분을 위하여 undefined 는 ETX(end of text)[code:0x03] 값으로 대체되어 서버로 전송됩니다. 


◆ WRE 제약
 
- nDataTYpe 값이 “Binary”인 경우에는 bAsync 값과 상관없이 비동기(ASync)로 처리합니다.

- bCompress 값은 지원하지 않습니다.

- bAsync 값을 false로 설정하면 Environment의 httptimeout 속성에 설정된 대기시간이 적용되지 않습니다.

 
◆ Mobile 제약
 
- iOS/iPadOS 는 비동기(Async) 방식만 지원하여 bAsync 값이 적용되지 않습니다.

이벤트

onafteruserconfirm

UserConfirm 창이 닫힌 후에 발생하는 이벤트입니다.

지원 환경

문법

onafteruserconfirm(obj:nexacro.Application,e:nexacro.EventInfo);

파라미터

참고

- filesecurelevel 속성값이 "all" 일 때 허용된 경로나 파일 이외에 접근하면, 접근 허용여부를 확인하는 UserConfirm 창이 표시됩니다.

onbeforeexit

Application 이 종료되기 전에 발생하는 이벤트입니다.

지원 환경

문법

onbeforeexit(obj:nexacro.Application,e:nexacro.ExitEventInfo);

파라미터

반환

참고

- 일반적으로 Application 종료 전 사용자의 확인을 받을 때 사용하는 이벤트입니다.

- onbeforeexit 이벤트 발생 후 모든 Frame 에서 onbeforeclose 이벤트가 발생합니다.

- onbeforeclose 이벤트는 최하위부터 최상위로 전파되는 이벤트입니다.
   ChildFrame 의 하위 오브젝트에 onbeforeclose 이벤트가 정의되어 있다면 최하위 오브젝트의 이벤트부터 차례로 수행됩니다.
   최종 onbeforeclose 이벤트 수행 후 각 이벤트의 리턴값은 누적되어 종료를 위한 확인창에 모두 표시됩니다.

- 종료를 위한 확인창에서 "확인"을 선택하면 onexit 이벤트가 발생하고 Application 이 종료됩니다.

- 종료를 위한 확인창에서 "취소"를 선택하면 onexit 이벤트가 발생하지 않고 Application 이 종료되지 않습니다.


◆ Desktop WRE 제약

- Edge, Chrome, FireFox 일 때 onbeforeexit 이벤트에 작성한 alert(), confirm() 메소드는 수행되지 않습니다.
   브라우저의 제약사항이므로 alert(), confirm() 메소드 사용에 주의하여야 합니다.

onbeforeuserconfirm

UserConfirm 창이 표시 되기 전에 발생하는 이벤트입니다.

지원 환경

문법

onbeforeuserconfirm(obj:nexacro.Application,e:nexacro.EventInfo);

파라미터

참고

- filesecurelevel 속성값이 "all" 일 때 허용된 경로나 파일 이외에 접근하면, 접근 허용여부를 확인하는 UserConfirm 창이 표시됩니다.

onduplicateexecution

중복실행 불가로 설정된 어플리케이션을 중복으로 실행 시 발생하는 이벤트입니다.

지원 환경

문법

onduplicateexecution(obj:nexacro.Application,e:nexacro.DuplicateExecutionEventInfo);

파라미터

참고

- Windows NRE 에서만 발생하는 이벤트입니다.

- 어플리케이션 실행 시 "-OO" 옵션값을 "true" 로 설정하면 "OnlyOne" 상태로 어플리케이션이 실행됩니다.
   "OnlyOne" 상태에서는 어플리케이션이 중복으로 실행되지 않고, 한 개만 실행할 수 있습니다.

- 사용자가 이미 실행된 어플리케이션을 중복 실행하려고 하는 경우 먼저 실행된 어플리케이션에서 이를 감지하고 처리할 수 있습니다.

onerror

Application 에서 실행한 Transaction 에서 에러가 생겼을 때 발생하는 이벤트입니다.

지원 환경

문법

onerror(obj:nexacro.Application,e:nexacro.ErrorEventInfo);

파라미터

반환

참고

- Application 의 Transaction 이 실행중일 때 ESC 키를 입력하여 Application 의 onerror 이벤트를 발생 시킬 수 있습니다.
   Form 의 Transaction 이 실행중일 때 ESC 키를 입력하면 Form 의 onerror 이벤트가 발생합니다.

- Application 에서 발생한 onerror 이벤트는 Form 으로 전파되지 않습니다.

onexit

Application 이 종료될 때 발생하는 이벤트입니다.

지원 환경

문법

onexit(obj:nexacro.Application,e:nexacro.ExitEventInfo);

파라미터

참고

- onexit 이벤트에서 트랜잭션을 비동기(Async) 방식으로 수행하면 넥사크로 애플리케이션이 종료되면서 통신을 모두 중지시키기 때문에 정상적으로 처리되지 않을 수 있습니다.
  이런 경우에는 트랜잭션을 동기(Sync) 방식으로 수행해서 처리합니다.


◆ Desktop WRE 제약

- Edge, Chrome, FireFox 일 때 onexit 이벤트에 작성한 alert(), confirm() 메소드는 수행되지 않습니다.
   브라우저의 제약사항이므로 alert(), confirm() 메소드 사용에 주의하여야 합니다.

onload

Application 에 등록된 모든 오브젝트와 데이터가 로드된 후 발생하는 이벤트입니다.

지원 환경

문법

onload(obj:nexacro.Application,e:nexacro.LoadEventInfo);

파라미터

참고

- Application 의 준비가 완료된 상태입니다.

- Environment 의 onload 이벤트 발생 후에 발생하는 이벤트입니다.

onloadforms

ChildFrame 에 연결된 모든 Form 이 모두 로드되면 발생하는 이벤트입니다.

지원 환경

문법

onloadforms(obj:nexacro.Application,e:nexacro.LoadEventInfo);

파라미터

onloadingappvariables

Application 의 AppVariables 영역에 정의된 오브젝트가 모두 생성된 후에 발생하는 이벤트입니다.

지원 환경

문법

onloadingappvariables(obj:nexacro.Application,e:nexacro.LoadEventInfo);

파라미터

참고

- 이벤트가 발생하는 시점에는 생성된 DataSet 에 데이터나 Application 에 Form 이 로딩되기 전입니다.
  따라서 이벤트에서 나머지 오브젝트 로딩에 필요한 정보를 추가, 수정하면 변경된 값을 적용시킬 수 있습니다.

onnotification

모바일 기기에서 넥사크로에 대한 Notification 을 수신하였을 때 발생하는 이벤트입니다.

지원 환경

문법

onnotification(obj:nexacro.Application,e:nexacro.NotificationEventInfo);

파라미터