Premium

React Pivot Grid (ピボットグリッド) の概要

React ピボットグリッドは、クロス集計形式で大量の多次元データを合計して表すために使用されます。データの概要は、簡単かつ迅速にソート、グループ化、またはフィルタリングできます。このようなデータには、合計、平均、およびその他の統計が含まれる場合があります。エンドユーザーは、必要に応じて、ドラッグアンドドロップ操作でピボットテーブルのレイアウトを変更できます。

React ピボットグリッドは、ピボットテーブルにデータを表示し、提供されたデータセットで複雑な分析を実行するのに役立ちます。この洗練されたピボットグリッドコントロールは、後でクロス集計形式で表示される大量のデータを整理、集計、およびフィルタリングするために使用されます。React ピボットグリッドの主な機能は、行のディメンション、列のディメンション、集計、およびフィルターです。

IgrPivotGrid を使用すると、ユーザーはデータを多次元のピボットテーブル構造で構成および表示できます。行と列は個別のデータグループを表し、データセルの値は集計を表します。これにより、単純なフラットデータセットに基づく複雑なデータ分析が可能になります。IgrPivotGrid は機能豊富なピボットテーブルで、さまざまなディメンションと値を簡単に構成できるだけでなく、フィルタリングやソートなどの追加のデータ操作も提供します。

React ピボットグリッドの例

以下は、React ピボットデータセレクターコンポーネントと組み合わせた React ピボットグリッドの例です。このようにして、より柔軟なランタイム構成オプションを使用できます。

React ピボットグリッドを使用した作業の開始

React IgrPivotGrid は、PivotConfiguration プロパティを介して構成できます。

<IgrPivotGrid data={pivotData} pivotConfiguration={pivotConfiguration}>
</IgrPivotGrid>

これは、rows (行)、columns (列)、values (値) の 3 つの主要なディメンションによって定義されます。rows と columns は、グリッドの行と列に表示されるグループ化された構造を定義します。values は、グループの関連する値を計算および表示するために使用される集計フィールドと集計を**定義します。

フィルターは、filters 構成プロパティを介して定義することもできます。ディメンションまたは値として追加したくないが、UI を介して関連するメンバー値をフィルタリングしたいフィールドに使用できます。

ディメンション構成

各基本ディメンション構成には、提供されたデータのフィールドに一致する MemberName が必要です。

複数の兄弟ディメンションを定義できます。これにより、関連する行または列のディメンション領域に、より複雑なネストされたグループが作成されます。

ディメンションは、ドラッグアンドドロップを使用して、対応するチップを介して、ある領域から別の領域に並べ替えたり移動したりできます。

ディメンションは、ChildLevel プロパティを介して拡張可能な階層を記述することもできます。例えば:

const dimension: IgrPivotDimension = {
    memberName: "AllProducts",
    enabled: true,
    childLevel: {
        memberName: "ProductCategory",
        enabled: true
    }
};

この場合、ディメンションはグリッドの関連セクション (行または列) にエキスパンダーを描画し、階層の一部として子を展開または縮小ことができます。デフォルトでは、行のディメンションは最初に展開されます。この動作は、ピボットグリッドの DefaultExpandState プロパティで制御できます。

事前定義されたディメンション

ピボットグリッドの一部として、構成を容易にするために、いくつかの追加の事前定義されたディメンションが公開されています:

IgrPivotDateDimension 日付フィールドに使用できます。デフォルトで次の階層を記述します:
- すべての期間
- 年
- 四半期
- 月
- 完全な日付

次のように、行または列に設定できます:


const pivotConfiguration: IgrPivotConfiguration = {
    columns: [
        new IgrPivotDateDimension({
            enabled: true,
            memberName: "Date",
        })
    ]
};

また、階層の特定の部分を有効または無効にするために、2 番目のオプションパラメーターを介してさらにカスタマイズすることもできます。例えば:

 new IgrPivotDateDimension({
    enabled: true,
    memberName: "Date",
}, {
    total: true,
    years: true,
    months: true,
    fullDate: true,
    quarters: false
});

値の構成

値の構成には、提供されたデータのフィールドに一致するメンバーが必要です。または、より複雑なカスタムシナリオ用にカスタム aggregator 関数を定義できます。データフィールドのデータ型に応じて使用できる 4 つの事前定義された集計があります:

PivotNumericAggregate - 数値フィールド用。次の集計関数が含まれています: SUM、AVG、MIN、MAX、COUNT。
PivotDateAggregate - 日付フィールド用。次の集計関数が含まれています: LATEST、EARLIEST、COUNT。
PivotTimeAggregate - 時間フィールド用。次の集計関数が含まれています: LATEST、EARLIEST、COUNT。
PivotAggregate - その他のデータ型用。これが基本集計です。次の集計関数が含まれています: COUNT。

現在の集計関数は、バリューチップのドロップダウンを使用して実行時に変更できます。デフォルトでは、フィールドのデータ型に基づいて使用可能な集計のリストが表示されます。集計のカスタムリストは、AggregateList プロパティを介して設定することもできます。例えば:

const totalSale = (members: any, data: any) => data.reduce((accumulator:any, value: any) => accumulator + value.UnitPrice * value.UnitsSold, 0);

const totalMin = (members: any, data: any) => {
    return data.map((x:any) => x.UnitPrice * x.UnitsSold).reduce((a:number, b:number) => Math.min(a, b));
};

const totalMax = (members: any, data: any) => {
    return data.map((x:any) => x.UnitPrice * x.UnitsSold).reduce((a:number, b:number) => Math.max(a,b));
};

const pivotConfiguration: IgrPivotConfiguration = {
      values: [
            {
                enabled: true,
                member: "AmountofSale",
                displayName: "Amount of Sale",
                aggregate: {
                    aggregatorName: "SUM",
                    key: "SUM",
                    label: "Sum of Sale",
                },
                aggregateList: [{
                    key: 'SUM',
                    aggregator: totalSale,
                    label: 'Sum of Sale'
                }, {
                    key: 'MIN',
                    aggregator: totalMin,
                    label: 'Minimum of Sale'
                }, {
                    key: 'MAX',
                    aggregator: totalMax,
                    label: 'Maximum of Sale'
                }]
            }
      ]
};

ピボット値は DisplayName プロパティも提供します。この値のカスタム名を列ヘッダーに表示するために使用できます。

プロパティを有効にする

PivotConfiguration は、IgrPivotGrid コンポーネントの現在の状態を記述するインターフェースです。これを使用すると、開発者はデータのフィールドを rows、columns、filters または values (行、列、フィルター、値) として宣言できます。この構成では、これらの各要素を個別に有効または無効にすることができます。ピボットグリッドの現在の状態には、有効な要素のみが含まれます。IgrPivotDataSelector コンポーネントは同じ構成を利用し、すべての有効と無効の要素のリストを表示します。それぞれについて、適切な状態のチェックボックスがあります。エンドユーザーは、これらのチェックボックスを使用してさまざまな要素を切り替えることにより、ピボット状態を簡単に調整できます。 Enable プロパティは、特定の IgrPivotDimension または IgrPivotValue がアクティブであり、ピボットグリッドによって描画されるピボットビューに参加するかどうかを制御します。

完全な構成のコード

基本的なピボット構成を見てみましょう:

const pivotConfiguration1: IgrPivotConfiguration = {
    columns: [
        new IgrPivotDateDimension({
            enabled: true,
            memberName: "Date",
        })
    ],
    rows: [
        {
            enabled: true,
            memberName: "SellerCity"
        },
        {
            enabled: true,
            memberName: "ProductName"
        }
    ],
    filters: [
        {
            enabled: true,
            memberName: "SellerName"
        }
    ],
    values: [
        {
            member: "ProductUnitPrice",
            displayName: "Amount of Sale",
            dataType: "currency",
            enabled: true,
            aggregate: {
                    aggregatorName: "SUM",
                    key: "SUM",
                    label: "Sum of Sale",
                }
        }
    ]
};

この構成では、各ディメンショングループの値を合計する 1 行、1 列、および 1 つの集計が定義されます。メンバーは、提供されたデータソースで使用可能なフィールドと一致します。

完全な構成の例

上記のコードを使用すると、Date の一意の列、Product Name 、Seller City を一意の行にグループ化し、関連するセルに売上高の関連集計を表示する次の例が得られます。

設定の自動生成

AutoGenerateConfig プロパティは、データソースフィールドに基づいてディメンションと値を自動的に生成します。

