개요

데이터를 테이블 형태로 저장하는 오브젝트입니다.

엔진과 밀접하게 연관되어 있으며 내부에서 사용하는 데이터는 Dataset 형태를 사용합니다.
컴포넌트와 바인딩한 Dataset 을 이용해 데이터의 변경사항을 공유합니다. 
통신시에도 데이터를 주고 받는 형식으로 사용합니다. 

Dataset 의 Column 이나 레코드를 추가/삭제/수정하는 메소드, 레코드 그룹, 정렬, 필터 기능, 통계 메소드(Sum, Max, Min, Avg, Count)를 지원합니다.
또한 다른 Dataset 을 합치거나 추가하거나 복사하는 기능을 지원합니다.

filterstr 속성에 Expression 을 지정하면 Dataset 의 레코드가 필터링됩니다.
keystring 속성을 통해 데이터를 그룹으로 묶거나 정렬할 수 있습니다.

지원 환경

- Dataset 은 수정/삭제된 레코드의 변경전 내용을 확인할 수 있는 getDeletedRowset(), getOrgColumn() 등의 메소드를 지원합니다.
   또한 필터링된 레코드들과 필터링되지 않은 레코드들을 제어할수 있는 메소드를 따로 제공하고 있습니다.

- Dataset 은 상황에 따라 이벤트가 발생합니다.
   특히 onload 이벤트는 여러 상황에서 발생되므로 이벤트 오브젝트의 reason 속성값으로 구분하여 처리하도록 합니다.

- Dataset 의 Column 명은 공백이 포함될 수 없습니다.

- Dataset 의 copyData(), assign() 등의 메소드에서 Dataset 을 파라미터로 지정할수 있습니다.
   이때 해당 Form 에 지정된 Dataset 이 없을 경우 상위 Form 에서 검색하게 됩니다.
   하위 Form 의 Dataset 을 지정하기 위해서는 명시적으로 SubForm.Dataset 오브젝트를 인수로 주어야 합니다.

- 넥사크로 라이브러리에서 Dataset 오브젝트의 실제 클래스명은 NormalDataset입니다.
   그러나, 사용자 편의를 위해 넥사크로 스튜디오와 도움말 등에서는 오브젝트 이름을 "Dataset"으로 표기하며, 스크립트에서 오브젝트를 생성할 때도 new Dataset처럼 사용할 수 있습니다.
   내부적으로는 nexacro.NormalDataset 클래스로 처리되기 때문에, 넥사크로 스튜디오에서 자동으로 생성되는 이벤트 핸들러 함수나 도움말 등에서 "nexacro.NormalDataset"라는 클래스명이 노출될 수 있습니다.
   예를 들어, Dataset 오브젝트의 이벤트 핸들러 함수 생성 시에는 Parameters 항목이 아래와 같이 표시되는 것은 정상적인 동작입니다.
   this.Dataset00_onrowposchanged = function(obj:nexacro.NormalDataset,e:nexacro.DSRowPosChangeEventInfo)

생성자

// Create Object
var ds = new Dataset;

ds.url = "http://1.10.10.1:8080/service/test.jsp";
ds.load();

objParentForm.addChild("DatasetID", ds);

속성

arguments

DataSet 의 url 속성에 설정된 Business Service 에 전달할 인수를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.arguments[= strArgument]

문법 설정

this.Dataset00.arguments = "dept_cd=02 type_cd=A";

참고

- arguments 속성값은 Business Service 호출시 통신 DataSet 레이아웃의 Param 정보로 들어갑니다.

binddataobject

Dataset 오브젝트와 바인드되는 DataObject 오브젝트의 ID를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.binddataobject[= strDataobject]

문법 설정

this.Dataset00.binddataobject = "DataObject00"

활용 예제

• 간단한 데이터 표시하기

colcount

DataSet 에 정의된 Column 의 갯수를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

Dataset.colcount

문법 설정

var n = this.Dataset00.colcount

참고

- DataSet 에 Constant Column (상수 컬럼) 이 정의되어 있다면 Constant Column 갯수도 포함됩니다.

colinfos

DataSet 에 정의된 Column 정보를 Collection 형태로 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

Dataset.colinfos

문법 설정

var objCol0 = this.Dataset00.colinfos[0].name;

참고

- colinofs 속성은 Collection 접근방식을 사용할 수 있습니다.
  this.Dataset00.colinfos[0], this.Dataset00.colinfos["ColID"], this.Dataset00.colinfos.length 등의 방법을 사용합니다.

collation

데이터 정렬 방식을 결정하는 유형을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.collation[= strCollation]

문법 설정

this.Dataset00.collation = "systemlanguage";
this.Dataset00.collation = "aa-DJ";
this.Dataset00.collation = "aa_DJ";

참고

- Dataset 오브젝트의 Column type이 "String"일 경우에 적용됩니다.

constcount

DataSet 에 정의된 Const Column (상수 컬럼)의 갯수를 갖는 읽기전용 속성업니다.

지원 환경

속성 타입

문법

Dataset.constcount

문법 설정

var count = this.Dataset00.constcount;

dataobjectbindmode

바인딩된 DataObject 오브젝트와의 통신 방식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.dataobjectbindmode[= strDataobjectbindmode]

문법 설정

strDataobjectbindmode ::= "oneway" | "twoway"

this.Dataset00.dataobjectbindmode = "twoway";

참고

- 속성값을 설정하지 않으면 "oneway"로 동작합니다.

- dataobjectbindmode 속성값을 "twoway"로 설정하고 Dataset 오브젝트 데이터 변경 시 아래와 같이 바인딩 된 DataObject의 이벤트가 발생합니다.

 * 데이터 추가, 삭제, 위치 변경 등 Row 단위 변경
    ondatachanged 이벤트가 발생합니다.
    - updatecontrol = true
        applyChange 메소드 실행 시 이벤트 발생
    - updatecontrol = false
        Row 단위 변경 발생 시 이벤트 발생
        여러 Row를 변경하는 메소드 실행 시에는 2번 이상 이벤트가 발생합니다.
        예를 들어 exchangeRow 메소드 실행 시 메소드는 한 번 실행되지만 2개 Row의 위치가 변경되어 2개 Row 데이터가 변경되는 것이므로 ondatachanged 이벤트는 2번 발생합니다.

 * 특정 Row의 Column 값 변경
    updatecontrol 속성값에 따라 발생하는 이벤트가 달라집니다.
    - updatecontrol = true
        Column 값 변경 후 applyChange 메소드 실행 시 ondatachanged 이벤트가 발생합니다.
        특정 Column 값만 변경하고 applyChange 메소드를 실행했더라도 Row 단위 변경으로 처리하기 때문에 onvaluechanged 이벤트가 아닌 ondatachanged 이벤트가 발생합니다.
    - updatecontrol = false
        Column 값 변경 시 onvaluechanged 이벤트가 발생합니다.

- dataobjectpath 속성 설정 시 필터 스크립트를 적용한 경우에는 양방향 통신을 지원하지 않습니다. 예를 들어 dataobjectpath 속성값 설정 시 "$.data[?(@.employee_age==31)]" 형식으로 필터 스크립트를 적용한 경우입니다. 
  양방향 통신을 하면서 데이터 필터링이 필요한 경우에는 filterstr 속성을 사용해주세요.

활용 예제

• 양방향 통신 적용하기

dataobjectpath

바인딩된 DataObject 오브젝트의 전체 데이터 경로에서 새로운 루트 정보를 지정합니다.

지원 환경

속성 타입

문법

Dataset.dataobjectpath[= strDataobjectpath]

문법 설정

this.Dataset00.dataobjectpath = "$.data[*]";

참고

- strDataobjectpath 파라미터의 상세한 문법은 아래 링크를 참고하세요.
https://github.com/dchester/jsonpath#jsonpath-syntax

활용 예제

• 간단한 데이터 표시하기

• 다국어로 Button 라벨 표시하기

enableevent

DataSet 에서 이벤트를 발생시킬지 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.enableevent[= bEvent]

문법 설정

bEvent ::= 'true' | 'false'

this.Dataset00.enableevent = true;
this.Dataset00.enableevent = false;

