ExcelImportObject

개요

엑셀 또는 한셀 파일의 내용을 DataSet 에 Import 하는 오브젝트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




속성

commandversion

Import 시 데이터 인코딩 방식을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☐ macOS

☐ Edge

☐ Chrome

☐ Safari

☐ Firefox

☐ Opera

Mobile NRE

Mobile WRE

☐ Android

☐ iOS/iPadOS

☐ Android

☐ iOS/iPadOS




속성 타입

☑ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

ExcelImportObject.commandversion [=enumVersion]

문법 설정

enumVersion ::= "1.0" | "2.0" | "3.0"
this.ExcelImportObject00.commandversion = "2.0";

"1.0"

인코딩 처리를 하지 않습니다.

"2.0"

Base32로 인코딩합니다.

"3.0"

Base64로 인코딩합니다.

참고

- commandversion 속성을 설정하지 않으면 "1.0"으로 적용됩니다.

commdataformat

Import를 위해 데이터를 서버에 전송 시 사용할 통신형식을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☑ Enum

☐ Expr

☐ Control

☑ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법 설정

enumFormat ::= 'xml' | 'ssv' | 'json'

"xml"

XML 형식으로 데이터를 전송합니다.

"ssv"

SSV 형식으로 데이터를 전송합니다.

"json"

JSON 형식으로 데이터를 전송합니다.

참고

- commdataformat 속성값을 설정하지 않으면 "xml" 로 적용됩니다.

filefilter

Import 할 파일을 선택하는 파일선택창에 적용될 파일형식을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☐ macOS

☐ Edge

☐ Chrome

☐ Safari

☐ Firefox

☐ Opera

Mobile NRE

Mobile WRE

☐ Android

☐ iOS/iPadOS

☐ Android

☐ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법 설정

this.ExcelImport00.filefilter = "All(*.*)|*.*|Text Files(*.txt)|*.txt|";
this.ExcelImport00.filefilter = "Excel Files(*.xlsx)|*.xls;*.xlsx|Word Files(*.docx)|*.doc;*.docx|ALL Files(*.*)|*.*|";

strFileFilter

파일선택창에 적용될 파일형식을 "설명|확장자" 형식으로 설정합니다.


"|" 문자를 구분자로 하여 설명과 실제 확장자를 쌍으로 여러개의 파일형식을 설정할 수 있습니다.

한 개의 파일형식내에서 복수개의 확장자를 지정할 때는 "*.xlsx;*.xls" 와 같이 ";" 문자로 구분하여 설정합니다.

참고

- filefilter 속성값을 설정하지 않으면 빈문자열이 설정되고, "All(*.*)|*.*|" 로 동작합니다.

- importfilemode 속성값이 "local" 이거나 importData(), importDataEx() 메소드의 strSource 파라미터값을 설정하지 않았을 경우 파일선택창이 표시됩니다.

- 파일형식이 여러개 일 경우 파일선택창에 기본으로 표시될 파일형식을 filefilterindex 속성에 인덱스값으로 설정합니다.
   인덱스는 0 부터 시작하며 첫번째 파일형식부터 차례로 설정됩니다.

filefilterindex

파일선택창에 기본으로 표시될 파일형식을 인덱스값으로 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☐ macOS

☐ Edge

☐ Chrome

☐ Safari

☐ Firefox

☐ Opera

Mobile NRE

Mobile WRE

☐ Android

☐ iOS/iPadOS

☐ Android

☐ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

ExcelImportObject.filefilterindex[= nIndex]

문법 설정

this.ExcelImportObject00.filefilterindex = 1;

nIndex

파일선택창에 설정된 파일형식 중 기본으로 표시될 파일형식의 인덱스를 숫자로 설정합니다.

참고

- filefilterindex 속성값을 설정하지 않으면 0 으로 적용됩니다.

- 파일선택창에 표시되는 파일형식은 filefilter 속성에 설정합니다.
   파일형식의 인덱스는 0 부터 시작하며 첫번째 파일형식부터 차례로 인덱스가 설정됩니다.

importfilemode

Import 할 파일의 위치와 처리방식을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




속성 타입

☑ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법 설정

enumMode ::= 'server' | 'local'

"server"

서버에 위치한 파일을 Import 하며 Import 후에도 해당 파일을 삭제하지 않습니다.

서버에 해당 파일이 없는 경우나 Local이나 Network File을 지정하는 경우, Import 가 처리되지 않고 결과를 수신받습니다.

