Documentation – ピボットテーブル

Pythonjava: ピボットテーブルを作成する

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

ピボットテーブルを作成する

Aspose.Cells for Python via Javaには、ピボットテーブルを作成する機能が提供されています。Aspose.Cellsを使用してピボットテーブルを作成するには、以下の手順に従ってください：

CellオブジェクトのsetValueプロパティを使用して、ワークシートセルにいくつかのデータを追加します。このデータはピボットテーブルのデータソースとして使用されます。
Worksheetオブジェクトにカプセル化されたPivotTableCollection addメソッドを呼び出して、ワークシートにピボットテーブルを追加します。
PivotTableオブジェクトをPivotTableCollectionからPivotTableインデックスを渡してアクセスします。
上記で説明したピボットテーブルオブジェクトのいずれかをPivotTableCollectionオブジェクトで使用してピボットテーブルを管理します。

次のコードスニペットは、Aspose.Cells APIを使用してピボットテーブルを作成する方法を示しています。

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

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

時々、ピボットテーブルセルのフォーマットが必要です。たとえば、ピボットテーブルセルに背景色を適用したい場合。Aspose.Cellsは、この目的に使用できる2つのメソッドPivotTable.formatAll()とPivotTable.format()を提供しています。

PivotTable.formatAll()はピボットテーブル全体にスタイルを適用し、PivotTable.format()はピボットテーブルの単一セルにスタイルを適用します。

以下のサンプルコードは、ピボットテーブル全体をライトブルーの色でフォーマットし、次に2番目の表行を黄色でフォーマットします。

コードを実行する前の入力ピボットテーブル

コードを実行した後の出力ピボットテーブル

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

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

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

はじめに

ピボットテーブルの更新は、単一の操作であることはほとんどありません。舞台裏では、Aspose.Cells は元のソースデータからワークシートに表示される値へと接続する階層的なデータチェーンを維持しています。このチェーンを理解することが、状況に応じて適切な更新 API を選択する鍵となります。 4 層のデータチェーンは以下のとおりです。

データソース — 生の値が格納されている、元のワークシート範囲、データベースクエリ、または統合範囲。
PivotCache — ソースデータのメモリ内スナップショット。すべてのピボットテーブルは PivotCache の上に構築され、すべてのデータの収集と集計はここで行われます。
PivotTable — 行、列、値、フィルタの各フィールドを定義するビューオブジェクト。PivotTable は PivotCache からのみデータを読み取り、データソースから直接読み取ることはありません。
Cells — PivotTable が計算結果とスタイルを描画する先のワークシートの Cells。

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

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

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

クイックスタート

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

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType
# 新しいワークブックを作成
workbook = Workbook()
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」
pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
# ピボットフィールドを割り当て：Fruitを行、Yearを列、Amountをデータ
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Column, "Year")
pivotTable.addFieldToArea(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")
jpype.shutdownJVM()

本記事の以降のセクションでは、より限定的な API を選択すべきケースについて説明します。

必要なインポート

本記事のすべての Python サンプルは、ピボット型が aspose.cells.pivot 名前空間に存在するため、次のインポートに依存しています。

import jpype
import aspose.cells as cells jpype モジュールは JVM をブートストラップするために使用され、aspose.cells は全体で使用される workbook/worksheet/cell/pivot 型を公開します。

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

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

using Aspose.Cells;
Workbook workbook = new Workbook("input.xlsx");
workbook.RefreshAll();
workbook.Save("output.xlsx");

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

特定のワークシート上にあるピボットテーブルだけを更新したい場合があります。たとえば、他のワークシート上のピボットテーブルは無関係で変更すべきではないことが分かっている場合です。このような場合のために、Aspose.Cells は単一の Worksheet インスタンスを対象とする Worksheet.refreshPivotTables() を提供しています。

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType
workbook = Workbook()
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)
pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
pivotTable.addFieldToArea(PivotFieldType.ROW, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.COLUMN, "Year")
pivotTable.addFieldToArea(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")
jpype.shutdownJVM()

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

単一のピボットテーブルを細かく制御したい場合は、キャッシュベースの API に 2 つの選択肢があります。どちらを選ぶかは、実際に何が変わったか、つまり基になるソースデータなのか、ピボットテーブル自身のビュー/レイアウト設定のみなのかによって異なります。

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

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

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

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

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType
workbook = Workbook()
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)
# "Pivot1" という名前のピボットテーブルを追加し、配置先はセル E3、ソースは A1:C9
pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
# フィールドを割り当てる：Fruit を行、Year を列、Amount をデータ
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Column, "Year")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
# 表示/レイアウトのプロパティを変更する — これは表示のみの変更であり、
# PivotCache.Refresh() を介してソースデータを再読み込みする必要はない。
pivotTable.setRefreshDataOnOpeningFile(False)
# CalculateData() は、PivotCache に保持されているデータから
# このピボットテーブルの表示（データ + スタイル）を再描画する。ソースデータが変更されていないため、
# ソースへのラウンドトリップは行われず、キャッシュされた値のみが
# ワークシートのセルに再計算される。
pivotTable.calculateData()
# ワークブックをディスクに保存する
workbook.save("output.xlsx")
jpype.shutdownJVM()

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

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

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

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

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

