API
API
Interfaces
IFallbackFieldSort

IFallbackFieldSort

축(행 또는 열) 전체에 적용되는 fallback 정렬 설정.

각 차원에 setFieldSort() 로 명시 정렬이 지정되지 않았을 때 적용되는 기본 정렬 규칙이다. 항상 'value' 타입으로 동작하며, 반대 축의 특정 셀/그룹 소계/Grand Total 을 기준으로 같은 축의 모든 차원을 정렬한다.

  • 명시 setFieldSort 와는 완전히 독립적으로 보관된다.
  • 명시 정렬이 있는 차원은 fallback 을 무시한다 (단, scope 가 'all' 인 경우 명시 direction 이 'none' 인 차원도 fallback 으로 덮는다).
  • measure 차원(valuesAsRows 시 행 측의 measure 레벨 등) 은 fallback 대상에서 자동 제외된다.

Properties

direction: 'none' | 'asc' | 'desc'

fallback 정렬 방향.

  • 'asc' | 'desc': fallback 활성.
  • 'none': fallback 비활성 (설정은 유지되며 UI 토글에 활용).

default: undefined

measure: string (opens in a new tab)

정렬 기준 측정값 필드명.

default: undefined

scope: 'all' | 'unset'

적용 범위.

  • 'unset' (기본): setFieldSort 가 전혀 없는 차원에만 적용. 명시 direction 이 'none' 인 차원은 fallback 대상에서 제외.
  • 'all': 위에 더해, 명시 direction 이 'none' 인 차원에도 fallback 을 적용.

default: undefined

target: Array (opens in a new tab)<string (opens in a new tab)>'total'

반대 축의 대상 위치.

  • number: 반대 축 리프 인덱스.
  • string[] (전체 차원 수): 특정 리프 셀.
  • string[] (부분 차원): 해당 prefix 의 그룹 소계.
  • 'total' 또는 미지정: Grand Total.

default: undefined