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

Nodejscpp: ピボットテーブルの書式設定

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

ピボットテーブルの外観

ピボットテーブルの外観をカスタマイズする方法については、「ピボットテーブルの作成」でシンプルなピボットテーブルの作成方法が説明されています。この記事では、さまざまなプロパティを設定してピボットテーブルの外観をカスタマイズする方法について説明します:

ピボットテーブルの書式オプション
ピボットフィールドの書式オプション
データフィールドの書式オプション

ピボットテーブルフォーマットオプションの設定方法

PivotTable クラスは、全体のピボットテーブルを制御し、さまざまな方法で書式設定できます。

自動フォーマットタイプの設定方法

Microsoft Excelはさまざまなプリセットレポートフォーマットを提供しています。Aspose.Cells for Node.js via C++もこれらのフォーマットオプションをサポートしています。アクセス方法は次の通り：

PivotTable.setIsAutoFormat(value) を true に設定します。
PivotTableAutoFormatType 列挙型から書式設定オプションを割り当てます。

フォーマットオプションの設定方法

以下のコードサンプルは、ピボットテーブルを書式設定して行と列の合計を表示する方法、およびレポートのフィールド順序を設定する方法を示しています。また、null 値にカスタム文字列を設定する方法も示しています。

見た目と手触りの書式設定

事前設定されたレポート形式を使用せずに、ピボットテーブルレポートの外観を手動でフォーマットする場合、PivotTable.formatAll(style) メソッドと PivotTable.format(row, column, style) メソッドを使用します。所望のフォーマットのためのスタイルオブジェクトを作成します。たとえば：

ピボットフィールドのフォーマットオプションの設定方法

PivotField クラスは、ピボットテーブルのフィールドを表し、さまざまな方法で書式設定できます。以下のコードサンプルは、次のように行います:

行フィールドへのアクセス。
小計の設定。
自動並べ替えの設定。
自動表示の設定。

行/列/ページフィールドのフォーマット設定方法

データフィールドのフォーマット設定方法

以下のコードサンプルは、データフィールドの表示形式と数値形式を設定する方法を示しています。

ピボットフィールドをクリアする方法

PivotFieldCollection には、ピボットフィールドをクリアするための clear() メソッドがあります。たとえば、ページ、列、行、またはデータなど、領域内のすべてのピボットフィールドをクリアしたい場合に使用します。以下のコードサンプルは、データ領域内のすべてのピボットフィールドをクリアする方法を示しています。

Nodejscpp: ピボットテーブルとピボットチャートの作成

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

ピボットテーブルは、レコードのインタラクティブな集計です。たとえば、ワークシートのリストには数百の請求書エントリがあります。ピボットテーブルは、顧客、製品、または日付別に請求書を合計することができます。Microsoft Excelを使用すると、ピボットテーブル内の情報をボタンをドラッグするだけで素早く再配置することが可能です。

ピボットチャートは、ピボットテーブルのデータのインタラクティブなグラフィカルな表現です。ピボットチャートはExcel 2000で導入されました。ピボットテーブルが自動的に小計と合計を作成するため、ピボットチャートを使用することでデータを理解することがさらに容易になります。

Aspose.Cells for Node.js via C++はpivot tablesとpivot chartsをサポートしています。

Aspose.Cells for Node.js via C++を使用してピボットテーブルとチャートを追加する。

Aspose.Cells for Node.js via C++は、ピボットテーブルを作成するために使用される特別なクラスセットを提供します。これらのクラスは、ピボットテーブルオブジェクトを作成し設定するために使用され、ピボットテーブルの基本的な構成要素として機能します：

PivotField、ピボットテーブルレポート内のフィールド。
PivotFields、ピボットテーブル内のすべてのPivotFieldオブジェクトのコレクション。
PivotTable、ワークシート上のPivotTableレポート。
PivotTables、ワークシート上のすべてのPivotTableオブジェクトのコレクション。

Aspose.Cells for Node.js via C++の使用準備。

NPMからAspose.Cells for Node.js via C++をインストールし、コマンドは： $ npm install aspose.cells.node。
「Aspose.Cells for Node.js via C++」のインストール手順を段階的に説明する方法もあります。

Aspose.Cells for Node.js via C++を使用してピボットテーブルを追加する方法。

Aspose.Cells for Node.js via C++を使用してピボットテーブルを作成するには：

Cell オブジェクトの put_value メソッドを使用してワークシートのセルにデータを追加します。また、データが入力済みのテンプレートファイルを使用することもできます。このデータは、ピボットテーブルのデータソースとして使用されます。
PivotTablesコレクションのaddメソッド（Worksheetオブジェクトにカプセル化されています）を呼び出すことによって、ワークシートにピボットテーブルを追加します。
ピボットテーブルの新しいPivotTableオブジェクトにアクセスするには、そのインデックスを渡してPivotTablesコレクションからアクセスします。#PivotTableオブジェクトにカプセル化されているピボットテーブルオブジェクトを使用して、テーブルを管理します。

以下にコード例を示します。

Aspose.Cells for Node.js via C++ライブラリを使用してピボットチャートを追加する方法。

Aspose.Cells for Node.js via C++を使用してピボットチャートを作成するには：

チャートを追加します。
グラフのPivotSourceを、スプレッドシート内の既存のピボットテーブルを指すように設定します。
他の属性を設定します。

Nodejscpp: ピボットテーブルとソースデータ

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

Pivot Tableのソースデータ

デザイン時にはわからない異なるデータソース（たとえばデータベースなど）からデータを取るピボットテーブルを作成したいときがあります。この記事では、ピボットテーブルのデータソースを動的に変更するアプローチについて説明します。

ピボットテーブルのデータソースを変更する

新しいデザイナーテンプレートを作成します。
1. 以下のスクリーンショットに示すように、新しいデザイナーテンプレートファイルを作成します。
2. その後、DataSourceという名前の範囲を定義します。この範囲はこれらのセルの範囲を参照します。
  
  デザイナーテンプレートの作成と名前付き範囲の定義、DataSource

この名前付き範囲に基づいてPivot Tableを作成します。
1. Microsoft Excelでデータ、ピボットテーブル、ピボットテーブルおよびピボットチャートレポートを選択します。
2. 最初のステップで作成した名前付き範囲に基づいてピボットテーブルを作成します。
  
  DataSourceに基づいてピボットテーブルを作成する

