Documentation – ピボットテーブルを挿入する

Nodejsjava: Aspose.Cells for Node.js via Java でピボットテーブルとピボットキャッシュを更新する

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells は、ワークブック全体から単一のピボットテーブルまで、4 つの異なるスコープでピボットデータを再ロードできる階層化された更新 API を提供します。Aspose.Cells for Node.js via Java v26.7 以降、従来の PivotTable.RefreshData() メソッドは非推奨となり、この記事で説明するより効率的でキャッシュ対応の API に置き換える必要があります。

はじめに

ピボットテーブルの更新は、単一の操作であることはほとんどありません。内部的には、Aspose.Cells は元のソースデータとワークシートに表示されるレンダリング値を接続する階層化されたデータチェーンを維持しています。このチェーンを理解することが、あらゆる状況において適切な更新 API を選択する鍵となります。 4 層データチェーンは次のとおりです:

Data Source — 生データが格納されている元のワークシート範囲、データベースクエリ、または統合範囲。
PivotCache — ソースデータのメモリ内スナップショット。すべてのピボットテーブルは PivotCache の上に構築され、ここですべてのデータが収集および集計されます。
PivotTable — 行、列、値、フィルタの各フィールドを定義するビューオブジェクト。PivotTable はデータソースから直接ではなく、PivotCache からのみデータを読み取ります。
Cells — PivotTable が計算値と書式をレンダリングする先のワークシートの Cells。

PivotCache.SourceType (列挙型 PivotTableSourceType) は、キャッシュデータの取得元を示します。v26.7 の時点で、PivotCache.Refresh() は Sheet と Consolidation のソースタイプのみをサポートしています。つまり、ワークシート範囲に存在するデータのみです。外部ソース (データベース、外部接続など) は、現時点ではキャッシュ API を通じて更新できません。

このチェーンのため、Aspose.Cells には 2 つの基本的な更新パスがあります:

PivotTable.CalculateData() — 既にキャッシュされたデータから 1 つの PivotTable の表示を再計算します。データソースへのラウンドトリップはありません。この記事のすべてのシナリオではワークシートセルのソースデータを使用しているため、ソースタイプは Sheet であり、更新操作は説明どおりに動作します。

クイックスタート

ワークブック内のすべてのピボットを更新する最小限のコードだけが必要な場合は、1 回の呼び出しで十分です:

const aspose = require('aspose.cells');
const workbook = new aspose.cells.Workbook("input.xlsx");
workbook.refreshAll();
workbook.save("output.xlsx");

この記事の残りの部分では、代わりにいつより狭い API を選択すべきかについて説明します。

必要なインポート

const aspose = require('aspose.cells');
特定のインポートの場合: const { Workbook, Cells, PivotTableSourceType } = require('aspose.cells');

ワークブック内のすべてのピボットテーブルを更新する

ワークブック内のすべてのピボットキャッシュとすべてのピボットテーブルが最新のソースデータを反映するようにする必要がある場合、最もシンプルで包括的な API は Workbook.RefreshAll() です。1 回の呼び出しでワークブック全体を走査し、各 PivotCache をそのソースから更新し、それに依存するすべての PivotTable を再計算します。これは、パフォーマンスが問題にならない一般的なフルドキュメントの更新に推奨されるアプローチです。次の例では、Fruit/Year/Amount ソース範囲を持つワークブックを作成し、1 つのピボットテーブルを作成してソース値の一部を変更し、その後 RefreshAll() を使用してすべてを 1 回の呼び出しで最新の状態に更新します。