참고

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

- enableevent 속성값이 true 일 때 많은 양의 데이터를 변경할 경우 DataSet 에 작업을 할 때마다 이벤트가 발생합니다.
  이 경우 enableevent 속성값을 false 로 설정하면 이벤트 발생으로 인한 처리속도 지연과 화면 깜빡임을 방지할 수 있습니다.

- enableevent 속성값을 true로 변경하면 onrowsetchanged, onvaluechanged 이벤트가 발생합니다.

filterstr

DataSet 에 로드된 데이터를 필터링할 조건식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.filterstr[= strFilter]

문법 설정

this.Dataset00.filterstr = "column0 == 'test'";

참고

- 조건식에 해당하는 데이터만 DataSet 에 필터링되어 로드됩니다.
  필터링이 완료된 후에는 onrowsetchanged 이벤트가 발생하며 e.reason 값은 "REASON_FILTER" 가 됩니다.

- 이미 필터링된 데이터셋의 filterstr을 재설정하면 전체 데이터를 다시 필터링하여 기존에 필터링된 내역은 유지되지 않습니다.

- DataSet 을 다시 로드하거나 트랜잭션을 수행할 때 filterstr 속성은 loadfiltermode 속성의 영향을 받습니다.
  자세한 내용은 loadfiltermode 속성 설명을 참조하시기 바랍니다.

keystring

Dataset 오브젝트에 로드된 데이터를 그룹화 하거나 정렬할 기준이 되는 조건식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.keystring[= strKeystring]

문법 설정

strKeystring ::= <Key> [',' <Key>] [',' <OrderKey>]

<Key> ::= [<group-type> ':'] <group-col>

<group-type> ::= 'G' | 'S'
<group-col> ::= [<sort-type>] <column-id> [[','] <group-col>]

<sort-type> ::= '+' | '-'

<OrderKey> ::= 'O:'<column-id>'['<locale code>']'[<locale option>]

this.Dataset00.keystring = "column0";
this.Dataset00.keystring = "G:column0";
this.Dataset00.keystring = "G:+column0-column1";
this.Dataset00.keystring = "S:column0+column0";
this.Dataset00.keystring = "G:+column0, S:-column1";
this.Dataset00.keystring = "S:column0, O:column0['en-US']";
this.Dataset00.keystring = "S:column0-column1, O:column0['en-US']{ 'sensitivity' : 'base', 'ignorePunctuation' : true }";

참고

- keystring 속성이 설정되면 설정된 조건으로 그룹화/정렬이 수행된 후 onrowsetchanged 이벤트가 발생합니다.
   이때 onrowsetchanged 이벤트의 e.reason 속성값은 "REASON_SORTGROUP" 이 됩니다.

- keystring 속성을 설정 시 아래와 같은 방법을 사용할 수 있습니다.
"," 를 이용하면 그룹에 레벨을 줄 수 있습니다.
예를 들어, "G:column1,column2" 은 데이터를 column1 으로 그룹화한 후 그룹 내에서 column2 로 다시 그룹화한다는 의미입니다.
컬럼명에는 공백이 포함할 수 있으므로 "," 의 앞과 뒤에는 공백이 없어야 합니다.
"," 를 사용하지 않으면 두 개 이상의 열을 하나의 그룹키(Group Key)로 병합하여 사용할 수 있습니다.
예를 들어, "G:+column1-column2" 형식으로 입력하면 column1 과 column2 의 값을 합쳐 그룹화 값으로 사용하겠다는 뜻이 됩니다.
첫 글자로 "S:" 를 사용하면 그룹화 없이 정렬(Sorting)만 할 수 있습니다.
예를 들어 "S:+column1-column2" 형식으로 입력하면 column1 을 오름차순으로 정렬하고, column1 이 같은 레코드들은 column2 를 내림차순으로 정렬하겠다는 뜻이 됩니다.
만약, <group-type> 이 생략되면 "G" 옵션이 적용됩니다.
- 그룹화되면 Dataset 오브젝트에 논리적 레코드(Logical Record)가 생성됩니다.
   논리적 레코드는 Dataset 오브젝트에 열을 구성할 경우 prop 속성을 통해서 그룹화한 레코드들이 어떤 값을 가질지 설정할 수 있습니다.
   prop 속성값으로는 Count, Sum, Max, Min, Avg, Text 가 있습니다.
   keystring 으로 설정된 열은 prop 속성값의 대상에서 제외됩니다.

- Dataset 오브젝트를 로드하거나 트랜잭션을 수행할 경우 적용할 keystring 값은 loadkeymode 의 영향을 받습니다.
   자세한 사항은 loadkeymode 속성의 설명을 참조하시기 바랍니다.

- datatyperule 속성값이 "2.0" 인 경우 정렬 시 변경된 Data Validation 규칙이 적용되므로 주의하여야 합니다.
Column 타입이 "STRING" 이면 EmptyString("") < [Value] < undefined==null==NaN 순서로 정렬됩니다.
Column 타입이 "INT", "FLOAT", "BIGDECIMAL" 이면 -Infinity < [-Number] < 0 < [+Number] < Infinity < EmptyString("") < undefined==null==NaN 순서로 정렬됩니다.
Column 타입이 "DATE", "TIME", "DATETIME" 이면 EmptyString("") < [Date] < [Invalid Date] < undefined==null==NaN 순서로 정렬됩니다.
- OrderKey 설정 시에는 아래와 같은 제약이 있습니다.
locale code로 설정한 값을 브라우저에서 지원하지 않을 경우 운영체제 또는 브라우저 설정 언어 정보를 기반으로 동작하고 경고 메시지를 출력합니다.
locale code에서 설정한 속성 중 locale option에서 설정한 속성과 중복되는 속성이 있으면 locale option 설정값이 적용됩니다.
collation 속성을 설정했더라도 해당 컬럼 처리 시에는 locale code 설정값이 적용됩니다.
예를 들어 collation 속성값은 "en-US"으로 설정하고 keystring 속성값은 ""S:column0,O:column0['ja-JP']"으로 설정한 경우에는 keystring에서 설정한 "ja-JP" locale code가 적용됩니다.

활용 예제

• 레코드 그룹핑하기

• 레코드 정렬하기

• 합계/소계 구하기

• 헤더 이벤트를 이용한 정렬하기

• 그룹에 레벨 지정해서 subtotal 계산하기

• 정렬 옵션 설정하기

loadfiltermode

DataSet 에 데이터를 로드하거나 트랜잭션을 수행할 때 filterstr 속성값의 적용방법을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.loadfiltermode[= enumMode]

문법 설정

enumMode ::= 'keep' | 'reset'

this.Dataset00.loadfiltermode = "keep";
this.Dataset00.loadfiltermode = "reset";

참고

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

- filterstr 속성의 초기값은 DataSet이 생성될 때 filterstr 의 값으로 설정됩니다.

- filterstr 속성은 스크립트 등에 의해 사용 중 계속 변경이 발생할 수 있습니다.
  변경이 발생한 상태에서 트랜잭션 등을 사용하여 다시 로드하는 경우 filterstr 초기값이 적용된 것과는 다른 결과가 발생할 수 있습니다.
  만약, 데이터셋을 다시 로드할 때 filterstr 초기값이 적용되기를 원한다면 이 속성의 값을 'reset'으로 설정합니다.

loadkeymode

DataSet 에 데이터를 로드하거나 트랜잭션을 수행할 때 keystring 속성값의 적용방법을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.loadkeymode[= enumMode]

문법 설정

enumMode ::= 'keep' | 'reset'

this.Dataset00.loadkeymode = "keep";
this.Dataset00.loadkeymode = "reset";

참고

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

- keystring 속성의 초기값은 DataSet 이 생성될 때 keystring 의 값으로 설정됩니다.

- keystring 속성은 스크립트 등에 의해 사용 중 계속 변경이 발생할 수 있습니다.
  변경이 발생한 상태에서 트랜잭션 등을 사용하여 다시 로드하는 경우 keystring 초기값이 적용된 것과는 다른 결과가 발생할 수 있습니다.
  만약, 데이터셋을 다시 로드할 때 keystring 초기값이 적용되기를 원한다면 이 속성의 값을 'reset'으로 설정합니다.