次の表は、利用可能な更新 API とそれぞれの選択基準をまとめたものです。

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

よくある落とし穴

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

Pythonjava: Aspose.Cells for Python 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.setPivotTableStyleType(int) は、組み込みの名前付きスタイル(明テーマ・暗テーマ、Excel 2017 で追加されたスタイルを含む)を選択します。これらのプリセットは読み取り専用です。
pivotTable.setPivotTableStyleName(String) は、workbook.getWorksheets().getTableStyles().addPivotTableStyle(String) で定義したカスタムスタイルを選択します。プリセットで提供される範囲を超えて、色、罫線、フォントを変更したい場合は、カスタムスタイルが必要です。さらに、pivotTable.formatAll(Style) は、単一の Style オブジェクトをピボットのすべてのセルに適用し、上記のいずれかのスタイル名 API で設定された内容を上書きするショートカットです。基になるテーマに関係なく均一な外観が必要な場合に便利です。

レガシー XLS プリセット自動フォーマットの適用

ピボットテーブルの setAutoFormatType メソッドは、com.aspose.cells.pivot.PivotTableAutoFormatType 列挙の値を受け付けます。使用可能な値は REPORT_1 から REPORT_10、CLASSIC、および TABLE_1 から TABLE_10 です。次の例では、新しいワークブックを読み込み、Fruit/Year/Amount のサンプルデータを設定し、ピボットテーブルを追加して PivotTableAutoFormatType.REPORT_5 を適用し、結果を .xls として保存します。

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

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, PivotFieldType, PivotTableAutoFormatType
# シナリオ 1: レガシー XLS プリセット自動フォーマットを適用する
# 使用中の API: PivotTable.AutoFormatType
# ターゲットファイル形式: .xls(レガシー)
# 完全なサンプルとデータファイルについては、https://github.com/aspose-cells/Aspose.Cells-for-.NET を参照してください
# 新しいワークブックを作成する
workbook = Workbook()
# 最初のワークシートを取得する
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 に、ソース範囲 A1:C10 を使用して「Pivot1」という名前のピボットテーブルを追加する
pivotIndex = sheet.getPivotTables().add("A1:C10", "E3", "Pivot1")
pivotTable = sheet.getPivotTables().get(pivotIndex)
# フィールドを割り当てる: Fruit → 行、Amount → データ
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
# レガシー XLS プリセット自動フォーマット「Report5」を適用する
# 注: このプロパティは .xls として保存する場合にのみ意味を持ちます。
# .xlsx/.xlsm/.xlsb として保存する場合、Excel は AutoFormatType を無視し、
# PivotTableStyleType / PivotTableStyleName で指定されたものを使用します。
pivotTable.setAutoFormatType(PivotTableAutoFormatType.Report5)
# ワークブックをレガシー .xls 形式で保存する
workbook.save("output.xls")
jpype.shutdownJVM()

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

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

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