const AsposeCells = require("aspose.cells");
// 新しいワークブックを作成
const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);
// セルA1:C1にヘッダー行を書き込み
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");
// セルA2:C9にデータ行を書き込み（2020年と2021年にわたる8行の果物のデータ）
worksheet.getCells().get("A2").putValue("grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(50);
worksheet.getCells().get("A3").putValue("blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(60);
worksheet.getCells().get("A4").putValue("kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(70);
worksheet.getCells().get("A5").putValue("cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(80);
worksheet.getCells().get("A6").putValue("grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(90);
worksheet.getCells().get("A7").putValue("blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(100);
worksheet.getCells().get("A8").putValue("kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(110);
worksheet.getCells().get("A9").putValue("cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(120);
// ピボットテーブルを追加：ソース範囲"A1:C9"、配置先のセル"E3"、名前"Pivot1"
const pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
const pivotTable = worksheet.getPivotTables().get(pivotIndex);
// ピボットフィールドを割り当て：Fruitを行、Yearを列、Amountをデータに
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
// 変更をシミュレートするため、ソースデータのいくつかのAmount値を変更
worksheet.getCells().get("C2").putValue(55);
worksheet.getCells().get("C5").putValue(85);
worksheet.getCells().get("C9").putValue(125);
// ワークブック内のすべてのピボットテーブル/ピボットキャッシュを更新
workbook.refreshAll();
// ワークブックを保存
workbook.save("output.xlsx");

単一のワークシート上のすべてのピボットテーブルを更新する

ときには、特定のワークシートに存在するピボットテーブルのみを更新する必要がある場合があります。たとえば、他のワークシートのピボットテーブルが関連していないことがわかっていて、触れてはならない場合です。このケースのために、Aspose.Cells は単一の Worksheet インスタンスを対象とする Worksheet.RefreshPivotTables() を提供します。

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");
worksheet.getCells().get("A2").putValue("grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);
worksheet.getCells().get("A3").putValue("blueberry");
worksheet.getCells().get("B3").putValue(2021);
worksheet.getCells().get("C3").putValue(150);
worksheet.getCells().get("A4").putValue("kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(200);
worksheet.getCells().get("A5").putValue("cherry");
worksheet.getCells().get("B5").putValue(2021);
worksheet.getCells().get("C5").putValue(120);
worksheet.getCells().get("A6").putValue("grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(180);
worksheet.getCells().get("A7").putValue("blueberry");
worksheet.getCells().get("B7").putValue(2020);
worksheet.getCells().get("C7").putValue(130);
worksheet.getCells().get("A8").putValue("kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(220);
worksheet.getCells().get("A9").putValue("cherry");
worksheet.getCells().get("B9").putValue(2020);
worksheet.getCells().get("C9").putValue(140);
let pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
worksheet.getCells().get("C2").putValue(300);
worksheet.getCells().get("C5").putValue(250);
worksheet.getCells().get("C9").putValue(400);
worksheet.refreshPivotTables();
workbook.save("output.xlsx");

単一のピボットテーブルを更新する

単一のピボットテーブルに対してきめ細かい制御を行いたい場合、キャッシュベースの API は 2 つのオプションを提供します。どちらを選択するかは、実際に何が変更されたかによって異なります。基になるソースデータか、ピボットテーブル自体のビュー/レイアウト設定のみかです。

ソースデータが変更された場合 — `PivotCache.Refresh()` を使用

基になるソースデータが変更された場合、正しいエントリポイントは pivotTable.PivotCache.Refresh() です。この呼び出しはソースデータをキャッシュに再読み込みし、そのキャッシュに依存するすべての PivotTable を再計算します。

ビュー/レイアウトのみが変更された場合 — `CalculateData()` を使用

ソースデータが変更されておらず、ピボットテーブルのビューまたはレイアウト設定のみが変更された場合 (たとえば、フィールドが別のエリアに移動された場合や、開く時に更新する設定が切り替えられた場合)、データソースへのラウンドトリップは不要です。キャッシュにはすでに正しいデータが保持されており、レンダリングされた PivotTable の再計算のみが必要です。この場合、pivotTable.CalculateData() が正しい選択です。次の例では、ピボットテーブルのソース以外のプロパティを変更し、その後 CalculateData() を呼び出して既存のキャッシュから再レンダリングします。

var workbook = new AsposeCells.Workbook();
var worksheet = workbook.getWorksheets().get(0);
// フルーツ / 年 / 数量の見出し行を書き込む
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");
// 8行のデータ行を書き込む（2〜9行目、ソース範囲A1:C9に合わせる）
worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);
worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(200);
worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(300);
worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(400);
worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(150);
worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(250);
worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(350);
worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(450);
// 名前が "Pivot1" のピボットテーブルを追加し、配置先セルE3、ソース範囲をA1:C9とする
var pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
var pivotTable = worksheet.getPivotTables().get(pivotIndex);
// フィールドを割り当てる：Fruitを行、Yearを列、Amountをデータへ
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
// 表示/レイアウトプロパティを変更する — これは表示のみの変更であるため、
// PivotCache.Refresh() を通じてソースデータを再読み込みする必要はない。
pivotTable.setRefreshDataOnOpeningFile(false);
// CalculateData() はこのピボットテーブルの表示（データ＋スタイル）を
// PivotCache にすでに保持されているデータから再レンダリングする。ソースデータは変更されていないため、
// ソースへのラウンドトリップは行われず、キャッシュされた値のみがワークシートセルに再計算される。
pivotTable.calculateData();
// ワークブックをディスクに保存する
workbook.save("output.xlsx");

ワークブックには、多くの場合、1 つの共有キャッシュの上に存在する多くのピボットテーブルが含まれています。これらを列挙するには (たとえば、一括更新を実行する前や、共有キャッシュの影響を診断するため)、PivotCache.GetPivotTables() を使用します。このメソッドは、指定されたキャッシュに依存するすべての PivotTable のコレクションを返します。

非推奨の `PivotTable.RefreshData()` からの移行

Aspose.Cells for Node.js via Java v26.7 より前では、ピボットテーブルを更新する標準的な方法は、各ピボットテーブルに対して個別に PivotTable.RefreshData() を呼び出すことでした。v26.7 以降、そのメソッドは非推奨となり、上記のキャッシュ対応 API に置き換える必要があります。実際のワークブックでは、テーブルごとの RefreshData() アプローチに問題がある理由は 2 つあります:

ソースが変更されていない場合でも、呼び出すたびにソースからデータを再取得します。推奨される代替手段は次のとおりです: 次の例では、単一のキャッシュを共有する複数のピボットテーブルを持つワークブックの新しい効率的なパターンを示します。

どの更新 API を使用すべきか?

次の表は、利用可能な更新 API とそれぞれをいつ選択すべきかをまとめたものです。

目的	推奨 API	メモ
ワークブック内のすべてを更新する	`Workbook.RefreshAll()`	1 回の呼び出しで、すべてのキャッシュとテーブルをカバーします。
単一シートのピボットテーブルのみを更新する	`Worksheet.RefreshPivotTables()`	単一のワークシートを対象とします。
1 つのキャッシュのソースデータが変更された	`pivotTable.PivotCache.Refresh()`	共有キャッシュ上のすべてのピボットテーブルを更新します。
ビュー/レイアウト設定のみが変更された	`pivotTable.CalculateData()`	不要なソースへのラウンドトリップをスキップします。
共有キャッシュ上のすべてのピボットテーブルをリスト表示する	`pivotCache.GetPivotTables()`	一括更新の前に列挙するために使用します。
実際には、非推奨のテーブルごとの `RefreshData()` よりも、キャッシュベースの API を優先してください。これらは共有キャッシュを認識し、冗長なソースフェッチを回避し、更新要件を満たす最小のスコープを選択できるようにします。

よくある落とし穴

保存前に更新することを忘れる。 ピボットテーブルは、データチェーンが更新された場合にのみ、レンダリングされた値をワークシートに書き込みます。ソースセルを変更した場合は、Workbook.save() の前に PivotCache.Refresh() (または Workbook.RefreshAll()) を呼び出してください。そうしないと、保存されたファイルには古い集計値が含まれます。
テーブルごとに非推奨の RefreshData() を呼び出す。 v26.7 では、PivotTable.RefreshData() は非推奨となっており、呼び出しごとにソースを再取得します。複数のピボットテーブルがキャッシュを共有している場合、これは N 回の冗長なソースフェッチを意味します。単一の PivotCache.Refresh() を呼び出し、続けてテーブルごとに CalculateData() を呼び出すように置き換えてください。
レイアウトのみが変更された場合に更新する。 ソースデータに触れずにピボットテーブルのビューのみ (列順、ConsolidationFunction など) を変更した場合、PivotCache.Refresh() は不要で低速です。pivotTable.CalculateData() を呼び出して、既存のキャッシュから再レンダリングしてください。
PivotCache.Refresh() では外部ソースがサポートされない。 ピボットテーブルのソースが外部接続 (データベース、OLAP キューブなど) からのものである場合、PivotCache.Refresh() は v26.7 ではそれを更新できません。現在、Sheet と Consolidation のソースタイプのみをサポートしています。外部ソースの場合は、ワークブックを再オープンするか、ソースからキャッシュを再構築してください。

Nodejsjava: Aspose.Cells for Node.js via Java でピボットテーブルにスタイルを適用する

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells は、従来のピボット自動書式(.xls ファイル向け)と、モダンな名前付きまたはカスタムピボットテーブルスタイル(.xlsx、.xlsm、.xlsb ファイル向け)の両方を適用できます。使用する API は、ワークブックの読み込み元ではなく、保存先のファイル形式によって決まります。

はじめに

Aspose.Cells は、ピボットテーブル用の 2 つの並行スタイル API を提供します。どちらを使用するかは、読み込み元の形式ではなく、ワークブックの保存先形式によって決まります。.xls ファイルから読み込んだワークブックを .xlsx として再保存する場合、従来のスタイル API ではなく、モダンなスタイル API が適用されます。

PivotTable.pivotTableStyleType は、組み込みの名前付きスタイル(ライトテーマおよびダークテーマ。Excel 2017 で追加されたスタイルを含む)のいずれかを選択します。これらのプリセットは読み取り専用です。
PivotTable.pivotTableStyleName は、Worksheets.getTableStyles().addPivotTableStyle(...) を通じて自分で定義したカスタムスタイルを選択します。プリセットで提供される範囲を超えて色、罫線、フォントを変更する必要がある場合は、カスタムスタイルが必要です。さらに、PivotTable.formatAll(Style) は、単一の Style オブジェクトをピボットのすべてのセルに適用するショートカットであり、上記のいずれかのスタイル名 API で設定された内容を上書きします。基になるテーマに関係なく統一された外観が必要な場合に便利です。

従来の XLS プリセット自動書式を適用する

PivotTable.autoFormatType は、Aspose.Cells.Pivot.PivotTableAutoFormatType 列挙体の値を受け取ります。利用可能な値は、Report1 から Report10、Classic、Table1 から Table10 です。次の例では、新しいワークブックを読み込み、Fruit/Year/Amount のサンプルデータを設定し、ピボットテーブルを追加して PivotTableAutoFormatType.Report5 を適用し、結果を .xls として保存します。

なぜ列フィールドがないのですか? Report シリーズの自動書式(Report1 から Report10、Table1 から Table10)は、クラシック Excel で行フィールドと値のみを持つ一次元のピボットテーブル用に設計されており、列フィールドヘッダーの組み込みスタイルはありません。ピボットに列フィールドが必要な場合は、シナリオ 2 のモダンな PivotTableStyleType プリセットを使用してください。これらは、モダン Excel で使用される二次元レイアウト向けに設計されています。

let workbook = new AsposeCells.Workbook();
// 最初のワークシートを取得する
let sheet = workbook.getWorksheets().get(0);
// ソースデータにヘッダー行（Fruit、Year、Amount）を入力する
// および2020年と2021年にわたるgrape、blueberry、kiwi、cherryの9つのデータ行
sheet.getCells().get(0, 0).putValue("Fruit");
sheet.getCells().get(0, 1).putValue("Year");
sheet.getCells().get(0, 2).putValue("Amount");
sheet.getCells().get(1, 0).putValue("grape");
sheet.getCells().get(1, 1).putValue(2020);
sheet.getCells().get(1, 2).putValue(50);
sheet.getCells().get(2, 0).putValue("blueberry");
sheet.getCells().get(2, 1).putValue(2020);
sheet.getCells().get(2, 2).putValue(30);
sheet.getCells().get(3, 0).putValue("kiwi");
sheet.getCells().get(3, 1).putValue(2020);
sheet.getCells().get(3, 2).putValue(25);
sheet.getCells().get(4, 0).putValue("cherry");
sheet.getCells().get(4, 1).putValue(2020);
sheet.getCells().get(4, 2).putValue(40);
sheet.getCells().get(5, 0).putValue("grape");
sheet.getCells().get(5, 1).putValue(2021);
sheet.getCells().get(5, 2).putValue(60);
sheet.getCells().get(6, 0).putValue("blueberry");
sheet.getCells().get(6, 1).putValue(2021);
sheet.getCells().get(6, 2).putValue(35);
sheet.getCells().get(7, 0).putValue("kiwi");
sheet.getCells().get(7, 1).putValue(2021);
sheet.getCells().get(7, 2).putValue(28);
sheet.getCells().get(8, 0).putValue("cherry");
sheet.getCells().get(8, 1).putValue(2021);
sheet.getCells().get(8, 2).putValue(45);
sheet.getCells().get(9, 0).putValue("grape");
sheet.getCells().get(9, 1).putValue(2020);
sheet.getCells().get(9, 2).putValue(45);
// ソース範囲A1:C10を使用して、宛先セルE3に「Pivot1」という名前のピボットテーブルを追加する
let pivotIndex = sheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
let pivotTable = sheet.getPivotTables().get(pivotIndex);
// フィールドを割り当てる：Fruit → 行、Amount → データ
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.ROW, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.DATA, "Amount");
// レガシーXLSプリセット自動フォーマット「Report5」を適用する
// 注：このプロパティは.xlsとして保存する場合にのみ有効です。
// .xlsx/.xlsm/.xlsbとして保存する場合、ExcelはAutoFormatTypeを無視します
// およびPivotTableStyleType / PivotTableStyleNameで指定されたものを使用します。
pivotTable.setAutoFormatType(AsposeCells.PivotTableAutoFormatType.REPORT_5);
// ワークブックをレガシー.xls形式で保存する
workbook.save("output.xls");

モダンな名前付きプリセットのピボットテーブルスタイルを適用する

カスタムピボットテーブルスタイルを定義して適用する

組み込みプリセットは変更できません。色、罫線、フォントを上書きする必要がある場合は、カスタムピボットスタイルを定義する必要があります。ワークフローは 3 つのステップで構成されます。

Worksheets.getTableStyles().addPivotTableStyle(String name) を使用して、ワークブックの TableStyles コレクションにカスタムスタイルを追加します。新しく作成されたスタイルのインデックスが返されます。
TableStyle.tableStyleElements.add(TableStyleElementType) を通じて要素(WholeTable や GrandTotalRow など)を追加し、TableStyleElement.setElementStyle(Style) を介して各要素に Style を割り当てて、スタイルを構成します。
PivotTable.pivotTableStyleName をスタイルの名前に設定して、カスタムスタイルをピボットに適用します。このプロパティは組み込みプリセットを選択するため、ここでは pivotTableStyleType を使用しないでください。

pivotTableStyleName と pivotTableStyleType は互換性がありません。組み込みプリセットには pivotTableStyleType を使用し、addPivotTableStyle を通じて定義したカスタムスタイルには pivotTableStyleName を使用します。両方を設定しても害はありませんが、意図したソースに一致する側のみがレンダリングされます。

利用可能な TableStyleElementType の値には、WholeTable、FirstRow、LastRow、FirstColumn、LastColumn、GrandTotalRow、GrandTotalColumn、PageFieldLabels、PageFieldValues が含まれます。次の例では、WholeTable に細い黒の罫線、GrandTotalRow に太字の赤いフォントを持つカスタムピボットスタイルを定義し、pivotTableStyleName を介して適用して .xlsx として保存します。

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
// ソースデータを設定：ヘッダー行 + 9データ行 (A1:C10)
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");
worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);
worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(200);
worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(300);
worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(400);
worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(500);
worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(600);
worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(700);
worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(800);
worksheet.getCells().get("A10").putValue("Grape");
worksheet.getCells().get("B10").putValue(2021);
worksheet.getCells().get("C10").putValue(900);
// A1:C10をソースとするピボットテーブルをE3に配置、名前を"Pivot1"とする
let pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.ROW, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.COLUMN, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.DATA, "Amount");
// ステップ1：新しいカスタムピボットテーブルスタイルを登録し、インデックスを取得する
let styleIndex = workbook.getWorksheets().getTableStyles().addPivotTableStyle("CustomPivotStyle");
let tableStyle = workbook.getWorksheets().getTableStyles().get(styleIndex);
// ステップ2：WholeTable要素を追加し、4辺すべてに細い黒枠線を適用する
let wholeTableElementIndex = tableStyle.getTableStyleElements().add(AsposeCells.TableStyleElementType.WHOLE_TABLE);
let wholeTableElement = tableStyle.getTableStyleElements().get(wholeTableElementIndex);
let wholeTableStyle = workbook.createStyle();
let topBorder = wholeTableStyle.getBorders().get(AsposeCells.BorderType.TOP_BORDER);
topBorder.setLineStyle(AsposeCells.CellBorderType.THIN);
topBorder.setColor(AsposeCells.Color.BLACK);
let bottomBorder = wholeTableStyle.getBorders().get(AsposeCells.BorderType.BOTTOM_BORDER);
bottomBorder.setLineStyle(AsposeCells.CellBorderType.THIN);
bottomBorder.setColor(AsposeCells.Color.BLACK);
let leftBorder = wholeTableStyle.getBorders().get(AsposeCells.BorderType.LEFT_BORDER);
leftBorder.setLineStyle(AsposeCells.CellBorderType.THIN);
leftBorder.setColor(AsposeCells.Color.BLACK);
let rightBorder = wholeTableStyle.getBorders().get(AsposeCells.BorderType.RIGHT_BORDER);
rightBorder.setLineStyle(AsposeCells.CellBorderType.THIN);
rightBorder.setColor(AsposeCells.Color.BLACK);
wholeTableElement.setElementStyle(wholeTableStyle);
// ステップ3：GrandTotalRow要素を追加し、太字の赤色フォントを適用する
let grandTotalElementIndex = tableStyle.getTableStyleElements().add(AsposeCells.TableStyleElementType.GRAND_TOTAL_ROW);
let grandTotalElement = tableStyle.getTableStyleElements().get(grandTotalElementIndex);
let grandTotalStyle = workbook.createStyle();
grandTotalStyle.getFont().setBold(true);
grandTotalStyle.getFont().setColor(AsposeCells.Color.RED);
grandTotalElement.setElementStyle(grandTotalStyle);
// ステップ4：名前でカスタムスタイルを適用する（PivotTableStyleTypeではない、これは組み込みプリセット用）
pivotTable.setPivotTableStyleName("CustomPivotStyle");
workbook.save("output.xlsx");

FormatAll を使用してすべてのピボットセルに 1 つのスタイルを適用する

PivotTable.formatAll(Style) は、ピボットテーブルのすべてのセル(データ領域、行ヘッダーと列ヘッダー、集計を含む)に単一の Style オブジェクトを適用するショートカットです。以前に pivotTableStyleType または pivotTableStyleName を介して設定された内容はすべて上書きされます。

formatAll は pivotTableStyleType と pivotTableStyleName の両方を上書きします。ピボット全体でテーマに関係なく統一された外観が必要な場合にのみ使用してください。

次の例では、黄色の単色塗りつぶし、太字の濃紺フォント、すべての辺に細い黒の罫線を持つ Style を作成し、formatAll で適用して .xlsx として保存します。

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
// ソースデータを入力: ヘッダー行 (1行目) + 9データ行 (2～10行目)
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");
worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(5000);
worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(3000);
worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(4000);
worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(2000);
worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(6000);
worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(3500);
worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(4500);
worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(2500);
worksheet.getCells().get("A10").putValue("Grape");
worksheet.getCells().get("B10").putValue(2021);
worksheet.getCells().get("C10").putValue(5500);
// ピボットテーブルを追加: ソース範囲 A1:C10、配置先セル E3、名前 "Pivot1"
let pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);
// ピボットフィールドを割り当て: Fruit -> 行エリア、Year -> 列エリア、Amount -> データエリア
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
// ピボットテーブルの全セルに強制適用されるStyleを構築
let style = workbook.createStyle();
style.setForegroundColor(AsposeCells.Color.Yellow);
style.setPattern(AsposeCells.BackgroundType.Solid);
style.getFont().setIsBold(true);
style.getFont().setColor(AsposeCells.Color.DarkBlue);
style.getBorders().get(AsposeCells.BorderType.TopBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.TopBorder).setColor(AsposeCells.Color.Black);
style.getBorders().get(AsposeCells.BorderType.BottomBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.BottomBorder).setColor(AsposeCells.Color.Black);
style.getBorders().get(AsposeCells.BorderType.LeftBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.LeftBorder).setColor(AsposeCells.Color.Black);
style.getBorders().get(AsposeCells.BorderType.RightBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.RightBorder).setColor(AsposeCells.Color.Black);
// FormatAllを適用: この単一のスタイルをピボットテーブルの全セルに強制適用し、
// 以前に設定された PivotTableStyleType / PivotTableStyleName をすべて上書きします
pivotTable.formatAll(style);
// ワークブックを最新の .xlsx 形式で保存
workbook.save("output.xlsx");

どのスタイル API を使用すべきか?

スタイル API の選択は、保存先のファイル形式によって異なります。以下の表をクイックリファレンスとしてご利用ください。

保存先のファイル形式	使用する API	注意事項
`.xls`(従来形式)	`PivotTable.autoFormatType`	`Aspose.Cells.Pivot.PivotTableAutoFormatType` の値(例: `Report1`–`Report10`、`Classic`、`Table1`–`Table10`)。モダン形式で保存する場合は無視されます。
`.xlsx` / `.xlsm` / `.xlsb`(モダン形式、組み込みスタイル)	`PivotTable.pivotTableStyleType`	`Aspose.Cells.PivotTableStyleType` の値(ライト/ダークテーマ。Excel 2017 で追加されたものを含む)。
`.xlsx` / `.xlsm` / `.xlsb`(モダン形式、カスタムスタイル)	`PivotTable.pivotTableStyleName` + `Worksheets.getTableStyles().addPivotTableStyle(...)`	組み込みプリセットだけでは不十分な場合に使用します。`TableStyleElement.setElementStyle(...)` を介して設定します。
任意の形式(統一上書き)	`PivotTable.formatAll(Style)`	ピボット全体の他のすべてのスタイル設定を上書きするショートカットです。
判断に迷う場合は、`.xlsx` として保存し、組み込みテーマには `pivotTableStyleType` を、カスタムテーマには `pivotTableStyleName` を使用してください。

Nodejsjava: Aspose.Cells for Node.js via Java でピボットテーブルの行と列のフィールドを追加する

Mon, 01 Jan 0001 00:00:00 +0000

Adding a Field to the Row or Column Region

PivotTable.addFieldToArea(PivotFieldType fieldType, String fieldName) メソッドは、ソースデータから基本フィールドを 4 つのピボット領域のいずれかに移動します。fieldType 引数には、次の PivotFieldType 値のいずれかを指定します。

ROW — 左側に縦に配置されるフィールド
COLUMN — 上部に横に配置されるフィールド
DATA — 値が集計されるフィールド
PAGE — レポートフィルターとして使用されるフィールドフィールドのネスト順序は重要です。最初に Category を行領域に追加し、その後 Item を追加すると、外側のグループ化が Category、内側のグループ化が Item であるピボットが生成されます。順序を逆にした場合、階層も逆になります。

Pivot Field Subtotals

PivotField.setSubtotals(PivotFieldSubtotalType subtotalType, boolean shown) メソッドは、ピボットフィールドに表示される小計行を制御します。各呼び出しは、1 つの小計タイプを個別に切り替えます。shown = true を渡すと小計が表示され、shown = false を渡すと非表示になります。各呼び出しは 1 つのタイプにのみ影響するため、異なる subtotalType 値でメソッドを複数回呼び出すことで、小計のカスタムサブセットを構築できます。 PivotFieldSubtotalType 列挙型は、利用可能な小計の種類を定義します。

AUTOMATIC — Aspose.Cells がデフォルトの選択を行います（通常は数値フィールドに対して SUM）
NONE — すべての小計行を抑制します
SUM
COUNT
AVERAGE
MAX
MIN
PRODUCT
STD_DEV
STD_DEVP
VAR
VARP

小計は、行領域（または列領域）に 2 つ以上のピボットフィールドがある場合にのみレンダリングされます。フィールドが 1 つだけの場合、その間で意味のある小計を計算する対象がないため、setSubtotals 呼び出しは視覚的な効果を持ちません。したがって、この記事では、各 Category グループ間の小計境界が明確に見えるように、すべての例で 2 つの行フィールド（外側が Category、内側が Item）を使用しています。

Scenario 1 — Automatic (Default) Subtotals

setSubtotals をまったく呼び出さない場合、Aspose.Cells は数値フィールドに対して AUTOMATIC の選択を適用します。次の例は、外側の Category 行フィールドに対して setSubtotals(PivotFieldSubtotalType.AUTOMATIC, true) を呼び出すことで、この動作を明示的に確認します。

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");
worksheet.getCells().get(0, 0).putValue("Category");
worksheet.getCells().get(0, 1).putValue("Item");
worksheet.getCells().get(0, 2).putValue("Year");
worksheet.getCells().get(0, 3).putValue("Amount");
worksheet.getCells().get(1, 0).putValue("Fruit");
worksheet.getCells().get(1, 1).putValue("Apple");
worksheet.getCells().get(1, 2).putValue(2020);
worksheet.getCells().get(1, 3).putValue(100);
worksheet.getCells().get(2, 0).putValue("Fruit");
worksheet.getCells().get(2, 1).putValue("Apple");
worksheet.getCells().get(2, 2).putValue(2021);
worksheet.getCells().get(2, 3).putValue(150);
worksheet.getCells().get(3, 0).putValue("Fruit");
worksheet.getCells().get(3, 1).putValue("Banana");
worksheet.getCells().get(3, 2).putValue(2020);
worksheet.getCells().get(3, 3).putValue(80);
worksheet.getCells().get(4, 0).putValue("Fruit");
worksheet.getCells().get(4, 1).putValue("Banana");
worksheet.getCells().get(4, 2).putValue(2021);
worksheet.getCells().get(4, 3).putValue(90);
worksheet.getCells().get(5, 0).putValue("Vegetable");
worksheet.getCells().get(5, 1).putValue("Carrot");
worksheet.getCells().get(5, 2).putValue(2020);
worksheet.getCells().get(5, 3).putValue(50);
worksheet.getCells().get(6, 0).putValue("Vegetable");
worksheet.getCells().get(6, 1).putValue("Carrot");
worksheet.getCells().get(6, 2).putValue(2021);
worksheet.getCells().get(6, 3).putValue(60);
worksheet.getCells().get(7, 0).putValue("Vegetable");
worksheet.getCells().get(7, 1).putValue("Daikon");
worksheet.getCells().get(7, 2).putValue(2020);
worksheet.getCells().get(7, 3).putValue(40);
worksheet.getCells().get(8, 0).putValue("Vegetable");
worksheet.getCells().get(8, 1).putValue("Daikon");
worksheet.getCells().get(8, 2).putValue(2021);
worksheet.getCells().get(8, 3).putValue(45);
let pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
let categoryField = pivotTable.getRowFields().get(0);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.Automatic, true);
pivotTable.calculateData();
workbook.save("output_automatic.xlsx");

Scenario 2 — Suppressing All Subtotals (None)

setSubtotals(PivotFieldSubtotalType.NONE, true) を呼び出すと、ピボットからすべての小計行が削除され、フィールド行と最下部の総計のみが残ります。これは、集計行のない生のグループ化データが必要な場合に便利です。

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");
let headers = ["Category", "Item", "Year", "Amount"];
for (let j = 0; j < headers.length; j++)
{
    worksheet.getCells().get(0, j).putValue(headers[j]);
}
let data = [
    ["Fruit", "Apple", 2020, 100],
    ["Fruit", "Apple", 2021, 150],
    ["Fruit", "Banana", 2020, 80],
    ["Fruit", "Banana", 2021, 90],
    ["Vegetable", "Carrot", 2020, 50],
    ["Vegetable", "Carrot", 2021, 60],
    ["Vegetable", "Daikon", 2020, 40],
    ["Vegetable", "Daikon", 2021, 45]
];
for (let i = 0; i < data.length; i++)
{
    for (let j = 0; j < data[i].length; j++)
    {
        worksheet.getCells().get(i + 1, j).putValue(data[i][j]);
    }
}
let pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
let categoryField = pivotTable.getRowFields().get(0);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.None, true);
pivotTable.calculateData();
workbook.save("output_none.xlsx");

Scenario 3 — Custom Subtotal Subset (Sum + Average)

1 つの小計タイプに限定されません。各 setSubtotals 呼び出しは 1 つのタイプに対して独立して動作するため、SUM と AVERAGE のそれぞれでメソッドを 2 回呼び出すことで、各 Category グループに対して 2 つの小計行からなるカスタムサブセットが生成されます。

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");
worksheet.getCells().get("A1").putValue("Category");
worksheet.getCells().get("B1").putValue("Item");
worksheet.getCells().get("C1").putValue("Year");
worksheet.getCells().get("D1").putValue("Amount");
worksheet.getCells().get(1, 0).putValue("Fruit");
worksheet.getCells().get(1, 1).putValue("Apple");
worksheet.getCells().get(1, 2).putValue(2020);
worksheet.getCells().get(1, 3).putValue(100);
worksheet.getCells().get(2, 0).putValue("Fruit");
worksheet.getCells().get(2, 1).putValue("Apple");
worksheet.getCells().get(2, 2).putValue(2021);
worksheet.getCells().get(2, 3).putValue(150);
worksheet.getCells().get(3, 0).putValue("Fruit");
worksheet.getCells().get(3, 1).putValue("Banana");
worksheet.getCells().get(3, 2).putValue(2020);
worksheet.getCells().get(3, 3).putValue(80);
worksheet.getCells().get(4, 0).putValue("Fruit");
worksheet.getCells().get(4, 1).putValue("Banana");
worksheet.getCells().get(4, 2).putValue(2021);
worksheet.getCells().get(4, 3).putValue(90);
worksheet.getCells().get(5, 0).putValue("Vegetable");
worksheet.getCells().get(5, 1).putValue("Carrot");
worksheet.getCells().get(5, 2).putValue(2020);
worksheet.getCells().get(5, 3).putValue(50);
worksheet.getCells().get(6, 0).putValue("Vegetable");
worksheet.getCells().get(6, 1).putValue("Carrot");
worksheet.getCells().get(6, 2).putValue(2021);
worksheet.getCells().get(6, 3).putValue(60);
worksheet.getCells().get(7, 0).putValue("Vegetable");
worksheet.getCells().get(7, 1).putValue("Daikon");
worksheet.getCells().get(7, 2).putValue(2020);
worksheet.getCells().get(7, 3).putValue(40);
worksheet.getCells().get(8, 0).putValue("Vegetable");
worksheet.getCells().get(8, 1).putValue("Daikon");
worksheet.getCells().get(8, 2).putValue(2021);
worksheet.getCells().get(8, 3).putValue(45);
let pivotTables = worksheet.getPivotTables();
let pivotIndex = pivotTables.add("A1:D9", "F3", "PivotTable1");
let pivotTable = pivotTables.get(pivotIndex);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
let categoryField = pivotTable.getRowFields().get(0);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.Sum, true);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.Average, true);
pivotTable.calculateData();
workbook.save("output_custom.xlsx");

Recap

Nodejsjava: Aspose.Cells for Node.js via Java における値フィールド

Mon, 01 Jan 0001 00:00:00 +0000

値フィールドは、すべてのピボットテーブルの中核をなす存在であり、ソースデータを集計する数値的な集計値です。Aspose.Cells for Node.js via Java では、PivotTable.addFieldToArea を使ってベースフィールドを追加することでピボットテーブルのデータ領域が構成され、その領域に配置された各フィールドは独自の集計関数を持つことができます。2 つ以上のデータフィールドが存在する場合、Aspose.Cells は特別な集計フィールド PivotTable.getValuesField() を公開し、これをベースフィールドとして行または列の軸にプロットすることで、レイアウト内での値フィールドの表示方法をより細かく制御できます。

データ領域へのフィールドの追加

ベースフィールドをデータ（値）領域に追加することは、ピボットテーブルがソースデータを集計する方法を形作るための最初のステップです。Aspose.Cells は PivotTable.addFieldToArea(PivotFieldType, string) を提供しており、定数 PivotFieldType.DATA とソース列名を受け取るオーバーロードになっています。フィールドがデータ領域に追加されると、API はそのフィールドを PivotTable.getDataFields() コレクションに追加順に公開します。デフォルトでは、数値型のソース列は ConsolidationFunction.SUM で集計され、非数値型の列は COUNT が既定値となります。

const AsposeCells = require("aspose.cells");
const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");
const headers = ["Category", "Item", "Year", "Amount"];
for (let j = 0; j < headers.length; j++) {
    worksheet.getCells().get(0, j).putValue(headers[j]);
}
const data = [
    ["Fruit",     "Apple",  2020, 100],
    ["Fruit",     "Apple",  2021, 150],
    ["Fruit",     "Banana", 2020,  80],
    ["Fruit",     "Banana", 2021,  90],
    ["Vegetable", "Carrot", 2020,  50],
    ["Vegetable", "Carrot", 2021,  60],
    ["Vegetable", "Daikon", 2020,  40],
    ["Vegetable", "Daikon", 2021,  45]
];
for (let i = 0; i < data.length; i++) {
    for (let j = 0; j < data[i].length; j++) {
        worksheet.getCells().get(i + 1, j).putValue(data[i][j]);
    }
}
const pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1", true, false);
const pivotTable = worksheet.getPivotTables().get(pivotIndex);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.calculateData();
workbook.save("output_drag.xlsx");

集計関数の変更

データ領域に配置された各フィールドは内部的に PivotField インスタンスとしてラップされており、その getFunction() プロパティは ConsolidationFunction 列挙体の値を返します。同じ setFunction() セッターを使用すると、利用可能な集計関数（SUM、COUNT、AVERAGE、MAX、MIN、PRODUCT、STD_DEV、STD_DEVP、VAR、VARP など）を切り替えることができます。

Function を変更しても影響するのは集計のみであり、ソース列は変更されません。

したがって、一方のデータフィールドを SUM のままにして、同じソース列を対象とするものの COUNT や AVERAGE を使用する 2 つ目のデータフィールドを、1 つのピボット内で追加することができます。

const AsposeCells = require("aspose.cells");
const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");
const headers = ["Category", "Item", "Year", "Amount"];
for (let j = 0; j < headers.length; j++) {
    worksheet.getCells().get(0, j).putValue(headers[j]);
}
const data = [
    ["Fruit",     "Apple",  2020, 100],
    ["Fruit",     "Apple",  2021, 150],
    ["Fruit",     "Banana", 2020,  80],
    ["Fruit",     "Banana", 2021,  90],
    ["Vegetable", "Carrot", 2020,  50],
    ["Vegetable", "Carrot", 2021,  60],
    ["Vegetable", "Daikon", 2020,  40],
    ["Vegetable", "Daikon", 2021,  45]
];
for (let i = 0; i < data.length; i++) {
    for (let j = 0; j < data[i].length; j++) {
        worksheet.getCells().get(i + 1, j).putValue(data[i][j]);
    }
}
const pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1", true, false);
const pivotTable = worksheet.getPivotTables().get(pivotIndex);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.getDataFields().get(1).setFunction(AsposeCells.ConsolidationFunction.Count);
pivotTable.calculateData();
workbook.save("output_function.xlsx");

行または列の軸への値フィールドのプロット

ピボットテーブルに 2 つ以上のデータフィールドが含まれる場合、Aspose.Cells は PivotTable.getValuesField() という追加の仮想フィールドを公開します。この仮想フィールドは、データ領域に存在するすべてのデータフィールドの集計を表します。ベースピボットフィールドとして行領域または列領域にドラッグすることができ、複数のメジャーを並べて配置する場合に便利です。

PivotTable.getValuesField() は、値フィールドが 0 個または 1 個しかない場合は機能しません。

以下のシナリオでは、上記の各機能を同じピボット構造に対して段階的に示す 3 つのエンドツーエンドの例を紹介します。

const AsposeCells = require("aspose.cells");
const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");
const headers = ["Category", "Item", "Year", "Amount"];
for (let j = 0; j < headers.length; j++) {
    worksheet.getCells().get(0, j).putValue(headers[j]);
}
const data = [
    ["Fruit",     "Apple",  2020, 100],
    ["Fruit",     "Apple",  2021, 150],
    ["Fruit",     "Banana", 2020,  80],
    ["Fruit",     "Banana", 2021,  90],
    ["Vegetable", "Carrot", 2020,  50],
    ["Vegetable", "Carrot", 2021,  60],
    ["Vegetable", "Daikon", 2020,  40],
    ["Vegetable", "Daikon", 2021,  45]
];
for (let i = 0; i < data.length; i++) {
    for (let j = 0; j < data[i].length; j++) {
        worksheet.getCells().get(i + 1, j).putValue(data[i][j]);
    }
}
const pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1", true, false);
const pivotTable = worksheet.getPivotTables().get(pivotIndex);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.getDataFields().get(1).setFunction(AsposeCells.ConsolidationFunction.Count);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, pivotTable.getValuesField());
pivotTable.calculateData();
workbook.save("output_plot.xlsx");

Nodejsjava: Aspose.Cells for Node.js via Java でピボットテーブルにフィルターフィールドを追加する

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells は、ピボットテーブル内のフィルターフィールドのライフサイクル全体をサポートします。高レベルの便利な API または低レベルの PageFields コレクションを通じてフィルターフィールドを追加でき、単一選択モードでページフィルタを駆動したり、すべてのページアイテムを表示するようにクリアしたり、フィールドを複数選択に切り替えて Excel のチェックボックス UI を通じてユーザーが複数のページアイテムを一度に選択できるようにすることができます。

はじめに

フィルターフィールドは、ピボット本体が表示するソースデータのどのサブセットを制御するピボットフィールドです。エンドユーザーは Excel でレンダリングされたピボットの上部にあるドロップダウンとしてそれを見て、利用可能なページアイテムの 1 つを選択すると、そのページアイテムに属するレコードのみが要約されるようにピボット本体が再構築されます。ピボットフィールドは、PivotFieldType.Row、PivotFieldType.Column、または PivotFieldType.Data ではなく、PivotFieldType.Page として登録されたときにフィルターフィールドになります。フィルターフィールドは 2 つの動作で動作します。デフォルトの単一選択動作では、一度に 1 つのページアイテムのみが表示されるため、ピボット本体は正確に 1 つのサブセットを要約します。複数選択動作では、フィールドはチェックボックスリストを公開し、ピボット本体はチェックされたすべてのページアイテムの和集合を要約します。同じソースフィールドは、単一プロパティを切り替えることによって、これらの動作間を前後に移動できます。 Aspose.Cells for Node.js via Java は、フィルターフィールドを登録する 2 つの同等の方法を公開しています。高レベル API は pivotTable.addFieldToArea(PivotFieldType.Page, "fieldName") であり、ソース列名を受け取り、1 回の呼び出しでフィールドを追加します。低レベル API は pivotTable.getPageFields().add(PivotField) であり、すでに PivotField 参照を保持しており、同じフィールドインスタンスをフィルター領域に追加する場合に使用されます。どちらの API も最終的に同じ PageFields コレクションにデータを格納し、この記事の残りの部分では、それらの選択方法と各フィルタリングモードの駆動方法について説明します。

フィルターフィールドの追加

フィルター領域にピボットフィールドを登録するには 2 つの方法があります。高レベルの呼び出しはソース列名を文字列として受け取り、最も一般的なパスです。低レベルの呼び出しは既存の PivotField インスタンスを受け入れ、同じフィールドオブジェクトを複数のピボット領域で再利用する必要がある場合に便利です。どちらの呼び出しもフィールドを pivotTable.getPageFields() に配置し、その後、レンダリングされたピボットの上部にページドロップダウンとして表示されます。

addFieldToArea によるフィルターフィールドの追加

次の例では、小さな Fruit / Year / Amount データセットを作成し、Fruit を行領域に、Amount をデータ領域に、Year をフィルター領域に持つピボットテーブルをセル E3 に配置し、ピボットを更新して、ワークブックを保存します。

var workbook = new AsposeCells.Workbook();
var worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");
// ヘッダー行を設定する
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");
// 9行のサンプルデータを入力：果物、年、金額
var data = [
    [ "apple", 2020, 100 ],
    [ "banana", 2021, 200 ],
    [ "apple", 2021, 150 ],
    [ "grape", 2020, 120 ],
    [ "orange", 2022, 180 ],
    [ "banana", 2020, 90 ],
    [ "grape", 2021, 130 ],
    [ "apple", 2022, 170 ],
    [ "orange", 2021, 110 ]
];
for (var i = 0; i < data.length; i++)
{
    worksheet.getCells().get(i + 1, 0).putValue(data[i][0]);
    worksheet.getCells().get(i + 1, 1).putValue(data[i][1]);
    worksheet.getCells().get(i + 1, 2).putValue(data[i][2]);
}
// セルE3にアンカーされたピボットテーブルを追加する
var pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "PivotTable1");
var pivotTable = worksheet.getPivotTables().get(pivotIndex);
// フィールドをそれぞれのエリアに追加：果物を行、金額をデータ、年をページフィールド
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");
// ピボットテーブルのデータを更新して計算する
pivotTable.calculateData();
// ワークブックを保存する
workbook.save("pageFieldSample.xlsx");

getPageFields().add によるフィルターフィールドの追加

すでに PivotField インスタンスを操作している場合は、それを pivotTable.getPageFields().add に直接渡すことができます。ピボットテーブルとフィルターフィールドは前のシナリオとまったく同じように構築されます。最終的なフィルター領域の登録のみが低レベル API 呼び出しに置き換えられます。

let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);
// ヘッダー
sheet.getCells().get("A1").putValue("Fruit");
sheet.getCells().get("B1").putValue("Year");
sheet.getCells().get("C1").putValue("Amount");
// サンプルデータ (9 行)
sheet.getCells().get("A2").putValue("apple");    sheet.getCells().get("B2").putValue("2020"); sheet.getCells().get("C2").putValue(100);
sheet.getCells().get("A3").putValue("apple");    sheet.getCells().get("B3").putValue("2021"); sheet.getCells().get("C3").putValue(150);
sheet.getCells().get("A4").putValue("apple");    sheet.getCells().get("B4").putValue("2022"); sheet.getCells().get("C4").putValue(200);
sheet.getCells().get("A5").putValue("grape");    sheet.getCells().get("B5").putValue("2020"); sheet.getCells().get("C5").putValue(300);
sheet.getCells().get("A6").putValue("grape");    sheet.getCells().get("B6").putValue("2021"); sheet.getCells().get("C6").putValue(400);
sheet.getCells().get("A7").putValue("grape");    sheet.getCells().get("B7").putValue("2022"); sheet.getCells().get("C7").putValue(500);
sheet.getCells().get("A8").putValue("blueberry"); sheet.getCells().get("B8").putValue("2020"); sheet.getCells().get("C8").putValue(250);
sheet.getCells().get("A9").putValue("blueberry"); sheet.getCells().get("B9").putValue("2021"); sheet.getCells().get("C9").putValue(350);
sheet.getCells().get("A10").putValue("blueberry");sheet.getCells().get("B10").putValue("2022"); sheet.getCells().get("C10").putValue(450);
// E3 に A1:C10 をカバーするピボットテーブルを追加
let pivotIndex = sheet.getPivotTables().add("E3", "A1:C10", "PivotTable1");
let pivotTable = sheet.getPivotTables().get(pivotIndex);
// Fruit -> 行、Amount -> データ (Year は下記のように Page に配置)
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
// 低レベルアプローチ：BaseFields から既存の Year PivotField を取得し、
// PageFields.Add(PivotField) 経由で Page エリアに登録する。
let yearField = pivotTable.getBaseFields().get("Year");
pivotTable.getPageFields().add(yearField);
// 新しいページフィールドが保存されたワークブックに反映されるように更新
pivotTable.calculateData();
workbook.save("output.xlsx");