name

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

지원 환경

속성 타입

문법

Dataset.name[= strName]

문법 설정

참고

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

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

preload

DataSet 의 url 속성을 설정한 경우 DataSet 에 데이터를 로드하는 시점을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.preload[= bPreload]

문법 설정

bPreload ::= 'true' | 'false'

this.Dataset00.preload = true;

참고

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

progressload

서버로부터 데이터를 Chunked 방식으로 여러번에 걸쳐서 받을 경우에 대한 처리방법을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.progressload[= bPLoad]

문법 설정

bPLoad ::= 'true' | 'false'

this.Dataset00.progressload = true;

참고

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

- 성능 문제로 인하여 DataSet 에서 onload 가 발생하는 횟수는 Chunked 데이터가 로딩된 횟수와 다를 수 있습니다.
   또한, 브라우저에 따라 onload 이벤트가 발생하는 횟수가 달라질 수 있습니다.

- Chunked 된 데이터를 수신중에 onload 이벤트가 발생하면 DSLoadEventInfo 의 reason 속성값에 1 이 전달됩니다.
   데이터를 모두 수신하여 onload 이벤트가 발생하면 DSLoadEventInfo 의 reason 속성값에 0 이 전달됩니다.

- Chunked 된 첫번째 데이터를 수신하면 rowposition 속성값이 변경되고 onrowposchanged 이벤트가 발생합니다.
   이후 Chunked 된 나머지 데이터를 수신할 때는 rowposition 속성이 변경되지 않습니다.

◆ 제약

- 서버에서 받는 데이터 형식이 JSON인 경우에는 progressload 속성이 적용되지 않습니다.

reversesubsum

DataSet 이 keystring 속성에 의해 그룹핑 되었을 때 그룹소계가 표시될 위치를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.reversesubsum[= bSubsum]

문법 설정

bSubsum ::= 'true' | 'false'

this.Dataset00.reversesubsum = true;

참고

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

- getGroupRangeStart() 메소드에 의해 반환되는 그룹 범위의 시작위치는 이 속성과 무관합니다.

rowcount

DataSet 에 로드된 데이터의 갯수를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

Dataset.rowcount

문법 설정

var n = this.Dataset00.rowcount;

참고

- 필터링 되거나 삭제된 데이터(Row)는 제외됩니다.

rowposition

DataSet 에서 현재 선택된 데이터의 Row 인덱스를 갖는 속성입니다.

지원 환경

속성 타입

문법

Dataset.rowposition[= nRow]

문법 설정

this.Dataset00.rowposition = 1;

참고

- DataSet 에 데이터가 없을 경우에는 -1 값을 갖습니다.

- rowposition 속성을 변경시키면 DataSet 에서 canrowposchange 이벤트가 발생합니다.
  만약 canrowposchange 이벤트의 반환값을 false 로 설정하면 rowposition 속성값을 변경하지 않습니다.
  canrowposchange 이벤트의 반환값을 true 로 설정하거나 반환값이 없는 경우에는 rowposition 속성값을 변경하고 onrowposchanged 이벤트가 발생합니다.

- Grid 의 selectype 속성값이 "row" 또는 "cell" 일 때 바인드 된 DataSet 의 rowposition 속성값을 변경하면 Grid 의 해당 Row 가 선택처리됩니다.

- Grid 의 selecttype 속성값이 "row", "cell" 이외의 값일 때는 바인드 된 DataSet 의 rowposition 속성값을 변경해도 Grid 의 선택이 변경되지 않고 기존값을 유지합니다.
   이 때, DataSet 의 rowposition 값과 Grid 에 표시된 선택의 위치가 달라지므로 사용에 주의하여야 합니다.

saveinfinity

DataSet 에서 타입이 INT, FLOAT, BIGDECIMAL 인 Column 에 저장된 Infinity 값의 처리 방법을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.saveinfinity[= enumSave]

문법 설정

enumSave ::= 'include' | 'exclude'

this.Dataset00.saveinfinity = "exclude";

참고

- saveinfinity 속성값을 설정하지 않으면 undefined 가 설정되고 Environment 의 datasetsaveinfinity 속성값으로 동작합니다.

saveinvaliddate

DataSet 에서 타입이 DATE, TIME, DATETIME 인 Column 에 저장된 잘못된 날자값의 처리 방법을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.saveinvaliddate[= enumSave]

문법 설정

enumSave ::= 'include' | 'exclude'

this.Dataset00.saveinvaliddate = "include";

참고

- saveinvaliddate 속성값을 설정하지 않으면 undefined 가 설정되고 Environment 의 datasetsaveinvaliddate 속성값으로 동작합니다.

savenan

DataSet 에서 타입이 INT, FLOAT, BIGDECIMAL 인 Column 에 저장된 NaN 값의 처리 방법을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.savenan[= enumSave]

문법 설정

enumSave ::= 'include' | 'exclude'

this.Dataset00.savenan = "include";

참고

- savenan 속성값을 설정하지 않으면 undefined 가 설정되고 Environment 의 datasetsavenan 속성값으로 동작합니다.

serverdatasetid

DataSet 의 url 속성에 설정된 Business Service 를 통해 전달된 DataSet 중 실제 사용될 DataSet 의 ID를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.serverdatasetid[= strDatasetID]

문법 설정

this.Dataset00.serverdatasetid = "ds_sawon";

참고

- DataSet 을 선택하기 위해서는 Business Service 에 기술되어 있는 DataSet ID를 지정해야 합니다.
  설정된 ID가 Business Service 내에 존재하지 않는다면 데이터가 로드되지 않습니다.

updatecontrol

DataSet 의 데이터가 Insert/Update/Delete 되었을 경우 각 RowType 을 자동으로 변경할 지 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.updatecontrol[= bUpdatecontrol]

문법 설정

bUpdatecontrol ::= 'true' | 'false'

this.Dataset00.updatecontrol = true;

참고

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

- updatecontrol 속성값이 false 일 경우만 setRowType() 메소드를 사용할 수 있습니다.

- updatecontrol 속성값을 false 로 사용하다가 true 로 변경하면 DataSet 이 오동작 할 수 있습니다.
   따라서 updatecontrol 속성값의 변경은 true 에서 false 로만 변경해 사용하여야 합니다.

활용 예제

• RowType 변경하기

url

DataSet 에 Business Service 를 연결하는 경우 해당 서비스의 경로(URL)을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.url[= strUrl]

문법 설정

strUrl ::= <absolute-url> | <relative-url>

this.DataSet00.url = "http://localhost:8080/Prj/BService/Serv00.jsp";     // 절대경로

this.DataSet00.url = "../BService/Serv00.jsp";                                     // 상대경로
this.DataSet00.url = "Service1::Serv00.jsp";                                         // TypeDefinition의 Services 경로

참고

- DataSet 의 preload 속성이 "false"로 설정되어도 DataSet 의 load() 메소드를 수행하면 url 속성값에 설정된 서비스로 DataSet 을 로드합니다.

- DataSet 에 데이터가 로드되면 DataSet 에서 onload 이벤트가 발생합니다.


◆ 서비스(Service Prefix)

- Business Service 를 호출하기 위해 공통되는 접근경로를 TypeDefinition 에 정의하고, 
  컴포넌트의 속성이나 스크립트에 TypeDefinition에 정의된 Preifx를 기술하여 경로 정보를 간단히 표현할 수 있는 기능입니다.

useclientlayout

트랜잭션을 수행하여 수신된 DataSet 의 Column Layout 을 적용할 지 설정하는 속성입니다.

지원 환경

속성 타입

문법

Dataset.useclientlayout[= bUseclient]

문법 설정

bUseclient ::= 'true' | 'false'

this.Dataset00.useclientlayout = true;

참고

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

활용 예제

• 새로 받은 데이터와 기존 데이터를 비교하기

메서드

addColumn

DataSet 에 Column 을 추가하는 메소드입니다.

지원 환경

문법

Dataset.addColumn( strColID, strColType [,nColSize [, strDatapath]] )

파라미터