対応するフィールドをピボットテーブルの行と列にドラッグし、スクリーンショットに示されているような結果のピボットテーブルを作成します。

対応するフィールドに基づいてピボットテーブルを作成する

設計したピボットテーブルが以下に示されています。

データオプションの設定で開くときに更新をチェックします。

ピボットテーブルオプションの設定

これで、このファイルをデザイナーテンプレートファイルとして保存できます。

新しいデータを埋め込んでピボットテーブルのソースデータを変更します。
1. デザイナーテンプレートが作成されたら、次のコードを使用してピボットテーブルのソースデータを変更します。

以下のコード例を実行すると、ピボットテーブルのソースデータが変更されます。

Nodejscpp: ピボットテーブルに計算フィールドを追加する

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

可能な使用シナリオ

既知のデータに基づいてピボットテーブルを作成すると、それに含まれるデータが望んでいるものではないことがあります。望んでいるデータは、これらの元のデータの組み合わせです。たとえば、データを望んだ形式にするために、元のデータを加算、減算、乗算、除算する必要があります。その場合、計算フィールドを構築し、計算用の対応する式を設定する必要があります。その後、計算フィールドで統計などの操作を行います。

Excelでピボットテーブルに計算フィールドを追加する方法

Excelのピボットテーブルに計算フィールドを挿入するには、以下の手順に従います:

追加したいピボットテーブルを選択します。
リボットテーブルツールの「分析」タブに移動します。
「フィールド、アイテム、およびセット」をクリックし、その後、ドロップダウンメニューから「計算フィールド」を選択します。
「名前」フィールドに、計算フィールドの名前を入力します。
「式」フィールドに、適切なピボットテーブルのフィールド名と数学演算子を使用して実行する計算の式を入力します。
「OK」をクリックして計算フィールドを作成します。
新しい計算フィールドは、値のセクションの下にあるピボットテーブルフィールドリストに表示されます。
計算フィールドをピボットテーブルの値セクションにドラッグして、計算された値を表示します。

Aspose.Cells for Node.js via C++ライブラリを使ったピボットテーブルに計算フィールドを追加する方法

Aspose.Cells for Node.js via C++を使ってExcelファイルに計算フィールドを追加します。サンプルコードを参照してください。例の実行後、ピボットテーブルに計算フィールドが追加されます。

元のデータを設定し、ピボットテーブルを作成します。
ピボットテーブル内の既存のPivotFieldに応じて計算フィールドを作成します。
計算フィールドをデータ領域に追加します。
最後に、output XLSX形式でブックを保存します。

サンプルコード

Nodejscpp: Aspose.Cells for Node.js via C++でピボットテーブルを更新する

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

Aspose.Cellsは、ワークブック全体から単一のピボットテーブルまで、4つの異なるスコープでピボットデータを再読み込みできる階層的なリフレッシュAPIを提供します。Aspose.Cells for Node.js via C++ v26.7以降、従来のメソッドPivotTable.RefreshData()は非推奨となり、本記事で紹介するより効率的でキャッシュ対応のAPIに置き換える必要があります。

はじめに

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

データソース — 生の値が格納されている元のワークシート範囲、データベースクエリ、または統合範囲。
PivotCache — ソースデータのインメモリスナップショット。すべてのピボットテーブルはPivotCacheの上に構築され、ここですべてのデータが収集および集計されます。
PivotTable — 行、列、値、フィルタのフィールドを定義するビューオブジェクト。PivotTableはデータソースから直接読み取ることはなく、常にそのPivotCacheからのみ読み取ります。
Cells — PivotTableが計算された値とスタイルをレンダリングする先のワークシートのCells。特に重要な概念は共有キャッシュです。ワークブック内の複数のピボットテーブルが同じソース範囲を参照している場合、それらは1つのPivotCacheインスタンスを共有します。1つのPivotCacheを多くのピボットテーブルから参照でき、そのキャッシュを更新すると、依存しているすべてのPivotTableが一度に更新されます。
PivotCache.SourceType（列挙型PivotTableSourceType）は、キャッシュデータの取得元を示します。v26.7時点で、PivotCache.Refresh()がサポートするのは**Sheet**と**Consolidation**のソースタイプのみです。つまり、ワークシート範囲に存在するデータのみが対象となります。外部ソース（データベースや外部接続など）は、キャッシュAPIを介してはまだ更新できません。
このチェーンのため、Aspose.Cellsには2つの基本的なリフレッシュパスがあります。

PivotCache.Refresh() — ソースからキャッシュへの再読み込みと、それに依存するすべてのPivotTableの再計算を単一の操作で行います。
PivotTable.CalculateData() — すでにキャッシュされたデータから1つのPivotTableの表示を再計算し、データソースへのラウンドトリップは行いません。本記事のすべてのシナリオではワークシートセルのソースデータを使用するため、ソースタイプはSheetとなり、リフレッシュ操作は前述のとおりに動作します。

必要なインポート

本記事のすべてのJavaScriptの例では、Aspose.Cells for Node.js via C++モジュールが読み込まれ、ピボットタイプがAspose.Cells.Pivot名前空間に存在することを前提としています。一般的なセットアップは以下のとおりです。

const AsposeCells = require("aspose.cells.node");
const { PivotFieldType } = AsposeCells;（またはAsposeCells.Pivot.PivotFieldType経由でアクセス）

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

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

let workbook = new AsposeCells.Workbook();
let 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"
let pivotIndex = worksheet.getPivotTables().add("A1:C9", "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");

// 変更をシミュレートするためにソースデータの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()を提供しています。これはWorkbook.RefreshAll()よりも選択的です。対象のワークシート上にあるピボットテーブルのみが更新され、他のワークシート上にあるピボットテーブルはそのまま残されます。次の例では、同じFruit/Year/Amountのソースデータを設定し、最初のワークシートにピボットテーブルを追加し、一部のソース値を変更してから、そのワークシート上にあるピボットテーブルのみを更新します。

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を再計算します。

ピボットテーブルは単一のPivotCacheインスタンスを共有するため、PivotCache.Refresh()を呼び出すと、参照した1つのテーブルだけでなく、そのキャッシュ上に構築されたすべてのピボットテーブルが再計算されます。2つのピボットテーブルが同じソース範囲を共有している場合、一方のキャッシュを更新すると両方が更新されます。

