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

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

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

ピボットテーブルの外観

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

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

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

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

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

Microsoft Excelにはさまざまなプリセットのレポートフォーマットがあります。Aspose.Cells for Python via .NETもこれらの書式設定オプションをサポートしています。アクセスするためには:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Aspose.Cells for Python via .NET はピボットテーブルとピボットチャートをサポートしています。

Excel ライブラリの Aspose.Cells for Python によるピボットテーブルおよびチャートの追加

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

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

Aspose.Cells for Python via .NET の使用の準備

pypi から Aspose.Cells for Python via .NET をインストールします。コマンドは次のとおりです: $ pip install aspose-cells-python。
開発環境に “Aspose.Cells for Python via .NET” をインストールする手順については、ステップバイステップの手順に従うこともできます。

Aspose.Cells for Python Excel ライブラリを使用してピボットテーブルを追加する方法

Aspose.Cells for Python via .NET を使用してピボットテーブルを作成するには:

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

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

Aspsoe.Cells for Python Excel ライブラリを使用してピボットチャートを追加する方法

Aspose.Cells for Python via .NET を使用してPivotChartを作成するには:

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

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

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

Pivot Tableのソースデータ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

可能な使用シナリオ

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

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

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

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

Aspose.Cells for Python Excelライブラリを使用してピボットテーブルに計算フィールドを追加する方法

Aspose.Cells for Python via .NETを使用してExcelファイルに計算フィールドを追加します。次のサンプルコードをご覧ください。例のコードを実行すると、計算フィールドがワークシートに追加されたピボットテーブルが追加されます。

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

サンプルコード

Pythonnet: Aspose.Cells for Python via .NET でのピボットテーブルの更新

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

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

はじめに

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

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

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

必要なインポート

この記事のすべての Python サンプルコードは、ピボット関連の型が aspose.cells.pivot 名前空間に存在するため、次の 3 つの import 文から始まります。

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

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

import aspose.cells as ac

# 新しいワークブックを作成
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

# A1:C1 のセルにヘッダー行を書き込む
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