単一選択フィルタリング (1 つのページアイテムの表示)

デフォルトの単一選択動作では、フィルターフィールドは単一のドロップダウンとしてレンダリングされ、PivotField.CurrentPageItem 整数がどのページアイテムがピボット本体を駆動するかを選択します。特定のインデックスを割り当てるとその 1 つのアイテムが選択されます。特別なセンチネル値 0x7FFD (10 進数 32765) を割り当てるとフィルタがクリアされ、すべてのページアイテムが一度に要約されます。単一選択がデフォルトです。明示的に有効化する必要はありません。

すべてのアイテムの表示

CurrentPageItem をマジック値 0x7FFD に設定することは、ページフィルタをクリアすることと同等です。フィルタが適用されていないかのように、ピボット本体はすべてのページアイテムを要約します。

var workbook = new AsposeCells.Workbook();
var sheet = workbook.getWorksheets().get(0);
// Fruit/Year/Amount のデータを入力
sheet.getCells().get("A1").putValue("Fruit");
sheet.getCells().get("B1").putValue("Year");
sheet.getCells().get("C1").putValue("Amount");
var data = [
    ["Apple", 2022, 100],
    ["Apple", 2023, 150],
    ["Banana", 2022, 80],
    ["Banana", 2023, 120],
    ["Cherry", 2022, 200],
    ["Cherry", 2023, 250]
];
for (var r = 0; r < data.length; r++) {
    for (var c = 0; c < data[r].length; c++) {
        sheet.getCells().get(r + 1, c).putValue(data[r][c]);
    }
}
// E3 にピボットテーブルを作成
var pivotTables = sheet.getPivotTables();
var index = pivotTables.add("=A1:C7", "E3", "PivotTable1");
var pivotTable = pivotTables.get(index);
// ピボットフィールドを設定: Fruit→行、Amount→データ、Year→ページ
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");
pivotTable.calculateData();
// ページフィールドのフィルタをクリアして、ページフィールド内のすべての項目を表示する。
// 0x7FFD (10進数 32765) は「すべての項目」を意味する特別なセンチネル値です —
// Excel のページフィールドドロップダウンで「(すべて)」を選択するのと同じです。
pivotTable.getPageFields().get(0).setCurrentPageItem(0x7FFD);
workbook.save("output.xlsx");