次の例では、この共有キャッシュの動作を示すために同じソース範囲上に2つのピボットテーブルを作成し、一部のソース値を変更してから、1つのキャッシュ参照を介して更新します。

const AsposeCells = require("aspose.cells");

// 新しいワークブックを作成し、最初のワークシートにアクセスする
const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);

// ヘッダー行を書き込む: 果物 / 年 / 数量
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

// 約9行のデータ行を書き込む (ぶどう / ブルーベリー / キウイ / さくらんぼ を 2020-2021 にわたって)
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);

// セル E3 に配置する最初のリピボットテーブル「Pivot1」を追加する、ソース範囲は A1:C9
const pivotIndex1 = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
const pivotTable1 = worksheet.getPivotTables().get(pivotIndex1);

// Pivot1 のフィールドを割り当てる
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// 同じソース範囲 A1:C9 を使用して E15 に配置する 2 番目のピボットテーブル「Pivot2」を追加する
// Pivot1 と Pivot2 はソース範囲が同じであるため、1 つの PivotCache を共有する。
const pivotIndex2 = worksheet.getPivotTables().add("A1:C9", "E15", "Pivot2");
const pivotTable2 = worksheet.getPivotTables().get(pivotIndex2);

// Pivot2 に同じフィールドを割り当てる
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// データ変更をシミュレートするために、ソースデータの複数の Amount セルの値を変更する
worksheet.getCells().get("C2").putValue(150);
worksheet.getCells().get("C4").putValue(350);
worksheet.getCells().get("C7").putValue(650);

// 共有されている PivotCache を更新する。
// Pivot1 と Pivot2 は同じ PivotCache を共有しているため、この 1 回の呼び出しで
// 両方のピボットテーブル (データ + スタイル) が更新されたソースから更新される。
pivotTable1.getPivotCache().refresh();

// ワークブックを保存する
workbook.save("output.xlsx");

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

ソースデータは変更されておらず、ピボットテーブルのビューやレイアウト設定のみが変更された場合（例えば、フィールドが別のエリアに移動された場合や、ファイルを開いたときに更新する設定が切り替えられた場合など）、データソースへのラウンドトリップは必要ありません。キャッシュにはすでに正しいデータが保持されており、レンダリングされたPivotTableのみを再計算する必要があります。この場合、pivotTable.CalculateData()が適切な選択です。これにより不要なソースフェッチが回避され、多くのピボットテーブルが同じキャッシュを共有している場合に大幅に高速化されます。次の例では、ピボットテーブルのソース以外のプロパティを変更し、既存のキャッシュからCalculateData()を呼び出して再レンダリングします。

var workbook = new AsposeCells.Workbook();
var worksheet = workbook.getWorksheets().get(0);

// Fruit / Year / Amount のヘッダー行を書き込む
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);

// セル E3 に配置し、A1:C9 をソースとする「Pivot1」という名前のピボットテーブルを追加する
var pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
var pivotTable = worksheet.getPivotTables().get(pivotIndex);

// フィールドを割り当てる：Fruit を行、Year を列、Amount をデータ
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Data, "Amount");

// 表示／レイアウトのプロパティを変更する — これは表示のみの変更なので、
// PivotCache.Refresh() を介してソースデータを再読み込みする必要はない。
pivotTable.setRefreshDataOnOpeningFile(false);

// CalculateData() は、PivotCache に既に保持されているデータから、このピボットテーブルの表示
//（データとスタイル）を再レンダリングする。ソースデータは変更されていないため、
// ソースへのラウンドトリップは行われず、キャッシュされた値がワークシートのセルに
// 再計算されるだけである。
pivotTable.calculateData();

// ワークブックをディスクに保存する
workbook.save("output.xlsx");

同じPivotCacheを共有するすべてのピボットテーブルを取得する

ワークブックには、1つの共有キャッシュ上に構築された多くのピボットテーブルが含まれていることがよくあります。これらを列挙するには、例えば一括更新を実行する前や共有キャッシュの影響を診断するために、PivotCache.GetPivotTables()を使用します。このメソッドは、指定されたキャッシュに依存するすべてのPivotTableのコレクションを返します。これは2つのピボットテーブルが実際に同じPivotCacheインスタンスを共有していることを確認するための最も直接的な方法でもあります。キャッシュ参照を比較するか、GetPivotTables()が返すコレクションを反復処理してどのピボットテーブルが含まれているかを確認するだけです。次の例では、同じソース範囲上に2つのピボットテーブルを作成し、それらが同じキャッシュインスタンスを共有していることを確認し、キャッシュのピボットテーブルを列挙します。

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

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

ソースが変更されていない場合でも、呼び出すたびにソースからデータを再取得します。
呼び出しのたびに共有キャッシュ全体が更新されます。多くのピボットテーブルが1つのキャッシュを共有している場合、ピボットテーブルごとにRefreshData()を繰り返し呼び出すと、同じキャッシュが何度も再取得され、非常に低速になります。推奨される代替方法は次のとおりです。
ワークブック内のすべてのピボットテーブルを更新する → workbook.refreshAll();を使用
その一部を更新する → 1つのキャッシュに対してはpivotTable.PivotCache.Refresh();を使用。キャッシュは共有されているため、この1回の呼び出しで、そのキャッシュ上に構築されたすべてのピボットテーブルが更新されます。すでに更新済みのキャッシュ上に存在する他のピボットテーブルは、安全にスキップできます。
ピボットビュー/レイアウトのみが変更された → ソースへのラウンドトリップなしに既存のキャッシュから再レンダリングするためにpivotTable.CalculateData();を使用。次の例では、単一のキャッシュを共有する複数のピボットテーブルを持つワークブックに対する新しい効率的なパターンを示します。

let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);

// --- ソースデータを構築: Fruit / Year / Amount (ヘッダー + 9行) ---
sheet.getCells().get("A1").putValue("Fruit");
sheet.getCells().get("B1").putValue("Year");
sheet.getCells().get("C1").putValue("Amount");