var nIndex;
nIndex = this.Dataset00.addColumn( "column00", "string" );
nIndex = this.Dataset00.addColumn( "column00", "string", 120 );
nIndex = this.Dataset00.addColumn( "id", "string", 120, "@.id" );

반환

참고

- Column 의 ID 생성 규칙은 JavaScript Id 생성규칙과 동일합니다.

- Column 의 추가에 성공하면 onrowsetchanged 이벤트가 발생합니다.
  이 때, onrowsetchanged 이벤트의 e.reason 속성값은 "REASON_CHANGELAYOUT" 가 됩니다.

- Column 의 추가에 실패하면 onrowsetchanged 이벤트가 발생하지 않습니다.

- 넥사크로 스튜디오에서 Dataset 오브젝트의 dataobjectpath 속성을 선택하고 Data Path Editor를 실행하면 Json Contents에서 컬럼으로 추가할 항목을 선택하고 추가하면 datapath 속성값을 자동으로 설정합니다.

addColumnInfo

DataSet 에서 ColumnInfo 객체를 사용하여 Column 을 추가하는 메소드입니다.

지원 환경

문법

Dataset.addColumnInfo( strID, objColInfo )

파라미터

var objColinfo = new ColumnInfo() ;
objColinfo.type = "String";
objColinfo.size = 5;

var nIndex = this.Dataset00.addColumnInfo("new_col1", objColinfo);

반환

참고

- ColumnInfo 객체는 Column 의 ID, Type, Size 정보를 갖습니다.

- Column 의 추가에 성공하면 onrowsetchanged 이벤트가 발생합니다.
  이 때 onrowsetchanged 이벤트의 e.reason 속성값은 "REASON_CHANGELAYOUT" 가 됩니다.
  만약, 실패하면 Event가 발생하지 않습니다.

addConstColumn

DataSet 에 Const Column(상수 컬럼)을 추가하는 메소드입니다.

지원 환경

문법

Dataset.addConstColumn( strColID, varVal [, strColType [, nColSize [, strDatapath]]] )

파라미터

var nIndex;
nIndex = this.Dataset00.addConstColumn( "ConstColumn1", 1234, "INT", 200 );
nIndex = this.Dataset00.addConstColumn( "ConstColumn2", "TEST", "STRING", 256 );
nIndex = this.Dataset00.addConstColumn( "company", , "STRING", 256, "$.company" );

반환

참고

- Const Column 추가에 성공하면 onrowsetchanged 이벤트가 발생합니다.
   이 때, onnrowsetchanged 이벤트의 e.reason 속성값은 "REASON_CHANGELAYOUT" 가 됩니다.

- 넥사크로 스튜디오에서 Dataset 오브젝트의 dataobjectpath 속성을 선택하고 Data Path Editor를 실행하면 Json Contents에서 컬럼으로 추가할 항목을 선택하고 추가하면 datapath 속성값을 자동으로 설정합니다.
- varVal, strDatapath 파라미터가 같이 설정된 경우에는 varVal 파라미터 값은 무시합니다.

addEvent

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

지원 환경

문법

Dataset.addEvent( strEventID )

파라미터

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

반환

참고

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

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

addEventHandler

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

지원 환경

문법

Dataset.addEventHandler( strEventID, objFunc, objTarget )

파라미터

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

반환

addEventHandlerLookup

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

지원 환경

문법

Dataset.addEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

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

반환

참고

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

addRow

DataSet 의 마지막 Row 에 새로운 데이터(Row)를 추가하는 메소드입니다.

지원 환경

문법

Dataset.addRow()

파라미터

var nRow = this.Dataset00.addRow();

반환

참고

- DataSet 에 Column 이 정의되어 있지 않다면 메소드는 수행되지 않습니다.

- 새로운 Row 추가 후 onrowsetchanged → canrowposchange → onrowposchanged → onvaluechanged 순서로 이벤트가 발생됩니다.
  이 때, onrowsetchanged 이벤트의 e.reason 속성값은 "REASON_APPEND" 가 됩니다.

- updatecontrol 속성값이 "true"이면 추가된 Row 의 타입은 "ROWTYPE_INSERT"가 되고, "false"이면 "ROWTYPE_NORMAL" 이 됩니다.

- 새로운 Row 가 추가되면 rowposition 속성값이 추가된 Row로 변경되고 canrowposchange 이벤트가 발생합니다.
  canrowposchange 이벤트에서 "false"를 반환하면 rowposition 속성이 변경되지 않습니다.
  canrowposchange 이벤트에서 "true"를 반환하면 rowposition 속성이 변경되고 onrowposchanged 이벤트가 발생합니다.

활용 예제

• 레코드 추가/삭제하기

append

인수로 전달된 서비스경로(URL)에서 데이터를 로드하여 현재 DataSet 의 마지막 Row 뒤에 추가하는 메소드입니다.

지원 환경

문법

Dataset.append([strUrl])

파라미터

this.Dataset00.append("Service1::Serv00.jsp");

참고

- 데이터 로드를 위한 통신 중 에러가 발생하면 Application 의 onerror 이벤트가 발생합니다.

- strUrl 값이 생략되었을 때 DataSet 의 url 속성값이 설정되어 있지 않으면 onload 이벤트가 발생하며 e.errorcode, e.errormsg 에 에러 내역이 전달됩니다.

- 데이터 로드에 성공하면 onload 이벤트가 발생하며 e.reason 속성값은 "REASON_APPEND" 가 됩니다.

- 데이터 추가 시 DataSet 상태에 따라 아래와 같이 동작합니다.

  1) 현재 DataSet 에 Column 정보가 없다면 추가할 DataSet 의 Column 정보가 현재 DataSet 에 복사되고 모든 데이터가 추가됩니다.
  2) 현재 DataSet 에 Column 정보가 있다면 추가할 DataSet 의 Column 명과 현재 DataSet 의 Column 명이 일치하는 Column 에만 데이터가 추가됩니다.

appendData

현재 Dataset 의 마지막 Row 다음에 지정한 Dataset 의 데이터(Row)를 추가하는 메소드입니다.

지원 환경

문법

Dataset.appendData( objDataset [,bCheckCol [,bUpdateConstCol]] )

파라미터

var nRowCnt;
nRowCnt = this.Dataset00.appendData( this.Dataset01 );
nRowCnt = this.Dataset00.appendData( this.Dataset01, true, true );

반환

참고

- appendData() 메소드는 bCheckCol, bUpdateConstCol 매개변수의 설정에 따라 아래와 같이 동작합니다.

  1) bUpdateConstCol 이 false 이고, bCheckCol 이 true 이면
      objDataset 과 현재 Dataset 의 Column ID 를 비교하여 같은 ID 를 가진 Column 에만 데이터를 추가합니다.
      만약 같은 ID 를 가진 Column 이 없으면 추가되지 않습니다.

  2) bUpdateConstCol 이 false 이고, bCheckCol 이 false 이면
      Column ID 와는 상관없이 Column 의 인덱스 순서에 따라 순차적으로 데이터를 추가합니다.

  3) bUpdateConstCol 이 true 이고, bCheckCol 이 true 이면
      objDataset 과 현재 Dataset 의 Const Column ID 를 비교하여 같은 ID 를 가진 Const Column 의 값을 변경합니다.
      만약 같은 ID 를 가진 Const Column 이 없으면 Const Column 의 값이 변경되지 않습니다.

  4) bUpdateConstCol 이 true 이고, bCheckCol 이 false 이면
      Const Column ID 와는 상관없이 Const Column 의 인덱스 순서에 따라 순차적으로 데이터를 추가합니다.


- 현재 Dataset 에 Const Column 을 포함한 어떤 Column 도 정의되어 있지 않으면 objDataset 의 모든 Column 이 추가됩니다.
   단, Const Column 은 bUpdateConstCol 속성값이 true 일 때만 추가됩니다.

- appendData() 메소드가 수행된 후에는 onrowsetchanged 이벤트가 발생합니다.
   이 때, onrowsetchanged 이벤트의 e.reason 속성값은 "REASON_APPEND" 가 됩니다.

