■ DataSet.Do (LoadExcelData)

SECTION

 

Method

SINCE

 

NewPacket – 지원안함 Max - 1.2.1.41, Unicode - 2.0.1.43

DESCRIPTION

 

로칼 PC의 엑셀파일(.xls, .xlsx)을 데이터 셋으로 읽어 들이는 기능.

Do 메서드의 하위 기능에 해당하는 LoadExcelData 기능이다.

LoadExcelData 은 Excel 파일로 얻은 문자열 형태의 Data값을 다시 DataSet의 Data로 저장한다.

LoadExcelData는 별도의 Header 정보를 포함할 수 없으므로 SetDataHeader에서 정의 된 순서대로 대입된다.  LoadExcelData 사용 시 반드시 SetDataHeader로 헤더 정보를 정의해야 한다.

- 첫번째 인자는 이 기능을 사용한다는 의미에서 반드시 정확한 “LoadExcelData”로 시작해야 한다.

“LoadExcelData” 뒤에 붙는 문자열은 괄호 안에 콤마로 구분된 7개의 인자가 존재한다.

- 두번째 인자의 괄호 안의 수가 String으로 되어 있으므로 사용자는 Integer의 값을 String으로 변환하는 과정을 유념해야 한다.

Notice

1. 클라이언트에 Microsoft Excel 이 없어도 사용가능 합니다.

2. 최대 4MByte 까지만 Load 가능합니다.

3. Excel 의 서식(Formula, sum, min, max 등 수식 및 %, , 등 셀서식변경)에 대해서는 지원하지 않고 Int, double, String, WString(다국어)등 엑셀에 저장된 데이터를 데이터셋에 그대로 불러오는 기능으로 사용해야 합니다. 서식등의 기능은 Grid등 Visual 컴포넌트에서 설정을 해야 합니다.

4. 엑셀의 문제로 인해서, 다국어가 깨지는 현상이 있을시(Unicode 데이터가 Ansi데이터로 저장) 되는경우, 7번째 인자 (UserWString)를 1(=true)로 설정, 다국어가 깨지지 않도록 해야 합니다.

5. Excel 2007(*.xlsx) 은 지원되지 않습니다. Excel 2007 사용시 Excel.Application 을 사용하시기 바랍니다. (DataSet > Do > Excel.Application)

6. DataSet ColumnType이 BigInt일때는 지원되지 않습니다. Excel.Application을 사용하시기 바랍니다. (DataSet > Do > Excel.Application)

SYNTAX

 

DataSetID.Do(“LoadExcelData”,”FilePath,SheetName,StartRow,StartCol,Option,DecFlag,UserWString”)

POSSIBLE VALUES

 

해당없음

PARAMETERS

 

BSTR FilePath : File이름을 포함한 Path

BSTR SheetName: Excel에서의 Sheet명 or Excel에서의 Sheet Index (시작 Index : 0 )

Long StartRow : Excel파일에서의 읽어 들일 시작 Row 위치

Long StartCol : Excel 파일에서 읽어 들일 시작 Col 위치

Long Option : 수행 Option

- 생략가능. 생략 시 디폴트값으로 0 세팅(Excel파일에서 Sheet명으로 파일 데이터 읽음)

Style

Description

0

 Excel파일에서 읽어올 데이터 Sheet 파일을 Sheet명으로 선택 - 두번째 인자인 SheetName에 Sheet명 입력

1

 Excel파일에서 읽어올 데이터 Sheet 파일을 Sheet Index로 선택 - 두번째 인자인 SheetName에 Sheet Index 입력
 (
시작Index : 0 ~)

2

 로드할 Excel 선택시 지정된 경로가 아닌 파일다이얼로그를 띄워서 Excel 파일 선택
 -
두번째 인자인 SheetName에 Sheet명 입력

4

 Header가 String type일때 정수형 소수점이 나올지 안나올지여부 (1,2,1,68 버전부터 추가된 기능)

INT DecFlag : INT MAX VALUE(32767) 보다 큰값일 때 지수형으로 표현할지여부(value : 0: 표현 or 1: 정수로표현)

- 생략가능, 생략 시 디폴트값으로 0 세팅 (1,2,1,68 버전부터 추가된 기능)

INT UserWString : Excel의 ANISI로 저장된 데이터를 Unicode로 변환 여부(Unicode 버전만 사용가능 value : 0 or 1)

 

RETURN VALUES

 

해당없음

EXAMPLE

 

[JavaScript]

<SCRIPT language=javascript>

function fn_importdata() {

DataSet.SetDataHeader("Partno:STRING(16),,Currency:STRING(40),Hidden:STRING(40)");

DataSet.Do("LoadExcelData","'C:\\test.xls','Sheet2',0,0,0"); // Option Value 0인 경우

//DataSet.Do("LoadExcelData","'C:\\test.xls','0',0,0,1"); // Option Value 1인 경우

//DataSet.Do("LoadExcelData","'C:\\test.xls','Sheet2',0,0,2"); // Option Value 2인 경우

}

</SCRIPT>

SAMPLE

 

./sample/LoadExcelData_s1.html

SEE ALSO

 

Excel.Application