sheet.getCells().get("A2").putValue("Grape");      sheet.getCells().get("B2").putValue(2020); sheet.getCells().get("C2").putValue(1000);
sheet.getCells().get("A3").putValue("Blueberry");  sheet.getCells().get("B3").putValue(2020); sheet.getCells().get("C3").putValue(2000);
sheet.getCells().get("A4").putValue("Kiwi");       sheet.getCells().get("B4").putValue(2020); sheet.getCells().get("C4").putValue(1500);
sheet.getCells().get("A5").putValue("Cherry");     sheet.getCells().get("B5").putValue(2020); sheet.getCells().get("C5").putValue(2500);
sheet.getCells().get("A6").putValue("Grape");      sheet.getCells().get("B6").putValue(2021); sheet.getCells().get("C6").putValue(3000);
sheet.getCells().get("A7").putValue("Blueberry");  sheet.getCells().get("B7").putValue(2021); sheet.getCells().get("C7").putValue(1800);
sheet.getCells().get("A8").putValue("Kiwi");       sheet.getCells().get("B8").putValue(2021); sheet.getCells().get("C8").putValue(2200);
sheet.getCells().get("A9").putValue("Cherry");     sheet.getCells().get("B9").putValue(2021); sheet.getCells().get("C9").putValue(2700);

// --- 最初のピボットテーブル (Pivot1) を配置先セル E3 に追加 ---
let idx1 = sheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
let pivotTable1 = sheet.getPivotTables().get(idx1);
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// --- 2番目のピボットテーブル (Pivot2) を同じソース範囲に追加 ---
// Pivot1 と Pivot2 は 1 つの PivotCache を共有します。
// これはまさに、テーブルごとの従来の RefreshData() が
// 非効率になるシナリオです。1つのテーブルを更新すると共有キャッシュ全体を
// 再フェッチするため、N 個のテーブルを更新すると同じ高コストのフェッチを N 回実行します。
let idx2 = sheet.getPivotTables().add("A1:C9", "E15", "Pivot2");
let pivotTable2 = sheet.getPivotTables().get(idx2);
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// --- ソースデータの複数の Amount 値を変更 ---
sheet.getCells().get("C2").putValue(5000);   // Grape  2020
sheet.getCells().get("C5").putValue(7500);   // Cherry 2020
sheet.getCells().get("C9").putValue(9500);   // Cherry 2021

// --- 旧パターン (v26.7 以前) — PivotTable.RefreshData() ---
// pivotTable1.RefreshData();  // ソースから再フェッチし、キャッシュ全体を更新
// pivotTable2.RefreshData();  // 再び再フェッチ — キャッシュはすでに最新です!
// 各呼び出しで共有キャッシュが再構築されるため、N テーブル = N 回の冗長なフェッチになります。

// --- 新しい v26.7+ パターン: キャッシュを 1 回更新し、必要に応じて再レンダリング ---
// PivotCache.Refresh() を 1 回呼び出すと、変更された値が共有キャッシュに取り込まれ、
// それを参照するすべてのピボットテーブルの表示が再計算されます。
// Pivot1 と Pivot2 は 1 つの PivotCache を共有しているため、この 1 回の呼び出しで
// 両方のテーブルが更新されます — ソースへの 2 度目のラウンドトリップは不要です。
pivotTable1.getPivotCache().refresh();

// CalculateData() は、キャッシュ内のデータからピボットテーブルの表示 (データ + スタイル)
// のみを再レンダリングします — ソースには触れません。
// ここでは API を実演するために Pivot2 に対して呼び出します: キャッシュが
// 1 回更新された後は、ソースに戻ることなく依存するテーブルを再レンダリングできます。
// ピボットテーブルの表示/レイアウト設定のみが変更され、
// キャッシュが最新の場合は、CalculateData() を単独で使用してください。
pivotTable2.calculateData();

workbook.save("output.xlsx");

どのリフレッシュAPIを使用すべきか

以下の表は、利用可能なリフレッシュAPIとそれぞれを選択するタイミングをまとめたものです。

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

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

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

Aspose.Cells は、レガシーのピボットテーブル自動書式（.xls ファイル向け）と、モダンな名前付きまたはカスタムのピボットテーブルスタイル（.xlsx、.xlsm、.xlsb ファイル向け）の両方を適用することをサポートします。呼び出すべき API は、ワークブックの読み込み元のフォーマットではなく、保存先のファイルフォーマットによって決まります。

はじめに

Aspose.Cells は、ピボットテーブル向けに 2 つの並列なスタイル API を提供します。これらの使い分けは、読み込み元のフォーマットではなく、ワークブックの保存先のフォーマットによって決まります。.xls ファイルから読み込まれたワークブックを .xlsx として再保存する場合、レガシー API ではなく、モダンなスタイル API が適用されます。

レガシーの .xls 出力の場合は、PivotTable.AutoFormatType プロパティを Aspose.Cells.Pivot.PivotTableAutoFormatType 列挙体と共に使用してください。この API は、従来の Excel でピボットテーブル向けに提供されていた自動書式ピッカーに対応します。

モダンの .xlsx、.xlsm、.xlsb 出力の場合は、2 種類のスタイル API が利用可能です。

PivotTable.PivotTableStyleType は、組み込みの名前付きスタイル（ライトテーマおよびダークテーマ。Excel 2017 で追加されたスタイルを含む）のいずれかを選択します。これらのプリセットは読み取り専用です。
PivotTable.PivotTableStyleName は、Workbook.Worksheets.TableStyles.AddPivotTableStyle(...) を通じて独自に定義したカスタムスタイルを選択します。プリセットで提供される範囲を超えて、色、罫線、フォントをカスタマイズする場合は、カスタムスタイルが必要です。

さらに、PivotTable.FormatAll(Style) は、単一の Style オブジェクトをピボットのすべてのセルに適用するショートカットであり、上記いずれかのスタイル名 API で行った設定をすべて上書きします。これは、基盤となるテーマに関係なく均一な外観が必要な場合に便利です。

レガシー XLS プリセット自動書式の適用

PivotTable.AutoFormatType は、Aspose.Cells.Pivot.PivotTableAutoFormatType 列挙体の値を受け取ります。利用可能な値は Report1 から Report10、Classic、Table1 から Table10 です。

AutoFormatType は、ワークブックが .xls として保存される場合にのみ有効です。同じワークブックが .xlsx、.xlsm、または .xlsb として保存される場合、Excel はこのプロパティを無視し、PivotTableStyleType および PivotTableStyleName の設定にフォールバックします。

次の例では、新しいワークブックを読み込み、Fruit/Year/Amount のサンプルデータを入力し、ピボットテーブルを追加して、PivotTableAutoFormatType.Report5 を適用し、結果を .xls として保存します。

