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

Java: ピボットテーブルのラベルまたは値によるフィルター処理

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

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

はじめに

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

ラベルフィルター — テキストラベルに基づいて行または列フィールドのアイテムをフィルターします。
日付フィルター — 日付時刻値（または空白）のみを含む行または列フィールドをフィルターします。
値フィルター — データフィールドの集計値に基づいてアイテムをフィルターします。
トップ10フィルター — 値フィールドによるランキングで上位または下位 N 個のアイテムのみを表示します。
ピボットアイテムの表示/非表示 — フィールド内の各アイテムの表示を手動で制御します。各アプローチは PivotField クラスの異なるメソッド、または PivotItem クラスのプロパティを使用します。フィルターを適用した後、ピボットテーブルで refreshData() と calculateData() を呼び出して、キャッシュされたデータと計算値が新しいフィルター状態を反映するようにする必要があります。

ラベルフィルター

ラベルフィルターを使用すると、テキストキャプションをパターンと比較して、行または列フィールドのアイテムをフィルターできます。これは、特定の文字で始まる名前、特定の単語を含む名前、または他のキャプションベースの基準に一致する商品のみを表示したい場合に役立ちます。 Aspose.Cells は、PivotField.filterByLabel(PivotFilterType, String) メソッドを通じてラベルフィルターを公開しています。PivotFilterType 列挙型には、CaptionBeginsWith、CaptionContains、CaptionEndsWith、CaptionDoesNotContain、CaptionIsNotBlank、CaptionIsBlank などの値が含まれます。2 番目の引数は比較に使用されるラベル文字列を提供します。次の例では、既存のピボットテーブルを含むワークブックを読み込み、キャプションが指定されたプレフィックスで始まるアイテムのみが表示されるようにラベルフィルターを適用し、ピボットテーブルを更新して結果を保存します。

import com.aspose.cells.*;

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

// ピボットテーブルを含む既存のワークブックを読み込む
Workbook workbook = new Workbook(fileName);

// インデックスでワークシートにアクセスする（最初のワークシート）
Worksheet worksheet = workbook.getWorksheets().get(0);

// インデックスでピボットテーブルにアクセスする
PivotTable pivotTable = worksheet.getPivotTables().get(0);

// 最初の行の PivotField を取得する
PivotField rowField = pivotTable.getRowFields().get(0);

// ラベルフィルターを適用する - 指定された接頭辞で始まるラベルの行項目のみを表示する
rowField.filterByLabel(PivotFilterType.CAPTION_BEGINS_WITH, prefix, "");

// フィルターを有効にするためにピボットテーブルのデータを更新して再計算する
pivotTable.refreshData();

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

日付フィルター

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

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

Aspose.Cells は、PivotField.filterByDate(PivotFilterType, params DateTime[] values) メソッドを通じて日付フィルターを公開しています。PivotFilterType 列挙型には、Today、Yesterday、LastWeek、ThisWeek、NextWeek、LastMonth、ThisMonth、NextMonth、LastQuarter、ThisQuarter、NextQuarter、LastYear、ThisYear、NextYear、Between などの専用日付値が含まれます。選択したフィルタータイプに応じて、1 つまたは 2 つの DateTime 値を渡します（Between の場合は開始日と終了日を渡します）。次の例では、行領域に日付フィールドを含むピボットテーブルを含むワークブックを読み込み、表示可能なアイテムを特定の日付範囲に制限する日付フィルターを適用し、ピボットテーブルを更新してワークブックを保存します。

import java.io.File;
import java.io.FileNotFoundException;

String inputPath = "sample.xlsx";
String outputPath = "output_filtered.xlsx";

if (!new File(inputPath).exists())
{
    throw new FileNotFoundException("Source workbook not found: " + inputPath);
}

// ピボットテーブルを含む既存のワークブックを読み込みます
Workbook workbook = new Workbook(inputPath);

// ピボットテーブルを保持するワークシートに（インデックスで）アクセスします
Worksheet worksheet = workbook.getWorksheets().get(0);

// インデックスでピボットテーブルにアクセスします
PivotTable pivotTable = worksheet.getPivotTables().get(0);