特定の 1 つのアイテムの表示

CurrentPageItem を実際のインデックスに設定すると、その 1 つのページアイテムのみが選択されます。インデックスはフィルターフィールドのソート済みアイテムリスト内のアイテムの位置であるため、たとえば 1 はソート後の 2 番目のアイテムを選択します。

var workbook = new AsposeCells.Workbook();
var sheet = workbook.getWorksheets().get(0);
var cells = sheet.getCells();
// サンプルデータを追加 (フルーツ/年/金額)
cells.get("A1").setValue("Fruit");
cells.get("B1").setValue("Year");
cells.get("C1").setValue("Amount");
cells.get("A2").setValue("Apple");
cells.get("B2").setValue("2020");
cells.get("C2").setValue("100");
cells.get("A3").setValue("Apple");
cells.get("B3").setValue("2021");
cells.get("C3").setValue("150");
cells.get("A4").setValue("Banana");
cells.get("B4").setValue("2020");
cells.get("C4").setValue("200");
cells.get("A5").setValue("Banana");
cells.get("B5").setValue("2021");
cells.get("C5").setValue("250");
// E3にピボットテーブルを追加
var pivotTables = sheet.getPivotTables();
var pivotIndex = pivotTables.add("A1:C5", "E3", "PivotTable1");
var pivotTable = pivotTables.get(pivotIndex);
// フィールドを追加: フルーツ→行、金額→データ、年→ページ
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");
// ページフィールド固有の操作
pivotTable.getPageFields().get(0).setCurrentPageItem(1); // 1 = ソート順の2番目のアイテム (例: "2021")
// ピボットテーブルを更新して計算
pivotTable.calculateData();
workbook.save("output.xlsx");