列フィールドがないのはなぜですか？ Report シリーズの自動書式（Report1〜Report10、Table1〜Table10）は、従来の Excel で単一次元のピボットテーブル（行フィールドと値のみ）のために設計されたものであり、列フィールドのヘッダーに対する組み込みのスタイル設定はありません。ピボットテーブルに列フィールドが必要な場合は、代わりに下のシナリオ 2 のモダンな PivotTableStyleType プリセットを使用してください。これらはモダンな Excel が使用する二次元レイアウト向けに設計されています。

const AsposeCells = require("aspose.cells");

// シナリオ 1: レガシー XLS プリセット自動フォーマットを適用する
// 使用中の API: PivotTable.AutoFormatType
// 対象ファイル形式: .xls（レガシー）
// 完全なサンプルとデータファイルについては、https://github.com/aspose-cells/Aspose.Cells-for-.NET を参照してください

// 新しいワークブックを作成
const workbook = new AsposeCells.Workbook();

// 最初のワークシートを取得
const 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);

// セル E3 に「Pivot1」という名前のピボットテーブルをソース範囲 A1:C10 を使用して追加
const pivotIndex = sheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
const pivotTable = sheet.getPivotTables().get(pivotIndex);

// フィールドを割り当て: Fruit → 行、Year → 列、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.Report5);

// ワークブックをレガシー .xls 形式で保存
workbook.save("output.xls");

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

PivotTable.PivotTableStyleType は、Aspose.Cells.PivotTableStyleType 列挙体の値を受け取ります。この列挙体は、ライトテーマの PivotTableStyleLight1 から PivotTableStyleLight28、およびダークテーマの PivotTableStyleDark1 から PivotTableStyleDark28 を網羅しています。Excel 2017 で追加されたスタイル（ライトテーマおよびダークテーマの第二波）も、同じ列挙体からアクセスできます。

これは、モダンなファイルフォーマットに対して推奨される API です。レガシーの自動書式と異なり、ここで選択されたスタイルは Excel によって忠実にレンダリングされ、他の Office ツールとのラウンドトリップでも保持されます。

次の例では、同じ Fruit/Year/Amount データを使用して、同じピボットテーブルを作成し、PivotTableStyleDark1 を適用し、ワークブックを .xlsx として保存します。

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");

// 果物 / 年 / 金額の9つのデータ行
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(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(2020);
worksheet.getCells().get("C5").putValue(180);

worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(120);

worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(170);

worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(210);

worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(190);

worksheet.getCells().get("A10").putValue("Grape");
worksheet.getCells().get("B10").putValue(2021);
worksheet.getCells().get("C10").putValue(130);

// E3に「Pivot1」という名前のピボットテーブルを追加し、データソースはA1:C10
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");

// モダンなExcel 2007+の名前付きプリセットピボットスタイルを適用する。
// PivotTableStyleTypeは.xlsx / .xlsm / .xlsbファイル用の正しいAPIであり、
// AutoFormatTypeはこれらの形式ではExcelに無視される。
// PivotTableStyleDark1はダークテーマファミリー
// (PivotTableStyleDark1..PivotTableStyleDark28)に属し、同じ列挙型には
// 新しいExcel 2017のライト/ダークテーマ
// (PivotTableStyleLight1..Light28 / Dark1..Dark28)も含まれている。
pivotTable.setPivotTableStyleType(AsposeCells.PivotTableStyleType.PivotTableStyleDark1);

// モダンな.xlsxとして保存する — これはPivotTableStyleTypeが意味を持つ形式である。
workbook.save("output.xlsx");

カスタムピボットテーブルスタイルの定義と適用

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

Workbook.Worksheets.TableStyles.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_Cells").get("C2").putValue(100);

worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020_Cells").get("C3").putValue(200);

worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020_Cells").get("C4").putValue(300);

worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020_Cells").get("C5").putValue(400);

worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021_Cells").get("C6").putValue(500);

worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021_Cells").get("C7").putValue(600);

worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021_Cells").get("C8").putValue(700);

worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021_Cells").get("C9").putValue(800);

worksheet.getCells().get("A10").putValue("Grape");
worksheet.getCells().get("B10").putValue(2021_Cells").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.WholeTable));
let wholeTableElement = tableStyle.getTableStyleElements().get(wholeTableElementIndex_Workbook.createStyle();
wholeTableStyle.getBorders().get(AsposeCells.BorderType.TopBorder).setLineStyle(AsposeCells.CellBorderType.Thin));
wholeTableStyle.getBorders().get(AsposeCells.BorderType.TopBorder).setColor(AsposeCells.Color.Black));
wholeTableStyle.getBorders().get(AsposeCells.BorderType.BottomBorder).setLineStyle(AsposeCells.CellBorderType.Thin));
wholeTableStyle.getBorders().get(AsposeCells.BorderType.BottomBorder).setColor(AsposeCells.Color.Black));
wholeTableStyle.getBorders().get(AsposeCells.BorderType.LeftBorder).setLineStyle(AsposeCells.CellBorderType.Thin));
wholeTableStyle.getBorders().get(AsposeCells.BorderType.LeftBorder).setColor(AsposeCells.Color.Black));
wholeTableStyle.getBorders().get(AsposeCells.BorderType.RightBorder).setLineStyle(AsposeCells.CellBorderType.Thin));
wholeTableStyle.getBorders().get(AsposeCells.BorderType.RightBorder).setColor(AsposeCells.Color.Black));
wholeTableElement.setElementStyle(wholeTableStyle);

// ステップ 3: GrandTotalRow 要素を追加し、太字の赤いフォントを適用する
let grandTotalElementIndex = tableStyle.getTableStyleElements().add(AsposeCells.TableStyleElementType.GrandTotalRow));
let grandTotalElement = tableStyle.getTableStyleElements().get(grandTotalElementIndex_Workbook.createStyle();
grandTotalStyle.getFont().setIsBold(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).putValue(2020);

worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);

worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);

worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);

worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);

worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);

worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);

worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);

worksheet.getCells().get("A10").putValue("Grape");
worksheet.getCells().get("B10").putValue(2021);

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");

// ピボットテーブルのすべてのセルに強制的に適用される 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.TableStyles.AddPivotTableStyle(...)`	組み込みプリセットでは不十分な場合に使用します。`TableStyleElement.SetElementStyle(...)` を通じて設定します。
任意のフォーマット（均一な上書き）	`PivotTable.FormatAll(Style)`	ピボット全体にわたる他のすべてのスタイル設定を上書きするショートカット。