// 行エリアから日付のPivotFieldを取得します
// (日付フィルターは行/列エリアに日時セルまたは空白のみが含まれている場合にのみ機能します)
PivotField dateField = pivotTable.getRowFields().get(0);

// Betweenフィルターの日付基準を定義します
DateTime startDate = new DateTime(2020, 1, 1);
DateTime endDate = new DateTime(2020, 12, 31);

// ピボットフィールドに日付フィルターを適用します
dateField.filterByDate(PivotFilterType.DATE_BETWEEN, startDate, endDate);

// フィルターを有効にするためにピボットテーブルを更新して再計算します
pivotTable.refreshData();

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

値フィルター

値フィルターは、ピボットテーブルがデータ領域で計算する集計値に対して機能します。テキストラベルを照合する代わりに、数値の合計をしきい値と比較します。典型的なユースケースには、売上合計が目標額を超える製品のみを表示する、またはトランザクション数が範囲内に収まる地域のみを表示するなどが含まれます。 Aspose.Cells は、PivotField.filterByValue(PivotField valueField, PivotFilterType filterType, params Object[] values) メソッドを通じて値フィルターを公開しています。filterType パラメータは ValueGreaterThan、ValueLessThan、ValueBetween、ValueEqual、ValueNotEqual、ValueGreaterThanOrEqual、ValueLessThanOrEqual などの値を使用します。valueField パラメータは評価されるデータフィールドを指定し、最後の引数はしきい値を提供します。次の例では、ピボットテーブルを含むワークブックを読み込み、集計された売上が数値のしきい値を超えるアイテムのみを保持する値フィルターを適用し、ピボットテーブルを更新してワークブックを保存します。

import com.aspose.cells.*;

Workbook workbook = new Workbook("sample.xlsx");
Worksheet worksheet = workbook.getWorksheets().get(0);
PivotTable pivotTable = worksheet.getPivotTables().get(0);

PivotField rowField = pivotTable.getRowFields().get(0);
PivotField dataField = pivotTable.getDataFields().get(0);

// PivotFieldCollectionにIndexOfがないため、データフィールドのインデックスを手動で検索する
int dataFieldIndex = -1;
for (int i = 0; i < pivotTable.getDataFields().getCount(); i++)
{
    if (pivotTable.getDataFields().get(i) == dataField)
    {
        dataFieldIndex = i;
        break;
    }
}

if (dataFieldIndex >= 0)
{
    rowField.filterByValue(dataFieldIndex, PivotFilterType.VALUE_GREATER_THAN, 5000, Double.MAX_VALUE);
}

pivotTable.refreshData();

workbook.save("output.xlsx");

トップ10フィルター

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

トップ10フィルターは、ピボットテーブルのデータ領域に 1 つ以上の値ピボットフィールドがある場合にのみ効果的です。少なくとも 1 つの値フィールドがないと、アイテムをランキングするための集計メジャーがないため、フィルターを適用できません。

Aspose.Cells は、PivotField.filterTop10(int itemCount, boolean isTop, PivotField valueField, PivotFilterType filterType) メソッドを通じてトップ10フィルターを公開しています。itemCount パラメータは保持するアイテム数を定義し、isTop は上位アイテムを保持するかどうかを示し（true で上位、false で下位）、valueField はランキングに使用されるデータフィールドを参照し、filterType は値の計算方法を制御します（通常は Sum ですが、Count や Percent もあります）。次の例では、値フィールドを含むピボットテーブルを含むワークブックを読み込み、売上の合計で上位 10 個のアイテムのみを保持するトップ10フィルターを適用し、ピボットテーブルを更新してワークブックを保存します。

import com.aspose.cells.*;

// ピボットテーブルを含む既存のワークブックを読み込む
String inputPath = "input.xlsx";
String outputPath = "output.xlsx";
Workbook workbook = new Workbook(inputPath);

// ピボットテーブルを保持するワークシートにアクセスする (インデックス0)
Worksheet worksheet = workbook.getWorksheets().get(0);

// インデックスでピボットテーブルにアクセスする
PivotTable pivotTable = worksheet.getPivotTables().get(0);