workbook.getWorksheets().getTableStyles().addPivotTableStyle(String name) を使用して、ワークブックの TableStyles コレクションにカスタムスタイルを追加します。これにより、新しく作成されたスタイルのインデックスが返されます。
tableStyle.getTableStyleElements().add(TableStyleElementType) で要素(例: WHOLE_TABLE や GRAND_TOTAL_ROW)を追加し、tableStyleElement.setElementStyle(Style) で各要素に Style を割り当てることで、スタイルを構成します。
pivotTable.setPivotTableStyleName(String) をスタイル名で呼び出して、カスタムスタイルをピボットに適用します。ここでは setPivotTableStyleType を使用しないでください。このメソッドは組み込みプリセットを選択するためのものです。

setPivotTableStyleName と setPivotTableStyleType は互いに置き換え可能ではありません。組み込みプリセットには setPivotTableStyleType を、addPivotTableStyle を使用して定義したカスタムスタイルには setPivotTableStyleName を使用してください。両方とも設定しても問題ありませんが、意図したソースと一致する方のみがレンダリングされます。

使用可能な TableStyleElementType の値には、WHOLE_TABLE、FIRST_ROW、LAST_ROW、FIRST_COLUMN、LAST_COLUMN、GRAND_TOTAL_ROW、GRAND_TOTAL_COLUMN、PAGE_FIELD_LABELS、および PAGE_FIELD_VALUES が含まれます。次の例では、WHOLE_TABLE に細い黒い罫線、GRAND_TOTAL_ROW に太字の赤いフォントを持つカスタムピボットスタイルを定義し、setPivotTableStyleName で適用して .xlsx として保存します。

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat
from asposecells.api import PivotFieldType, TableStyleElementType, BorderType, CellBorderType
from java.awt import Color
workbook = Workbook()
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」という名前で追加
pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
pivotTable.addFieldToArea(PivotFieldType.ROW, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.COLUMN, "Year")
pivotTable.addFieldToArea(PivotFieldType.DATA, "Amount")
# ステップ 1: 新しいカスタムピボットテーブルスタイルを登録し、そのインデックスを取得
styleIndex = workbook.getWorksheets().getTableStyles().addPivotTableStyle("CustomPivotStyle")
tableStyle = workbook.getWorksheets().getTableStyles().get(styleIndex)
# ステップ 2: WholeTable 要素を追加し、4辺すべてに細い黒の罫線を適用
wholeTableElementIndex = tableStyle.getTableStyleElements().add(TableStyleElementType.WHOLE_TABLE)
wholeTableElement = tableStyle.getTableStyleElements().get(wholeTableElementIndex)
wholeTableStyle = workbook.createStyle()
wholeTableStyle.getBorders().get(BorderType.TOP_BORDER).setLineStyle(CellBorderType.THIN)
wholeTableStyle.getBorders().get(BorderType.TOP_BORDER).setColor(Color.BLACK)
wholeTableStyle.getBorders().get(BorderType.BOTTOM_BORDER).setLineStyle(CellBorderType.THIN)
wholeTableStyle.getBorders().get(BorderType.BOTTOM_BORDER).setColor(Color.BLACK)
wholeTableStyle.getBorders().get(BorderType.LEFT_BORDER).setLineStyle(CellBorderType.THIN)
wholeTableStyle.getBorders().get(BorderType.LEFT_BORDER).setColor(Color.BLACK)
wholeTableStyle.getBorders().get(BorderType.RIGHT_BORDER).setLineStyle(CellBorderType.THIN)
wholeTableStyle.getBorders().get(BorderType.RIGHT_BORDER).setColor(Color.BLACK)
wholeTableElement.setElementStyle(wholeTableStyle)
# ステップ 3: GrandTotalRow 要素を追加し、太字の赤いフォントを適用
grandTotalElementIndex = tableStyle.getTableStyleElements().add(TableStyleElementType.GRAND_TOTAL_ROW)
grandTotalElement = tableStyle.getTableStyleElements().get(grandTotalElementIndex)
grandTotalStyle = workbook.createStyle()
grandTotalStyle.getFont().setBold(True)
grandTotalStyle.getFont().setColor(Color.RED)
grandTotalElement.setElementStyle(grandTotalStyle)
# ステップ 4: カスタムスタイルを名前で適用(組み込みプリセット用の PivotTableStyleType では無い)
pivotTable.setPivotTableStyleName("CustomPivotStyle")
workbook.save("output.xlsx")
jpype.shutdownJVM()

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

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