複数選択フィルタリング

複数選択フィルタリングは、ページドロップダウンをチェックボックスリストに変え、エンドユーザーが複数のページアイテムを同時に選択できるようにします。Aspose.Cells は連携する 2 つのプロパティを公開しています。複数選択 UI がまったく機能するためには、PivotField.IsMultipleItemSelectionAllowed を true に設定する必要があります。有効化された後、PivotItem.IsHidden はチェックボックスリストに表示されるアイテムを制御するため、すべてのアイテムを表示するか、特定のアイテムのみをホワイトリストに登録するかのいずれかを選択できます。以下のコードは、シナリオ 1a で構築された同じ Year フィルターフィールドで複数選択を有効化し、2 つのパターンを示します。パート A では、すべてのエントリの IsHidden を false に設定したままにすることで、すべてのページアイテムを表示します。一方、パート B では、選択したソース値のみをホワイトリストに登録し、switch (pivotItems[i].getStringValue()) ブロックを使用して他のすべてを非表示にします。

const AsposeCells = require("aspose.cells");
// — ピボットテーブルとページフィールドは、シナリオ1aとまったく同じ方法で構築されます
//   (Fruit/Year/Amountデータ、E3にピボット、Fruit→Row、
//   Amount→Data、Year→Page via AddFieldToArea)。
//   以下では、ページフィールドに複数選択フィルタリングを適用します。
const workbook = new AsposeCells.Workbook();
const sheet = workbook.getWorksheets().get(0);
const cells = sheet.getCells();
// サンプルデータ: Fruit | Year | Amount
cells.get(0, 0).putValue("Fruit");
cells.get(0, 1).putValue("Year");
cells.get(0, 2).putValue("Amount");
const data = [
    ["apple",  "2019", "100"],
    ["apple",  "2020", "150"],
    ["apple",  "2021", "200"],
    ["banana", "2019", "110"],
    ["banana", "2020", "160"],
    ["banana", "2021", "210"],
    ["grape",  "2019", "120"],
    ["grape",  "2020", "170"],
    ["grape",  "2021", "220"]
];
for (let i = 0; i < data.length; i++) {
    cells.get(i + 1, 0).putValue(data[i][0]);
    cells.get(i + 1, 1).putValue(parseInt(data[i][1]));
    cells.get(i + 1, 2).putValue(parseInt(data[i][2]));
}
const pivotSheet = workbook.getWorksheets().add("Pivot");
const pivots = pivotSheet.getPivotTables();
const pivotIndex = pivots.add("E3", "A1:C10", "PivotTable1");
const pivotTable = pivots.get(pivotIndex);
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.ROW, "Fruit");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.DATA, "Amount");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.PAGE, "Year");
// — ページフィールドで複数選択を有効にする
pivotTable.getPageFields().get(0).setMultipleItemSelectionAllowed(true);
// パートA — すべてのアイテムを選択する（すべてのアイテムを表示する）
const pivotItems = pivotTable.getPageFields().get(0).getPivotItems();
for (let i = 0; i < pivotItems.getCount(); i++) {
    pivotItems.get(i).setHidden(false);
}
// パートB — ソース値によって特定のアイテムのみを選択する
for (let i = 0; i < pivotItems.getCount(); i++) {
    switch (pivotItems.get(i).getStringValue()) {
        case "2020":
        case "grape":
        case "blueberry":
            pivotItems.get(i).setHidden(false);
            break;
        default:
            pivotItems.get(i).setHidden(true);
            break;
    }
}
pivotTable.calculateData();
workbook.save("output.xlsx");