// データ領域に少なくとも1つの値PivotFieldがあることを確認する
if (pivotTable.getDataFields().getCount() == 0)
{
    throw new RuntimeException("Pivot table has no value (data) PivotField.");
}
PivotField valueField = pivotTable.getDataFields().get(0);

// 対象の行PivotFieldを取得する (Top 10を適用するフィールド)
PivotField rowField = pivotTable.getRowFields().get(0);

// 最初(かつ唯一の)データフィールドはインデックス0にある。Top 10はこれによってランク付けされる。
int valueFieldIndex = 0;

// 行フィールドにTop 10フィルターを適用する:
//   - itemCount   = 10
//   - filterType  = PivotFilterType.SUM
//   - isTop       = true (上位N件; falseは下位N件を意味する)
//   - valueFieldIndex = アイテムをランク付けするために使用されるデータフィールドのインデックス
rowField.filterTop10(10, PivotFilterType.SUM, true, valueFieldIndex);

// ピボットテーブルのデータを更新し、再計算してフィルターを有効にする
pivotTable.refreshData();

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

ピボットアイテムの表示/非表示によるフィルター

構造化されたフィルター API に加えて、Aspose.Cells では各ピボットアイテムの表示を直接制御できます。PivotField の PivotItems コレクションを反復処理し、IsHidden プロパティを切り替えることで、数式ベースのフィルターを適用せずに特定のアイテムを選択的に除外できます。IsHidden = true を設定するとアイテムがピボットテーブルから非表示になり、IsHidden = false を設定すると再表示されて再び表示されるようになります。このアプローチは、フィルター規則が不規則であるか、アイテム固有である場合（特定のレポートに表示すべきでない少数の名前付きカテゴリを非表示にするなど）に役立ちます。以下の例では、ピボットテーブルを読み込み、特定のアイテムを名前で非表示にし、再表示する方法を実証し、ピボットテーブルを更新してワークブックを保存します。

import com.aspose.cells.*;

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

// ピボットテーブルを含む最初のワークシートにアクセスする
Worksheet sheet = workbook.getWorksheets().get(0);

// インデックスでピボットテーブルにアクセスする（シート上の最初のピボットテーブル）
PivotTable pivotTable = sheet.getPivotTables().get(0);

// 対象のPivotFieldを取得する（アイテムの表示/非表示を切り替える最初の行ラベルフィールド）
PivotField pivotField = pivotTable.getRowFields().get(0);

// 選択したPivotFieldのPivotItemsコレクションを反復処理する
int itemCount = pivotField.getPivotItems().getCount();
for (int i = 0; i < itemCount; i++)
{
    PivotItem item = pivotField.getPivotItems().get(i);

    // 特定の名前/条件に一致するピボットアイテムを非表示にする
    if (item.getName() == "Item1" || item.getName() == "Item2")
    {
        item.setHidden(true);
    }

    // 非表示解除のデモ: 非表示にしていたピボットアイテムを再表示する
    if (item.getName() == "Item3")
    {
        item.setHidden(false);
    }
}

// 変更を反映するためピボットテーブルを更新して再計算する
pivotTable.refreshData();

// ワークブックを保存 - 非表示アイテムは元データに残る
// ただし、表示されるピボットテーブルの出力からは除外される
workbook.save("output_pivot_filtered.xlsx");

まとめ

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

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

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

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

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

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

ソースExcelファイル

出力Excelファイル

出力PDFファイル

Java: ピボットアイテムの絶対位置を指定する

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

ユーザーがピボットアイテムの絶対位置を指定する必要がある場合、Aspose.Cells API はこのユーザー要件を満たすためにいくつかの新しいプロパティとメソッドを公開しています。