# A2:C9 のセルにデータ行を書き込む（2020年と2021年にわたる8行のフルーツデータ）
worksheet.cells["A2"].put_value("grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(50)

worksheet.cells["A3"].put_value("blueberry")
worksheet.cells["B3"].put_value(2020)
worksheet.cells["C3"].put_value(60)

worksheet.cells["A4"].put_value("kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(70)

worksheet.cells["A5"].put_value("cherry")
worksheet.cells["B5"].put_value(2020)
worksheet.cells["C5"].put_value(80)

worksheet.cells["A6"].put_value("grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(90)

worksheet.cells["A7"].put_value("blueberry")
worksheet.cells["B7"].put_value(2021)
worksheet.cells["C7"].put_value(100)

worksheet.cells["A8"].put_value("kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(110)

worksheet.cells["A9"].put_value("cherry")
worksheet.cells["B9"].put_value(2021)
worksheet.cells["C9"].put_value(120)

# ピボットテーブルを追加：ソース範囲「A1:C9」、配置先セル「E3」、名前「Pivot1」
pivot_index = worksheet.pivot_tables.add("A1:C9", "E3", "Pivot1")
pivot_table = worksheet.pivot_tables[pivot_index]

# ピボットフィールドを割り当て：Fruit を行に、Year を列に、Amount をデータに
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# ソースデータの複数の Amount 値を変更して変更をシミュレート
worksheet.cells["C2"].put_value(55)
worksheet.cells["C5"].put_value(85)
worksheet.cells["C9"].put_value(125)

# ワークブック内のすべてのピボットテーブル / ピボットキャッシュを更新
workbook.refresh_all()

# ワークブックを保存
workbook.save("output.xlsx")

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

特定の 1 つのワークシート上にあるピボットテーブルだけを更新する必要がある場合があります。たとえば、他のワークシート上にあるピボットテーブルは無関係であることがわかっており、触れたくない場合です。このような場合、Aspose.Cells は単一の Worksheet インスタンスを対象とする Worksheet.refresh_pivot_tables() を提供します。これは Workbook.refresh_all() よりも選択的で、対象ワークシート上のピボットテーブルのみが更新され、他のワークシート上のピボットテーブルはそのまま残されます。次の例では、同じ Fruit/Year/Amount のソースデータを設定し、最初のワークシートにピボットテーブルを追加し、一部のソース値を変更してから、そのワークシート上のピボットテーブルのみを更新します。

import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

worksheet.cells["A2"].put_value("grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(100)

worksheet.cells["A3"].put_value("blueberry")
worksheet.cells["B3"].put_value(2021)
worksheet.cells["C3"].put_value(150)

worksheet.cells["A4"].put_value("kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(200)

worksheet.cells["A5"].put_value("cherry")
worksheet.cells["B5"].put_value(2021)
worksheet.cells["C5"].put_value(120)

worksheet.cells["A6"].put_value("grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(180)

worksheet.cells["A7"].put_value("blueberry")
worksheet.cells["B7"].put_value(2020)
worksheet.cells["C7"].put_value(130)

worksheet.cells["A8"].put_value("kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(220)

worksheet.cells["A9"].put_value("cherry")
worksheet.cells["B9"].put_value(2020)
worksheet.cells["C9"].put_value(140)

pivot_index = worksheet.pivot_tables.add("A1:C9", "E3", "Pivot1")
pivot_table = worksheet.pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

worksheet.cells["C2"].put_value(300)
worksheet.cells["C5"].put_value(250)
worksheet.cells["C9"].put_value(400)

worksheet.refresh_pivot_tables()

workbook.save("output.xlsx")

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

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

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

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

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

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

import aspose.cells as ac

# 新しいワークブックを作成し、最初のワークシートにアクセスします
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

# ヘッダー行を書き込みます: Fruit / Year / Amount
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

# 約9行のデータ行を書き込みます（2020-2021年にかけての grape / blueberry / kiwi / cherry）
worksheet.cells["A2"].put_value("Grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(100)

worksheet.cells["A3"].put_value("Blueberry")
worksheet.cells["B3"].put_value(2020)
worksheet.cells["C3"].put_value(200)

worksheet.cells["A4"].put_value("Kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(300)

worksheet.cells["A5"].put_value("Cherry")
worksheet.cells["B5"].put_value(2020)
worksheet.cells["C5"].put_value(400)

worksheet.cells["A6"].put_value("Grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(500)

worksheet.cells["A7"].put_value("Blueberry")
worksheet.cells["B7"].put_value(2021)
worksheet.cells["C7"].put_value(600)

worksheet.cells["A8"].put_value("Kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(700)

worksheet.cells["A9"].put_value("Cherry")
worksheet.cells["B9"].put_value(2021)
worksheet.cells["C9"].put_value(800)

# セルE3に固定された最初のピボットテーブル「Pivot1」を追加し、データ範囲はA1:C9
pivotIndex1 = worksheet.pivot_tables.add("A1:C9", "E3", "Pivot1")
pivotTable1 = worksheet.pivot_tables[pivotIndex1]

# Pivot1にフィールドを割り当てます
pivotTable1.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivotTable1.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivotTable1.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# 同じデータ範囲A1:C9を使用して、セルE15に固定された2番目のピボットテーブル「Pivot2」を追加します
# データ範囲が同一であるため、Pivot1とPivot2は単一のPivotCacheを共有します。
pivotIndex2 = worksheet.pivot_tables.add("A1:C9", "E15", "Pivot2")
pivotTable2 = worksheet.pivot_tables[pivotIndex2]

# Pivot2に同じフィールドを割り当てます
pivotTable2.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivotTable2.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivotTable2.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# データ変更をシミュレートするために、ソースデータのいくつかのAmountセルの値を変更します
worksheet.cells["C2"].put_value(150)
worksheet.cells["C4"].put_value(350)
worksheet.cells["C7"].put_value(650)

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

# ワークブックを保存します
workbook.save("output.xlsx")

表示やレイアウトのみが変更された場合 — `calculate_data()` を使用する

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

import aspose.cells as ac
import aspose.cells.pivot as acp

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

# Fruit / Year / Amount のヘッダー行を書き込み
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

# 8 行のデータ行を書き込み (2-9 行目、ソース範囲 A1:C9 に合わせる)
worksheet.cells["A2"].put_value("Grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(100)

worksheet.cells["A3"].put_value("Blueberry")
worksheet.cells["B3"].put_value(2020)
worksheet.cells["C3"].put_value(200)

worksheet.cells["A4"].put_value("Kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(300)

worksheet.cells["A5"].put_value("Cherry")
worksheet.cells["B5"].put_value(2020)
worksheet.cells["C5"].put_value(400)

worksheet.cells["A6"].put_value("Grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(150)

worksheet.cells["A7"].put_value("Blueberry")
worksheet.cells["B7"].put_value(2021)
worksheet.cells["C7"].put_value(250)

worksheet.cells["A8"].put_value("Kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(350)

worksheet.cells["A9"].put_value("Cherry")
worksheet.cells["B9"].put_value(2021)
worksheet.cells["C9"].put_value(450)

# 名前 "Pivot1" のピボットテーブルを追加し、出力先セル E3 に配置、ソースは A1:C9
pivot_index = worksheet.pivot_tables.add("A1:C9", "E3", "Pivot1")
pivot_table = worksheet.pivot_tables[pivot_index]

# フィールドを割り当て: Fruit を行、Year を列、Amount をデータ
pivot_table.add_field_to_area(acp.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(acp.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(acp.PivotFieldType.DATA, "Amount")

# 表示/レイアウトのプロパティを変更 — これは表示のみの変更なので、
# PivotCache.Refresh() を使用してソースデータを再読み込みする必要はありません。
pivot_table.refresh_data_on_opening_file = False

# CalculateData() は、PivotCache に既に保持されているデータから、このピボットテーブルの
# 表示 (データ + スタイル) を再レンダリングします。ソースデータが変更されていないため、
# ソースへの往復処理は行われず、キャッシュされた値のみがワークシートのセルに再計算されます。
pivot_table.calculate_data()

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

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

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

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

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

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

import aspose.cells as ac

# 新しいワークブックを作成し、最初のワークシートにアクセスします
workbook = ac.Workbook()
sheet = workbook.worksheets[0]

# --- ソースデータの作成: Fruit / Year / Amount (ヘッダー + 9行) ---
sheet.cells["A1"].put_value("Fruit")
sheet.cells["B1"].put_value("Year")
sheet.cells["C1"].put_value("Amount")

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

# --- 宛先セルE3に最初のピボットテーブル(Pivot1)を追加 ---
idx1 = sheet.pivot_tables.add("A1:C9", "E3", "Pivot1")
pivot_table1 = sheet.pivot_tables[idx1]
pivot_table1.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table1.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table1.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# --- 同じソース範囲に2番目のピボットテーブル(Pivot2)を追加 ---
# Pivot1とPivot2は1つの基礎となるPivotCacheを共有します。
# これはまさに、レガシーのテーブルごとのRefreshData()が
# 非効率になるシナリオです:1つのテーブルを更新すると、共有キャッシュ全体を
# 再フェッチするため、N個のテーブルを更新すると同じ高コストのフェッチをN回実行します。
idx2 = sheet.pivot_tables.add("A1:C9", "E15", "Pivot2")
pivot_table2 = sheet.pivot_tables[idx2]
pivot_table2.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table2.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table2.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# --- ソースデータの複数のAmount値を変更 ---
sheet.cells["C2"].put_value(5000)   # Grape  2020
sheet.cells["C5"].put_value(7500)   # Cherry 2020
sheet.cells["C9"].put_value(9500)   # Cherry 2021

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

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

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

workbook.save("output.xlsx")

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

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

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

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

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.auto_format_type プロパティと aspose.cells.pivot.PivotTableAutoFormatType 列挙型を組み合わせて使用します。この API は、クラシック Excel でピボットテーブル用に提供されていた自動書式ピッカーに対応しています。

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

PivotTable.pivot_table_style_type は、組み込みの名前付きスタイル (Excel 2017 で追加されたスタイルを含む、ライトテーマとダークテーマ) のいずれかを選択します。これらのプリセットは読み取り専用です。
PivotTable.pivot_table_style_name は、workbook.worksheets.table_styles.add_pivot_table_style(...) を使用して自分で定義したカスタムスタイルを選択します。プリセットで提供される範囲を超えて色、罫線、フォントを変更する場合は、カスタムスタイルが必要です。

さらに、PivotTable.format_all(Style) は、単一の Style オブジェクトをピボットのすべてのセルに適用するショートカットで、上記のスタイル名 API で設定された内容をすべて上書きします。これは、基になるテーマに関係なく均一な外観が必要な場合に役立ちます。

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

PivotTable.auto_format_type は、aspose.cells.pivot.PivotTableAutoFormatType 列挙型の値を受け取ります。利用可能な値は REPORT_1 ～ REPORT_10、CLASSIC、および TABLE_1 ～ TABLE_10 です。

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

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

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

import aspose.cells as ac

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

# 新しいワークブックを作成
workbook = ac.Workbook()

# 最初のワークシートを取得
sheet = workbook.worksheets[0]

# ソースデータに見出し行 (Fruit, Year, Amount) と
# 2020年と2021年にわたる grape、blueberry、kiwi、cherry の 9 データ行を入力
sheet.cells[0, 0].put_value("Fruit")
sheet.cells[0, 1].put_value("Year")
sheet.cells[0, 2].put_value("Amount")

sheet.cells[1, 0].put_value("grape")
sheet.cells[1, 1].put_value(2020)
sheet.cells[1, 2].put_value(50)

sheet.cells[2, 0].put_value("blueberry")
sheet.cells[2, 1].put_value(2020)
sheet.cells[2, 2].put_value(30)

sheet.cells[3, 0].put_value("kiwi")
sheet.cells[3, 1].put_value(2020)
sheet.cells[3, 2].put_value(25)

sheet.cells[4, 0].put_value("cherry")
sheet.cells[4, 1].put_value(2020)
sheet.cells[4, 2].put_value(40)

sheet.cells[5, 0].put_value("grape")
sheet.cells[5, 1].put_value(2021)
sheet.cells[5, 2].put_value(60)

sheet.cells[6, 0].put_value("blueberry")
sheet.cells[6, 1].put_value(2021)
sheet.cells[6, 2].put_value(35)

sheet.cells[7, 0].put_value("kiwi")
sheet.cells[7, 1].put_value(2021)
sheet.cells[7, 2].put_value(28)

sheet.cells[8, 0].put_value("cherry")
sheet.cells[8, 1].put_value(2021)
sheet.cells[8, 2].put_value(45)

sheet.cells[9, 0].put_value("grape")
sheet.cells[9, 1].put_value(2020)
sheet.cells[9, 2].put_value(45)

# 宛先セル E3 に "Pivot1" という名前のピボットテーブルをソース範囲 A1:C10 を使用して追加
pivot_index = sheet.pivot_tables.add("A1:C10", "E3", "Pivot1")
pivot_table = sheet.pivot_tables[pivot_index]

# フィールドを割り当て: Fruit -> Rows、Year -> Columns、Amount -> Data
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# レガシー XLS プレセット自動フォーマット "Report5" を適用
# 注: このプロパティは .xls 形式で保存する場合にのみ有効です。
# .xlsx/.xlsm/.xlsb として保存する場合、Excel は AutoFormatType を無視し、
# PivotTableStyleType / PivotTableStyleName で指定された形式を使用します。
pivot_table.auto_format_type = ac.PivotTableAutoFormatType.REPORT5

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

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

PivotTable.pivot_table_style_type は、aspose.cells.PivotTableStyleType 列挙型の値を受け取ります。この列挙型には、ライトテーマの PIVOT_TABLE_STYLE_LIGHT_1 ～ PIVOT_TABLE_STYLE_LIGHT_28 と、ダークテーマの PIVOT_TABLE_STYLE_DARK_1 ～ PIVOT_TABLE_STYLE_DARK_28 が含まれます。Excel 2017 で追加されたスタイル (ライトとダークテーマの第二波) も同じ列挙型からアクセスできます。

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

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

import aspose.cells as ac

# シナリオ 2: PivotTableStyleType を使用してモダンな Excel 2007+ の名前付き定義済みスタイルを適用します。
# 対象ファイル形式: .xlsx。PivotTableStyleType 列挙型は Aspose.Cells 名前空間に存在します
# (Aspose.Cells.Pivot ではありません) — そのため追加の using は必要ありません。
# GitHub リファレンス: https://github.com/aspose-cells/Aspose.Cells-for-.NET/blob/master/Examples/CSharp/PivotTables/ApplyStyleToPivotTable2.cs

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

# ヘッダー行: Fruit / Year / Amount
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

# Fruit / Year / Amount の 9 データ行
worksheet.cells["A2"].put_value("Grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(100)

worksheet.cells["A3"].put_value("Blueberry")
worksheet.cells["B3"].put_value(2020)
worksheet.cells["C3"].put_value(150)

worksheet.cells["A4"].put_value("Kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(200)

worksheet.cells["A5"].put_value("Cherry")
worksheet.cells["B5"].put_value(2020)
worksheet.cells["C5"].put_value(180)

worksheet.cells["A6"].put_value("Grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(120)

worksheet.cells["A7"].put_value("Blueberry")
worksheet.cells["B7"].put_value(2021)
worksheet.cells["C7"].put_value(170)

worksheet.cells["A8"].put_value("Kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(210)

worksheet.cells["A9"].put_value("Cherry")
worksheet.cells["B9"].put_value(2021)
worksheet.cells["C9"].put_value(190)

worksheet.cells["A10"].put_value("Grape")
worksheet.cells["B10"].put_value(2021)
worksheet.cells["C10"].put_value(130)

# E3 に "Pivot1" という名前で、A1:C10 をソースとするピボットテーブルを追加します
pivot_index = worksheet.pivot_tables.add("A1:C10", "E3", "Pivot1")
pivot_table = worksheet.pivot_tables[pivot_index]

# ピボットフィールドを割り当てます: Fruit → 行エリア、Year → 列エリア、Amount → データエリア
pivot_table.add_field_to_area(ac.PivotFieldType.Row, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.Column, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.Data, "Amount")

# モダンな Excel 2007+ の名前付き定義済みピボットスタイルを適用します。
# PivotTableStyleType は .xlsx / .xlsm / .xlsb ファイル用の正しい API です。AutoFormatType は
# これらの形式では Excel に無視されます。PivotTableStyleDark1 はダークテーマファミリー
# (PivotTableStyleDark1..PivotTableStyleDark28) に属し、同じ列挙型には新しい Excel 2017 の
# ライト/ダークテーマ (PivotTableStyleLight1..Light28 / Dark1..Dark28) も公開されています。
pivot_table.pivot_table_style_type = ac.PivotTableStyleType.PivotTableStyleDark1

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

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

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

workbook.worksheets.table_styles.add_pivot_table_style(name) 経由で、ワークブックの table_styles コレクションにカスタムスタイルを追加します。新しく作成されたスタイルのインデックスが返されます。
table_style.table_style_elements.add(TableStyleElementType) 経由で要素 (WHOLE_TABLE や GRAND_TOTAL_ROW など) を追加し、table_style_element.set_element_style(Style) 経由で各要素に Style を割り当てることで、スタイルを設定します。
PivotTable.pivot_table_style_name をスタイルの名前に設定することで、カスタムスタイルをピボットに適用します。ここでは pivot_table_style_type を使用しないでください。このプロパティは組み込みプリセットを選択するためです。

pivot_table_style_name と pivot_table_style_type は互いに交換できません。組み込みプリセットには pivot_table_style_type を、add_pivot_table_style で定義したカスタムスタイルには pivot_table_style_name を使用してください。両方を設定しても問題ありませんが、想定されるソースに対応する側のみがレンダリングされます。

利用可能な 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 に太字の赤いフォントを持つカスタムピボットスタイルを定義し、pivot_table_style_name 経由で適用して .xlsx として保存します。

import aspose.cells as ac
import System.Drawing

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

# ソースデータを設定：ヘッダー行 + 9データ行 (A1:C10)
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

worksheet.cells["A2"].put_value("Grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(100)

worksheet.cells["A3"].put_value("Blueberry")
worksheet.cells["B3"].put_value(2020)
worksheet.cells["C3"].put_value(200)

worksheet.cells["A4"].put_value("Kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(300)

worksheet.cells["A5"].put_value("Cherry")
worksheet.cells["B5"].put_value(2020)
worksheet.cells["C5"].put_value(400)

worksheet.cells["A6"].put_value("Grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(500)

worksheet.cells["A7"].put_value("Blueberry")
worksheet.cells["B7"].put_value(2021)
worksheet.cells["C7"].put_value(600)

worksheet.cells["A8"].put_value("Kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(700)

worksheet.cells["A9"].put_value("Cherry")
worksheet.cells["B9"].put_value(2021)
worksheet.cells["C9"].put_value(800)

worksheet.cells["A10"].put_value("Grape")
worksheet.cells["B10"].put_value(2021)
worksheet.cells["C10"].put_value(900)

# A1:C10をソースとし、E3に配置される「Pivot1」という名前のピボットテーブルを追加
pivot_index = worksheet.pivot_tables.add("A1:C10", "E3", "Pivot1")
pivot_table = worksheet.pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# ステップ1：新しいカスタムピボットテーブルスタイルを登録し、そのインデックスを取得
style_index = workbook.worksheets.table_styles.add_pivot_table_style("CustomPivotStyle")
table_style = workbook.worksheets.table_styles[style_index]

# ステップ2：WholeTable要素を追加し、4辺すべてに細い黒色の境界線を適用
whole_table_element_index = table_style.table_style_elements.add(ac.TableStyleElementType.WHOLE_TABLE)
whole_table_element = table_style.table_style_elements[whole_table_element_index]
whole_table_style = workbook.create_style()
whole_table_style.borders[ac.BorderType.TOP_BORDER].line_style = ac.CellBorderType.THIN
whole_table_style.borders[ac.BorderType.TOP_BORDER].color = System.Drawing.Color.Black
whole_table_style.borders[ac.BorderType.BOTTOM_BORDER].line_style = ac.CellBorderType.THIN
whole_table_style.borders[ac.BorderType.BOTTOM_BORDER].color = System.Drawing.Color.Black
whole_table_style.borders[ac.BorderType.LEFT_BORDER].line_style = ac.CellBorderType.THIN
whole_table_style.borders[ac.BorderType.LEFT_BORDER].color = System.Drawing.Color.Black
whole_table_style.borders[ac.BorderType.RIGHT_BORDER].line_style = ac.CellBorderType.THIN
whole_table_style.borders[ac.BorderType.RIGHT_BORDER].color = System.Drawing.Color.Black
whole_table_element.set_element_style(whole_table_style)

# ステップ3：GrandTotalRow要素を追加し、太字の赤色フォントを適用
grand_total_element_index = table_style.table_style_elements.add(ac.TableStyleElementType.GRAND_TOTAL_ROW)
grand_total_element = table_style.table_style_elements[grand_total_element_index]
grand_total_style = workbook.create_style()
grand_total_style.font.is_bold = True
grand_total_style.font.color = System.Drawing.Color.Red
grand_total_element.set_element_style(grand_total_style)

# ステップ4：名前でカスタムスタイルを適用（PivotTableStyleTypeではなく、ビルトインプリセット用です）
pivot_table.pivot_table_style_name = "CustomPivotStyle"

workbook.save("output.xlsx")

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

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

format_all は pivot_table_style_type と pivot_table_style_name の両方を上書きします。テーマに関係なく、ピボット全体で均一な外観が必要な場合にのみ使用してください。

次の例では、黄色の単色塗りつぶし、太字のダークブルーフォント、およびすべての辺に細い黒の罫線を持つ Style を作成し、format_all で適用して、.xlsx として保存します。

from System.Drawing import Color
import aspose.cells as ac
from aspose.cells.pivot import PivotFieldType
from aspose.cells import BackgroundType, CellBorderType, BorderType

# シナリオ 4: FormatAll API を使用してすべてのピボットテーブルセルに単一のスタイルを適用
# 使用中の API: PivotTable.FormatAll(Style)
# 出力形式: .xlsx
# GitHub リファレンス: Aspose.Cells-for-.NET リポジトリのピボットテーブルスタイル例を参照

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

# ソースデータを入力: ヘッダー行 (1 行目) + データ 9 行 (2 ～ 10 行目)
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

worksheet.cells["A2"].put_value("Grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(5000)

worksheet.cells["A3"].put_value("Blueberry")
worksheet.cells["B3"].put_value(2020)
worksheet.cells["C3"].put_value(3000)

worksheet.cells["A4"].put_value("Kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(4000)

worksheet.cells["A5"].put_value("Cherry")
worksheet.cells["B5"].put_value(2020)
worksheet.cells["C5"].put_value(2000)

worksheet.cells["A6"].put_value("Grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(6000)

worksheet.cells["A7"].put_value("Blueberry")
worksheet.cells["B7"].put_value(2021)
worksheet.cells["C7"].put_value(3500)

worksheet.cells["A8"].put_value("Kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(4500)

worksheet.cells["A9"].put_value("Cherry")
worksheet.cells["B9"].put_value(2021)
worksheet.cells["C9"].put_value(2500)

worksheet.cells["A10"].put_value("Grape")
worksheet.cells["B10"].put_value(2021)
worksheet.cells["C10"].put_value(5500)

# ピボットテーブルを追加: ソース範囲 A1:C10、配置先セル E3、名前 "Pivot1"
pivot_index = worksheet.pivot_tables.add("A1:C10", "E3", "Pivot1")
pivot_table = worksheet.pivot_tables[pivot_index]

# ピボットフィールドを割り当て: Fruit → 行エリア、Year → 列エリア、Amount → データエリア
pivot_table.add_field_to_area(PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(PivotFieldType.DATA, "Amount")

# ピボットテーブルのすべてのセルに強制適用する Style を作成
style = workbook.create_style()
style.foreground_color = Color.Yellow
style.pattern = BackgroundType.SOLID
style.font.is_bold = True
style.font.color = Color.DarkBlue
style.borders[BorderType.TOP_BORDER].line_style = CellBorderType.THIN
style.borders[BorderType.TOP_BORDER].color = Color.Black
style.borders[BorderType.BOTTOM_BORDER].line_style = CellBorderType.THIN
style.borders[BorderType.BOTTOM_BORDER].color = Color.Black
style.borders[BorderType.LEFT_BORDER].line_style = CellBorderType.THIN
style.borders[BorderType.LEFT_BORDER].color = Color.Black
style.borders[BorderType.RIGHT_BORDER].line_style = CellBorderType.THIN
style.borders[BorderType.RIGHT_BORDER].color = Color.Black

# FormatAll を適用: この単一のスタイルをピボットテーブルのすべてのセルに強制適用し、
# 以前に設定された PivotTableStyleType / PivotTableStyleName を上書きします
pivot_table.format_all(style)

# ワークブックを最新の .xlsx 形式で保存
workbook.save("output.xlsx")

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

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

対象ファイル形式	使用する API	メモ
`.xls` (レガシー)	`PivotTable.auto_format_type`	`aspose.cells.pivot.PivotTableAutoFormatType` の値 (例: `REPORT_1`～`REPORT_10`、`CLASSIC`、`TABLE_1`～`TABLE_10`)。モダン形式で保存する場合は無視されます。
`.xlsx` / `.xlsm` / `.xlsb` (モダン、組み込みスタイル)	`PivotTable.pivot_table_style_type`	`aspose.cells.PivotTableStyleType` の値 (Excel 2017 の追加を含むライト/ダークテーマ)。
`.xlsx` / `.xlsm` / `.xlsb` (モダン、カスタムスタイル)	`PivotTable.pivot_table_style_name` + `worksheets.table_styles.add_pivot_table_style(...)`	組み込みプリセットでは不十分な場合に使用します。`table_style_element.set_element_style(...)` 経由で設定します。
任意の形式 (均一な上書き)	`PivotTable.format_all(Style)`	ピボット全体で他のすべてのスタイル設定を上書きするショートカット。

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

Aspose.Cells for Python via .NET でピボットテーブルを更新する

Pythonnet: Aspose.Cells for Python via .NET でピボットテーブルの行フィールドと列フィールドを追加する

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

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

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

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

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

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

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

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

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

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

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

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

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

import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

worksheet.cells[0, 0].put_value("Category")
worksheet.cells[0, 1].put_value("Item")
worksheet.cells[0, 2].put_value("Year")
worksheet.cells[0, 3].put_value("Amount")

worksheet.cells[1, 0].put_value("Fruit")
worksheet.cells[1, 1].put_value("Apple")
worksheet.cells[1, 2].put_value(2020)
worksheet.cells[1, 3].put_value(100)

worksheet.cells[2, 0].put_value("Fruit")
worksheet.cells[2, 1].put_value("Apple")
worksheet.cells[2, 2].put_value(2021)
worksheet.cells[2, 3].put_value(150)

worksheet.cells[3, 0].put_value("Fruit")
worksheet.cells[3, 1].put_value("Banana")
worksheet.cells[3, 2].put_value(2020)
worksheet.cells[3, 3].put_value(80)

worksheet.cells[4, 0].put_value("Fruit")
worksheet.cells[4, 1].put_value("Banana")
worksheet.cells[4, 2].put_value(2021)
worksheet.cells[4, 3].put_value(90)

worksheet.cells[5, 0].put_value("Vegetable")
worksheet.cells[5, 1].put_value("Carrot")
worksheet.cells[5, 2].put_value(2020)
worksheet.cells[5, 3].put_value(50)

worksheet.cells[6, 0].put_value("Vegetable")
worksheet.cells[6, 1].put_value("Carrot")
worksheet.cells[6, 2].put_value(2021)
worksheet.cells[6, 3].put_value(60)

worksheet.cells[7, 0].put_value("Vegetable")
worksheet.cells[7, 1].put_value("Daikon")
worksheet.cells[7, 2].put_value(2020)
worksheet.cells[7, 3].put_value(40)

worksheet.cells[8, 0].put_value("Vegetable")
worksheet.cells[8, 1].put_value("Daikon")
worksheet.cells[8, 2].put_value(2021)
worksheet.cells[8, 3].put_value(45)

pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1")
pivot_table = worksheet.pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

category_field = pivot_table.row_fields[0]
category_field.set_subtotals(ac.PivotFieldSubtotalType.AUTOMATIC, True)

pivot_table.calculate_data()

workbook.save("output_automatic.xlsx")

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

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

import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

headers = ["Category", "Item", "Year", "Amount"]
for j in range(len(headers)):
    worksheet.cells[0, j].put_value(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[i])):
        worksheet.cells[i + 1, j].put_value(data[i][j])

pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1")
pivot_table = worksheet.pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

category_field = pivot_table.row_fields[0]
for st in [ac.PivotFieldSubtotalType.SUM, ac.PivotFieldSubtotalType.COUNT, ac.PivotFieldSubtotalType.AVERAGE, ac.PivotFieldSubtotalType.MAX, ac.PivotFieldSubtotalType.MIN, ac.PivotFieldSubtotalType.PRODUCT]:
    category_field.set_subtotals(st, True)
pivot_table.calculate_data()

workbook.save("output_none.xlsx")

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

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

= ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

worksheet.cells["A1"].put_value("Category")
worksheet.cells["B1"].put_value("Item")
worksheet.cells["C1"].put_value("Year")
worksheet.cells["D1"].put_value("Amount")

worksheet.cells[1, 0].put_value("Fruit")
worksheet.cells[1, 1].put_value("Apple")
worksheet.cells[1, 2].put_value(2020)
worksheet.cells[1, 3].put_value(100)

worksheet.cells[2, 0].put_value("Fruit")
worksheet.cells[2, 1].put_value("Apple")
worksheet.cells[2, 2].put_value(2021)
worksheet.cells[2, 3].put_value(150)

worksheet.cells[3, 0].put_value("Fruit")
worksheet.cells[3, 1].put_value("Banana")
worksheet.cells[3, 2].put_value(2020)
worksheet.cells[3, 3].put_value(80)

worksheet.cells[4, 0].put_value("Fruit")
worksheet.cells[4, 1].put_value("Banana")
worksheet.cells[4, 2].put_value(2021)
worksheet.cells[4, 3].put_value(90)

worksheet.cells[5, 0].put_value("Vegetable")
worksheet.cells[5, 1].put_value("Carrot")
worksheet.cells[5, 2].put_value(2020)
worksheet.cells[5, 3].put_value(50)

worksheet.cells[6, 0].put_value("Vegetable")
worksheet.cells[6, 1].put_value("Carrot")
worksheet.cells[6, 2].put_value(2021)
worksheet.cells[6, 3].put_value(60)

worksheet.cells[7, 0].put_value("Vegetable")
worksheet.cells[7, 1].put_value("Daikon")
worksheet.cells[7, 2].put_value(2020)
worksheet.cells[7, 3].put_value(40)

worksheet.cells[8, 0].put_value("Vegetable")
worksheet.cells[8, 1].put_value("Daikon")
worksheet.cells[8, 2].put_value(2021)
worksheet.cells[8, 3].put_value(45)

pivot_tables = worksheet.pivot_tables
pivot_index = pivot_tables.add("A1:D9", "F3", "PivotTable1")
pivot_table = pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

category_field = pivot_table.row_fields[0]
category_field.set_subtotals(ac.PivotFieldSubtotalType.SUM, True)
category_field.set_subtotals(ac.PivotFieldSubtotalType.AVERAGE, True)

pivot_table.calculate_data()

workbook.save("output_custom.xlsx")

まとめ

上記の 3 つのシナリオは、同じデータセットとピボットテーブル構造を共有しています。これらの唯一の違いは、外側の Category 行フィールドに適用される set_subtotals 呼び出しです。2 つのフィールドのルールを覚えておいてください。領域内にフィールドが 1 つしかない場合は、小計化する対象がないため、set_subtotals の目に見える効果を得たい場合は、必ず行領域または列領域に少なくとも 2 つのフィールドを配置してください。

import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

worksheet.cells[0, 0].put_value("Category")
worksheet.cells[0, 1].put_value("Item")
worksheet.cells[0, 2].put_value("Year")
worksheet.cells[0, 3].put_value("Amount")

worksheet.cells[1, 0].put_value("Fruit")
worksheet.cells[1, 1].put_value("Apple")
worksheet.cells[1, 2].put_value(2020)
worksheet.cells[1, 3].put_value(100)

worksheet.cells[2, 0].put_value("Fruit")
worksheet.cells[2, 1].put_value("Apple")
worksheet.cells[2, 2].put_value(2021)
worksheet.cells[2, 3].put_value(150)

worksheet.cells[3, 0].put_value("Fruit")
worksheet.cells[3, 1].put_value("Banana")
worksheet.cells[3, 2].put_value(2020)
worksheet.cells[3, 3].put_value(80)

worksheet.cells[4, 0].put_value("Fruit")
worksheet.cells[4, 1].put_value("Banana")
worksheet.cells[4, 2].put_value(2021)
worksheet.cells[4, 3].put_value(90)

worksheet.cells[5, 0].put_value("Vegetable")
worksheet.cells[5, 1].put_value("Carrot")
worksheet.cells[5, 2].put_value(2020)
worksheet.cells[5, 3].put_value(50)

worksheet.cells[6, 0].put_value("Vegetable")
worksheet.cells[6, 1].put_value("Carrot")
worksheet.cells[6, 2].put_value(2021)
worksheet.cells[6, 3].put_value(60)

worksheet.cells[7, 0].put_value("Vegetable")
worksheet.cells[7, 1].put_value("Daikon")
worksheet.cells[7, 2].put_value(2020)
worksheet.cells[7, 3].put_value(40)

worksheet.cells[8, 0].put_value("Vegetable")
worksheet.cells[8, 1].put_value("Daikon")
worksheet.cells[8, 2].put_value(2021)
worksheet.cells[8, 3].put_value(45)

pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1")
pivot_table = worksheet.pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

category_field = pivot_table.row_fields[0]
category_field.set_subtotals(ac.PivotFieldSubtotalType.AUTOMATIC, True)

pivot_table.calculate_data()

workbook.save("output_automatic.xlsx")python
import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

headers = ["Category", "Item", "Year", "Amount"]
for j in range(len(headers)):
    worksheet.cells[0, j].put_value(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[i])):
        worksheet.cells[i + 1, j].put_value(data[i][j])

pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1")
pivot_table = worksheet.pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

category_field = pivot_table.row_fields[0]
for st in [ac.PivotFieldSubtotalType.SUM, ac.PivotFieldSubtotalType.COUNT, ac.PivotFieldSubtotalType.AVERAGE, ac.PivotFieldSubtotalType.MAX, ac.PivotFieldSubtotalType.MIN, ac.PivotFieldSubtotalType.PRODUCT]:
    category_field.set_subtotals(st, True)
pivot_table.calculate_data()

workbook.save("output_none.xlsx")python
= ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

worksheet.cells["A1"].put_value("Category")
worksheet.cells["B1"].put_value("Item")
worksheet.cells["C1"].put_value("Year")
worksheet.cells["D1"].put_value("Amount")

worksheet.cells[1, 0].put_value("Fruit")
worksheet.cells[1, 1].put_value("Apple")
worksheet.cells[1, 2].put_value(2020)
worksheet.cells[1, 3].put_value(100)

worksheet.cells[2, 0].put_value("Fruit")
worksheet.cells[2, 1].put_value("Apple")
worksheet.cells[2, 2].put_value(2021)
worksheet.cells[2, 3].put_value(150)

worksheet.cells[3, 0].put_value("Fruit")
worksheet.cells[3, 1].put_value("Banana")
worksheet.cells[3, 2].put_value(2020)
worksheet.cells[3, 3].put_value(80)

worksheet.cells[4, 0].put_value("Fruit")
worksheet.cells[4, 1].put_value("Banana")
worksheet.cells[4, 2].put_value(2021)
worksheet.cells[4, 3].put_value(90)

worksheet.cells[5, 0].put_value("Vegetable")
worksheet.cells[5, 1].put_value("Carrot")
worksheet.cells[5, 2].put_value(2020)
worksheet.cells[5, 3].put_value(50)

worksheet.cells[6, 0].put_value("Vegetable")
worksheet.cells[6, 1].put_value("Carrot")
worksheet.cells[6, 2].put_value(2021)
worksheet.cells[6, 3].put_value(60)

worksheet.cells[7, 0].put_value("Vegetable")
worksheet.cells[7, 1].put_value("Daikon")
worksheet.cells[7, 2].put_value(2020)
worksheet.cells[7, 3].put_value(40)

worksheet.cells[8, 0].put_value("Vegetable")
worksheet.cells[8, 1].put_value("Daikon")
worksheet.cells[8, 2].put_value(2021)
worksheet.cells[8, 3].put_value(45)

pivot_tables = worksheet.pivot_tables
pivot_index = pivot_tables.add("A1:D9", "F3", "PivotTable1")
pivot_table = pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

category_field = pivot_table.row_fields[0]
category_field.set_subtotals(ac.PivotFieldSubtotalType.SUM, True)
category_field.set_subtotals(ac.PivotFieldSubtotalType.AVERAGE, True)

pivot_table.calculate_data()

workbook.save("output_custom.xlsx")

まとめ

Pythonnet: Aspose.Cells for Python via .NET でピボットテーブルの値フィールドを管理する

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

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

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

from aspose.cells.pivot import PivotFieldType

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

# A1:D1のヘッダー
worksheet.cells[0, 0].put_value("Category")
worksheet.cells[0, 1].put_value("Item")
worksheet.cells[0, 2].put_value("Year")
worksheet.cells[0, 3].put_value("Amount")

# A2:D9のデータ行、jで分岐するネストループを使用
for i in range(1, 9):
    for j in range(4):
        if j == 0:
            worksheet.cells[i, j].put_value("Fruit" if i <= 4 else "Vegetable")
        elif j == 1:
            if i == 1 or i == 2:
                worksheet.cells[i, j].put_value("Apple")
            elif i == 3 or i == 4:
                worksheet.cells[i, j].put_value("Banana")
            elif i == 5 or i == 6:
                worksheet.cells[i, j].put_value("Carrot")
            else:
                worksheet.cells[i, j].put_value("Daikon")
        elif j == 2:
            worksheet.cells[i, j].put_value(2020 + ((i - 1) % 2))
        elif j == 3:
            if i == 1:
                worksheet.cells[i, j].put_value(100)
            elif i == 2:
                worksheet.cells[i, j].put_value(150)
            elif i == 3:
                worksheet.cells[i, j].put_value(80)
            elif i == 4:
                worksheet.cells[i, j].put_value(90)
            elif i == 5:
                worksheet.cells[i, j].put_value(50)
            elif i == 6:
                worksheet.cells[i, j].put_value(60)
            elif i == 7:
                worksheet.cells[i, j].put_value(40)
            else:
                worksheet.cells[i, j].put_value(45)

# F3にPivotTable1という名前のピボットテーブルを追加
pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1", True, False)
pivot_table = worksheet.pivot_tables[pivot_index]

# ピボットレイアウト: 行にCategoryとItem、列にYear、データフィールドにAmount
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 つのピボット内で、1 つのデータフィールドを Sum のままにして、同じソース列を対象とするが Count または Average を使用する 2 番目のデータフィールドを追加することができます。

import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

headers = ["Category", "Item", "Year", "Amount"]
for j in range(len(headers)):
    worksheet.cells[0, j].put_value(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[i])):
        worksheet.cells[i + 1, j].put_value(data[i][j])

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(ac.PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")

pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

count_field = pivot_table.data_fields[1]
count_field.function = ac.ConsolidationFunction.COUNT

pivot_table.calculate_data()

workbook.save("output_function.xlsx")

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

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

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

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

import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

headers = ["Category", "Item", "Year", "Amount"]
for j in range(len(headers)):
    worksheet.cells[0, j].put_value(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[i])):
        worksheet.cells[i + 1, j].put_value(data[i][j])

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(ac.PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")
pivot_table.data_fields[1].function = ac.ConsolidationFunction.COUNT

# 値フィールドを列軸にプロットします。
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, pivot_table.values_field)

pivot_table.calculate_data()

workbook.save("output_plot.xlsx")

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

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

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

はじめに

フィルターフィールドは、ピボット本体が表示するソースデータの どのサブセット を制御するピボットフィールドです。エンドユーザーはレンダリングされたピボットの上部にあるドロップダウンとしてそれを表示し、利用可能なページアイテムのいずれかを選択すると、そのページアイテムに属するレコードのみが要約されるようにピボット本体が再構築されます。ピボットフィールドは、PivotFieldType.ROW、PivotFieldType.COLUMN、または PivotFieldType.DATA ではなく PivotFieldType.PAGE として登録されたときにフィルターフィールドになります。

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

Aspose.Cells for Python via .NET は、フィルターフィールドを登録するための 2 つの同等の方法を公開しています。ハイレベル API は PivotTable.add_field_to_area(PivotFieldType.PAGE, "field_name") で、ソース列名を受け取り、単一の呼び出しでフィールドを追加します。低レベル API は PivotTable.page_fields.add(PivotField) で、すでに PivotField 参照を保持していて、同じフィールドインスタンスをページエリアに追加したい場合に使用されます。どちらの API も最終的に同じ page_fields コレクションに格納され、この記事の残りではそれらの選択方法と各フィルタリングモードの駆動方法を説明します。

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

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

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

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

import aspose.cells as ac

# 新しいワークブックを作成
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

# ヘッダー行を設定
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("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.cells[i + 1, 0].put_value(data[i][0])
    worksheet.cells[i + 1, 1].put_value(data[i][1])
    worksheet.cells[i + 1, 2].put_value(data[i][2])

# セルE3にアンカーされたピボットテーブルを追加
pivot_index = worksheet.pivot_tables.add("A1:C10", "E3", "PivotTable1")
pivot_table = worksheet.pivot_tables[pivot_index]

# フィールドをそれぞれのエリアに追加: Fruitを行、Amountをデータ、Yearをページフィールド
pivot_table.add_field_to_area(ac.PivotFieldType.Row, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.Data, "Amount")
pivot_table.add_field_to_area(ac.PivotFieldType.Page, "Year")

# ピボットテーブルのデータを更新して計算
pivot_table.calculate_data()

# ワークブックを保存
workbook.save("pageFieldSample.xlsx")

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

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

import aspose.cells as ac

# — ピボットテーブルとページフィールドは、Scenario 1a とまったく同じように構築されます
#   (Fruit/Year/Amount データ、E3 にピボット、Fruit→行、
#   Amount→データ)。以下では、BaseFields コレクションから
#   Year PivotField を取得し、PageFields.Add に渡します — これは
#   AddFieldToArea の低レベルの代替手段です。結果は
#   Scenario 1a と機能的に同一です。

workbook = ac.Workbook()
sheet = workbook.worksheets[0]

# ヘッダー
sheet.cells["A1"].put_value("Fruit")
sheet.cells["B1"].put_value("Year")
sheet.cells["C1"].put_value("Amount")

# サンプルデータ（9 行）
sheet.cells["A2"].put_value("apple");    sheet.cells["B2"].put_value("2020"); sheet.cells["C2"].put_value(100)
sheet.cells["A3"].put_value("apple");    sheet.cells["B3"].put_value("2021"); sheet.cells["C3"].put_value(150)
sheet.cells["A4"].put_value("apple");    sheet.cells["B4"].put_value("2022"); sheet.cells["C4"].put_value(200)
sheet.cells["A5"].put_value("grape");    sheet.cells["B5"].put_value("2020"); sheet.cells["C5"].put_value(300)
sheet.cells["A6"].put_value("grape");    sheet.cells["B6"].put_value("2021"); sheet.cells["C6"].put_value(400)
sheet.cells["A7"].put_value("grape");    sheet.cells["B7"].put_value("2022"); sheet.cells["C7"].put_value(500)
sheet.cells["A8"].put_value("blueberry"); sheet.cells["B8"].put_value("2020"); sheet.cells["C8"].put_value(250)
sheet.cells["A9"].put_value("blueberry"); sheet.cells["B9"].put_value("2021"); sheet.cells["C9"].put_value(350)
sheet.cells["A10"].put_value("blueberry");sheet.cells["B10"].put_value("2022"); sheet.cells["C10"].put_value(450)

# A1:C10 をカバーする E3 にピボットテーブルを追加
pivot_index = sheet.pivot_tables.add("E3", "A1:C10", "PivotTable1")
pivot_table = sheet.pivot_tables[pivot_index]

# Fruit → 行、Amount → データ（Year は以下にページへ追加）
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# 低レベルの方法: BaseFields から既存の Year PivotField を取得し、
# PageFields.Add(PivotField) 経由でページエリアに登録します。
year_field = pivot_table.base_fields["Year"]
pivot_table.page_fields.add(year_field)

# 新しいページフィールドが保存されたワークブックに反映されるように更新
pivot_table.calculate_data()

workbook.save("output.xlsx")

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

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

すべてのアイテムの表示

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

import aspose.cells as ac

# 新しいワークブックを作成
workbook = ac.Workbook()
sheet = workbook.worksheets[0]

# Fruit/Year/Amount のデータを入力
sheet.cells["A1"].put_value("Fruit")
sheet.cells["B1"].put_value("Year")
sheet.cells["C1"].put_value("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.cells[r + 1, c].put_value(data[r][c])

# E3 にピボットテーブルを作成
pivot_tables = sheet.pivot_tables
index = pivot_tables.add("=A1:C7", "E3", "PivotTable1")
pivot_table = pivot_tables[index]

# ピボットフィールドを設定: Fruit→行、Amount→データ、Year→ページ
pivot_table.add_field_to_area(ac.PivotFieldType.Row, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.Data, "Amount")
pivot_table.add_field_to_area(ac.PivotFieldType.Page, "Year")

pivot_table.calculate_data()

# ページフィルタをクリアして、ページフィールドの全項目を表示します。
# 0x7FFD（10進数で32765）は "全項目" を意味する特別なセンチネル値です —
# Excel のページフィールドドロップダウンで「(すべて)」を選択するのと同じです。
pivot_table.page_fields[0].current_page_item = 0x7FFD

workbook.save("output.xlsx")

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

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

import aspose.cells as ac

# ワークブックを作成
workbook = ac.Workbook()
sheet = workbook.worksheets[0]
cells = sheet.cells

# サンプルデータを追加 (果物/年/金額)
cells["A1"].put_value("Fruit")
cells["B1"].put_value("Year")
cells["C1"].put_value("Amount")

cells["A2"].put_value("Apple")
cells["B2"].put_value("2020")
cells["C2"].put_value("100")

cells["A3"].put_value("Apple")
cells["B3"].put_value("2021")
cells["C3"].put_value("150")

cells["A4"].put_value("Banana")
cells["B4"].put_value("2020")
cells["C4"].put_value("200")

cells["A5"].put_value("Banana")
cells["B5"].put_value("2021")
cells["C5"].put_value("250")

# E3にピボットテーブルを追加
pivot_tables = sheet.pivot_tables
pivot_index = pivot_tables.add("A1:C5", "E3", "PivotTable1")
pivot_table = pivot_tables[pivot_index]

# フィールドを追加: Fruit→行, Amount→データ, Year→ページ
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")
pivot_table.add_field_to_area(ac.PivotFieldType.PAGE, "Year")

# ページフィールド固有の操作
pivot_table.page_fields[0].current_page_item = 1  # 1 = ソート順で2番目の項目（例: "2021"）

# ピボットテーブルを更新して計算
pivot_table.calculate_data()

workbook.save("output.xlsx")

複数選択フィルタリング

複数選択フィルタリングはページドロップダウンをチェックボックスリストに変え、エンドユーザーが複数のページアイテムを同時に選択できるようにします。Aspose.Cells は連携して機能する 2 つのプロパティを公開しています。PivotField.is_multiple_item_selection_allowed は、複数選択 UI がまったく有効になる前に True に設定する必要があります。有効にした後、PivotItem.is_hidden がチェックボックスリストに表示されるアイテムを制御するため、すべてのアイテムを表示するか、特定のアイテムのみをホワイトリストに登録するかを選択できます。

以下のコードは、シナリオ 1a で構築された同じ Year フィルターフィールドで複数選択を有効にし、2 つのパターンを示します。パート A はすべての PivotItem の is_hidden を False のままにすることですべてのページアイテムを明らかにし、パート B は選択したソース値のみをホワイトリストに登録し、pivot_items[i].get_string_value() をテストする if / elif ブロックを通じてその他すべてを非表示にします。

import aspose.cells as ac

# — ピボットテーブルとページフィールドは以下とまったく同じ方法で構築されます
#   シナリオ1a（Fruit/Year/Amountデータ、E3にピボット、Fruit→行、
#   Amount→データ、Year→ページをAddFieldToArea経由で設定）。
#   以下ではページフィールドに複数選択フィルタを適用します。

workbook = ac.Workbook()
sheet = workbook.worksheets[0]
cells = sheet.cells

# サンプルデータ: Fruit | Year | Amount
cells[0, 0].put_value("Fruit")
cells[0, 1].put_value("Year")
cells[0, 2].put_value("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[i + 1, 0].put_value(data[i][0])
    cells[i + 1, 1].put_value(int(data[i][1]))
    cells[i + 1, 2].put_value(int(data[i][2]))

pivot_sheet = workbook.worksheets.add("Pivot")
pivots = pivot_sheet.pivot_tables
pivot_index = pivots.add("E3", "A1:C10", "PivotTable1")
pivot_table = pivots[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")
pivot_table.add_field_to_area(ac.PivotFieldType.PAGE, "Year")

# — ページフィールドで複数選択を有効化
pivot_table.page_fields[0].is_multiple_item_selection_allowed = True

# パートA — すべての項目を選択（すべての項目を表示）
pivot_items = pivot_table.page_fields[0].pivot_items
for i in range(pivot_items.count):
    pivot_items[i].is_hidden = False

# パートB — ソース値で特定の項目のみを選択
for i in range(pivot_items.count):
    value = pivot_items[i].get_string_value()
    if value == "2020" or value == "grape" or value == "blueberry":
        pivot_items[i].is_hidden = False
    else:
        pivot_items[i].is_hidden = True

pivot_table.calculate_data()

workbook.save("output.xlsx")

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

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

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

シナリオ / ユースケース	推奨される API	使用するプロパティ	メモ
ソース列名でフィルターフィールドを追加する (最も一般的)	`PivotTable.add_field_to_area(PivotFieldType.PAGE, "field_name")`	n/a	ハイレベル、ワンライナー。`PivotField` 参照が必要ない場合はこれを使用します。
すでに `PivotField` オブジェクトを持っている場合にフィルターフィールドを追加する	`PivotTable.page_fields.add(PivotField)`	n/a	フィールドオブジェクトが他の場所で取得されたものであるか、再利用が必要な場合に使用します。
単一のページアイテムにフィルタリングする (デフォルトモード)	`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 つのアイテムが表示されたままになるように、ソースデータに対してホワイトリストを構築してください。そうすれば、保存したワークブックはすべてのマシンで確実に開きます。

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

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

Aspose.Cells for Python via .NETでは、ワークシートからPivot Tableを削除または削除する機能が提供されます。ピボットテーブルオブジェクトまたはピボットテーブルの位置を使用してピボットテーブルを削除できます。ピボットテーブルオブジェクトを使用してピボットテーブルを削除するにはWorksheet.pivot_tables.remove(pivot_table)メソッドを使用し、ピボットテーブルのポジションでピボットテーブルオブジェクトを削除するにはWorksheet.pivot_tables.remove_at(index, keep_data)メソッドを使用してください。

Aspose.Cells for Python Excelライブラリを使用したワークシートからピボットテーブルを削除する方法

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

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

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

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

Aspose.Cells for Python via .NETは、既存のピボットテーブルを含むワークブックを変換するか、新しいピボットテーブルを作成してファイルをODS形式で保存する能力を提供します。これには、出力ODSファイルでピボットテーブルがレンダリングされることを保証するために、保存する前にPivotTable.calculate_dataを呼び出すことが重要です。次のコードスニペットは、ODSファイルにピボットテーブルを保存する方法を示しています。

サンプルコード

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

出力ODSファイル

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

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

ピボットテーブルの外観

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

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

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

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

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

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

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

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

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

Excel ライブラリの Aspose.Cells for Python によるピボットテーブルおよびチャートの追加

Aspose.Cells for Python via .NET の使用の準備

Aspose.Cells for Python Excel ライブラリを使用してピボットテーブルを追加する方法

Aspsoe.Cells for Python Excel ライブラリを使用してピボットチャートを追加する方法

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

Pivot Tableのソースデータ

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

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

可能な使用シナリオ

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

Aspose.Cells for Python Excelライブラリを使用してピボットテーブルに計算フィールドを追加する方法

サンプルコード

Pythonnet: Aspose.Cells for Python via .NET でのピボットテーブルの更新

はじめに

必要なインポート

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

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

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

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

表示やレイアウトのみが変更された場合 — calculate_data() を使用する

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

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

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

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

はじめに

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

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

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

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

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

関連記事

Pythonnet: Aspose.Cells for Python via .NET でピボットテーブルの行フィールドと列フィールドを追加する

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

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

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

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

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

まとめ

関連記事

まとめ

関連記事

Pythonnet: Aspose.Cells for Python via .NET でピボットテーブルの値フィールドを管理する

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

集計関数の変更

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

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

はじめに

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

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

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

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

すべてのアイテムの表示

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

複数選択フィルタリング

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

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

Aspose.Cells for Python Excelライブラリを使用したワークシートからピボットテーブルを削除する方法

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

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

サンプルコード

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

表示やレイアウトのみが変更された場合 — `calculate_data()` を使用する

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

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

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

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