数値フィールド:
- PivotNumericAggregate.sum アグリゲーターを使用して IgrPivotValue として作成されます。
- 値のコレクションに追加され、デフォルトで有効になります。
数値以外のフィールド:
- IgrPivotDimension として作成されます。
- デフォルトで無効です。
- 列コレクションに追加されます。
日付フィールド (最初の date フィールドのみが有効になり、他の date フィールドには非数値フィールドのルールが適用されます):
- IgrPivotDateDimension として作成されます。
- デフォルトで有効です。
- 行コレクションに追加されます。

この機能により、開発者はディメンションと値を手動で指定することなく、ピボットビューをすばやく作成できます。ピボットグリッドの横にあるピボットセレクターを使用すると、ユーザーは必要に応じてディメンションと値を有効にしたり並べ替えたりできます。

ピボット値計算キー

ピボットグリッドは、ピボット計算を行うために使用するオブジェクトキーのフィールドをカスタマイズできます。既に集計された値を確認できる以下のサンプルデータで、それらがどのように使用されているかを詳しく見ることができます:

[
    {
        ProductCategory: 'All', AllProducts: 'All Products', All: 1000, 'All-Bulgaria': 774, 'All-USA': 829, 'All-Uruguay': 524,
        AllProducts_records: [
            { ProductCategory: 'Clothing', 'All-Bulgaria': 774, 'All-USA': 296, 'All-Uruguay': 456 },
            { ProductCategory: 'Bikes', 'All-Uruguay': 68 },
            { ProductCategory: 'Accessories', 'All-USA': 293 },
            { ProductCategory: 'Components', 'All-USA': 240 }
        ]
    }
];

これらはすべて、PivotConfiguration の一部である pivotKeys プロパティに格納され、デフォルトのピボットキーを変更するために使用できます。

children - 階層構築のために子を格納するフィールド。これは、グループ化された値と、その値に基づくすべての pivotGridRecords からのマップを表します。これは、階層の作成中に何かを行う必要がある非常に特殊なシナリオで利用できます。一般的な使用法のためにこれを変更する必要はありません。
records - 元のデータレコードへの参照を格納するフィールド。上記の例で見ることができます - AllProducts_records。このプロパティと同じ名前でデータにフィールドを設定することは避けてください。データレコードに records プロパティがある場合は、pivotKeys を使用して異なる一意の値を指定できます。
aggregations - 集計値を格納するフィールド。階層の作成中に適用され、一般的なシナリオでは変更する必要はありません。
level - 階層に基づいてディメンションレベルを格納するフィールド。このプロパティと同じ名前でデータにフィールドを設定することは避けてください。データレコードに level プロパティがある場合は、pivotKeys を使用して異なる一意の値を指定できます。
columnDimensionSeparator - 一意の列フィールド値を生成するときに使用されるセパレーター。上からの例のダッシュ (-) - All-Bulgaria です。
rowDimensionSeparator - 一意の行フィールド値を生成するときに使用されるセパレーター。records と level フィールドを作成するときに使用されます。

デフォルト値:

デフォルトのキーを含むデータフィールド値がある場合は、現在使用していない他の記号に一致する区切り文字を必ず変更してください。そうしないと、集計値の計算と表示で予期しない動作が発生する可能性があります。

既知の問題と制限

制限	説明
列を宣言的に設定することはサポートされていません。	ピボットグリッドは `Columns` (列) の構成に基づいて列を生成するため、ベースグリッドのように宣言的に設定することはサポートされていません。このような列は無視されます。
ディメンション / 値に重複した `MemberName` または `Member` プロパティ値を設定します。	これらのプロパティは、各ディメンション / 値に対して一意である必要があります。複製すると、最終結果からデータが失われる可能性があります。
行選択は、Single (単一) モードでのみサポートされます。	現在、複数選択はサポートされていません。

API リファレンス

IgrPivotConfiguration
IgrPivotGrid
IgrPivotDataSelector
IgrPivotDateDimensionOptions
IgrColumn

その他のリソース

コミュニティに参加して新しいアイデアをご提案ください。

React Pivot Grid (ピボット グリッド) の概要

React ピボット グリッドの例

React ピボット グリッドを使用した作業の開始