親ノードに関係なくすべてのPivotItemsの位置インデックスを指定するために使用できるPivotItem.setPosition()プロパティが追加されました。- 同じ親ノード内のPivotItemsの位置インデックスを指定するために使用できるPivotItem.setPositionInSameParentNode()プロパティが追加されました。
移動する位置のカウント値に基づいてアイテムを上下に移動するための PivotItem.move(int count, boolean isSameParent) メソッドが追加されました。カウント値がゼロより小さい場合、アイテムが上に移動し、カウント値がゼロより大きい場合、PivotItem が下に移動します。同じ親ノード内で移動操作を行うかどうかを指定するブール型の isSameParent パラメータが含まれています。
PivotItem.move(int count) メソッドが廃止されたため、代わりに新たに追加されたメソッド PivotItem.move(int count, boolean isSameParent) を使用することが推奨されます。

なお、これらのプロパティとメソッドを使用する前に、必ず PivotTable.refreshData および PivotTable.calculateData メソッドを呼び出す必要があります。

サンプルコード

次のサンプルコードでは、ピボットテーブルを作成し、同じ親ノード内での Pivot Items の位置を指定しています。

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

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

可能な使用シナリオ

Microsoft Excelでは、ピボットテーブルのピボットフィールドをグループ化することができます。ピボットフィールドに関連するデータが多い場合、それらをセクションにグループ化することはよく行われます。Aspose.CellsもPivotTable.setManualGroupField()メソッドを使用してこの機能を提供しています。

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

以下のサンプルコードは、サンプルExcelファイルを読み込み、ピボットテーブルの最初のピボットフィールドをPivotTable.setManualGroupField()メソッドを使用してグループ化します。その後、ピボットテーブルのデータを更新して計算し、ワークブックを出力Excelファイルとして保存します。スクリーンショットでは、サンプルコードのサンプルExcelファイルへの影響が示されています。スクリーンショットで示されているように、最初のピボットフィールドは現在、月と四半期によるグループ化が行われています。

サンプルコード

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

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

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

Aspose.Cellsは、ピボットテーブルでデータの非表示やソートをサポートしています。以下のコードスニペットは、スコア列を降順でソートし、スコアが60未満の行を非表示にする機能を示しています。

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

ソースファイル

出力ファイル

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

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

可能な使用シナリオ

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

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

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

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

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

以下のサンプルコードを参照してください。データを設定し、それに基づいてPivotTableを作成します。次に、ピボットテーブルの行フィールドにフィルターを追加します。最後に、output XLSX形式でブックを保存します。例のコードを実行してフィルターを追加した後、特定のPivotFieldのフィルターをクリアする必要がある場合、特定のピボットフィールドのフィルターがクリアされます。output XLSXを確認してください。

サンプルコード

Java: ピボットフィルタ

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

可能な使用シナリオ

既知のデータでピボットテーブルを作成し、ピボットテーブルにフィルターを追加したい場合は、フィルターを学んで使用する必要があります。Aspose.Cells Java APIを使用すると、Pivot Tablesのフィールド値にフィルターを追加できます。

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

Excelのピボットテーブルにフィルタを追加するには、次の手順に従います:

クリアしたいPivotTableを選択します。
ピボットテーブルに追加したいフィルタのドロップダウン矢印をクリックします。
ドロップダウンメニューから「トップ10」を選択します。
表示モードとフィルタの数を設定します。

ピボットテーブルにフィルタを追加

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

サンプルコード

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

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

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

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

サンプルコード

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

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

Aspose.Cellsには、ピボットフィールドの表示名によってセルオブジェクトにアクセスできるPivotTable.getCellByDisplayName()メソッドがあります。このメソッドは、ピボットフィールドの見出しをハイライトまたはフォーマットしたい場合に便利です。この記事では、データフィールドの表示名でセルオブジェクトを取得し、その書式設定を適用する方法を説明します。

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

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

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

Java: ピボットテーブルのラベルまたは値によるフィルター処理

はじめに

ラベルフィルター

日付フィルター

値フィルター

トップ10フィルター

ピボットアイテムの表示/非表示によるフィルター

まとめ

関連記事

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

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

Java: ピボットアイテムの絶対位置を指定する

サンプルコード

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

可能な使用シナリオ

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

サンプルコード

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

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

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

可能な使用シナリオ

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

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

サンプルコード

Java: ピボットフィルタ

可能な使用シナリオ

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

ピボットテーブルにフィルタを追加

サンプルコード

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

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

サンプルコード

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

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

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

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