DataField

데이터 필드 모델 객체

상세 설명

DataProvider 의 필드관련 method 에서 사용된다.

예제 코드

// model
let fields = ds.getFields();
ds.setFields(fields);

프로퍼티 정보

amText


amText: string

오전 표시 텍스트

baseField


baseField: string

기준 필드

상세 설명

읽어올 때는 대문자로 출력된다.

속성으로 접근하여 설정하면 대문자로 저장된다.

검증 시 사용된다.

baseYear


baseYear: number

년도 값이 100보다 작을 경우 기준 년도

기본값

2000

booleanFormat


booleanFormat: string

Boolean 형식의 값일 때 서식

상세 설명

이 값이 지정되면 boolean 필드의 값을 출력할 때 변환 형식으로 사용된다.

DataOutputOptions.booleanFormat 에 설정된 값을 우선한다.

콜론(:) 또는 세미콜론(;)으로 구분하여 왼쪽은 false일 때, 오른쪽은 true일 때

예) 'Nub: Yub'

calculated


calculated: boolean읽기전용

calculated 필드인지 여부

상세 설명

valueExpression 이나 valueCallback 이 설정되어 있으면 calculated 이다.

dataType


dataType: ValueType

자료형

상세 설명

ValueType 참고

datetimeFormat


datetimeFormat: string

날짜 형식의 값일 때 서식

상세 설명

이 값이 지정되면 datetime 필드의 값을 출력할 때 변환 형식으로 사용된다.

DataOutputOptions.datetimeFormat 에 설정된 값을 우선한다.

예) 'yyyy-M-dd'

defaultValue


defaultValue: any

필드의 기본 데이터 값

상세 설명

기본값을 지정하면 GridView.beginInsertRow(), GridView.beginAppendRow() 함수 호출시 지정된 기본값이 입력된 상태로 새로운 행이 추가된다.

fieldName


fieldName: string

필드명

상세 설명

읽어올 때에는 대문자로 출력된다.

속성으로 접근 하여 설정하면, orgFieldName 이 그대로 설정되고 해당 속성은 내부적으로 처리하기 위해 대문자로 바뀌어 설정된다.

header


header: string

그룹 헤더 타이틀

상세 설명

Row Grouping 시 그룹 헤더의 타이틀에 기준필드의 헤더 값을 표시할 수 있다.

index


index: number읽기전용

필드의 인덱스

length


length: number

데이터 길이

maximum


maximum: number

최대 범위의 한계값

상세 설명

숫자 또는 날짜형 자료형일 때 사용 가능하다.

minimum


minimum: number

최소 범위의 한계값

상세 설명

숫자 또는 날짜형 자료형일 때 사용 가능하다.

nullValue


nullValue: any

데이터가 null 일 때 대체될 데이터

orgFieldName


orgFieldName: string읽기전용

지정 당시의 필드명

pmText


pmText: string

오후 표시 텍스트

set


set: any[]

필드셋

상세 설명

배열에 포함된 값이 아니면 undefined로 저장되게 한다.

Boolean 자료형을 제외한 나머지 자료형에서 사용가능하다.

subType


subType: ValueType

기본 자료형을 제한된 범위로 사용하기 위한 지시자

상세 설명

ValueType 참고

기본값

null

subTypeEnabled


subTypeEnabled: boolean

updatable


updatable: boolean

필드값 수정 가능 여부

valueExpression


valueExpression: string

calculated 필드일 경우 사용될 수식

상세 설명

values['필드명'], values[필드인덱스]로 참조한다.

수식에서 다른 calculated 필드의 참조는 허용하지 않는다.

예제 코드

dataField.valueExpression = "values['Quantity'] * values['UnitPrice']";

콜백 정보

valueCallback


valueCallback: FieldValueCallback

calculated 필드일 경우 수식을 지정하여 계산 될 콜백

상세 설명

수식에서 다른 calculated 필드의 참조는 허용하지 않는다.

예제 코드

dataField.valueCallback = function (provider, dataRow, fieldName, fieldNames, values) {
    let quantity = values[fieldNames.indexOf("Quantity")];
    let unitprice = values[fieldNames.indexOf("UnitPrice")];
    if (isNaN(quantity) || isNaN(unitprice))
        return undefined;
    else
        return quantity >= 1000 ? Math.round(quantity * unitprice * 0.95) : quantity * unitprice;
}