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

Pythonnet: ラベルまたは値でピボットテーブルをフィルタリングする

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

Aspose.Cellsは、ピボットテーブルに表示されるデータをフィルタリングするための5つの実用的な戦略を提供します。テキストベースの行または列フィールドにラベルフィルタを適用し、フィールドに日時セルのみが含まれるか空白である場合には日付フィルタを使用し、集計された数値に対して値フィルタを適用し、値フィールドによるランキングでトップ10フィルタを使用するか、is_hiddenプロパティを使用して個々のピボットアイテムを手動で表示・非表示にすることができます。各戦略は、PivotFieldクラスとPivotItemクラスの専用APIを通じて公開されています。

はじめに

ピボットテーブルは強力な分析ツールですが、生の概要には提示する必要のある情報よりもはるかに多くの情報が含まれていることがよくあります。フィルタリングは、特定のレポートにとって重要な行、列、または値にピボットテーブルを絞り込むための主要なメカニズムです。Aspose.Cells for Python via .NETは、Microsoft Excelで利用可能なフィルタリング機能を反映しており、レポート生成を完全に自動化できるようにプログラムで公開しています。

この記事で扱うフィルタリング戦略は次のとおりです。

ラベルフィルタ — テキストラベルに基づいて行または列フィールドのアイテムをフィルタリングします。
日付フィルタ — 日時値（または空白）のみを含む行または列フィールドをフィルタリングします。
値フィルタ — データフィールドの集計値に基づいてアイテムをフィルタリングします。
トップ10フィルタ — 値フィールドによるランキングで上位または下位N個のアイテムのみを表示します。
ピボットアイテムの表示・非表示 — フィールド内の各アイテムの表示を手動で制御します。

各アプローチは、PivotFieldクラスの異なるメソッド、またはPivotItemクラスのプロパティを使用します。フィルタを適用した後、ピボットテーブルでrefresh_data()とcalculate_data()を呼び出して、キャッシュされたデータと計算値が新しいフィルタ状態を反映するようにする必要があります。

ラベルフィルタ

ラベルフィルタを使用すると、行または列フィールドのアイテムをテキストキャプションをパターンと比較することでフィルタリングできます。これは、特定の文字で始まる名前、特定の単語を含む名前、または他のキャプション基準に一致する製品のみを表示する場合に便利です。

Aspose.Cellsは、PivotField.filter_by_label(PivotFilterType, label_string)メソッドを通じてラベルフィルタリングを公開しています。PivotFilterType列挙には、CaptionBeginsWith、CaptionContains、CaptionEndsWith、CaptionDoesNotContain、CaptionIsNotBlank、CaptionIsBlankなどの値が含まれます。2番目の引数は、比較に使用されるラベル文字列を提供します。

次の例は、既存のピボットテーブルを含むワークブックを読み込み、キャプションが指定された接頭辞で始まるアイテムのみが表示されるようにラベルフィルタを適用し、ピボットテーブルを更新して結果を保存します。

import aspose.cells as ac

fileName = "sample.xlsx"
prefix = "B"

# ピボットテーブルを含む既存のワークブックをロードします
workbook = ac.Workbook(fileName)

# インデックスでワークシートにアクセスします（最初のワークシート）
worksheet = workbook.worksheets[0]

# インデックスでピボットテーブルにアクセスします
pivot_table = worksheet.pivot_tables[0]

# 最初の行の PivotField を取得します
row_field = pivot_table.row_fields[0]

# ラベルフィルターを適用します — 指定された接頭辞で始まるラベルの行項目のみを表示します
row_field.filter_by_label(ac.PivotFilterType.CAPTION_BEGINS_WITH, prefix, "")

# フィルターを反映するためにピボットテーブルのデータを更新して再計算します
pivot_table.pivot_cache.refresh()

# ワークブックをディスクに保存します
workbook.save(fileName)

日付フィルタ

日付フィルタを使用すると、今日、先週、今月、次の四半期、特定の日付範囲などの日付ベースの基準でピボットテーブルを絞り込むことができます。これらは、日時情報を格納するフィールドに対してのみ機能する特殊なフィルタです。