迷った場合は、.xlsx として保存し、組み込みテーマには PivotTableStyleType を、カスタムテーマには PivotTableStyleName を使用してください。

Refreshing Pivot Tables in Aspose.Cells for Node.js via C++

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

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

行領域または列領域へのフィールドの追加

PivotTable.AddFieldToArea(PivotFieldType fieldType, string fieldName) メソッドは、ソースデータのベースフィールドを 4 つのピボット領域のいずれかに移動します。fieldType 引数は、次の PivotFieldType 値のいずれかを受け入れます。

Row — 左側に縦方向に配置されるフィールド
Column — 上部に横方向に配置されるフィールド
Data — 値が集計されるフィールド
Page — レポートフィルターとして使用されるフィールド

フィールドを追加した後は、PivotTable.RowFields プロパティと PivotTable.ColumnFields プロパティを介してアクセスできます。各プロパティは PivotFieldCollection を返します。RowFields のインデックス 0 のフィールドは最も外側の行フィールドであり、以降のインデックスはその内側にネストされているフィールドを表します。同じインデックスの規則が ColumnFields にも適用されます。

フィールドのネスト順序は重要です。最初に Category を行領域に追加し、次に Item を追加すると、外側のグループが Category で内側のグループが Item となるピボットが生成されます。順序を逆にすると階層も逆になります。

ピボットフィールドの小計

PivotField.SetSubtotals(PivotFieldSubtotalType subtotalType, bool shown) メソッドは、ピボットフィールドに表示される小計行を制御します。各呼び出しは、単一の小計タイプのみを独立して切り替えます。shown = true を渡すと小計が表示され、shown = false を渡すと非表示になります。各呼び出しは 1 つのタイプにのみ影響を与えるため、異なる subtotalType 値でメソッドを複数回呼び出すことで、小計のカスタムサブセットを構築できます。

PivotFieldSubtotalType 列挙型は、利用可能な小計の種類を定義します。

Automatic — Aspose.Cells がデフォルトの選択（通常、数値フィールドでは Sum）を適用します
None — すべての小計行を抑制します
Sum
Count
Average
Max
Min
Product
StdDev
StdDevp
Var
Varp

小計は、行領域（または列領域）に 2 つ以上のピボットフィールドがある場合にのみ表示されます。単一のフィールドではその間に集計する対象がないため、そのケースでは SetSubtotals の呼び出しは目に見える効果を持ちません。したがって、この記事ではすべての例で 2 つの行フィールド（外側 Category、内側 Item）を配置し、各 Category グループ間の小計の境界が見えるようにしています。

シナリオ 1 — 自動（デフォルト）の小計

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");

シナリオ 2 — すべての小計の抑制（None）

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

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");
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");

const categoryField = pivotTable.getRowFields().get(0);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.None, true);
pivotTable.calculateData();

workbook.save("output_none.xlsx");

シナリオ 3 — カスタム小計サブセット（Sum + Average）

単一の小計タイプに限定されるわけではありません。各 SetSubtotals 呼び出しは 1 つのタイプに対して独立して動作するため、Sum で 1 回、Average で 1 回とメソッドを 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");

まとめ

上記の 3 つのシナリオは、データセットとピボットテーブルの構造が共通しています。相違点は、外側の Category 行フィールドに適用する SetSubtotals 呼び出しだけです。「2 フィールドルール」を忘れないでください。領域にフィールドが 1 つしかない場合は小計を挟む対象が存在しないため、SetSubtotals の効果を視覚的に確認したいときは、行領域または列領域に必ず 2 つ以上のフィールドを配置してください。

Nodejscpp: Aspose.Cells for Node.js via C++ でピボットテーブルの値フィールドを管理する

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

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

基本フィールドをデータ（値）領域に追加することは、ピボットテーブルがソースデータをどのように集計するかを形作る最初のステップです。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");

// A1:D1 のヘッダー
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");

// A2:D9 のデータ行（j で分岐するネストされたループを使用）
for (let i = 1; i <= 8; i++) {
 for (let j = 0; j < 4; j++) {
 switch (j) {
 case 0:
 worksheet.getCells().get(i, j).putValue(i <= 4 ? "Fruit" : "Vegetable");
 break;
 case 1:
 if (i === 1 || i === 2) worksheet.getCells().get(i, j).putValue("Apple");
 else if (i === 3 || i === 4) worksheet.getCells().get(i, j).putValue("Banana");
 else if (i === 5 || i === 6) worksheet.getCells().get(i, j).putValue("Carrot");
 else worksheet.getCells().get(i, j).putValue("Daikon");
 break;
 case 2:
 worksheet.getCells().get(i, j).putValue(2020 + ((i - 1) % 2));
 break;
 case 3:
 if (i === 1) worksheet.getCells().get(i, j).putValue(100);
 else if (i === 2) worksheet.getCells().get(i, j).putValue(150);
 else if (i === 3) worksheet.getCells().get(i, j).putValue(80);
 else if (i === 4) worksheet.getCells().get(i, j).putValue(90);
 else if (i === 5) worksheet.getCells().get(i, j).putValue(50);
 else if (i === 6) worksheet.getCells().get(i, j).putValue(60);
 else if (i === 7) worksheet.getCells().get(i, j).putValue(40);
 else worksheet.getCells().get(i, j).putValue(45);
 break;
 }
 }
}

// F3 に PivotTable1 という名前のピボットテーブルを追加
const pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1", true, false);
const pivotTable = worksheet.getPivotTables().get(pivotIndex);

// ピボットレイアウト: 行に Category と Item、列に Year、データフィールドに Amount
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Data, "Amount");

pivotTable.calculateData();
workbook.save("output_drag.xlsx");

集計関数の変更

データ領域に配置された各フィールドは内部的に PivotField インスタンスとしてラップされ、その getFunction() プロパティは ConsolidationFunction 列挙型の値を返します。同じ setFunction() セッターを使用すると、Sum、Count、Average、Max、Min、Product、StdDev、StdDevp、Var、Varp などの利用可能な集計を切り替えることができます。

集計関数の変更は集計結果のみに影響し、ソース列は変更されません。

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

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");