"local"

파일 대화 상자(File Dialog)를 표시해 로컬에 위치한 파일을 선택합니다.

로컬에 위치한 파일을 서버로 전송해 Import 처리하며 Import 처리 후에 서버에 생성된 파일은 삭제됩니다.

참고

- importfilemode 속성값을 설정하지 않으면 "local" 로 적용됩니다.

importtype

ExcelImportObject 가 Import 할 파일의 형식을 상수값으로 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법 설정

this.ExcelImportObject00.importtype = nexacro.ImportTypes.EXCEL2007;
this.ExcelImportObject00.importtype = 1040;

constImportTypes

Import 할 파일의 형식을 상수값으로 설정합니다.


256 (0x0100) 또는 nexacro.ImportTypes.EXCEL 설정 시 엑셀 97 형식으로 Import 합니다.

272 (0x0110) 또는 nexacro.ImportTypes.EXCEL97 설정 시 엑셀 97~2003 형식으로 Import 합니다.

288 (0x0120) 또는 nexacro.ImportTypes.EXCEL2007 설정 시 엑셀 2007 XML 형식으로 Import 합니다.

1040 (0x0410) 또는 nexacro.ImportTypes.HANCELL2014 설정 시 한셀 2014 형식으로 Import 합니다.

1280 (0x0500) 또는 nexacro.ImportTypes.CSV 설정 시 CSV 형식으로 Import 합니다.

1296 (0x0510) 또는 nexacro.ImportTypes.TXT 설정 시 TXT 형식으로 Import 합니다.

참고

- importtype 속성값을 설정하지 않거나 null 설정 시 256 (0x0100) 으로 적용됩니다.

- 한셀 2010 형식은 현재 지원되지 않습니다. Excel 2007 파일로 저장해서 사용하시기 바랍니다.

활용 예제

importurl

ExcelImportObject 가 Import 를 수행할 서버의 URL 을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

ExcelImportObject.importurl[= strImporturl]

문법 설정

strImporturl ::= <absolute-url> | <relative-url>
this.ExcelImportObject00.importurl = "https://localhost:8080/nexacro-xeni/XImport";

<absolute-url>

Import 를 수행할 서버의 URL 을 문자열로 설정합니다.

웹에 접근 가능한 환경이어야 하고, Cross Domain 상황이면 사용에 제한이 있습니다.

<relative-url>

현재 Form 위치를 기준으로 한 상대경로를 사용하여 설정합니다.

참고

- importurl 속성값을 설정하지 않으면 Import 가 수행되지 않습니다.

활용 예제

name

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

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☑ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

ExcelImportObject.name[= strName]

문법 설정

strName

컴포넌트의 이름을 설정합니다.

참고

- name 속성은 사용자가 지정한 컴포넌트의 이름으로 논리적으로 중복이 가능합니다.

- 넥사크로 스튜디오에서 컴포넌트를 생성하거나 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.

quotechar

Import 시 한정자로 사용할 값을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☑ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

ExcelImportObject.quotechar[= strQuotechar]

문법 설정

this.ExcelImportObject00.quotechar = "'";

strQuotechar

구분자로 분리되는 항목 중 분리하지 않을 부분을 처리하기 위한 텍스트 한정자를 설정합니다.

" (quotation mark), ' (apostrophe), "none", "default" 값을 설정할 수 있습니다.

참고

- default 값은 "default" 입니다.
  유효하지 않은 값을 입력할 경우에는 속성값은 "default" 값으로 처리합니다.
  "default" 값으로 설정한 경우에는 XENI 텍스트 한정자 설정값에 따라 동작합니다.

separator

Import 시 구분자로 사용할 값을 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☑ iOS/iPadOS

☑ Android

☑ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

ExcelImportObject.separator[= strSeparator]

문법 설정

this.ExcelImportObject00.separator = "0x1E";

strSeparator

컬럼을 구분을 문자를 설정합니다.

10진수 또는 16진수로 설정할 수 있습니다.

(16진수인 경우에는 0xXX, 0XXX의 형태로 입력해야 합니다).


0x00(0) ~ 0x7F(127) 범위의 ASCII 문자를 하나만 설정할 수 있습니다.

단, 아래 문자는 설정할 수 없습니다.


0x0A(10) - LF(Line Feed)

0x0D(13) - CR(Carriage Return)

0x22(34) - " (quotation mark)

0x27(39) - ' (apostrophe)