日付フィルタは、行または列の領域に日時セルのみが含まれるか空白の場合にのみ機能します。基になるフィールドに数値やテキストなどの他のデータ型が含まれている場合、日付フィルタは期待される結果を生成しません。このフィルタを適用する前に、フィールドが日付として書式設定され、すべての値が有効なDateTimeインスタンスまたは空のセルであることを確認してください。

Aspose.Cellsは、PivotField.filter_by_date(PivotFilterType, *date_times)メソッドを通じて日付フィルタリングを公開しています。PivotFilterType列挙には、Today、Yesterday、LastWeek、ThisWeek、NextWeek、LastMonth、ThisMonth、NextMonth、LastQuarter、ThisQuarter、NextQuarter、LastYear、ThisYear、NextYear、Betweenなどの専用日付値が含まれます。選択したフィルタタイプに応じて、1つまたは2つのDateTime値を渡します（Betweenの場合は開始日と終了日を渡します）。

次の例は、行領域に日付フィールドを含むピボットテーブルを持つワークブックを読み込み、表示対象のアイテムを特定の日付範囲に制限する日付フィルタを適用し、ピボットテーブルを更新してワークブックを保存します。

from datetime import datetime

input_path = "sample.xlsx"
output_path = "output_filtered.xlsx"

if not os.path.exists(input_path):
    raise FileNotFoundError("Source workbook not found.", input_path)

# ピボットテーブルを含む既存のワークブックを読み込む
workbook = ac.Workbook(input_path)

# ピボットテーブルを含むワークシートにアクセスする(インデックス指定)
worksheet = workbook.worksheets[0]

# インデックスでピボットテーブルにアクセスする
pivot_table = worksheet.pivot_tables[0]

# 行エリアから日付PivotFieldを取得する
# (日付フィルターは、行/列エリアに日時セルまたは空白のみが含まれている場合にのみ機能します)
date_field = pivot_table.row_fields[0]

# Betweenフィルターの日付条件を指定する
start_date = datetime(2020, 1, 1)
end_date = datetime(2020, 12, 31)

# ピボットフィールドに日付フィルターを適用する
date_field.filter_by_date(ac.PivotFilterType.DATE_BETWEEN, start_date, end_date)

# フィルターを有効にするためにピボットテーブルを更新して再計算する
pivot_table.pivot_cache.refresh()

# ワークブックを保存する
workbook.save(output_path)

値フィルタ

値フィルタは、ピボットテーブルがデータ領域で計算する集計値に対して機能します。テキストラベルを照合する代わりに、数値の合計をしきい値と比較します。典型的な使用例には、売上合計が目標額を超える製品のみを表示する、またはトランザクション数が範囲内に入る地域のみを表示するなどがあります。

Aspose.Cellsは、PivotField.filter_by_value(value_field, PivotFilterType, *thresholds)メソッドを通じて値フィルタリングを公開しています。PivotFilterTypeパラメータは、ValueGreaterThan、ValueLessThan、ValueBetween、ValueEqual、ValueNotEqual、ValueGreaterThanOrEqual、ValueLessThanOrEqualなどの値を使用します。value_fieldパラメータは評価するデータフィールドを指定し、最後の引数はしきい値を提供します。

次の例は、ピボットテーブルを含むワークブックを読み込み、集計された売上が数値しきい値を超えるアイテムのみを保持する値フィルタを適用し、ピボットテーブルを更新してワークブックを保存します。

import aspose.cells as ac

workbook = ac.Workbook("sample.xlsx")
worksheet = workbook.worksheets[0]
pivot_table = worksheet.pivot_tables[0]

row_field = pivot_table.row_fields[0]
data_field = pivot_table.data_fields[0]

# PivotFieldCollection には IndexOf がないため、データフィールドのインデックスを手動で見つけます
data_field_index = -1
for i in range(pivot_table.data_fields.count):
    if pivot_table.data_fields[i] == data_field:
        data_field_index = i
        break

if data_field_index >= 0:
    row_field.filter_by_value(data_field_index, ac.PivotFilterType.VALUE_GREATER_THAN, 5000, float('inf'))

pivot_table.pivot_cache.refresh()

workbook.save("output.xlsx")

トップ10フィルタ

