Web Components ピボット グリッドの概要

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

    Web Components ピボット グリッドとは

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

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

    Web Components ピボット グリッドの例

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

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

    Web Components IgcPivotGrid は、pivotConfiguration プロパティを介して構成できます。

    <igc-pivot-grid #grid1 data="data" pivot-configuration="pivotConfigHierarchy">
    </igc-pivot-grid>
    

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

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

    ディメンション構成

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

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

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

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

       {
                memberFunction: () => 'All',
                memberName: 'AllProducts',
                enabled: true,
                childLevel: {
                    memberFunction: (data) => data.ProductCategory,
                    memberName: 'ProductCategory',
                    enabled: true
                }
        }
    

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

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

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

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

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

    public pivotConfigHierarchy: IgcPivotConfiguration = {
        rows: [
            new IgcPivotDateDimension({ memberName: 'Date', enabled: true });
        ]
    }
    

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

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

    値の構成

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

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

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

    public pivotConfigHierarchy: IgcPivotConfiguration = {
        values: [
            {
                member: 'AmountOfSale',
                displayName: 'Amount of Sale',
                aggregate: {
                    key: 'SUM',
                    aggregator: IgcTotalSaleAggregate.totalSale,
                    label: 'Sum of Sale'
                },
                aggregateList: [{
                    key: 'SUM',
                    aggregator: IgcTotalSaleAggregate.totalSale,
                    label: 'Sum of Sale'
                }, {
                    key: 'MIN',
                    aggregator: IgcTotalSaleAggregate.totalMin,
                    label: 'Minimum of Sale'
                }, {
                    key: 'MAX',
                    aggregator: IgcTotalSaleAggregate.totalMax,
                    label: 'Maximum of Sale'
                }]
            }
        ]
    }
    
    public static totalSale: PivotAggregation = (members, data: any) =>
        data.reduce((accumulator, value) => accumulator + value.UnitPrice * value.UnitsSold, 0);
    
    public static totalMin: PivotAggregation = (members, data: any) => {
        return data.map(x => x.UnitPrice * x.UnitsSold).reduce((a, b) => Math.min(a, b));
    };
    
    public static totalMax: PivotAggregation = (members, data: any) => {
        return data.map(x => x.UnitPrice * x.UnitsSold).reduce((a, b) => Math.max(a,b));
    };
    

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

    プロパティを有効にする

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

    完全な構成のコード

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

          public pivotConfigHierarchy: IgcPivotConfiguration = {
            columns: [
                {
    
                    memberName: 'ProductName',
                    memberFunction: (data) => data.ProductName,
                    enabled: true
                },
                {
    
                    memberName: 'SellerCity',
                    memberFunction: (data) => data.SellerCity,
                    enabled: true
                }
    
    
            ],
            rows: [
                {
                    memberName: 'SellerName',
                    memberFunction: (data) => data.SellerName,
                    enabled: true,
                }
            ],
            values: [
                {
                    member: 'AmountofSale',
                    displayName: "Amount of Sale",
                    aggregate: {
                        aggregator: IgcPivotNumericAggregate.sum,
                        key: 'SUM',
                        label: 'Sum of Sale'
                    },
                    enabled: true
    
                }
            ]
        };
    

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

    public data = [
    [
        {
            ProductName: `Clothing`,
            ProductUnitPrice: 12.8,
            SellerName: `Stanley Brooker`,
            SellerCity: `Seattle`,
            Date: `2007-01-01T00:00:00`,
            Value: 94.4,
            NumberOfUnits: 282
        },
    ];
    

    完全な構成の例

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

    既知の問題と制限

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

    API リファレンス

    その他のリソース

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