class RtDataView

See Also

Template Params

Events

• onFilterChange: (args: any) => void
  
  Properties of args

  property	type	i/o	opt	description
  dv	RtDataView	in	N	데이터뷰 객체 자신

  addFilter 등으로 필터 설정 상태가 변결될 때 발생한다.
  
• onSortChange: (args: any) => void
  
  Properties of args

  property	type	i/o	opt	description
  dv	RtDataView	in	N	데이터뷰 객체 자신

  sort 호출로 정렬 설정 상태가 변경될 때 발생한다.
  

Properties

• autoArrange: boolean
  
  Default true
  
  
  원본 데이터 수정/추가 시 정렬 및 필터들을 다시 적용한다.
  false이면 행이 추가되거나 변경된 후 명시적으로 build(true)를 호출해야 정렬 및 필터링 상태가 다시 적용된다.
• hideDeleted: boolean
  
  Default false
  
  
  softDeleting일때 삭제된 데이터행을 화면에 표시할것인지를 결정한다.
  true이면 행을 화면에 표시하지 않는다.
• source: RtListData readonly
  
  원본 데이터 객체.
  

Methods

• addFilter
  function addFilter(filter: IRtDataFilter, build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  filter	IRtDataFilter	N		데이터 필터 설정 모델.
  build	boolean	Y	false	true면 필터 제거 후 행들을 재구축한다.

  Returns

  RtDataView - 데이터뷰 자신.
  데이터 필터 설정 모델을 추가한다.
• addFilterSet
  function addFilterSet(fs: IRtDataFilterSet, build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  fs	IRtDataFilterSet	N		필터셋.
  build	boolean	Y	false	true면 필터 제거 후 행들을 재구축한다.

  Returns

  RtDataView - 데이터뷰 자신.
  필터셋을 추가한다.
• addPostFilter
  function addPostFilter(filter: IRtDataFilter, build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  filter	IRtDataFilter	N		데이터 필터 설정 모델.
  build	boolean	Y	false	true면 필터 제거 후 행들을 재구축한다.

  Returns

  RtDataView - 데이터뷰 자신.
  정렬 후 적용되는 데이터 필터 설정 모델을 추가한다.
• addPostFilterSet
  function addPostFilterSet(fs: IRtDataFilterSet, build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  fs	IRtDataFilterSet	N		필터셋.
  build	boolean	Y	false	true면 필터 제거 후 행들을 재구축한다.

  Returns

  RtDataView - 데이터뷰 자신.
  정렬 후 적용되는 필터셋을 추가한다.
• addSort
  function addSort(field: string, dir: RtSortDirection, before?: string, build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  field	string	N		정렬할 필드 명.
  dir	RtSortDirection	N		정렬 방항.
  before	string	Y		기존 정렬 목록 사이에 추가할 때 추가할 위치가 되는 필드.
  build	boolean	Y	false	true면 호출 후 행들을 재구축한다.

  Returns

  RtDataView - 데이터뷰 자신.
  기존 정렬 상태에 필드 정렬을 기존 필드 정렬 앞에 추가한다.
  이미 정렬된 필드면 무시한다.

  See Also

  appendSort
  removeSort
  sort
• appendRows
  function appendRows(values: RtRowValues[]): number;
  Parameters

  param	type	opt	default	description
  values	RtRowValues[]	N		추가할 값들. json object 배열.

  Returns

  number - 추가 후 총 행 수.
  Exceptions
  

  readonly가 true면 발생한다.
  
  source 데이터의 마지막 행 다음에 새로운 하나 이상의 행들을 추가한다.
  insertRows(rowCount, values) 호출과 동일하다.
  json 객체 배열로 신규 행들의 값을 전달한다. json의 속성들 중 데이터 필드로 존재하지 않는 속성 값은 무시되고, 속성으로 전달되지 않는 필드 값은 undefined가 된다.
• appendSort
  function appendSort(field: string, dir: RtSortDirection, build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  field	string	N		정렬할 필드 명.
  dir	RtSortDirection	N		정렬 방항.
  build	boolean	Y	false	true면 호출 후 행들을 재구축한다.

  Returns

  RtDataView - 데이터뷰 자신.
  기존 정렬 목록의 마지막에 새 정렬 조건을 추가한다.
  이미 정렬된 필드면 무시한다.
• build
  function build(force=false): RtDataView;
  Parameters

  param	type	opt	default	description
  force	boolean	Y	false	true로 지정하면 필터나 정렬 설정이 변경되지 않아도 행 목록을 재구축한다.

  Returns

  RtDataView - 데이터뷰 자신.
  sort, select 등 정렬이나 필터링 상태 변경을 복수로 (build 매개변수 false) 실행한 후, 호출해서 행들이 재구축되도록 한다.
• clearFilters
  function clearFilters(build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  build	boolean	Y	false	true면 필터 제거 후 행들을 재구축한다.

  Returns

  RtDataView
  모든 필터들을 제거한다.
• clearSort
  function clearSort(build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  build	boolean	Y	false	true면 호출 후 행들을 재구축한다.

  Returns

  RtDataView - 데이터뷰 자신.
  정렬 상태를 제거한다.
• dedupe
  function dedupe(name: string, keyFields: string[], enabled=true, build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  name	string	N		필터 이름.
  keyFields	string[]	N		중복 판단 기준 필드들.
  enabled	boolean	Y	true
  build	boolean	Y	false	true면 필터 설정 후 바로 행들을 재구축한다.

  Returns

  RtDataView - 데이터뷰 자신.
  keyFields 매개변수에 지정한 필드들을 기준으로 중복된 원본 행들 중 한 행만을 가져오는 필터를 정렬 이 전에 적용한다.
  

  See Also

  dedupeAfter
  select
  selectAfter
  slice
  sliceAfter
• dedupeAfter
  function dedupeAfter(name: string, keyFields: string[], enabled=true, build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  name	string	N		필터 이름.
  keyFields	string[]	N		중복 판단 기준 필드들.
  enabled	boolean	Y	true
  build	boolean	Y	false	true면 필터 설정 후 바로 행들을 재구축한다.

  Returns

  RtDataView - 데이터뷰 자신.
  keyFields 매개변수에 지정한 필드들을 기준으로 중복된 원본 행들 중 한 행만을 가져오는 필터를 정렬 이 후에 적용한다.
  

  See Also

  dedupe
  select
  selectAfter
  slice
  sliceAfter
• deleteRow
  function deleteRow(row: number, force=false): void;
  Parameters

  param	type	opt	default	description
  row	number	N		삭제할 데이터행 번호.
  force	boolean	Y	false	true면 softDeleting이 설정돼도 실제로 삭제한다.

  Returns

  void
  지정한 행 번호에 위치한 데이터행을 삭제한다.
  행 번호가 범위를 벗어나면 예외가 발생된다.
• deleteRows
  function deleteRows(rows: number[], force=false): void;
  Parameters

  param	type	opt	default	description
  rows	number[]	N		삭제할 데이터행 목록. 범위를 벗어나면 예외가 발생한다. Array가 아니면 아무일도 하지 않고 []를 리턴한다.
  force	boolean	Y	false	true면 softDeleting이 설정돼도 실제로 삭제한다.

  Returns

  void - 실제 삭제된 행 번호 목록
  Exceptions
  

  readonly가 true면 발생한다.
  rows에 포함된 행번호가 0 ~ rowCount-1 범위를 벗어나면 발생한다.
  
  지정한 번호들에 위치한 데이터행들을 삭제한다.
  범위를 벗어난 행 번호가 포함되면 예외가 발생된다.

  See Also

  deleteRow
  deleteRange
• enableAllFilters
  function enableAllFilters(enabled: boolean, build=true): RtDataView;
  Parameters

  param	type	opt	default	description
  enabled	boolean	N		true면 필터들이 적용된다.
  build	boolean	Y	true	true면 필터 설정 후 바로 행들을 재구축한다.

  Returns

  RtDataView - 데이터뷰 자신.
  모든 필터들의 적용 여부를 변경한다.

  See Also

  enableFilters
  enableFilter
• enableFilter
  function enableFilter(filter: string, enabled: boolean, build=true): RtDataView;
  Parameters

  param	type	opt	default	description
  filter	string	N		필터 이름.
  enabled	boolean	N		true면 필터가 적용된다.
  build	boolean	Y	true	true면 필터 설정 후 바로 행들을 재구축한다.

  Returns

  RtDataView - 데이터뷰 자신.
  지정한 필터의 적용 여부를 변경한다.

  See Also

  enableFilters
  enableAllFilters
• enableFilters
  function enableFilters(filters: string[], enabled: boolean, build=true): RtDataView;
  Parameters

  param	type	opt	default	description
  filters	string[]	N		필터 이름 배열.
  enabled	boolean	N		true면 필터들이 적용된다.
  build	boolean	Y	true	true면 필터 설정 후 바로 행들을 재구축한다.

  Returns

  RtDataView - 데이터뷰 자신.
  지정한 필터들의 적용 여부를 변경한다.

  See Also

  enableFilter
  enableAllFilters
• getStatedRows
  function getStatedRows(state: RtDataRowState): number[];
  Parameters

  param	type	opt	default	description
  state	RtDataRowState	N		데이터행 상태

  Returns

  number[] - 행 번호 목록
  지정한 상태를 갖는 데이터행 번호 목록을 가져온다.
  
• insertRow
  function insertRow(row: number, values: RtRowValues, after=false): boolean;
  Parameters

  param	type	opt	default	description
  row	number	N		행 삽입 위치. rowCount 범위를 벗어나면 예외가 발생한다.
  values	RtRowValues	N		추가할 필드 값들을 json 객체로 넘겨야 한다.
  after	boolean	Y	false	true면 row 행으로 참조하는 source 데이터의 행 다음에 추가한다.

  Returns

  boolean - 실제로 추가되면 true
  Exceptions
  

  readonly가 true면 발생한다.
  row가 0 ~ rowCount 범위를 벗어나면 발생한다.
  
  지정한 위치에 새로운 행을 삽입 추가한다.
  values의 속성들 중 데이터 필드로 존재하지 않는 속성 값은 무시되고, 속성으로 전달되지 않는 필드 값은 undefined가 된다.
• removeFilter
  function removeFilter(filter: string, build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  filter	string	N		필터 이름.
  build	boolean	Y	false	true면 필터 제거 후 행들을 재구축한다.

  Returns

  RtDataView
  지정한 필터를 제거한다.
• removeFilters
  function removeFilters(filters: string[], build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  filters	string[]	N		필터 이름 배열.
  build	boolean	Y	false	true면 필터 제거 후 행들을 재구축한다.

  Returns

  RtDataView
  지정한 필터들을 제거한다.
• removeSort
  function removeSort(field: string|string[], build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  field	string | string[]	N		정렬 필드 혹은 필드 목록 배열.
  build	boolean	Y	false	true면 호출 후 행들을 재구축한다.

  Returns

  RtDataView - 데이터뷰 자신.
  기존 정렬 상태를 제거한다.
  정렬된 상태가 아닌 필드면 무시된다.
• select
  function select(name: string, filter: RtDataSelector, enabled=true, build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  name	string	N		필터 이름.
  filter	RtDataSelector	N		행 선택 콜백.
  enabled	boolean	Y	true
  build	boolean	Y	false	true면 필터 설정 후 바로 행들을 재구축한다.

  Returns

  RtDataView
  정렬 이 전에 실행되는 선택 필터를 추가한다.
  정렬 이 후에 적용되는 필터는 selectAfter로 추가할 수 있다.

  See Also

  slice
  dedupe
• selectAfter
  function selectAfter(name: string, filter: RtDataSelector, enabled=true, build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  name	string	N		필터 이름.
  filter	RtDataSelector	N		행 선택 콜백.
  enabled	boolean	Y	true
  build	boolean	Y	false	true면 필터 설정 후 바로 행들을 재구축한다.

  Returns

  RtDataView
  정렬 이 후에 실행되는 선택 필터를 추가한다.
  정렬 이 전에 적용되는 필터는 select로 추가할 수 있다.

  See Also

  slice
  dedupe
• slice
  function slice(name: string, ranges: number[]|number, enabled=true, build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  name	string	N		필터 이름.
  ranges	number[] | number	N		행 범위(들)
  enabled	boolean	Y	true
  build	boolean	Y	false	true면 필터 설정 후 바로 행들을 재구축한다.

  Returns

  RtDataView - 데이터뷰 자신.
  원본 데이터에서 지정한 범위 내의 행들만 가져오는 필터를 정렬 이 전에 적용한다.
  ranges 매개변수에 설정하는 행 범위는 두 가지 방식으로 지정할 수 있다.
  
  

  1. 단일 숫자 - 0부터 지정한 위치 이전까지의 행들. 지정한 위치가 0 이하이면 필터가 생성되지 않는다.
  2. 숫자 배열 - 이어지는 두 값을 쌍으로 시작/끝 범위를 생성한다. 두 번째 값이 첫번째 값보다 커야 한다. 또, 각각의 범위가 겹치지 않아야 하고 이전 범위보다 먼 영역이어야 한다.

  See Also

  sliceAfter
  select
  selectAfter
• sliceAfter
  function sliceAfter(name: string, ranges: number[]|number, enabled=true, build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  name	string	N		필터 이름.
  ranges	number[] | number	N		행 범위(들)
  enabled	boolean	Y	true
  build	boolean	Y	false	true면 필터 설정 후 바로 행들을 재구축한다.

  Returns

  RtDataView - 데이터뷰 자신.
  원본 데이터에서 지정한 범위 내의 행들만 가져오는 필터를 정렬 이 후에 적용한다.
  ranges 매개변수에 설정하는 행 범위는 두 가지 방식으로 지정할 수 있다. 1. 단일 숫자 - 0부터 지정한 위치 이전까지의 행들. 지정한 위치가 0 이하이면 필터가 생성되지 않는다. 2. 숫자 배열 - 이어지는 두 값을 쌍으로 시작/끝 범위를 생성한다. 두 번째 값이 첫번째 값보다 커야 한다. 또, 각각의 범위가 겹치지 않아야 하고 이전 범위보다 먼 영역이어야 한다.

  See Also

  slice
  select
  selectAfter
• snapshot
  function snapshot(options?: IRtDataSnapshotOptions): RtListData;
  Parameters

  param	type	opt	default	description
  options	IRtDataSnapshotOptions	Y		스냅샷 생성 설정 정보.

  Returns

  RtListData - 데이터
  데이터뷰의 데이터행 목록과 동일한 데이터행으로 구성되는 RtListData를 생성한다.
  데이터행들의 값들은 복사된다.
• sort
  function sort(options: RtSortType, build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  options	RtSortType	N		정렬 옵션. 지정하지 않거나 빈 설정이면 정렬 상태가 지워진다.
  build	boolean	Y	false	true면 호출 후 행들을 재구축한다.

  Returns

  RtDataView - 데이터뷰 자신.
  기존 정렬 상태를 취소하고 새로 정렬한다.
  기존 정렬 설정과 동일한 경우 아무일도 하지 않는다.

  See Also

  addSort
  removeSort
• toggleSort
  function toggleSort(field: string, build=false): RtDataView;
  Parameters

  param	type	opt	default	description
  field	string	N		정렬 방향을 변경할 필드 명.
  build	boolean	Y	false	true면 호출 후 행들을 재구축한다.

  Returns

  RtDataView - 데이터뷰 자신.
  데이터필드의 정렬 상태를 변경한다.
  1. 정렬 상태가 아니면 ASCENDING 정렬을 추가한다.
  2. ASCENDING 정렬 상태이면 DESCENDING 정렬로 변경한다.
  3. DESCENDING 정렬 상태이면 정렬을 제거한다.
  
• updateRow
  function updateRow(row: number, values: RtRowValues, forceEmpty=false, forceUpdate=false): boolean;
  Parameters

  param	type	opt	default	description
  row	number	N		변경할 행. 범위를 벗어나면 예외가 발생한다.
  values	RtRowValues	N		변경할 필드+값 목록.
  forceEmpty	boolean	Y	false	true이면 values에 없는 필드값은 undefind로 새로 지정하고,
  forceUpdate	boolean	Y	false	true이면 필드의 값이 동일해도 변경 상태로 설정한다.

  Returns

  boolean - 실제 변경되면 true.
  Exceptions
  

  readonly가 true면 발생한다.
  row가 0 ~ rowCount-1 범위를 벗어나면 발생한다.
  
  지정한 행의 필드 값들을 지정한 값들로 변경한다.
  지정한 행 위치가 범위를 벗어나면 예외가 발생된다. 실제로 하나 이상 필드의 값이 변경되면 true를 리턴한다. forceEmpty가 false이면 values에 지정되지 않은 값들은 변경하지 않는다. false이면 values에 없는 필드의 값은 손대지 않는다.
• updateValue
  function updateValue(row: number, field: string, value: any);
  Parameters

  param	type	opt	default	description
  row	number	N		변경할 행. 범위를 벗어나면 예외가 발생한다.
  field	string	N		필드 이름.
  value	any	N		변경할 값.

  Returns

  실제로 값이 변경되면 true.
  지정한 행의 필드 값을 지정한 값으로 변경한다.
  지정한 행 위치가 범위를 벗어나거나, 존재하지 않는 필드명이면 예외가 발생된다. 실제로 변경되면 true를 리턴한다.

Inherited Properties

• RtDataSource.name
• RtDataSource.rowCount

Inherited Methods

• RtSimpleData.createLinkView
• RtSimpleData.getValues
• RtSimpleData.getAllValues
• RtDataSource.findDistinctRows
• RtDataSource.findRow
• RtDataSource.findRows
• RtDataSource.getSummary
• RtDataSource.getValue
• RtDataSource.isRowCreated
• RtDataSource.isRowDeleted
• RtDataSource.isRowUpdated
• RtObject.destroy