SYIDAX / DATA GRID
피벗 분석 PRO
행과 열의 두 축으로 데이터를 교차 집계합니다.
피벗 분석샘플 주문 데이터
120 rowsGrid를 불러오는 중입니다…
옵션
아래 항목을 바꾸면 Grid와 코드에 바로 반영됩니다.
최근 결과
왼쪽에서 담당 팀을 찾고 위쪽에서 APAC·EMEA·AMER 지역을 찾으세요. 이 메뉴는 피벗이 적용된 상태로 시작합니다.
코드 보기
현재 미리보기
코드에 포함된 샘플 데이터 · 6행
사용 가이드
#팀별 주문 수량을 지역별로 나란히 비교할 때 사용합니다. 행은 담당 팀, 열은 지역, 교차하는 셀은 수량 합계가 됩니다.
직접 해보기
- 행과 열 읽기
왼쪽에서 담당 팀을 찾고 위쪽에서 APAC·EMEA·AMER 지역을 찾으세요. 이 메뉴는 피벗이 적용된 상태로 시작합니다.
- 교차 값 비교
예를 들어 Platform 행의 APAC 열은 Platform 팀의 APAC 주문 수량을 더한 값입니다. 각 지역을 나란히 비교해 보세요.
- 원본 주문 확인
표 아래 데이터 분석을 원본 데이터로 바꾸어 개별 주문을 확인한 뒤, 팀 × 지역 피벗을 선택해 요약으로 돌아오세요.
확인할 결과
여러 주문이 팀과 지역의 조합별 숫자로 요약됩니다. Total을 통해 행·열의 합계도 비교할 수 있습니다.
피벗의 수량 합계와 원본 주문 한 건의 수량을 구분하세요. 이 예제는 수량을 합산하며 평균이나 주문 건수를 계산하는 예제는 아닙니다.
알아두면 쉬운 용어
- 피벗
- 두 기준을 행과 열로 놓고 교차 집계하는 표입니다.
- pivotValueColumns
- 집계할 숫자 열이며 이 예제에서는 quantity입니다.
제품에 이 기능을 적용하려면 Pro 런타임과 유효한 라이선스가 필요합니다.
API reference
#주요 속성
| Attribute / Property | 타입 / 기본값 | 설명 |
|---|---|---|
PRO pivotMode | boolean기본값 false | pivot mode. When on (and the three axis props below are non-empty), the grid cross-tabs the data instead of the normal client pipeline: `pivotRowGroupColumns` form the left rows, the distinct values of `pivotColumns` become auto-generated secondary columns, and each cell is `pivotAggFuncs[valueColumn]` over that row-group ∩ pivot value. Mutually exclusive with tree data / row grouping. |
PRO pivotRowGroupColumns | string[]기본값 undefined | left-axis grouping columns (outermost first). |
PRO pivotColumns | string[]기본값 undefined | columns whose distinct values become the top-axis pivot columns. |
PRO pivotValueColumns | string[]기본값 undefined | the value columns aggregated into each cell. |
PRO pivotAggFuncs | Record<string, string>기본값 undefined | aggregation per value column (built-in name or a registered custom name; default 'sum'). |
나머지 속성4
| Attribute / Property | 타입 / 기본값 | 설명 |
|---|---|---|
PRO pivotSubtotals | 'off' | 'top' | 'bottom'기본값 'off' | PF-GROUPPIVOT-WIRING-02 — per-level subtotal PLACEMENT for the client cross-tab. `off` (default) composes exactly the pre-ADR-023 list; `top` places each open node's subtotal straight after its marker, `bottom` closes the subtree . Collapsed nodes and innermost nodes get none; level filtering stays a core-only option. |
PRO pivotGrandTotal | 'off' | 'top' | 'bottom'기본값 'bottom' | PF-GROUPPIVOT-WIRING-02 — grand-total placement. `bottom` is the default AND the pre-ADR-023 behavior (the computed grand total has always closed the list); `top` opens with it; `off` hides it. |
PRO pivotPanelShow | 'always' | 'onlyWhenPivoting' | 'never'기본값 'never' | Canonical Pivot Panel visibility policy from the roadmap contract. |
PRO pivotPanel | boolean기본값 false | Compatibility alias: `true` is equivalent to `pivotPanelShow='always'`. |
이벤트5
| 이벤트 | detail 타입 | 설명 |
|---|---|---|
PRO | PivotPanelChangeDetail | Fires after the pivot panel changes an axis, order, or aggregation. |
PRO | PivotPanelChangeDetail | Roadmap-compatible alias emitted with the same deterministic pivot config detail. |
PRO | { pivotMode: boolean } | Fires when the built-in pivot panel toggles delegated/client pivot mode. |
PRO | SyGridPivotCombinationConflictDetail | one conflict announcement per pivot combination the grid resolves against the caller's configuration (`PF-PIVOT-SILENT-01`). The detail carries the matrix vocabulary and the exact sentence the console also received; `getPivotCombinationReport` is the pull channel for the same information. |
PRO | SyGridPivotColumnsChangedDetail | PF-GROUPPIVOT-WIRING-02 — the refresh identity, LIVE: emitted once per cross-tab recompute whose generated column set actually changed (`diffPivotColumns` — retained / added / removed / moved / axesChanged). The stateful model lives in the 'group-pivot' chunk and carries its OWN re-entrancy latch ; the element adds none. No diff, no event — a recompute that regenerates the same columns is silence, not noise. |
메서드4
| 메서드 / 인수 | 반환 타입 | 설명 |
|---|---|---|
PRO | Promise<SyGridPivotCombinationReport> | the combination decision over the features this grid actually has configured. |
PRO | Promise<SyGridPivotSecondaryColumns | null> | the identity model of the columns the grid GENERATED for the current cross-tab. |
PRO columns: string[] | Promise<boolean> | Replace the pivot columns through the same validated transition path as the Pivot Panel. |
PRO columns: string[] | Promise<boolean> | Replace the value columns; duplicates are removed and arrays are detached from the caller. |
EXPLORE CAPABILITIES
기능별로 자세히 살펴보기
기능별 사용 상황과 설정 방법을 살펴보세요. 직접 체험하는 예제와 앱에서 연결하는 기능을 각 가이드에 안내합니다.