formatAll は setPivotTableStyleType と setPivotTableStyleName の両方を上書きします。ピボット全体でテーマ非依存の均一な外観が必要な場合にのみ使用してください。

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

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, Style
from asposecells.api import Color
from asposecells.api import PivotTable, PivotFieldType
from asposecells.api import BorderType, CellBorderType, BackgroundType
# シナリオ 4: FormatAll を使用してすべてのピボットテーブルセルに単一のスタイルを適用
# 使用中の API: PivotTable.FormatAll(Style)
# ターゲット形式: .xlsx
# GitHub リファレンス: Aspose.Cells-for-.NET リポジトリを参照 — ピボットテーブルのスタイル設定例
workbook = Workbook()
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"
pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
# ピボットフィールドを割り当て: Fruit -> 行エリア、Year -> 列エリア、Amount -> データエリア
pivotTable.addFieldToArea(PivotFieldType.ROW, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.COLUMN, "Year")
pivotTable.addFieldToArea(PivotFieldType.DATA, "Amount")
# ピボットテーブルのすべてのセルに強制適用されるスタイルを構築
style = workbook.createStyle()
style.setForegroundColor(Color.YELLOW)
style.setPattern(BackgroundType.SOLID)
style.getFont().setIsBold(True)
style.getFont().setColor(Color.DARK_BLUE)
style.getBorders().get(BorderType.TOP_BORDER).setLineStyle(CellBorderType.THIN)
style.getBorders().get(BorderType.TOP_BORDER).setColor(Color.BLACK)
style.getBorders().get(BorderType.BOTTOM_BORDER).setLineStyle(CellBorderType.THIN)
style.getBorders().get(BorderType.BOTTOM_BORDER).setColor(Color.BLACK)
style.getBorders().get(BorderType.LEFT_BORDER).setLineStyle(CellBorderType.THIN)
style.getBorders().get(BorderType.LEFT_BORDER).setColor(Color.BLACK)
style.getBorders().get(BorderType.RIGHT_BORDER).setLineStyle(CellBorderType.THIN)
style.getBorders().get(BorderType.RIGHT_BORDER).setColor(Color.BLACK)
# FormatAll を適用: この単一のスタイルをピボットテーブルのすべてのセルに強制し、
# 以前に設定された PivotTableStyleType / PivotTableStyleName をすべて上書きします
pivotTable.formatAll(style)
# ワークブックを最新の .xlsx 形式で保存
workbook.save("output.xlsx")
jpype.shutdownJVM()

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

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

対象ファイル形式	使用する API	メモ
`.xls`(レガシー)	`pivotTable.setAutoFormatType(int)`	`com.aspose.cells.pivot.PivotTableAutoFormatType` の値(例: `REPORT_1`～`REPORT_10`、`CLASSIC`、`TABLE_1`～`TABLE_10`)。モダン形式で保存する場合は無視されます。
`.xlsx` / `.xlsm` / `.xlsb`(モダン、組み込みスタイル)	`pivotTable.setPivotTableStyleType(int)`	`com.aspose.cells.PivotTableStyleType` の値(明テーマ/暗テーマ、Excel 2017 の追加を含む)。
`.xlsx` / `.xlsm` / `.xlsb`(モダン、カスタムスタイル)	`pivotTable.setPivotTableStyleName(String)` + `tableStyles.addPivotTableStyle(String)`	組み込みプリセットでは不十分な場合に使用します。`tableStyleElement.setElementStyle(Style)` で構成します。
任意の形式(均一な上書き)	`pivotTable.formatAll(Style)`	ピボット全体の他のすべてのスタイル設定を上書きするショートカット。
迷う場合は、`.xlsx` として保存し、組み込みテーマには `setPivotTableStyleType` を、カスタムテーマには `setPivotTableStyleName` を使用してください。