トップ10フィルタは、選択した値フィールドに基づいて最高または最低のN個のアイテムのみを保持する値フィルタの特殊な形式です。「収益によるトップ10製品」や「売上数によるワースト5地域」などのランキングレポートによく使用されます。

トップ10フィルタは、ピボットテーブルのデータ領域に1つ以上の値ピボットフィールドがある場合にのみ有効です。少なくとも1つの値フィールドがなければ、アイテムをランク付けするための集計指標がなく、フィルタを適用できません。

Aspose.Cellsは、PivotField.filter_top_10(item_count, is_top, value_field, PivotFilterType)メソッドを通じてトップ10フィルタリングを公開しています。item_countパラメータは保持するアイテムの数を定義し、is_topは上位アイテムを保持するか（True）下位アイテムを保持するか（False）を示し、value_fieldはランキングに使用されるデータフィールドを参照し、PivotFilterTypeは値の計算方法を制御します（通常はSumですが、CountやPercentも使用できます）。

次の例は、値フィールドを含むピボットテーブルを持つワークブックを読み込み、売上合計による上位10アイテムのみを保持するトップ10フィルタを適用し、ピボットテーブルを更新してワークブックを保存します。

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

# ピボットテーブルを含む既存のワークブックを読み込みます
inputPath = "input.xlsx"
outputPath = "output.xlsx"
workbook = ac.Workbook(inputPath)

# ピボットテーブルを含むワークシートにアクセスします（インデックス 0）
worksheet = workbook.worksheets[0]

# インデックスでピボットテーブルにアクセスします
pivotTable = worksheet.pivot_tables[0]

# データ領域に少なくとも 1 つの値 PivotField があることを確認します
if pivotTable.data_fields.count == 0:
    raise Exception("Pivot table has no value (data) PivotField.")
valueField = pivotTable.data_fields[0]

# 対象の行 PivotField（Top 10 を適用するフィールド）を取得します
rowField = pivotTable.row_fields[0]

# 最初（かつ唯一の）データフィールドはインデックス 0 にあります。Top 10 はこれでランク付けします。
valueFieldIndex = 0

# 行フィールドに Top 10 フィルターを適用します:
#   - itemCount   = 10
#   - filterType  = PivotFilterType.Sum
#   - isTop       = true (上位 N。false の場合は下位 N)
#   - valueFieldIndex = 項目のランク付けに使用されるデータフィールドのインデックス
rowField.filter_top10(10, acp.PivotFilterType.Sum, True, valueFieldIndex)

# ピボットテーブルのデータを更新し、フィルターを有効にするために再計算します
pivotTable.pivot_cache.refresh()

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

ピボットアイテムの表示・非表示によるフィルタリング

構造化フィルタAPIに加えて、Aspose.Cellsでは各ピボットアイテムの表示を直接制御できます。PivotFieldのPivotItemsコレクションを反復処理し、is_hiddenプロパティを切り替えることで、数式ベースのフィルタを適用せずに特定のアイテムを選択的に除外できます。is_hidden = Trueを設定するとアイテムがピボットテーブルから非表示になり、is_hidden = Falseを設定すると再表示されて再び表示されるようになります。

このアプローチは、フィルタリングルールが不規則またはアイテム固有である場合、たとえば特定のレポートに表示すべきではない少数の名前付きカテゴリを非表示にする場合に役立ちます。以下の例では、ピボットテーブルを読み込み、特定のアイテムを名前で非表示にし、再表示する方法を実演し、ピボットテーブルを更新してワークブックを保存します。

import aspose.cells as ac

# ピボットテーブルを含む既存のワークブックを読み込む
workbook = ac.Workbook("pivot_table_sample.xlsx")

# ピボットテーブルを含む最初のワークシートにアクセスする
sheet = workbook.worksheets[0]

# インデックスでピボットテーブルにアクセスする（シート上の最初のピボットテーブル）
pivot_table = sheet.pivot_tables[0]

# 対象のPivotFieldを取得する（アイテムを非表示/再表示する最初の行ラベルフィールド）
pivot_field = pivot_table.row_fields[0]