- appendData() 메소드는 rowposition 속성의 값을 변경하지 않습니다. 
   다만 메소드를 수행하기 전의 rowposition 속성값이 -1 인 경우는 rowposition 을 0 으로 변경하기 위해 canrowposchange 이벤트를 호출합니다.

- canrowposchange 이벤트에서 true 를 반환하면 새로운 Row 위치로 변경하고 onrowposchanged 이벤트가 호출됩니다.
   그러나 false 를 반환하면 rowposition 속성이 변경되지 않습니다.

- canrowposchange 이벤트는 onrowsetchanged 이벤트가 수행된 후 호출됩니다.

- keystring 또는 filterstr 속성으로 그룹핑/정렬/필터링 되어 있는 경우 appendData() 메소드 수행 후 자동으로 재적용되지 않습니다.
   따라서 그룹핑/정렬/필터링을 재적용하려면 updateSortGroup() 또는 filter() 메소드를 명시적으로 수행하여야 합니다.

- datatyperule 속성값이 "2.0" 인 경우 변경된 Data Validation 규칙이 적용됩니다.
   Column 타입에 따라 유효하지 않은 데이터로 처리될 수 있으므로 주의하여야 합니다.

활용 예제

• 다른 데이터셋의 레코드 추가하기

applyChange

DataSet 오브젝트의 Row의 타입을  "Dataset.ROWTYPE_NORMAL"로 바꾸는 메소드입니다.

지원 환경

문법

Dataset.applyChange()

파라미터

this.Dataset00.applyChange();

참고

- Row 의 타입을 "Dataset.ROWTYPE_NORMAL (1)"로 변경합니다.
  만약 특정한 Row 의 타입만 변경하려면 DataSet 의 setRowType() 메소드를 사용하시기 바랍니다.
  단, Row 의 타입이 다음과 같은 경우에는 "Dataset.ROWTYPE_NORMAL"로 변경되지 않고 현재 상태를 유지합니다.
  - Dataset.ROWTYPE_EMPTY (0)
  - Dataset.ROWTYPE_DELETE (8)
  - Dataset.ROWTYPE_GROUP (16)

- applyChange 메소드가 처리되고 onrowsetchanged 이벤트가 발생합니다.

활용 예제

• 변경 내용 데이터셋에 반영하기/되돌리기

assign

현재 DataSet 에 지정한 DataSet 의 Row, Column 정보와 모든 데이터를 부여하는 메소드입니다.

지원 환경

문법

Dataset.assign( objDataset )

파라미터

var nRowCnt = this.Dataset00.assign( this.Dataset01 );

반환

참고

- assign() 메소드를 수행하면 대상 DataSet 의 모든 Row, Column 정보는 삭제됩니다.

- assign() 메소드는 수행 시 onrowsetchanged → canrowposchange → onrowposchanged → onvaluechanged 순서로 이벤트가 발생합니다.

- onrowsetchanged 이벤트의 e.reason 속성값은 "REASON_ASSIGN" 가 됩니다.
  onrowsetchanged 이벤트가 수행된 후 rowposition 속성값은 "-1" 로 설정됩니다.

- onrowsetchanged 이벤트가 수행된 후 rowposition 속성값을 "0"으로 설정하기 위해 canrowposchange 이벤트를 호출합니다.

- canrowposchange 이벤트에서 "false"를 반환하는 경우에는 rowposition 속성값은 변경되지 않습니다.
  canrowposchange 이벤트에서 "true"를 반환하는 경우에는 새로운 rowposition 속성값을 "0" 으로 변경하고 onrowposchanged 이벤트를 호출합니다.

- DataSet 의 Row, Column 정보를 제외한 필터, 그룹 정보 등은 부여되지 않습니다.

clear

DataSet 의 Row, Column 정보와 데이터를 모두 삭제하는 메소드입니다.

지원 환경

문법

Dataset.clear()

파라미터

var nRowCnt = this.Dataset00.clear();

반환

참고

- clear() 메소드를 수행하면 현재 DataSet 의 모든 정보는 삭제되므로 reset() 메소드를 수행하여도 복구할 수 없습니다.
  만약, DataSet 의 데이터(Row) 만 삭제하려면 clearData() 메소드를 사용하시기 바랍니다.
  clearData() 메소드는 Column 정보는 삭제하지 않습니다.

- clear() 메소드의 수행이 완료되면 onrowsetchanged 이벤트가 발생합니다.
  이 때, onrowsetchanged 이벤트의 e.reason 속성값은 "REASON_CLEAR" 가 됩니다.
- onrowsetchanged 이벤트가 수행된 후 rowposition 속성값은 "-1" 로 설정됩니다. 
  rowposition 속성값이 "-1" 로 설정된 후 onrowposchanged 이벤트를 호출합니다.

clearData

DataSet 의 Column 정보 이외에 모든 데이터(Row) 를 삭제하는 메소드입니다.

지원 환경

문법

Dataset.clearData()

파라미터

var nRowCnt = this.Dataset00.clearData();

반환

참고

- clearData() 메소드가 수행되고 나면 모든 데이터(Row)가 제거되므로 reset() 메소드를 수행하여도 복구할 수 없습니다.
  만약, 다시 복구할 필요가 있다면 deleteAll() 메소드를 사용하시기 바랍니다.

- clearData() 메소드가 수행되면 onrowsetchanged 이벤트가 발생합니다. 
  이 때, onrowsetchanged 이벤트의 e.reason 속성값은 "REASON_CLEARDATA" 가 됩니다.
- onrowsetchanged 이벤트가 수행된 후 rowposition 속성값은 "-1"이 됩니다.  
  rowposition 속성값이 "-1" 로 설정된 후 onrowposchanged 이벤트를 호출합니다.

활용 예제

• 페이지 기능 구현하기

clearEventHandler

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

지원 환경

문법

Dataset.clearEventHandler( strEventID )

파라미터

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

반환

참고

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

copyData

현재 DataSet 에 지정한 DataSet 의 데이터(Row)를 복사하는 메소드입니다.

지원 환경

문법

Dataset.copyData( objDataset [, bFilteredOnly] )

파라미터

var nRowCnt;
nRowCnt = this.Dataset00.copyData(this.Dataset01);
nRowCnt = this.Dataset00.copyData(this.Dataset01, true);

반환

참고

- copyData() 메소드를 수행하면 현재 DataSet 의 모든 Row, Column 정보는 삭제됩니다.
  DataSet 이 복사될 때 삭제된 데이터(Row)는 복사하지 않습니다.
  또한, copyData() 메소드를 수행하여 복사된 데이터(Row)의 타입은 "ROWTYPE_NORMAL" 가 됩니다.

- copyData() 메소드를 수행하면 onrowsetchanged → canrowposchange → onrowposchanged → onvaluechanged 순서로 이벤트가 발생합니다.
  이 때, onrowsetchanged 이벤트의 e.reason 상태값은 "REASON_COPY" 가 됩니다.

- onrowsetchanged 이벤트가 수행된 후 rowposition 속성값을 "0" 으로 설정하기 위해 canrowposchange 이벤트를 호출합니다.

- canrowposchange 이벤트에서 "false" 를 반환하면 rowposition 속성이 변경되지 않습니다.
  그리고 "true" 를 반환하면 새로운 Row 의 위치로 변경하고 onrowposchanged 이벤트를 호출합니다.

활용 예제

• 새로 받은 데이터와 기존 데이터를 비교하기

• 페이지 기능 구현하기

copyRow

현재 Dataset 의 특정 데이터(Row)를 지정한 Dataset 의 데이터(Row)로 갱신하는 메소드입니다.

지원 환경

문법

Dataset.copyRow( nToRow, objDataset, nFromRow [,strColInfo] )

파라미터

var bSucc;
bSucc = this.Dataset00.copyRow(0,this.Dataset01,1);
bSucc = this.Dataset00.copyRow(0,this.Dataset01,1,"name=sawon_name,sabun=id_no");

반환

참고

- 복사할 Column 이 서로 다를 경우 복사될 Column 을 지정할 수 있습니다.
   매개변수인 strColInfo를 설정하면 지정된 Column 만 복사합니다.
   만약 Column 을 지정하지 않으면 같은 ID 를 가진 모든 Column 의 값을 복사합니다.