Pythonjava: Aspose.Cells for Python 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 の呼び出しは目に見える効果を持ちません。そのため、この記事のすべての例では2つの行フィールド（外側が Category、内側が Item）を配置し、各 Category グループ間の小計の境界が見えるようにしています。

Scenario 1 — Automatic (Default) Subtotals

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

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, PivotTable, PivotField, PivotFieldType, PivotFieldSubtotalType
workbook = Workbook()
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)
pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
pivotTable.addFieldToArea(PivotFieldType.ROW, "Category")
pivotTable.addFieldToArea(PivotFieldType.ROW, "Item")
pivotTable.addFieldToArea(PivotFieldType.COLUMN, "Year")
pivotTable.addFieldToArea(PivotFieldType.DATA, "Amount")
categoryField = pivotTable.getRowFields().get(0)
categoryField.setSubtotals(PivotFieldSubtotalType.AUTOMATIC, True)
pivotTable.calculateData()
workbook.save("output_automatic.xlsx")
jpype.shutdownJVM()

Scenario 2 — Suppressing All Subtotals (None)

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

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType, PivotFieldSubtotalType
workbook = Workbook()
worksheet = workbook.getWorksheets().get(0)
worksheet.setName("Data")
headers = ["Category", "Item", "Year", "Amount"]
for j in range(len(headers)):
    worksheet.getCells().get(0, j).putValue(headers[j])
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 i in range(len(data)):
    for j in range(len(data[0])):
        worksheet.getCells().get(i + 1, j).putValue(data[i][j])
pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
pivotTable.addFieldToArea(PivotFieldType.ROW, "Category")
pivotTable.addFieldToArea(PivotFieldType.ROW, "Item")
pivotTable.addFieldToArea(PivotFieldType.COLUMN, "Year")
pivotTable.addFieldToArea(PivotFieldType.DATA, "Amount")
categoryField = pivotTable.getRowFields().get(0)
categoryField.setSubtotals(PivotFieldSubtotalType.NONE, True)
pivotTable.calculateData()
workbook.save("output_none.xlsx")
jpype.shutdownJVM()

Scenario 3 — Custom Subtotal Subset (Sum + Average)

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

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotTableCollection, PivotTable, PivotFieldType, PivotField, PivotFieldSubtotalType
workbook = Workbook()
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)
pivotTables = worksheet.getPivotTables()
pivotIndex = pivotTables.add("A1:D9", "F3", "PivotTable1")
pivotTable = pivotTables.get(pivotIndex)
pivotTable.addFieldToArea(PivotFieldType.Row, "Category")
pivotTable.addFieldToArea(PivotFieldType.Row, "Item")
pivotTable.addFieldToArea(PivotFieldType.Column, "Year")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
categoryField = pivotTable.getRowFields().get(0)
categoryField.setSubtotals(PivotFieldSubtotalType.Sum, True)
categoryField.setSubtotals(PivotFieldSubtotalType.Average, True)
pivotTable.calculateData()
workbook.save("output_custom.xlsx")
jpype.shutdownJVM()

Recap

Pythonjava: Aspose.Cells for Python via Java の値フィールド

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

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

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

import aspose.cells as ac
from aspose.cells.pivot import PivotFieldType
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"
headers = ["Category", "Item", "Year", "Amount"]
for j, h in enumerate(headers):
    worksheet.cells.get(0, j).put_value(h)
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 i, row in enumerate(data):
    for j, val in enumerate(row):
        worksheet.cells.get(i + 1, j).put_value(val)
pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1", True, False)
pivot_table = worksheet.pivot_tables[pivot_index]
pivot_table.add_field_to_area(PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(PivotFieldType.DATA, "Amount")
pivot_table.calculate_data()
workbook.save("output_drag.xlsx")

集計関数の変更

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

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

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

import aspose.cells as ac
from aspose.cells.pivot import PivotFieldType, ConsolidationFunction
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"
headers = ["Category", "Item", "Year", "Amount"]
for j, h in enumerate(headers):
    worksheet.cells.get(0, j).put_value(h)
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 i, row in enumerate(data):
    for j, val in enumerate(row):
        worksheet.cells.get(i + 1, j).put_value(val)
pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1", True, False)
pivot_table = worksheet.pivot_tables[pivot_index]
pivot_table.add_field_to_area(PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(PivotFieldType.DATA, "Amount")
pivot_table.add_field_to_area(PivotFieldType.DATA, "Amount")
pivot_table.data_fields[1].function = ConsolidationFunction.COUNT
pivot_table.calculate_data()
workbook.save("output_function.xlsx")

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

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

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

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

import aspose.cells as ac
from aspose.cells.pivot import PivotFieldType, ConsolidationFunction
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"
headers = ["Category", "Item", "Year", "Amount"]
for j, h in enumerate(headers):
    worksheet.cells.get(0, j).put_value(h)
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 i, row in enumerate(data):
    for j, val in enumerate(row):
        worksheet.cells.get(i + 1, j).put_value(val)
pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1", True, False)
pivot_table = worksheet.pivot_tables[pivot_index]
pivot_table.add_field_to_area(PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(PivotFieldType.DATA, "Amount")
pivot_table.add_field_to_area(PivotFieldType.DATA, "Amount")
pivot_table.data_fields[1].function = ConsolidationFunction.COUNT
pivot_table.add_field_to_area(PivotFieldType.COLUMN, pivot_table.values_field)
pivot_table.calculate_data()
workbook.save("output_plot.xlsx")

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

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

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

はじめに

フィルターフィールドとは、ソースデータのどのサブセット をピボット本体に表示するかを制御するピボットフィールドです。エンドユーザーは Excel でレンダリングされたピボットの上部にあるドロップダウンとしてそれを認識し、利用可能なフィルター項目のいずれかを選択すると、そのフィルター項目に属するレコードのみが集計されるようにピボット本体が再構築されます。ピボットフィールドは、PivotFieldType.ROW、PivotFieldType.COLUMN、または PivotFieldType.DATA ではなく PivotFieldType.PAGE として登録されたときにフィルターフィールドになります。フィルターフィールドは 2 つの動作で動作できます。デフォルトの 単一選択 動作では、一度に 1 つのフィルター項目のみが表示されるため、ピボット本体は正確に 1 つのサブセットを集計します。複数選択 動作では、フィールドはチェックボックスのリストを公開し、ピボット本体はチェックされたすべてのフィルター項目の和集合を集計します。同じソースフィールドは、単一のプロパティを切り替えることによって、これらの動作間を前後に移動できます。 Aspose.Cells for Python via Java は、フィルターフィールドを登録するために 2 つの同等の方法を公開しています。ハイレベル API は PivotTable.add_field_to_area(PivotFieldType.PAGE, "fieldName") で、ソース列名を受け取り、1 回の呼び出しでフィールドを追加します。低レベル API は PivotTable.page_fields.add(PivotField) で、すでに PivotField 参照を保持しており、同じフィールドインスタンスをページエリアに追加したい場合に使用されます。両方の API は最終的に同じ page_fields コレクションを設定し、この記事の残りではそれらの間の選択方法と各フィルターモードの操作方法を説明します。

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

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

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

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

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, PivotFieldType
# 新しいワークブックを作成
workbook = Workbook()
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）を入力
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 i in range(len(data)):
    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にアンカーを置くピボットテーブルを追加
pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "PivotTable1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
# フィールドをそれぞれのエリアに追加：Fruitは行、Amountはデータ、Yearはページフィールド
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
pivotTable.addFieldToArea(PivotFieldType.Page, "Year")
# ピボットテーブルのデータを更新して計算
pivotTable.calculateData()
# ワークブックを保存
workbook.save("pageFieldSample.xlsx")
jpype.shutdownJVM()

page_fields.add によるフィルターフィールドの追加

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

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotTable, PivotField, PivotFieldType
# — ピボットテーブルとページフィールドは、シナリオ 1a とまったく同じ方法で構築されます
#   (Fruit/Year/Amount データ、E3 にピボット、Fruit→行、
#   Amount→データ)。以下では、BaseFields コレクションから
#   Year PivotField を取得し、PageFields.Add に渡します。
#   これは AddFieldToArea の代わりに使用する低レベルの方法です。
#   その結果はシナリオ 1a と機能的に同一です。
workbook = Workbook()
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 を範囲とするピボットテーブルを追加
pivotIndex = sheet.getPivotTables().add("E3", "A1:C10", "PivotTable1")
pivotTable = sheet.getPivotTables().get(pivotIndex)
# Fruit -> 行、Amount -> データ (Year は下記でページに追加)
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
# 低レベルの方法: BaseFields から既存の Year PivotField を取得し、
# PageFields.Add(PivotField) を介してページ領域に登録します。
yearField = pivotTable.getBaseFields().get("Year")
pivotTable.getPageFields().add(yearField)
# 新しいページフィールドが保存されるワークブックに反映されるように更新します
pivotTable.calculateData()
workbook.save("output.xlsx")
jpype.shutdownJVM()

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

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

すべての項目の表示

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

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType
# 新しいワークブックを作成
workbook = Workbook()
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")
data = [
    ["Apple", 2022, 100],
    ["Apple", 2023, 150],
    ["Banana", 2022, 80],
    ["Banana", 2023, 120],
    ["Cherry", 2022, 200],
    ["Cherry", 2023, 250]
]
for r in range(len(data)):
    for c in range(len(data[r])):
        sheet.getCells().get(r + 1, c).putValue(data[r][c])
# E3 にピボットテーブルを作成
pivotTables = sheet.getPivotTables()
index = pivotTables.add("=A1:C7", "E3", "PivotTable1")
pivotTable = pivotTables.get(index)
# ピボットフィールドを設定: Fruit→行、Amount→データ、Year→ページ
pivotTable.addFieldToArea(PivotFieldType.ROW, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.DATA, "Amount")
pivotTable.addFieldToArea(PivotFieldType.PAGE, "Year")
pivotTable.calculateData()
# ページフィールドのフィルターをクリアし、すべての項目を表示可能にする。
# 0x7FFD (10進数 32765) は「すべての項目」を意味する特殊なセンチネル値です —
# Excel のページフィールドドロップダウンで「(すべて)」を選択するのと同等です。
pivotTable.getPageFields().get(0).setCurrentPageItem(0x7FFD)
workbook.save("output.xlsx")
jpype.shutdownJVM()

特定の 1 つの項目の表示

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

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType
# Create workbook
workbook = Workbook()
sheet = workbook.getWorksheets().get(0)
cells = sheet.getCells()
# Add sample data (Fruit/Year/Amount)
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")
# Add pivot table at E3
pivotTables = sheet.getPivotTables()
pivotIndex = pivotTables.add("A1:C5", "E3", "PivotTable1")
pivotTable = pivotTables.get(pivotIndex)
# Add fields: Fruit→Row, Amount→Data, Year→Page
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
pivotTable.addFieldToArea(PivotFieldType.Page, "Year")
# Page-field-specific operations
pivotTable.getPageFields().get(0).setCurrentPageItem(1) # 1 = second item in sorted order (e.g. "2021")
# Refresh and calculate pivot table
pivotTable.calculateData()
workbook.save("output.xlsx")
jpype.shutdownJVM()

複数選択フィルター

複数選択フィルターは、ページドロップダウンをチェックボックスのリストに変換し、エンドユーザーが複数のフィルター項目を同時に選択できるようにします。Aspose.Cells は連携して動作する 2 つのプロパティを公開しています。PivotField.is_multiple_item_selection_allowed は、複数選択 UI がまったく有効になる前に True に設定する必要があります。有効にした後、PivotItem.is_hidden はチェックボックスリストに表示される項目を制御するため、すべての項目を表示するか、特定の項目のみをホワイトリスト化するかを選択できます。以下のコードは、シナリオ 1a で構築された同じ Year フィルターフィールドで複数選択を有効にし、2 つのパターンを示します。パート A では、すべてのエントリの is_hidden を False のままにしておくことですべてのフィルター項目を公開し、パート B では、switch (pivot_items[i].get_string_value()) ブロックを介して選択したソース値のみをホワイトリスト化し、他のすべてを非表示にします。

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType
import os
import re
# — ピボットテーブルとページフィールドは以下とまったく同じ構成です
#   シナリオ1a (Fruit/Year/Amountデータ、E3にピボット、Fruit→Row、
#   Amount→Data、Year→PageはAddFieldToAreaを使用)。
#   以下ではページフィールドに複数選択フィルタを適用します。
workbook = Workbook()
sheet = workbook.getWorksheets().get(0)
cells = sheet.getCells()
# サンプルデータ: Fruit | Year | Amount
cells.get(0, 0).putValue("Fruit")
cells.get(0, 1).putValue("Year")
cells.get(0, 2).putValue("Amount")
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 i in range(len(data)):
    cells.get(i + 1, 0).putValue(data[i][0])
    cells.get(i + 1, 1).putValue(int(data[i][1]))
    cells.get(i + 1, 2).putValue(int(data[i][2]))
pivotSheet = workbook.getWorksheets().add("Pivot")
pivots = pivotSheet.getPivotTables()
pivotIndex = pivots.add("E3", "A1:C10", "PivotTable1")
pivotTable = pivots.get(pivotIndex)
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
pivotTable.addFieldToArea(PivotFieldType.Page, "Year")
# — ページフィールドで複数選択を有効化
pivotTable.getPageFields().get(0).setMultipleItemSelectionAllowed(True)
# パートA — すべての項目を選択 (すべての項目を表示する)
pivotItems = pivotTable.getPageFields().get(0).getPivotItems()
for i in range(pivotItems.getCount()):
    pivotItems.get(i).setHidden(False)
# パートB — ソース値によって特定の項目のみを選択
for i in range(pivotItems.getCount()):
    value = pivotItems.get(i).getStringValue()
    if value == "2020" or value == "grape" or value == "blueberry":
        pivotItems.get(i).setHidden(False)
    else:
        pivotItems.get(i).setHidden(True)
pivotTable.calculateData()
workbook.save("output.xlsx")
jpype.shutdownJVM()

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

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

次の表は、各シナリオとモードをいつ使用すべきかをまとめたもので、すべてのシナリオを詳しく読まなくても適切な組み合わせを選択できます。

シナリオ / ユースケース	推奨 API	使用するプロパティ	注意事項
ソース列名でフィルターフィールドを追加する (最も一般的)	`PivotTable.add_field_to_area(PivotFieldType.PAGE, "fieldName")`	なし	ハイレベル、ワンライナー。`PivotField` 参照が必要ない限り、これを使用してください。
すでに `PivotField` オブジェクトを保持している場合にフィルターフィールドを追加する	`PivotTable.page_fields.add(PivotField)`	なし	フィールドオブジェクトが他の場所で取得された場合や再利用する必要がある場合に使用します。
単一のフィルター項目にフィルターする (デフォルトモード)	`PivotField.current_page_item`	特定のインデックスに設定	たとえば、`1` はソート済みリストの 2 番目の項目を表示します。
すべての項目を表示する / フィルターをクリアする	`PivotField.current_page_item`	`0x7FFD` に設定	マジック値 `0x7FFD` (10 進数 32765) は「すべての項目」のセンチネル値です。
Excel で複数選択 UI を有効にする	`PivotField.is_multiple_item_selection_allowed`	`True` に設定	`is_hidden` 呼び出しが有効になる前に必要です。
複数選択リスト内の個別項目を非表示 / 表示する	`PivotItem.is_hidden`	項目ごとに設定	少なくとも 1 つの項目が表示されたまま (`is_hidden == False`) でなければなりません。

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

Documentation – ピボットテーブル

Pythonjava: ピボットテーブルを作成する

ピボットテーブルを作成する

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

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

はじめに

クイックスタート

必要なインポート

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

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

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

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

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

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

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

よくある落とし穴

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

はじめに

レガシー XLS プリセット自動フォーマットの適用

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

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

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

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

Pythonjava: Aspose.Cells for Python 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

Pythonjava: Aspose.Cells for Python via Java の値フィールド

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

集計関数の変更

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

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

はじめに

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

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

page_fields.add によるフィルターフィールドの追加

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

すべての項目の表示

特定の 1 つの項目の表示

複数選択フィルター

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

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

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

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