注意: PivotItem.IsHidden を使用して複数選択フィルタリングを使用する場合、少なくとも 1 つの PivotItem は表示されたままにする必要があります (IsHidden == false)。すべてのアイテムが非表示になっている場合、Excel はファイルを開くときにクラッシュするか、空のピボットをレンダリングします。複数選択ホワイトリストにソースデータから少なくとも 1 つのアイテムが含まれていることを常に確認してください。

どの API とどのモードを使用すべきか?

以下の表は、各シナリオの詳細を読むことなく適切な組み合わせを選択できるように、各 API とモードをいつ使用するかについてまとめたものです。

シナリオ / ユースケース	推奨 API	使用するプロパティ	メモ
ソース列名でフィルターフィールドを追加する (最も一般的)	`pivotTable.addFieldToArea(PivotFieldType.Page, "fieldName")`	n/a	高レベルで 1 行で完結します。`PivotField` 参照が必要ない場合はこれを使用してください。
`PivotField` オブジェクトをすでに持っているときにフィルターフィールドを追加する	`pivotTable.getPageFields().add(PivotField)`	n/a	フィールドオブジェクトが他の場所で取得された場合や再利用する必要がある場合に使用します。
単一のページアイテムにフィルタリングする (デフォルトモード)	`PivotField.CurrentPageItem`	特定のインデックスに設定	たとえば、`1` はソート済みリストの 2 番目のアイテムを表示します。
すべてのアイテムを表示する / ページフィルタをクリアする	`PivotField.CurrentPageItem`	`0x7FFD` に設定	マジック値 `0x7FFD` (10 進数 32765) は「すべてのアイテム」のセンチネル値です。
Excel で複数選択 UI を有効化する	`PivotField.IsMultipleItemSelectionAllowed`	`true` に設定	`IsHidden` 呼び出しが有効になる前に必要です。
複数選択リスト内の個々のアイテムを表示 / 非表示にする	`PivotItem.IsHidden`	アイテムごとに設定	少なくとも 1 つのアイテムは表示されたままにする必要があります (`IsHidden == false`)。