0x00(00) - NUL (Null char.)

0x03(03) - ETX (End of Text)

0x1D(29) - GS (Group Separator)

0x28(40) - ( (left opening parenthesis)

0x29(41) - ) (right closing parenthesis)

0x3A(58) - : (colon)

0x3D(61) - = (equal sign)

참고

- default 값은 ","로 처리합니다.
  유효하지 않은 값을 입력할 경우에도 default 값으로 처리합니다.
- importtype 속성값이 nexacro.ImportTypes.TXT 인 경우에만 유효합니다.

userawdatevalue

엑셀의 셀값이 날짜 또는 시간 계열일 때 원본값 그대로 Import 할지 여부를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법 설정

bRawDate ::= 'true' | 'false'
this.ExcelImportObject00.userawdatevalue = true;

true

엑셀의 셀에 설정된 원본 데이터값만 Import 합니다.


셀의 표시형식에 따른 서식은 Import 하지 않습니다.

false

엑셀의 셀에 표시된 값을 Import 합니다.


셀의 표시형식에 따른 서식을 반영하여 Import 합니다.

참고

- userawdatevalue 속성을 설정하지 않으면 false 로 적용됩니다.

- userawdatevalue 속성은 엑셀의 셀 표시형식이 "날짜", "시간" 형식인 경우에 적용되는 속성입니다.

userawnumbervalue

엑셀의 셀값이 숫자계열일 때 원본값 그대로 Import 할지 여부를 설정하는 속성입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법 설정

bRawNum ::= 'true' | 'false'
this.ExcelImportObject00.userawnumbervalue = false;

true

엑셀의 셀에 설정된 원본 데이터값만 Import 합니다.


셀의 표시형식에 따른 서식은 Import 하지 않습니다.

false

엑셀의 셀에 표시된 값을 Import 합니다.


셀의 표시형식에 따른 서식을 반영하여 Import 합니다.

셀의 표시형식이 "통화", "회계" 이면 통화기호, 회계기호를 포함하여 Import 합니다.

셀의 표시형식이 "백분율" 이면 "%" 기호를 포함하지 않고 Import 합니다.

참고

- userawnumbervalue 속성을 설정하지 않으면 true 로 적용됩니다.

- userawnumbervalue 속성은 엑셀의 셀 표시형식이 "숫자", "통화", "회계", "백분율" 등 숫자형식인 경우에 적용되는 속성입니다.

메서드

addEvent

ExcelImportObject 에 특정 이벤트를 선언하여 추가하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




문법

ExcelImportObject.addEvent( strEventID )

파라미터

Parameters

Type

Description

strEventID

String

ExcelImportObject 에 추가할 이벤트의 ID 를 문자열로 설정합니다.

var bResult = this.ExcelImportObject00.addEvent( "onmove" );

반환

Type

Description

Boolean

이벤트 추가에 성공하면 true 를 반환합니다.


이벤트 추가에 실패하거나 선언되어 있는 이벤트 ID 설정 시 false 를 반환합니다.

참고

- Composite Component 와 같은 사용자 컴포넌트에 특정 이벤트를 추가할 때 사용하는 메소드입니다.

- ExcelImportObject 에서 특정 이벤트를 제거하려면 removeEvent() 메소드를 사용하여야 합니다.

addEventHandler

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

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




문법

ExcelImportObject.addEventHandler( strEventID, objFunc, objTarget )

파라미터

Parameters

Type

Description

strEventID

String

핸들러 함수가 추가될 이벤트의 ID를 설정합니다.

objFunc

Object

이벤트 발생 시 수행될 핸들러 함수를 설정합니다.

objTarget

Object

핸들러 함수가 정의된 영역을 설정합니다.