for (let i = 1; i <= 8; i++)
{
 for (let j = 0; j <= 3; j++)
 {
 if (j == 0)
 {
 worksheet.getCells().get(i, j).putValue(i <= 5 ? "Fruit" : "Vegetable");
 }
 else if (j == 1)
 {
 let items = ["Apple", "Apple", "Banana", "Banana", "Carrot", "Carrot", "Daikon", "Daikon"];
 worksheet.getCells().get(i, j).putValue(items[i - 1]);
 }
 else if (j == 2)
 {
 let years = [2020, 2021, 2020, 2021, 2020, 2021, 2020, 2021];
 worksheet.getCells().get(i, j).putValue(years[i - 1]);
 }
 else
 {
 let amounts = [100, 150, 80, 90, 50, 60, 40, 45];
 worksheet.getCells().get(i, j).putValue(amounts[i - 1]);
 }
 }
}

let pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1", true, false);
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");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

let countField = pivotTable.getDataFields().get(1);
countField.setFunction(AsposeCells.ConsolidationFunction.Count);

pivotTable.calculateData();

workbook.save("output_function.xlsx");

値フィールドを行または列の軸にプロットする

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

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

以下のシナリオでは、上記で説明した各機能を同じピボット構造に対して実証する 3 つのエンドツーエンドの例を順に紹介します。

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");

let categories = ["Fruit", "Fruit", "Fruit", "Fruit", "Vegetable", "Vegetable", "Vegetable", "Vegetable"];
let items = ["Apple", "Apple", "Banana", "Banana", "Carrot", "Carrot", "Daikon", "Daikon"];
let years = [2020, 2021, 2020, 2021, 2020, 2021, 2020, 2021];
let amounts = [100, 150, 80, 90, 50, 60, 40, 45];

for (let i = 1; i <= 8; i++)
{
 for (let j = 0; j <= 3; j++)
 {
 if (j == 0) worksheet.getCells().get(i, j).putValue(categories[i - 1]);
 else if (j == 1) worksheet.getCells().get(i, j).putValue(items[i - 1]);
 else if (j == 2) worksheet.getCells().get(i, j).putValue(years[i - 1]);
 else worksheet.getCells().get(i, j).putValue(amounts[i - 1]);
 }
}

let pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1", true, false);
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");
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");

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

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

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

はじめに

フィルターフィールドは、ピボット本体が表示するソースデータのどのサブセットを制御するピボットフィールドです。エンドユーザーは、Excel でレンダリングされたピボットの上部にあるドロップダウンとしてそれを表示し、利用可能なフィルター項目のいずれかを選択すると、そのフィルター項目に属するレコードのみが集計されるようにピボット本体が再構築されます。ピボットフィールドは、PivotFieldType.Row、PivotFieldType.Column、または PivotFieldType.Data ではなく PivotFieldType.Page として登録されたときにフィルターフィールドになります。

フィルターフィールドは2つの動作で動作できます。デフォルトの単一選択動作では、一度に1つのフィルター項目のみが表示されるため、ピボット本体は正確に1つのサブセットを集計します。複数選択動作では、フィールドはチェックボックスリストを公開し、ピボット本体はチェックされたすべてのフィルター項目の和集合を集計します。同じソースフィールドは、単一のプロパティを切り替えることによって、これらの動作間で前後に移動できます。

Aspose.Cells for Node.js via C++ は、フィルターフィールドを登録するための2つの同等の方法を公開しています。高レベル API は PivotTable.addFieldToArea(PivotFieldType.Page, "fieldName") であり、ソース列名を受け取り、単一の呼び出しでフィールドを追加します。下位レベル API は PivotTable.pageFields.add(PivotField) であり、すでに PivotField 参照を保持していて、同じフィールドインスタンスをフィルター領域に追加したい場合に使用されます。両方の API は最終的に同じ PageFields コレクションに格納され、この記事の残りでは、それらの間を選択する方法と各フィルタリングモードを駆動する方法を示します。

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

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

addFieldToArea を使用したフィルターフィールドの追加

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

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行のサンプルデータ（Fruit、Year、Amount）を入力する
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);

// フィールドをそれぞれのエリアに追加する：Fruitは行、Amountはデータ、Yearはページフィールド
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");

// ピボットテーブルのデータを更新して計算する
pivotTable.calculateData();

// ワークブックを保存する
workbook.save("pageFieldSample.xlsx");

pageFields.add を使用したフィルターフィールドの追加

すでに PivotField インスタンスを操作している場合は、それを PivotTable.pageFields.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 整数が、ピボット本体を駆動するフィルター項目を選択します。特定のインデックスを割り当てるとその項目が選択されます。特別なセンチネル値 0x7FFD(10進数で 32765)を割り当てると、フィルタがクリアされ、すべてのフィルター項目が一度に集計されます。単一選択がデフォルトです。明示的に有効化する必要はありません。

すべての項目の表示

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

let workbook = new AsposeCells.Workbook();
let 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");

let data = [
    ["Apple", 2022, 100],
    ["Apple", 2023, 150],
    ["Banana", 2022, 80],
    ["Banana", 2023, 120],
    ["Cherry", 2022, 200],
    ["Cherry", 2023, 250]
];

for (let r = 0; r < data.length; r++) {
    for (let c = 0; c < data[r].length; c++) {
        sheet.getCells().get(r + 1, c).putValue(data[r][c]);
    }
}

// E3 にピボットテーブルを作成
let pivotTables = sheet.getPivotTables();
let index = pivotTables.add("=A1:C7", "E3", "PivotTable1");
let 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").putValue("Fruit");
cells.get("B1").putValue("Year");
cells.get("C1").putValue("Amount");

cells.get("A2").putValue("Apple");
cells.get("B2").putValue("2020");
cells.get("C2").putValue("100");

cells.get("A3").putValue("Apple");
cells.get("B3").putValue("2021");
cells.get("C3").putValue("150");

cells.get("A4").putValue("Banana");
cells.get("B4").putValue("2020");
cells.get("C4").putValue("200");

cells.get("A5").putValue("Banana");
cells.get("B5").putValue("2021");
cells.get("C5").putValue("250");

// E3にピボットテーブルを追加
var pivotTables = sheet.getPivotTables();
var pivotIndex = pivotTables.add("A1:C5", "E3", "PivotTable1");
var pivotTable = pivotTables.get(pivotIndex);