複数選択フィルタリングを構成するときは、可視性制約を常に覚えておいてください。複数選択フィルターフィールド内のすべての PivotItem が非表示になっている場合、Excel は開くときにクラッシュするか、空のピボットをレンダリングします。ソースデータに対してホワイトリストを構築し、少なくとも 1 つのアイテムが表示されたままになるようにして、保存したワークブックがすべてのマシンで確実に開くようにしてください。

Documentation – ピボットテーブルを挿入する

Nodejsjava: Aspose.Cells for Node.js via Java でピボットテーブルとピボットキャッシュを更新する

はじめに

クイックスタート

必要なインポート

ワークブック内のすべてのピボットテーブルを更新する

単一のワークシート上のすべてのピボットテーブルを更新する

単一のピボットテーブルを更新する

ソースデータが変更された場合 — PivotCache.Refresh() を使用

ビュー/レイアウトのみが変更された場合 — CalculateData() を使用

非推奨の PivotTable.RefreshData() からの移行

どの更新 API を使用すべきか?

よくある落とし穴

Nodejsjava: Aspose.Cells for Node.js via Java でピボットテーブルにスタイルを適用する

はじめに

従来の XLS プリセット自動書式を適用する

モダンな名前付きプリセットのピボットテーブルスタイルを適用する