# 選択したPivotFieldのPivotItemsコレクションを反復処理する
item_count = pivot_field.pivot_items.count
for i in range(item_count):
    item = pivot_field.pivot_items[i]

    # 特定の名前/条件に一致するピボットアイテムを非表示にする
    if item.name == "Item1" or item.name == "Item2":
        item.is_hidden = True

    # 再表示の例: 以前に非表示にしたピボットアイテムを再度表示する
    if item.name == "Item3":
        item.is_hidden = False

# 変更を反映させるためにピボットテーブルを更新して再計算する
pivot_table.pivot_cache.refresh()

# ワークブックを保存する — 非表示のアイテムは基になるデータに残ります
# が、表示されるピボットテーブルの出力からは除外されます
workbook.save("output_pivot_filtered.xlsx")

まとめ

Aspose.Cells for Python via .NETは、Microsoft Excelにあるものと同等の完全なピボットテーブルフィルタリング機能を提供します。ラベル、日付、および値フィルタは最も一般的な分析シナリオをカバーし、トップ10フィルタはランキングレポートを処理します。フィルタリングルールが不規則な場合は、PivotItem.is_hiddenプロパティが柔軟なアイテムレベルのフォールバックを提供します。これらの戦略を組み合わせる（たとえば、ラベルフィルタを適用してから特定のアイテムを非表示にする）ことで、コードからピボットテーブルレポートを正確に作成できます。

Pythonnet: PivotTableのPivotFieldのDisplayNameによってCellオブジェクトを取得する

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

Aspose.Cells for Python via .NETでは、ピボットフィールドのディスプレイ名によってセルオブジェクトにアクセスするために使用できるPivotTable.get_cell_by_display_name(display_name)メソッドを提供しています。このメソッドは、ピボットフィールドヘッダーを強調表示または書式設定したい場合に役立ちます。この記事では、データフィールドの表示名によってセルオブジェクトを取得し、その後書式設定を適用する方法について説明しています。

PivotTableのPivotFieldのDisplayNameによってCellオブジェクトを取得する方法

以下のコードは、ワークシートの最初のピボットテーブルにアクセスし、ピボットテーブルの2番目のデータフィールドのDisplay名によるセルを取得します。そして、セルの塗りつぶし色とフォント色をそれぞれライトブルーとブラックに変更します。以下のスクリーンショットは、コードの実行前と後のピボットテーブルの様子を示しています。

ピボットテーブル - 実行前

ピボットテーブル - 実行後

Pythonnet: ピボットテーブル内のPivot Fieldをグループ化

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

可能な使用シナリオ

Microsoft Excelでは、ピボットテーブルのPivot Fieldをグループ化することができます。ピボットフィールドに関連するデータが大量の場合、それらをセクションにグループ化することはしばしば有用です。Aspose.Cells for Python via .NETも、PivotTable.set_manual_group_field()メソッドを使用してこの機能を提供します。

Pivot TableでPivot Fieldsをグループ化する方法

以下のサンプルコードは、サンプルExcelファイルをロードし、PivotTable.set_manual_group_field()メソッドを使用して最初のピボットフィールドにグループ化を行います。それからピボットテーブルのデータをリフレッシュして計算し、ブックを出力Excelファイルとして保存します。スクリーンショットは、サンプルコードのサンプルExcelファイルに対する効果を示しています。スクリーンショットに示されているように、最初のピボットフィールドは現在月ごとと四半期ごとにグループ化されています。

サンプルコード

Pythonnet: ピボットテーブルのデータを非表示にしたり並べ替えたり

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

Aspose.Cells for Python Excelライブラリを使用したピボットテーブルのデータの非表示とソート

Aspose.Cells for Python via .NETは、ピボットテーブルでデータを非表示およびソートする機能をサポートしています。次のコードスニペットは、Score列を降順でソートし、スコアが60未満の行を非表示にするこの機能を示しています。

コードスニペットで使用されているソースと出力のExcelファイルは、参照用に添付されています。

ソースファイル

出力ファイル

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

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

可能な使用シナリオ

既知のデータを使用してピボットテーブルを作成し、ピボットテーブルをフィルタする場合は、フィルタを学習して使用する必要があります。 Aspose.Cells for Python via .NET APIを使用すると、ピボットテーブルのフィールド値にフィルタを追加できます。

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