- copyRow() 메소드가 성공하면 oncolumnchanged 이벤트가 발생합니다.
   이 때, oncolumnchanged 이벤트의 DSColChangeEventInfo 객체 속성 중 Row 관련 속성만 유효합니다.

- updatecontrol 속성값이 true 이면 복사된 Row 의 타입은 "ROWTYPE_UPDATE" 가 되고, false 이면 "ROWTYPE_NORMAL" 가 됩니다.

- copyRow() 메소드는 지정된 위치의 Row 를 변경하므로, 복사하여 추가하기 위해서는 addRow() 메소드를 사용하여 새로운 Row 를 생성한 후 copyRow() 메소드를 수행해야 합니다.

- 매개변수인 nToRow 또는 nFromRow 에 undefined, null 등의 NaN 값을 입력하면 ECMA 정수 변환 규칙에 따라 0 이 되므로 주의하여야 합니다.

- nToRow가 현재 선택된 Row 인 경우 onvaluechanged 이벤트가 발생합니다.

- datatyperule 속성값이 "2.0" 인 경우 변경된 Data Validation 규칙이 적용됩니다.
   Column 타입에 따라 유효하지 않은 데이터로 처리될 수 있으므로 주의하여야 합니다.

createDataset

필터링 되어 보이지 않는 Row 를 제외한 범위에서 설정한 조건을 만족하는 Row 로 이루어진 Dataset 을 반환하는 메소드입니다.

지원 환경

문법

Dataset.createDataset( strDatasetID, arrColList [ , strWhereExpr [ , nStartIdx [ , nEndIdx ] ] ] )

파라미터

var objNewDS;
var arrColList = new Array ( "Column00", "NewCol1:Column01", "NewCol2", "NewCol3:Column00+Column01" );

objNewDS = this.Dataset00.createDataset( "Dataset01", arrColList );
objNewDS = this.Dataset00.createDataset( "Dataset01", arrColList, "Column02 == 10", 5, 10 );

반환

참고

- 필터링 되어 보이지 않는 Row 는 검색대상에서 제외합니다.
   필터링 된 Row 를 검색대상에 포함하려면 createDatasetNF() 메소드를 사용하여야 합니다.

- nStartIdx, nEndIdx 에 undefined, null 등의 NaN 값을 입력하면 ECMA 의 정수 변환 규칙에 따라 0 이 적용되므로 주의하여야 합니다.

createDatasetNF

필터링 되어 보이지 않는 Row 를 포함한 범위에서 설정한 조건을 만족하는 Row 로 이루어진 Dataset 을 반환하는 메소드입니다.

지원 환경

문법

Dataset.createDatasetNF( strDatasetID, arrColList [ , strWhereExpr [ , nStartIdx [ , nEndIdx ] ] ] )

파라미터

var objNewDS;
var arrColList = new Array ( "Column00", "NewCol1:Column01", "NewCol2", "NewCol3:Column00+Column01" );

objNewDS = this.Dataset00.createDataset( "Dataset01", arrColList );
objNewDS = this.Dataset00.createDataset( "Dataset01", arrColList, "Column02 == 10", 5, 10 );

반환

참고

- 필터링 되어 보이지 않는 Row 를 검색대상에 포함합니다.
   필터링 된 Row 를 검색대상에서 제외하려면 createDataset() 메소드를 사용하여야 합니다.

- nStartIdx, nEndIdx 에 undefined, null 등의 NaN 값을 입력하면 ECMA 의 정수 변환 규칙에 따라 0 이 적용되므로 주의하여야 합니다.

deleteAll

DataSet 의 모든 데이터(Row)를 삭제하는 메소드입니다.

지원 환경

문법

Dataset.deleteAll()

파라미터

var nRowCnt = this.Dataset00.deleteAll();

반환

참고

- deleteAll() 메소드가 수행되면 모든 데이터가 삭제되므로 rowposition 속성값은 "-1" 이 됩니다.

- updatecontrol 속성값이 "true"이면 삭제된 Row 의 타입은 "ROWTYPE_DELETE"가 되고, "false"이면 원본 데이터가 삭제되므로 복구할 수 없습니다.

- deleteAll() 메소드가 성공하면 onrowsetchanged 이벤트가 발생합니다.
  이 때, onrowsetchanged 이벤트의 e.reason 속성값은 "REASON_DELETEALL" 가 됩니다.
- onrowsetchanged 이벤트가 수행된 후 rowposition 속성값을 "-1" 로 설정합니다. 
  rowposition 속성값이 "-1" 로 설정된 후 onrowposchanged 이벤트를 호출합니다.

deleteColumn

DataSet 에서 지정한 Column 또는 Const Column 을 삭제하는 메소드입니다.

지원 환경

문법

Dataset.deleteColumn(nCol)
Dataset.deleteColumn(strColID)

파라미터

var bSucc;
bSucc = this.Dataset00.deleteColumn(1);
bSucc = this.Dataset00.deleteColumn("Age");

반환

참고

- deleteColumn() 메소드는 원본 데이터를 삭제하기 때문에 updatecontrol 속성값이 "false"일 때만 동작합니다.
  만약 updatecontrol 속성값이 "true"면 지정한 Column 을 삭제하지 않습니다.

- 지정한 Column 이 삭제되면 onrowsetchanged 이벤트가 발생합니다.
  이때, onrowsetchanged 이벤트의 e.reason 속성값은 "REASON_CHANGELAYOUT" 가 됩니다.

- 만약, 모든 Column 이 삭제되었으면 rowposition 속성값은 "-1" 이 됩니다.

deleteMultiRows

배열로 된 Row 목록을 입력 받아 해당 Row 들을 삭제하는 메소드입니다.

지원 환경

문법

Dataset.deleteMultiRows( arrRowlist );

파라미터

this.Dataset00.deleteMultiRows(this.Grid00.getSelectedDatasetRows());

참고

- Grid 의 getSelectedDatasetRows() 메소드 결과값을 인수로 사용할 수 있습니다.

활용 예제

• 여러 레코드 삭제하기

deleteRow

DataSet 에서 지정한 데이터(Row)를 삭제하는 메소드입니다.

지원 환경

문법

Dataset.deleteRow(nRow)

파라미터

var bSucc = this.Dataset00.deleteRow(1);

반환

참고

- deleteRow() 메소드가 성공하면 onrowsetchanged 이벤트가 발생합니다.
  이 때, onrowsetchanged 이벤트의 e.reason 속성값은 "REASON_DELETE" 가 됩니다.
- onrowsetchanged 이벤트가 수행된 후 rowposition 속성값이 변경됩니다.
- 마지막 위치의 Row가 삭제되었으면 rowposition 속성값은 새로운 마지막 Row 를 가리키게 됩니다.
  만약 모든 Row 가 삭제되었으면 rowposition 속성값은 "-1" 이 됩니다.
- rowposition의 변경상태에 관계없이 canrowposchange 이벤트는 발생하지 않고 onrowposchanged 이벤트가 발생합니다.

- updatecontrol 속성값이 "true" 인 경우에 삭제된 Row 의 타입은 "ROWTYPE_DELETE" 가 되고, "false" 인 경우에는 원본 데이터가 삭제되므로 복구할 수 없습니다.

- nRow에 "undefined, null" 등의 "NaN" 값을 입력하면 ECMA 정수 변환 규칙에 따라 "0" 이 됩니다.
  사용 시 주의하시기 바랍니다.

활용 예제

• 레코드 추가/삭제하기

exchangeRow

DataSet 에서 지정된 두 Row 의 위치(RowPosition)를 서로 바꾸는 메소드입니다.

지원 환경

문법

Dataset.exchangeRow(nRow1,nRow2)

파라미터

var bSucc = this.Dataset00.exchangeRow(2,4);

반환

참고

- exchangeRow() 메소드는 교환된 Row의 타입을 변경하지 않습니다.

- 성공하면 onrowsetchanged 이벤트가 각 Row 별로 두 번 발생합니다.
  이 때, onrowsetchanged 이벤트의 e.reason 속성값은 "REASON_EXCHANGE" 가 됩니다.