// フィールドを追加：Fruit→行、Amount→データ、Year→ページ
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つのプロパティを公開しています。PivotField.isMultipleItemSelectionAllowed は、複数選択 UI がまったく有効になる前に true に設定する必要があります。有効化された後、PivotItem.isHidden はチェックボックスリストに表示される項目を制御するため、すべての項目を表示するか、特定の項目のみをホワイトリストに登録することができます。

以下のコードは、シナリオ 1a で構築された同じ Year フィルターフィールドで複数選択を有効化し、2つのパターンを示します。パート A では、すべてのエントリの isHidden を false のままにしておくことで、すべてのフィルター項目を公開します。一方、パート B では、選択したソース値のみをホワイトリストに登録し、switch (pivotItems[i].getStringValue()) ブロックを介してその他すべてを非表示にします。

let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);
let cells = sheet.getCells();

// サンプルデータ：果物 | 年 | 数量
cells.get(0, 0).putValue("Fruit");
cells.get(0, 1).putValue("Year");
cells.get(0, 2).putValue("Amount");

let 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]));
}

let pivotSheet = workbook.getWorksheets().add("Pivot");
let pivots = pivotSheet.getPivotTables();
let pivotIndex = pivots.add("E3", "A1:C10", "PivotTable1");
let pivotTable = pivots.get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");

// ページフィールドで複数選択を有効にする
pivotTable.getPageFields().get(0).setIsMultipleItemSelectionAllowed(true);

// パートA — すべてのアイテムを選択する（すべてのアイテムを表示する）
let pivotItems = pivotTable.getPageFields().get(0).getPivotItems();
for (let i = 0; i < pivotItems.getCount(); i++) {
    pivotItems.get(i).setIsHidden(false);
}

// パートB — ソース値で特定のアイテムのみを選択する
for (let i = 0; i < pivotItems.getCount(); i++) {
    switch (pivotItems.get(i).getStringValue()) {
        case "2020":
        case "grape":
        case "blueberry":
            pivotItems.get(i).setIsHidden(false);
            break;
        default:
            pivotItems.get(i).setIsHidden(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.pageFields.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 つの項目が表示されたままになるようにし、保存されたワークブックがすべてのマシンで確実に開けるようにしてください。

Nodejscpp: ワークシートからのピボットテーブルの削除

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

Aspose.Cells for Node.js via C++は、ワークシートからピボットテーブルを削除または除去する機能を提供します。ピボットテーブルオブジェクトまたは位置を使用して削除できます。 Worksheet.getPivotTables().remove(pivotTable)メソッドを使用してピボットテーブルオブジェクトから削除し、Worksheet.getPivotTables().removeAt(index, keepData)メソッドを使用してピボットテーブルコレクション内の位置から削除してください。

Aspose.Cells for Node.js via C++を使ったワークシートからのピボットテーブル削除方法

次のサンプルコードでは、ワークシートから2つのピボットテーブルを削除する方法が示されています。最初にWorksheet.getPivotTables().remove(pivotTable)メソッドを使用してピボットテーブルを削除し、次にWorksheet.getPivotTables().removeAt(index, keepData)メソッドを使用してピボットテーブルを削除します。

Nodejscpp: ピボットテーブルをODSファイルに保存する

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

Aspose.Cells for Node.js via C++は、ピボットテーブルをODSファイルに保存する機能を提供します。既存のピボットテーブルを含むワークブックを変換するか、新しいピボットテーブルを作成してODS形式で保存してください。保存前に PivotTable.calculateData を呼び出し、出力されるODSファイルにピボットテーブルがレンダリングされるようにしてください。次のコードスニペットは、ピボットテーブルをODSファイルに保存する例です。

サンプルコード

上記のコードで生成された出力ファイルが添付されています。

出力ODSファイル

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

Nodejscpp: ピボットテーブルの書式設定

ピボットテーブルの外観

ピボットテーブルフォーマットオプションの設定方法

自動フォーマットタイプの設定方法

フォーマットオプションの設定方法

見た目と手触りの書式設定

ピボットフィールドのフォーマットオプションの設定方法

行/列/ページフィールドのフォーマット設定方法

データフィールドのフォーマット設定方法

ピボットフィールドをクリアする方法

Nodejscpp: ピボットテーブルとピボットチャートの作成

Aspose.Cells for Node.js via C++を使用してピボットテーブルとチャートを追加する。

Aspose.Cells for Node.js via C++の使用準備。

Aspose.Cells for Node.js via C++を使用してピボットテーブルを追加する方法。

Aspose.Cells for Node.js via C++ライブラリを使用してピボットチャートを追加する方法。

Nodejscpp: ピボットテーブルとソースデータ

Pivot Tableのソースデータ

ピボットテーブルのデータソースを変更する

Nodejscpp: ピボットテーブルに計算フィールドを追加する

可能な使用シナリオ

Excelでピボットテーブルに計算フィールドを追加する方法

Aspose.Cells for Node.js via C++ライブラリを使ったピボットテーブルに計算フィールドを追加する方法

サンプルコード

Nodejscpp: Aspose.Cells for Node.js via C++でピボットテーブルを更新する

はじめに

必要なインポート

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

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

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

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

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

同じPivotCacheを共有するすべてのピボットテーブルを取得する

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

どのリフレッシュAPIを使用すべきか

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

はじめに

レガシー XLS プリセット自動書式の適用

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

カスタムピボットテーブルスタイルの定義と適用

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

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

関連記事

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

行領域または列領域へのフィールドの追加

ピボットフィールドの小計

シナリオ 1 — 自動（デフォルト）の小計

シナリオ 2 — すべての小計の抑制（None）

シナリオ 3 — カスタム小計サブセット（Sum + Average）

まとめ

関連記事

Nodejscpp: Aspose.Cells for Node.js via C++ でピボットテーブルの値フィールドを管理する

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

集計関数の変更

値フィールドを行または列の軸にプロットする

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

はじめに

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

addFieldToArea を使用したフィルターフィールドの追加

pageFields.add を使用したフィルターフィールドの追加

単一選択フィルタリング(1つのフィルター項目の表示)

すべての項目の表示

1つの特定の項目の表示

複数選択フィルタリング

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

Nodejscpp: ワークシートからのピボットテーブルの削除

Aspose.Cells for Node.js via C++を使ったワークシートからのピボットテーブル削除方法

Nodejscpp: ピボットテーブルをODSファイルに保存する

サンプルコード

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

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

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