次のサンプルコードを参照してください。データを設定し、それに基づいてPivotTableを作成します。次に、ピボットテーブルの行フィールドにフィルタを追加します。最後に、output XLSX形式でブックを保存します。サンプルコードを実行した後は、ワークシートにトップ10フィルタが追加されたピボットテーブルが表示されます。

サンプルコード

Pythonnet: ピボットテーブルのカスタムソート

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

Aspose.Cells for Python Excel ライブラリを使用してピボットテーブルでカスタムソーティングを設定する方法

Aspose.Cells for Python via .NET API を使用して、フィールド値でピボットテーブルをソートすることができます。以下のコードスニペットは、サンプルの Excel ファイルを読み込んで、3 つのピボットテーブルを追加しています。最初のピボットテーブルはカスタムソートなし、2 番目のピボットテーブルは「SeaFood」の行フィールド値でソートされ、3 番目のピボットテーブルは「28/07/2000」の列フィールド値でソートされています。

サンプルソースファイルと出力ファイルは、テスト用のサンプルコードをダウンロードできます:

元のExcelファイル

出力Excelファイル

[出力PDFファイル]（98107430.pdf)

サンプルコード

Pythonnet: ピボットテーブルのフィルタをクリアする

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

可能な使用シナリオ

既知のデータでピボットテーブルを作成し、ピボットテーブルをフィルタリングしたい場合は、フィルターを学習して使用する必要があります。効果的に必要なデータをフィルタリングするのに役立ちます。Aspose.Cells for Python via .NET APIを使用することで、ピボットテーブルでフィールド値にフィルターを操作できます。

Excelのピボットテーブルでフィルターをクリアする方法

Excelでピボットテーブルのフィルタをクリアするには、以下の手順に従います：

クリアしたいPivotTableを選択します。
ピボットテーブルでクリアしたいフィルタのドロップダウン矢印をクリックします。
ドロップダウンメニューから「フィルタをクリア」を選択します。
ピボットテーブルからすべてのフィルタをクリアしたい場合は、ExcelのリボンのPivotTable Analyzeタブで「フィルタをクリア」ボタンをクリックすることもできます。

Aspose.Cells for Python Excelライブラリを使用してピボットテーブルでフィルターをクリアする方法

Aspose.Cells for Python via .NETを使用してピボットテーブルでフィルターをクリアする。以下はサンプルコードをご覧ください。

データを設定し、それに基づいてPivotTableを作成します。
ピボットテーブルの行フィールドにフィルタを追加します。
output XLSX形式でブックを保存します。サンプルコードを実行した後は、ワークシートにトップ10フィルタが追加されたピボットテーブルが表示されます。
特定のピボットフィールドのフィルタをクリアします。フィルタをクリアするコードを実行した後、特定のピボットフィールドのフィルタがクリアされます。output XLSXをご確認ください。

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

Pythonnet: ラベルまたは値でピボットテーブルをフィルタリングする

はじめに

ラベルフィルタ

日付フィルタ

値フィルタ

トップ10フィルタ

ピボットアイテムの表示・非表示によるフィルタリング

まとめ

関連記事

Pythonnet: PivotTableのPivotFieldのDisplayNameによってCellオブジェクトを取得する

PivotTableのPivotFieldのDisplayNameによってCellオブジェクトを取得する方法

Pythonnet: ピボットテーブル内のPivot Fieldをグループ化

可能な使用シナリオ

Pivot TableでPivot Fieldsをグループ化する方法

サンプルコード

Pythonnet: ピボットテーブルのデータを非表示にしたり並べ替えたり

Aspose.Cells for Python Excelライブラリを使用したピボットテーブルのデータの非表示とソート

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

可能な使用シナリオ

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

サンプルコード

Pythonnet: ピボットテーブルのカスタムソート

Aspose.Cells for Python Excel ライブラリを使用してピボットテーブルでカスタムソーティングを設定する方法

サンプルコード

Pythonnet: ピボットテーブルのフィルタをクリアする

可能な使用シナリオ

Excelのピボットテーブルでフィルターをクリアする方法

Aspose.Cells for Python Excelライブラリを使用してピボットテーブルでフィルターをクリアする方法

サンプルコード