- nRow1, nRow2 에 "undefined, null" 등의 "NaN" 값을 입력하면 ECMA 정수 변환 규칙에 따라 "0" 이 됩니다.
  사용 시 주의하시기 바랍니다.

extractRows

필터링 되어 보이지 않는 Row 를 제외한 범위에서 조건표현식을 만족하는 Row 의 인덱스 배열을 반환하는 메소드입니다.

지원 환경

문법

Dataset.extractRows( strExpr [ ,nStartIdx [ ,nEndIdx [ ,arrArgs ] ] ] )

파라미터

var arrRows;
var arrArgs = new Array( "A1", "03" );

arrRows = this.Dataset00.extractRows( "dept_cd == 'A1'" );
arrRows = this.Dataset00.extractRows( "dept_cd == 'A1'", 3 );
arrRows = this.Dataset00.extractRows( "dept_cd == 'A1'", 3, 50 );
arrRows = this.Dataset00.extractRows( "dept_cd == $0", 0, -1, arrArgs );

반환

참고

- 필터링 되어 보이지 않는 Row 는 검색대상에서 제외합니다.
  필터링 된 Row 를 검색대상에 포함하려면 extractRowsNF 메서드를 사용하여야 합니다.

- nStartIdx, nEndIdx 에 undefined, null 등의 NaN 값을 입력하면 ECMA 의 정수 변환 규칙에 따라 0 이 적용되므로 주의하여야 합니다.

extractRowsNF

필터링 되어 보이지 않는 Row 를 포함한 범위에서 조건표현식을 만족하는 Row 의 인덱스 배열을 반환하는 메소드입니다.

지원 환경

문법

Dataset.extractRowsNF( strExpr [ ,nStartIdx [ ,nEndIdx [ ,arrArgs ] ] ] )

파라미터

var arrRows;
var arrArgs = new Array( "A1", "03" );

arrRows = this.Dataset00.extractRowsNF( "dept_cd == 'A1'" );
arrRows = this.Dataset00.extractRowsNF( "dept_cd == 'A1'", 3 );
arrRows = this.Dataset00.extractRowsNF( "dept_cd == 'A1'", 3, 50 );
arrRows = this.Dataset00.extractRowsNF( "dept_cd == $0", 0, -1, arrArgs );

반환

참고

- 필터링 되어 보이지 않는 Row 를 검색대상에 포함합니다.
  필터링 된 Row 를 검색대상에서 제외하려면 extractRows 메서드를 사용하여야 합니다.

- nStartIdx, nEndIdx 에 undefined, null 등의 NaN 값을 입력하면 ECMA 의 정수 변환 규칙에 따라 0 이 적용되므로 주의하여야 합니다.

filter

DataSet 에 로드된 데이터를 조건에 만족하는 데이터(Row) 만 보이게 필터링하는 메소드입니다.

지원 환경

문법

Dataset.filter([strFilterExpr])

파라미터

this.Dataset00.filter();
this.Dataset00.filter("");
this.Dataset00.filter("dept_cd == 'A1'");
this.Dataset00.filter("amount > 1000 && model_cd = 'A-1'");
this.Dataset00.filter("amount > 1000 || amount < 50 ");

참고

- filter() 메소드를 수행하면 DataSet 의 filterstr 속성값이 strFilterExpr 인자에 설정된 값으로 변경됩니다.
   strFilterExpr 인자값을 생략하면 filterstr 속성값이 filter() 메소드의 인자값으로 사용됩니다.

- filter() 메소드를 수행하면 onrowsetchanged 이벤트가 발생하며 e.reason 속성값은 "REASON_FILTER" 가 됩니다.

- filter() 메소드 수행 후 rowposition 속성값은 필터링하기 이전 값에 해당하는 위치로 이동하며, 만일 이전 값이 없으면 "-1"로 바뀝니다.

- 이미 필터링되어 있는 DataSet 에 filter() 메소드를 수행하면 전체 데이터에서 strFilterExpr 조건으로 다시 필터링됩니다.

- strFilterExpr 은 조건식의 수행결과가 "true" 또는 "false" 이어야 합니다.

- Grid 의 selecttype 속성값이 "row" 의 동작에 의한 필터링 후 currentrow 의 select 가 "true" 로 설정되면서 onrowsetchanged가 발생 합니다.
   이때 e.reason이 40(stat:row type [select])인것과 31(filter)인 것이 이어서 두번 발생되는데 이는 정상적인 동작입니다.
   그러나 Multi Select가 그리드에 의해 자동 재설정될 때는 DataSet select에 의한 이벤트가 발생 하지 않습니다.

활용 예제

• 자동완성 기능으로 키워드 제시하기

• 조건에 맞는 레코드 필터링하기

• 페이지 기능 구현하기

• 마우스 휠 동작을 이용한 페이징 처리

• Like 조건으로 검색하기

• Grid 헤더에 필터 추가하기

• 대소문자 구분 없이 필터링하기

filterRow

DataSet 에서 특정 Row 를 보이지 않게 필터링하는 메소드입니다.

지원 환경

문법

Dataset.filterRow(nRow)

파라미터

this.Dataset00.filterRow(1);

참고

- filterRow() 메소드를 수행하면 onrowsetchanged 이벤트가 발생하며 e.reason 속성값은 "REASON_FILTER" 가 됩니다.
  만약, 필터링된 행을 다시 보이게 하려면 filter() 메소드를 참조하시기 바랍니다.

- nRow 에 "undefined, null" 등의 "NaN" 값을 입력하면 ECMA 정수 변환 규칙에 따라 "0" 이 됩니다.
  사용 시 주의하시기 바랍니다.

findEventHandler

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

지원 환경

문법

Dataset.findEventHandler( strEventID, objFunc, objTarget )

파라미터

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

var nIndex = this.Dataset00.findEventHandler( "onmove", this.Dataset00_onmove, this );

반환

참고

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

findMaxLengthRow

필터링 되어 보이지 않는 Row 를 제외한 범위에서 특정 Column 의 데이터 길이가 가장 긴 Row 의 인덱스를 반환하는 메소드입니다.

지원 환경

문법

Dataset.findMaxLengthRow( strColID [ ,nStartIdx [ , nEndIdx] ] )

파라미터

var nRow;

nRow = this.Dataset00.findMaxLengthRow( "column00" );
nRow = this.Dataset00.findMaxLengthRow( "column00", 10 );
nRow = this.Dataset00.findMaxLengthRow( "column00", 10, 10000 );

반환

참고

- 필터링 되어 보이지 않는 Row 는 검색대상에서 제외합니다.
   필터링 된 Row 를 검색대상에 포함하려면 findMaxLengthRowNF() 메소드를 사용하여야 합니다.

- nStartIdx, nEndIdx 에 undefined, null 등의 NaN 값을 입력하면 ECMA 의 정수 변환 규칙에 따라 0 이 적용되므로 주의하여야 합니다.

findMaxLengthRowNF

필터링 되어 보이지 않는 Row 를 포함한 범위에서 특정 Column 의 데이터 길이가 가장 긴 Row 의 인덱스를 반환하는 메소드입니다.

지원 환경

문법

Dataset.findMaxLengthRowNF( strColID [ ,nStartIdx [ , nEndIdx] ] )

파라미터

var nRow;

nRow = this.Dataset00.findMaxLengthRowNF( "column00" );
nRow = this.Dataset00.findMaxLengthRowNF( "column00", 10 );
nRow = this.Dataset00.findMaxLengthRowNF( "column00", 10, 10000 );

반환

참고

- 필터링 되어 보이지 않는 Row 를 검색대상에 포함합니다.
   필터링 된 Row 를 검색대상에서 제외하려면 findMaxLengthRow() 메소드를 사용하여야 합니다.

- nStartIdx, nEndIdx 에 undefined, null 등의 NaN 값을 입력하면 ECMA 의 정수 변환 규칙에 따라 0 이 적용되므로 주의하여야 합니다.

findNFRowIndex

필터링 된 DataSet 의 Row 인덱스를 필터링 되지 않은 DataSet 의 Row 인덱스로 반환하는 메소드입니다.

지원 환경

문법

Dataset.findNFRowIndex( nRowPos )

