@@ -571,6 +571,100 @@ public PivotDataFlat()
571571
572572` sample=" /{PivotGridSample}/features" , height = " 700" , alt = " {Platform} ピボット グリッドの例" `
573573
574+ ### 設定の自動生成
575+ ` autoGenerateConfig ` プロパティは、データ ソース フィールドに基づいてディメンションと値を自動的に生成します。
576+
577+ - 数値フィールド:
578+ - ` PivotNumericAggregate .sum ` アグリゲーターを使用して ` PivotValue ` として作成されます。
579+ - 値のコレクションに追加され、デフォルトで有効になります。
580+
581+ - 数値以外のフィールド:
582+ - ` PivotDimension ` として作成されます。
583+ - デフォルトで無効です。
584+ - 列コレクションに追加されます。
585+
586+ - 日付フィールド (最初の ` date ` フィールドのみが有効になり、他の ` date ` フィールドには非数値フィールドのルールが適用されます):
587+ - ` PivotDateDimension ` として作成されます。
588+ - デフォルトで有効です。
589+ - 行コレクションに追加されます。
590+
591+ この機能により、開発者はディメンションと値を手動で指定することなく、ピボット ビューをすばやく作成できます。ピボット グリッドの横にあるピボット セレクターを使用すると、ユーザーは必要に応じてディメンションと値を有効にしたり並べ替えたりできます。
592+
593+ ### ピボット値計算キー
594+
595+ ピボット グリッドは、ピボット計算を行うために使用するオブジェクトキーのフィールドをカスタマイズできます。
596+ 既に集計された値を確認できる以下のサンプル データで、それらがどのように使用されているかを詳しく見ることができます:
597+
598+ ` ` ` json
599+ [
600+ {
601+ ProductCategory: ' All' , AllProducts: ' All Products' , All: 1000 , ' All-Bulgaria' : 774 , ' All-USA' : 829 , ' All-Uruguay' : 524 ,
602+ AllProducts_records: [
603+ { ProductCategory: ' Clothing' , ' All-Bulgaria' : 774 , ' All-USA' : 296 , ' All-Uruguay' : 456 },
604+ { ProductCategory: ' Bikes' , ' All-Uruguay' : 68 },
605+ { ProductCategory: ' Accessories' , ' All-USA' : 293 },
606+ { ProductCategory: ' Components' , ' All-USA' : 240 }
607+ ]
608+ }
609+ ];
610+ ```
611+
612+ これらはすべて、`PivotConfiguration` の一部である **pivotKeys** プロパティに格納され、デフォルトのピボット キーを変更するために使用できます。
613+ - **children** - 階層構築のために子を格納するフィールド。これは、グループ化された値と、その値に基づくすべての pivotGridRecords からのマップを表します。これは、階層の作成中に何かを行う必要がある非常に特殊なシナリオで利用できます。一般的な使用法のためにこれを変更する必要はありません。
614+ - **records** - 元のデータ レコードへの参照を格納するフィールド。上記の例で見ることができます - **AllProducts_records**。このプロパティと同じ名前でデータにフィールドを設定することは避けてください。データ レコードに **records** プロパティがある場合は、**pivotKeys** を使用して異なる一意の値を指定できます。
615+ - **aggregations** - 集計値を格納するフィールド。階層の作成中に適用され 、一般的なシナリオでは変更する必要はありません。
616+ - **level** - 階層に基づいてディメンション レベルを格納するフィールド。このプロパティと同じ名前でデータにフィールドを設定することは避けてください。データ レコードに **level** プロパティがある場合は、**pivotKeys** を使用して異なる一意の値を指定できます。
617+ - **columnDimensionSeparator** - 一意の列フィールド値を生成するときに使用されるセパレーター。上からの例のダッシュ (**-**) - **All-Bulgaria** です。
618+ - **rowDimensionSeparator** - 一意の行フィールド値を生成するときに使用されるセパレーター。**records** と **level** フィールド を作成するときに使用されます。
619+
620+ デフォルト値:
621+
622+ ` ` ` typescript
623+ {
624+ aggregations: 'aggregations',
625+ records: 'records',
626+ children: 'children',
627+ level: 'level',
628+ rowDimensionSeparator: '_',
629+ columnDimensionSeparator: '-'
630+ };
631+ ` ` `
632+
633+ ` ` ` razor
634+ @code {
635+ {
636+ aggregations: 'aggregations',
637+ records: 'records',
638+ children: 'children',
639+ level: 'level',
640+ rowDimensionSeparator: '_',
641+ columnDimensionSeparator: '-'
642+ };
643+ }
644+ ` ` `
645+
646+ > [! Note ]
647+ > デフォルトのキーを含むデータ フィールド値がある場合は、現在使用していない他の記号に一致する区切り文字を必ず変更してください。そうしないと、集計値の計算と表示で予期しない動作が発生する可能性があります。
648+
649+ < ! -- Blazor -- >
650+ Blazor で ` PivotKeys ` をオーバーライドする場合、新しい PivotKeys オブジェクトを割り当てるとデフォルトのキーが完全に置き換えられるため、現在は他のすべてのキーを定義する必要があります。
651+
652+ ` ` ` razor
653+ @code {
654+ var pivotConfiguration = new IgbPivotConfiguration();
655+ pivotConfiguration.PivotKeys = new IgbPivotKeys()
656+ {
657+ Aggregations = "aggregations",
658+ Records = "records",
659+ Children = "children",
660+ Level = "level",
661+ RowDimensionSeparator = "_",
662+ ColumnDimensionSeparator = "^"
663+ };
664+ }
665+ ` ` `
666+ < ! -- end : Blazor -- >
667+
574668## 既知の問題と制限
575669
576670| 制限| 説明|
0 commit comments