カスタムピボットテーブルスタイルを定義して適用する

FormatAll を使用してすべてのピボットセルに 1 つのスタイルを適用する

どのスタイル API を使用すべきか?

Nodejsjava: Aspose.Cells for Node.js via Java でピボットテーブルの行と列のフィールドを追加する

Adding a Field to the Row or Column Region

Pivot Field Subtotals

Scenario 1 — Automatic (Default) Subtotals

Scenario 2 — Suppressing All Subtotals (None)

Scenario 3 — Custom Subtotal Subset (Sum + Average)

Recap

Related Articles

Nodejsjava: Aspose.Cells for Node.js via Java における値フィールド

データ領域へのフィールドの追加

集計関数の変更

行または列の軸への値フィールドのプロット

Nodejsjava: Aspose.Cells for Node.js via Java でピボットテーブルにフィルターフィールドを追加する

はじめに

フィルターフィールドの追加

addFieldToArea によるフィルターフィールドの追加

getPageFields().add によるフィルターフィールドの追加

単一選択フィルタリング (1 つのページアイテムの表示)

すべてのアイテムの表示

特定の 1 つのアイテムの表示

複数選択フィルタリング

どの API とどのモードを使用すべきか?

ソースデータが変更された場合 — `PivotCache.Refresh()` を使用

ビュー/レイアウトのみが変更された場合 — `CalculateData()` を使用

非推奨の `PivotTable.RefreshData()` からの移行