this.ExcelImportObject00_onmove = function( obj:nexacro.ExcelImportObject,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.ExcelImportObject00.addEventHandler( "onmove", this.ExcelImportObject00_onmove, this);

반환

Type

Description

Number

이벤트에 추가된 핸들러 함수의 인덱스를 반환합니다.

동일한 핸들러 함수가 이미 있다면 해당 핸들러 함수의 인덱스를 반환합니다.

정상적으로 추가되지 않은 경우에는 -1 을 반환합니다.

활용 예제

addEventHandlerLookup

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

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




문법

ExcelImportObject.addEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

Parameters

Type

Description

strEventID

String

핸들러 함수가 추가될 이벤트의 ID를 설정합니다.

strFunc

String

이벤트 발생 시 수행될 핸들러 함수의 이름을 문자열로 설정합니다.

objTarget

Object

핸들러 함수를 검색할 영역을 설정합니다.

해당 영역에 함수가 정의되지 않았다면 상위 영역으로 올라가며 검색을 합니다.

this.ExcelImportObject00_onmove = function( obj:nexacro.ExcelImportObject,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.ExcelImportObject00.addEventHandlerLookup( "onmove", "ExcelImportObject00_onmove", this);

반환

Type

Description

Number

이벤트에 추가된 핸들러 함수의 인덱스를 반환합니다.

동일한 핸들러 함수가 이미 있다면 해당 핸들러 함수의 인덱스를 반환합니다.

정상적으로 추가되지 않은 경우에는 "-1"을 반환합니다.

참고

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

clearEventHandler

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

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




문법

ExcelImportObject.clearEventHandler( strEventID )

파라미터

Parameters

Type

Description

strEventID

String

모든 핸들러 함수를 제거할 이벤트의 ID를 설정합니다.

var nCnt = this.ExcelImportObject00.clearEventHandler( "onmove" );

반환

Type

Description

Number

특정 이벤트에서 제거된 핸들러 함수의 갯수를 반환합니다.

참고

- 특정 핸들러 함수만 제거하려면 removeEventHandler() 메소드를 사용하여야 합니다.

destroy

스크립트에서 동적으로 생성한 ExcelImportObject 을(를) 삭제하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




문법

ExcelImportObject.destroy()

반환

Type

Description

Boolean

ExcelImportObject 이(가) 정상적으로 삭제되면 true 를 반환합니다.


ExcelImportObject 이(가) 정상적으로 삭제되지 않으면 false 를 반환합니다.

참고

- 동적으로 생성한 ExcelImportObject 을(를) 완전히 삭제하기 위해서는 destroy() 메소드를 호출해야 합니다.

findEventHandler

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

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




문법

ExcelImportObject.findEventHandler( strEventID, objFunc, objTarget )

파라미터

Parameters

Type

Description

strEventID

String

핸들러 함수를 찾을 이벤트의 ID를 설정합니다.

objFunc

Object

찾으려고 하는 핸들러 함수를 설정합니다.

objTarget

Object

찾으려고 하는 핸들러 함수가 정의된 영역을 설정합니다.

this.ExcelImportObject00_onmove = function( obj:nexacro.ExcelImportObject,  e:nexacro.MoveEventInfo ) { //수행할 스크립트 };

var nIndex = this.ExcelImportObject00.findEventHandler( "onmove", this.ExcelImportObject00_onmove, this );

반환

Type

Description

Number

특정 이벤트에서 찾은 핸들러 함수의 인덱스를 반환합니다.


특정 이벤트에 찾으려는 핸들러 함수가 존재하지 않으면 -1 을 반환합니다.

참고

- 핸들러 함수의 인덱스는 0 부터 시작합니다.

getEventHandler

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

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




문법

ExcelImportObject.getEventHandler( strEventID, nIdx )

파라미터

Parameters

Type

Description

strEventID

String

핸들러 함수를 얻을 이벤트의 ID를 설정합니다.

nIdx

Number

얻으려고 하는 핸들러 함수의 인덱스를 설정합니다.


핸들러 함수의 인덱스는 0 부터 시작합니다.

var objFunc = ExcelImportObject00.getEventHandler( "onmove", 0 );

반환

Type

Description

Object

지정된 인덱스의 핸들러 함수 오브젝트를 반환합니다.


지정된 인덱스에 핸들러 함수가 존재하지 않는다면 null 을 반환합니다.

importData

파일을 DataSet으로 Import 하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




문법

ExcelImportObject.importData( strSource,strRange,strOutDatasets [,strArgument] )

파라미터

Parameters

Type

Description

strSource

String

Import 할 파일의 위치를 URL 형식의 문자열로 설정합니다.


importfilemode 속성값이 "server" 일 경우 "http://", "https://" 형식으로 파일의 위치를 설정합니다.

importfilemode 속성값이 "server" 일 때 상대경로를 설정 시 importurl 속성에 설정된 경로를 기준으로 처리됩니다.

importfilemode 속성값이 "local" 이거나 strSource 값을 설정하지 않았을 경우 FileDialog 가 표시되고 파일을 선택합니다.

strRange

String

strSource 에 설정한 파일에서 DataSet 으로 Import 할 영역을 "시트명!셀영역:셀영역" 또는 Import 할 파일의 형식이 CSV, TXT 인 경우에 "시작영역:끝영역" 형식으로 설정합니다.


여러 영역을 지정해야 할 경우 아래 형식으로 반복 설정합니다.


strRange ::= '[Command=<strCommand>; Output=<dsName>; Head=<strArea>; Body=<strArea>]'


<strCommand> ::= 'getsheetlist' | 'getsheetdata'

"getsheetlist" 설정 시 strSource 에 설정한 파일에서 시트목록을 Import 합니다.

"getsheetdata" 설정 시 strSource 에 설정한 파일에서 <strArea> 의 데이터를 Import 합니다.

값을 생략 할 경우 "getsheetdata"로 적용됩니다.


<dsName>

Import 한 데이터를 갖는 변수명입니다.

strOutDatasets 에서 오른쪽 대입변수로 사용됩니다.

값을 생략 할 경우 "output1", "output2" ... 로 자동설정됩니다.


<strArea> ::= '시트명!셀영역:셀영역'

Import 할 데이터 영역을 설정합니다.

"Head" 항목에 정의된 영역은 Import 시 DataSet 의 Column 명으로 사용됩니다.

"Head" 항목 생략 시 "Column0", "Column1" ... 으로 자동설정됩니다.

"Body" 항목에 정의된 영역은 DataSet 의 Row 데이터로 Import 됩니다.

"Body" 항목 생략 시 모든 레코드가 Import 됩니다.

* 시트명을 생략하면 첫 번째 시트가 작업 대상이 됩니다.

* 첫 번째 시트가 아닌 다른 시트를 지정하는 경우에는 "Head", "Body" 모두 설정해주어야 합니다.

아래와 같이 설정한 경우에는 Head는 첫 번째 시트에서 처리되고 Body만 지정한 시트에서 처리됩니다.

Body에서 설정한 셀영역이 Head에 없는 경우에는 에러가 발생할 수 있습니다.

[Command=getData;Output=output2;Body=Sheet2!A1;]


  • Import 할 파일의 형식이 CSV, TXT 인 경우에는 아래와 같이 적용합니다.


<strCommand> 지원하지 않습니다.

<strArea> ::= StartCol[,StartRow[:EndCol[,EndRow]]]

"Head" 항목에서 StartRow, EndCol, EndRow를 생략하면 아래와 같이 처리합니다.

- StartRow=0, EndCol=ColumnCount-1, EndRow=0

"Head" 항목에서 EndRow 설정값은 무시하고 StartRow 설정값 기준으로 동작합니다.

"Body" 항목에서 StartRow, EndCol, EndRow를 생략하면 아래와 같이 처리합니다.

- StartRow=0, EndCol=ColumnCount-1, EndRow=RowCount-1

strOutDatasets

String

Import 한 데이터를 저장할 DataSet 의 ID 를 "DataSet명=변수명" 의 형식으로 설정합니다.


DataSet 을 1개 이상 설정할 수 있으며 공백으로 구분합니다.

우측의 "변수명" 은 strRange 에 설정한 변수명을 설정하거나 "output1" ... 으로 자동생성된 변수명을 설정합니다.

strArgument

String

Import 시 필요한 정보를 "변수명=변수값" 형태로 설정합니다.


파라미터쌍을 1개 이상 설정할 수 있으며 공백으로 구분합니다.

비밀번호가 설정된 엑셀파일을 Import 할 경우 "filepassword=엑셀파일비밀번호" 를 입력해야 정상동작합니다.

this.ExcelImportObject00.importData("http://localhost:8080/xeni/XImport/my.xlsx","Sheet00!D15:E28","Dataset03=output1");
this.ExcelImportObject00.importData("","Sheet00!D15:E28","Dataset03=output1","filepassword=strpassword");
this.ExcelImportObject00.importData("", "[Command=getsheetlist;Output=sheetlist][Command=getsheetdata;Output=output1;Head=!A1:K1;Body=!A2:K15][Output=output2; Body=Sheet1!B7:Z207]", "ds_list=sheetlist, ds_Data1=output1, ds_Data2=output2");

참고

- Import 중 ESC 키를 입력하면 Import 를 중지시킬 수 있습니다.

- Local 에 위치한 파일을 importurl 속성에 설정된 서버로 보낸 후 트랜잭션처럼 DataSet 으로 수신받습니다.

- importDataEx() 메소드와의 차이는 Import 를 구분할 수 있는 ID 파라미터의 유무입니다.

- Import 할 파일에 포함된 개체(이미지, 차트, 수식 등)는 Import 대상에 포함하지 않으며 개체가 포함된 경우 개체는 무시하고 처리합니다.

활용 예제

importDataEx

ID 로 구분하여 파일을 DataSet 으로 Import 하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




문법

ExcelImportObject.importDataEx( strImportID, strSource,strRange,strOutDatasets [,strArgument] )

파라미터

Parameters

Type

Description

strImportID

String

Import 를 구분하기 위한 ID 를 문자열로 설정합니다.


설정값은 onsuccess 이벤트에서 ExcelImportEventInfo 오브젝트의 importid 속성으로 전달됩니다.

strSource

String

Import 할 파일의 위치를 URL 형식의 문자열로 설정합니다.


importfilemode 속성값이 "server" 일 경우 "http://", "https://" 형식으로 파일의 위치를 설정합니다.

importfilemode 속성값이 "server" 일 때 상대경로를 설정 시 importurl 속성에 설정된 경로를 기준으로 처리됩니다.

importfilemode 속성값이 "local" 이거나 strSource 값을 설정하지 않았을 경우 FileDialog 가 표시되고 파일을 선택합니다.

strRange

String

strSource 에 설정한 파일에서 DataSet 으로 Import 할 영역을 "시트명!셀영역:셀영역" 또는 Import 할 파일의 형식이 CSV, TXT 인 경우에 "시작영역:끝영역" 형식으로 설정합니다.


여러 영역을 지정해야 할 경우 아래 형식으로 반복 설정합니다.


strRange ::= '[Command=<strCommand>; Output=<dsName>; Head=<strArea>; Body=<strArea>]'


<strCommand> ::= 'getsheetlist' | 'getsheetdata'

"getsheetlist" 설정 시 strSource 에 설정한 파일에서 시트목록을 Import 합니다.

"getsheetdata" 설정 시 strSource 에 설정한 파일에서 <strArea> 의 데이터를 Import 합니다.

값을 생략 할 경우 "getsheetdata"로 적용됩니다.


<dsName>

Import 한 데이터를 갖는 변수명입니다.

strOutDatasets 에서 오른쪽 대입변수로 사용됩니다.

값을 생략 할 경우 "output1", "output2" ... 로 자동설정됩니다.


<strArea> ::= '시트명!셀영역:셀영역'

Import 할 데이터 영역을 설정합니다.

"Head" 항목에 정의된 영역은 Import 시 DataSet 의 Column 명으로 사용됩니다.

"Head" 항목 생략 시 "Column0", "Column1" ... 으로 자동설정됩니다.

"Body" 항목에 정의된 영역은 DataSet 의 Row 데이터로 Import 됩니다.

"Body" 항목 생략 시 모든 레코드가 Import 됩니다.

* 시트명을 생략하면 첫 번째 시트가 작업 대상이 됩니다.

* 첫 번째 시트가 아닌 다른 시트를 지정하는 경우에는 "Head", "Body" 모두 설정해주어야 합니다.

아래와 같이 설정한 경우에는 Head는 첫 번째 시트에서 처리되고 Body만 지정한 시트에서 처리됩니다.

Body에서 설정한 셀영역이 Head에 없는 경우에는 에러가 발생할 수 있습니다.

[Command=getData;Output=output2;Body=Sheet2!A1;]


  • Import 할 파일의 형식이 CSV, TXT 인 경우에는 아래와 같이 적용합니다.


<strCommand> 지원하지 않습니다.

<strArea> ::= StartCol[,StartRow[:EndCol[,EndRow]]]

"Head" 항목에서 StartRow, EndCol, EndRow를 생략하면 아래와 같이 처리합니다.

- StartRow=0, EndCol=ColumnCount-1, EndRow=0

"Head" 항목에서 EndRow 설정값은 무시하고 StartRow 설정값 기준으로 동작합니다.

"Body" 항목에서 StartRow, EndCol, EndRow를 생략하면 아래와 같이 처리합니다.

- StartRow=0, EndCol=ColumnCount-1, EndRow=RowCount-1

strOutDatasets

String

Import 한 데이터를 저장할 DataSet 의 ID 를 "DataSet명=변수명" 의 형식으로 설정합니다.


DataSet 을 1개 이상 설정할 수 있으며 공백으로 구분합니다.

우측의 "변수명" 은 strRange 에 설정한 변수명을 설정하거나 "output1" ... 으로 자동생성된 변수명을 설정합니다.

strArgument

String

Import 시 필요한 정보를 "변수명=변수값" 형태로 설정합니다.


파라미터쌍을 1개 이상 설정할 수 있으며 공백으로 구분합니다.

비밀번호가 설정된 엑셀파일을 Import 할 경우 "filepassword=엑셀파일비밀번호" 를 입력해야 정상동작합니다.

this.ExcelImportObject00.importDataEx("Import00", "http://localhost:8080/xeni/XImport/my.xlsx","Sheet00!D15:E28","Dataset03=output1");
this.ExcelImportObject00.importDataEx("Import01", "","Sheet00!D15:E28","Dataset03=output1","filepassword=strpassword");
this.ExcelImportObject00.importDataEx("Import02", "", "[Command=getsheetlist;Output=sheetlist][Command=getsheetdata;Output=output1;Head=!A1:K1;Body=!A2:K15][Output=output2; Body=Sheet1!B7:Z207]", "ds_list=sheetlist, ds_Data1=output1, ds_Data2=output2");

참고

- Import 중 ESC 키를 입력하면 Import 를 중지시킬 수 있습니다.

- Local 에 위치한 파일을 importurl 속성에 설정된 서버로 보낸 후 트랜잭션처럼 DataSet 으로 수신받습니다.

- importData() 메소드와의 차이는 Import 를 구분할 수 있는 ID 파라미터의 유무입니다.

- Import 할 파일에 포함된 개체(이미지, 차트, 수식 등)는 Import 대상에 포함하지 않으며 개체가 포함된 경우 개체는 무시하고 처리합니다.

insertEventHandler

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

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




문법

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

파라미터

Parameters

Type

Description

strEventID

String

핸들러 함수가 삽입될 이벤트의 ID 를 설정합니다.

nIndex

Number

핸들러 함수가 삽입될 위치를 인덱스로 설정합니다.


-1 값 설정 시 마지막에 추가됩니다.

이벤트에 설정된 핸들러 함수의 갯수보다 큰 값을 설정한 경우 마지막에 추가됩니다.

NaN 값을 입력하면 ECMA 의 정수 변환 규칙에 따라 0 이 설정됩니다.

objFunc

Object

이벤트 발생 시 수행될 핸들러 함수를 설정합니다.

objTarget

Object

핸들러 함수가 정의된 영역을 설정합니다.

this.ExcelImportObject00_onmove = function( obj:nexacro.ExcelImportObject,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };

var nIndex = this.ExcelImportObject00.insertEventHandler( "onmove", 0, this.ExcelImportObject00_onmove, this);

반환

Type

Description

Number

이벤트에 삽입된 핸들러 함수의 인덱스를 반환합니다.

동일한 핸들러 함수가 이미 있다면 해당 핸들러 함수의 인덱스를 반환합니다.


핸들러 함수가 정상적으로 삽입되지 않은 경우에는 -1 을 반환합니다.

참고

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

removeEvent

ExcelImportObject 에 선언된 특정 이벤트를 삭제하는 메소드입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




문법

ExcelImportObject.removeEvent( strEventID )

파라미터

Parameters

Type

Description

strEventID

String

ExcelImportObject 에서 삭제할 이벤트의 ID 를 문자열로 설정합니다.

var bResult = this.ExcelImportObject00.removeEvent( "onmove" );

반환

Type

Description

Boolean

이벤트 삭제에 성공하면 true 를 반환합니다.


이벤트 삭제에 실패하거나 선언되지 않은 이벤트 ID 설정 시 false 를 반환합니다.

참고

- Composite Component 와 같은 사용자 컴포넌트에서 특정 이벤트를 삭제할 때 사용하는 메소드입니다.

- 이벤트에 핸들러 함수가 정의되어 있을 경우 이벤트를 삭제할 수 없습니다.

- ExcelImportObject 에 특정 이벤트를 추가하려면 addEvent() 메소드를 사용하여야 합니다.

- ExcelImportObject 에 기본으로 선언되어 있는 이벤트 삭제 시 오동작 할 수 있으므로 주의하여야 합니다.

removeEventHandler

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

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




문법

ExcelImportObject.removeEventHandler( strEventID, objFunc, objTarget )

파라미터

Parameters

Type

Description

strEventID

String

핸들러 함수를 제거할 이벤트의 ID를 설정합니다.

objFunc

Object

제거할 핸들러 함수를 설정합니다.

objTarget

Object

제거할 핸들러 함수가 정의된 영역을 설정합니다.

this.ExcelImportObject00_onmove = function( obj:nexacro.ExcelImportObject,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.ExcelImportObject00.removeEventHandler( "onmove", this.ExcelImportObject00_onmove, this);

반환

Type

Description

Number

핸들러 함수 제거에 성공하면 1 을 반환합니다.


핸들러 함수 제거에 실패하면 0 을 반환합니다.

참고

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

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

removeEventHandlerLookup

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

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




문법

ExcelImportObject.removeEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

Parameters

Type

Description

strEventID

String

핸들러 함수를 제거할 이벤트의 ID를 설정합니다.

strFunc

String

제거할 핸들러 함수의 이름을 문자열로 설정합니다.

objTarget

Object

제거할 핸들러 함수가 정의된 영역을 설정합니다.

해당 영역에 함수가 정의되지 않았다면 상위 영역으로 올라가며 검색을 합니다.

this.ExcelImportObject00_onmove = function( obj:nexacro.ExcelImportObject,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.ExcelImportObject00.removeEventHandlerLookup( "onmove", "ExcelImportObject00_onmove", this);

반환

Type

Description

Number

핸들러 함수 제거에 성공하면 1 을 반환합니다.


핸들러 함수 제거에 실패하면 0 을 반환합니다.

참고

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

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

setEventHandler

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

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




문법

ExcelImportObject.setEventHandler( strEventID, objFunc, objTarget )

파라미터

Parameters

Type

Description

strEventID

String

핸들러 함수를 변경할 이벤트의 ID를 설정합니다.

objFunc

Object

기존 핸들러 함수를 대체할 함수를 설정합니다.

objTarget

Object

대체할 핸들러 함수가 정의된 영역을 설정합니다.

this.ExcelImportObject00_onmove = function( obj:nexacro.ExcelImportObject,  e:nexacro.MoveEventInfo ) { //수행할 스크립트 };
var nIndex = this.ExcelImportObject00.setEventHandler( "onmove", this.ExcelImportObject00_onmove, this );

반환

Type

Description

Number

첫번째 핸들러 함수 변경에 성공하면 0 을 반환합니다.


첫번째 핸들러 함수 변경에 실패하면 -1 을 반환합니다.

참고

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

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

setEventHandlerLookup

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

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




문법

ExcelImportObject.setEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

Parameters

Type

Description

strEventID

String

핸들러 함수를 변경할 이벤트의 ID를 설정합니다.

strFunc

Object

기존 핸들러 함수를 대체할 함수의 이름을 문자열로 설정합니다.

objTarget

Object

대체할 핸들러 함수를 검색할 영역을 설정합니다.

해당 영역에 함수가 정의되지 않았다면 상위 영역으로 올라가며 검색을 합니다.

this.ExcelImportObject00_onmove = function( obj:nexacro.ExcelImportObject,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.ExcelImportObject00.setEventHandlerLookup( "onmove", "ExcelImportObject00_onmove", this);

반환

Type

Description

Number

첫번째 핸들러 함수 변경에 성공하면 0 을 반환합니다.


첫번째 핸들러 함수 변경에 실패하면 -1 을 반환합니다.

참고

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

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

이벤트

onerror

Import 도중 오류가 생겼을때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




문법

onerror(obj:nexacro.ExcelImportObject,e:nexacro.ExcelImportErrorEventInfo);

파라미터

Parameters

Type

Description

obj

ExcelImportObject

Event가 발생한 Object.

e

ExcelImportErrorEventInfo

Event Object.

참고

- onerror 이벤트가 발생하면 Import 기능이 종료됩니다.

onsuccess

Import 가 완료되었을때 발생하는 이벤트입니다.

지원 환경

Desktop NRE

Desktop WRE

☑ Windows

☑ macOS

☑ Edge

☑ Chrome

☑ Safari

☑ Firefox

☑ Opera

Mobile NRE

Mobile WRE

☑ Android

☐ iOS/iPadOS

☑ Android

☐ iOS/iPadOS




문법

onsuccess(obj:nexacro.ExcelImportObject,e:nexacro.ExcelImportEventInfo);

파라미터

Parameters

Type

Description

obj

ExcelImportObject

Event가 발생한 Object.

e

ExcelImportEventInfo

Event Object.