파라미터

var nRowIdxNF = this.Dataset00.findNFRowIndex( 10 );

반환

참고

- 필터링 된 DataSet 에서 특정 Row 가 갖는 인덱스값을 전달하면 해당 Row 가 필터링 되지 않은 원본 DataSet 에서 갖는 인덱스값을 반환합니다.

- 필터링 되지 않은 DataSet 에서는 전달된 값과 동일한 값을 반환합니다.

findRow

필터링 되어 보이지 않는 Row 를 제외한 범위에서 특정 Column 값이 전달된 값과 일치하는 첫번째 Row 의 인덱스를 반환하는 메소드입니다.

지원 환경

문법

Dataset.findRow( strColID, strVal [ ,nStartIdx [ ,nEndIdx ] ] )

파라미터

var nRow;

nRow = this.Dataset00.findRow( "column00", "100" );
nRow = this.Dataset00.findRow( "column00", "100", 10 );
nRow = this.Dataset00.findRow( "column00", "100", 10, 10000 );
nRow = this.Dataset00.findRow( 2, "100", 10, 10000 );

반환

참고

- 필터링 되어 보이지 않는 Row 는 검색대상에서 제외합니다.
   필터링 된 Row 를 검색대상에 포함하려면 findRowNF() 메소드를 사용하여야 합니다.

- keystring 속성을 사용하여 그룹화한 경우, 그룹정보를 가진 논리적 Row 는 검색대상에서 제외합니다.

- nStartIdx, nEndIdx 에 undefined, null 등의 NaN 값을 입력하면 ECMA 의 정수 변환 규칙에 따라 0 이 적용되므로 주의하여야 합니다.

활용 예제

• 조건에 맞는 특정 레코드 검색하기

• 메뉴 구성하기

findRowAs

필터링 되어 보이지 않는 Row 를 제외한 범위에서 특정 Column 값이 전달된 값으로 시작되는 첫번째 Row 의 인덱스를 반환하는 메소드입니다.

지원 환경

문법

Dataset.findRowAs( strColID, strVal, [ ,nStartIdx [ ,nEndIdx ] ] )

파라미터

var nRow;

nRow = this.Dataset00.findRowAs( "cloumn00", "100" );
nRow = this.Dataset00.findRowAs( "cloumn00", "100", 10 );
nRow = this.Dataset00.findRowAs( "cloumn00", "100", 10, 10000 );
nRow = this.Dataset00.findRowAs( 2, "100", 10, 10000 );

반환

참고

- 필터링 되어 보이지 않는 Row 는 검색대상에서 제외합니다.
   필터링 된 Row 를 검색대상에 포함하려면 findRowAsNF() 메소드를 사용하여야 합니다.

- keystring 속성을 사용하여 그룹화한 경우, 그룹정보를 가진 논리적 Row 는 검색대상에서 제외합니다.

- nStartIdx, nEndIdx 에 undefined, null 등의 NaN 값을 입력하면 ECMA 의 정수 변환 규칙에 따라 0 이 적용되므로 주의하여야 합니다.

findRowAsNF

필터링 되어 보이지 않는 Row 를 포함한 범위에서 특정 Column 값이 전달된 값으로 시작되는 첫번째 Row 의 인덱스를 반환하는 메소드입니다.

지원 환경

문법

Dataset.findRowAsNF( strColID, strVal, [ ,nStartIdx [ ,nEndIdx ] ] )

파라미터

var nRow;

nRow = this.Dataset00.findRowAsNF( "cloumn00", "100" );
nRow = this.Dataset00.findRowAsNF( "cloumn00", "100", 10 );
nRow = this.Dataset00.findRowAsNF( "cloumn00", "100", 10, 10000 );
nRow = this.Dataset00.findRowAsNF( 2, "100", 10, 10000 );

반환

참고

- 필터링 되어 보이지 않는 Row 를 검색대상에 포함합니다.
   필터링 된 Row 를 검색대상에서 제외하려면 findRowAs() 메소드를 사용하여야 합니다.

- keystring 속성을 사용하여 그룹화한 경우, 그룹정보를 가진 논리적 Row 는 검색대상에서 제외합니다.

- nStartIdx, nEndIdx 에 undefined, null 등의 NaN 값을 입력하면 ECMA 의 정수 변환 규칙에 따라 0 이 적용되므로 주의하여야 합니다.

findRowExpr

필터링 되어 보이지 않는 Row 를 제외한 범위에서 조건표현식을 만족하는 첫번째 Row 의 인덱스를 반환하는 메소드입니다.

지원 환경

문법

Dataset.findRowExpr( strExpr [ ,nStartIdx [ ,nEndIdx [ ,arrArgs] ] ])

파라미터

var nRow;
var arrArgs = new Array( "A2", "03" );

nRow = this.Dataset00.findRowExpr( "dept_cd == 'A2'" );
nRow = this.Dataset00.findRowExpr( "dept_cd == 'A2'", 2 );
nRow = this.Dataset00.findRowExpr( "dept_cd == 'A2'", 2, 10 );
nRow = this.Dataset00.findRowExpr( "dept_cd == 'A2' && pos_cd > '03'", 2, 10 );
nRow = this.Dataset00.findRowExpr( "dept_cd == $0 && pos_cd > $1", 0, -1, arrArgs );

반환

참고

- findRowExpr() 메소드는 설정한 조건표현식을 만족하는 Row 를 찾아 그 중 첫번째 Row 의 인덱스를 반환합니다.

- 필터링 되어 보이지 않는 Row 는 검색대상에서 제외합니다.
   필터링 된 Row 를 검색대상에 포함하려면 findRowExprNF() 메소드를 사용하여야 합니다.

- keystring 속성을 사용하여 그룹화한 경우, 그룹정보를 가진 논리적 Row 는 검색대상에서 제외합니다.

- nStartIdx, nEndIdx 에 undefined, null 등의 NaN 값을 입력하면 ECMA 의 정수 변환 규칙에 따라 0 이 적용되므로 주의하여야 합니다.

활용 예제

• 조건에 맞는 특정 레코드 검색하기

• 중복된 항목 제거하기

findRowExprNF

필터링 되어 보이지 않는 Row 를 포함한 범위에서 조건표현식을 만족하는 첫번째 Row 의 인덱스를 반환하는 메소드입니다.

지원 환경

문법

Dataset.findRowExprNF( strExpr [ ,nStartIdx [ ,nEndIdx [ ,arrArgs] ] ])

파라미터

var nRow;
var arrArgs = new Array( "A2", "03" );

nRow = this.Dataset00.findRowExprNF( "dept_cd == 'A2'" );
nRow = this.Dataset00.findRowExprNF( "dept_cd == 'A2'", 2 );
nRow = this.Dataset00.findRowExprNF( "dept_cd == 'A2'", 2, 10 );
nRow = this.Dataset00.findRowExprNF( "dept_cd == 'A2' && pos_cd > '03'", 2, 10 );
nRow = this.Dataset00.findRowExprNF( "dept_cd == $0 && pos_cd > $1", 0, -1, arrArgs );

반환

참고

- findRowExprNF() 메소드는 설정한 조건표현식을 만족하는 Row 를 찾아 그 중 첫번째 Row 의 인덱스를 반환합니다.

- 필터링 되어 보이지 않는 Row 를 검색대상에 포함합니다.
   필터링 된 Row 를 검색대상에서 제외하려면 findRowExpr() 메소드를 사용하여야 합니다.

- keystring 속성을 사용하여 그룹화한 경우, 그룹정보를 가진 논리적 Row 는 검색대상에서 제외합니다.

- nStartIdx, nEndIdx 에 undefined, null 등의 NaN 값을 입력하면 ECMA 의 정수 변환 규칙에 따라 0 이 적용되므로 주의하여야 합니다.

findRowNF

필터링 되어 보이지 않는 Row 를 포함한 범위에서 특정 Column 값이 전달된 값과 일치하는 첫번째 Row 의 인덱스를 반환하는 메소드입니다.

지원 환경

문법

Dataset.findRowNF( strColID, strVal [ ,nStartIdx [ ,nEndIdx ] ] )

파라미터