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

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

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

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

はじめに

ピボットテーブルは強力な分析ツールですが、生の集計結果には、特定のレポートで必要とするよりもはるかに多くの情報が含まれていることがよくあります。フィルター処理は、ピボットテーブルを特定のレポートに必要な行、列、値だけに絞り込むための主要な仕組みです。Aspose.Cells for C++ は Microsoft Excel で利用可能なフィルター機能を反映し、レポート生成を完全に自動化できるようにプログラミング的に公開しています。この記事で扱うフィルター戦略は次のとおりです。

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

ラベルフィルター

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

#include "Aspose.Cells.h"

using namespace Aspose::Cells;

int main() {
    Aspose::Cells::Startup();

    U16String fileName(u"sample.xlsx");
    U16String prefix(u"B");

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

    // インデックスでワークシートにアクセスする（最初のワークシート）
    Worksheet ws = wb.GetWorksheets().Get(0);

    // インデックスでピボットテーブルにアクセスする
    PivotTable pt = ws.GetPivotTables().Get(0);

    // 最初の行のPivotFieldを取得する
    PivotField rowField = pt.GetRowFields().Get(0);

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

    // フィルターが有効になるようにピボットテーブルのデータを更新して再計算する
    pt.RefreshData();

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

    Aspose::Cells::Cleanup();
    return 0;
}

日付フィルター

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

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

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

#include "Aspose.Cells.h"
#include <string>
#include <filesystem>

using namespace Aspose::Cells;
using namespace Aspose::Cells::Pivot;

int main() {
    Aspose::Cells::Startup();

    std::string inputPath = "sample.xlsx";
    std::string outputPath = "output_filtered.xlsx";

    if (!std::filesystem::exists(inputPath))
    {
        // ソースワークブックが見つかりません。
        Aspose::Cells::Cleanup();
        return -1;
    }

    // ピボットテーブルを含む既存のワークブックを読み込む
    Workbook workbook(U16String(inputPath.c_str()));

    // ピボットテーブルを含むワークシートにアクセスする(インデックス指定)
    Worksheet worksheet = workbook.GetWorksheets().Get(0);

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

    // 行エリアから日付のPivotFieldを取得する
    PivotField dateField = pivotTable.GetRowFields().Get(0);

    // Betweenフィルターの日付基準を定義する
    Date startDate{2020, 1, 1, 0, 0, 0, 0};
    Date endDate{2020, 12, 31, 0, 0, 0, 0};

    // ピボットフィールドに日付フィルターを適用する
    dateField.FilterByDate(PivotFilterType::DateBetween, startDate, endDate);

    // フィルターを反映させるためにピボットテーブルを更新して再計算する
    // ワークブックを保存する
    workbook.Save(U16String(outputPath.c_str()));

    Aspose::Cells::Cleanup();
    return 0;
}

値フィルター

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

#include "Aspose.Cells.h"
#include <cfloat>

using namespace Aspose::Cells;

int main() {
    Aspose::Cells::Startup();

    Workbook wb(u"sample.xlsx");
    Worksheet worksheet = wb.GetWorksheets().Get(0);
    PivotTable pivotTable = worksheet.GetPivotTables().Get(0);

    PivotField rowField = pivotTable.GetRowFields().Get(0);
    PivotField dataField = pivotTable.GetDataFields().Get(0);

    int dataFieldIndex = -1;
    int dataFieldCount = pivotTable.GetDataFields().GetCount();
    for (int i = 0; i < dataFieldCount; i++)
    {
        PivotField current = pivotTable.GetDataFields().Get(i);
        if (current.GetName() == dataField.GetName())
        {
            dataFieldIndex = i;
            break;
        }
    }

    if (dataFieldIndex >= 0)
    {
        rowField.FilterByValue(dataFieldIndex, PivotFilterType::ValueGreaterThan, 5000, DBL_MAX);
    }

    wb.Save(u"output.xlsx");

    Aspose::Cells::Cleanup();
    return 0;
}

上位 10 フィルター

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

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

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

#include "Aspose.Cells.h"
#include <stdexcept>

using namespace Aspose::Cells;
using namespace Aspose::Cells::Pivot;

int main() {
    Aspose::Cells::Startup();

    U16String inputPath(u"input.xlsx");
    U16String outputPath(u"output.xlsx");

    Workbook workbook(inputPath);

    Worksheet worksheet = workbook.GetWorksheets().Get(0);
    PivotTable pivotTable = worksheet.GetPivotTables().Get(0);

    if (pivotTable.GetDataFields().GetCount() == 0) {
        throw std::runtime_error("Pivot table has no value (data) PivotField.");
    }

    PivotField valueField = pivotTable.GetDataFields().Get(0);
    PivotField rowField = pivotTable.GetRowFields().Get(0);

    int valueFieldIndex = 0;

    rowField.FilterTop10(10, PivotFilterType::Sum, true, valueFieldIndex);

    workbook.Save(outputPath);

    Aspose::Cells::Cleanup();
    return 0;
}

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

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

#include "Aspose.Cells.h"
#include <string>

using namespace Aspose::Cells;

int main() {
    Aspose::Cells::Startup();

    // ピボットテーブルを含む既存のワークブックを読み込みます
    Workbook workbook(u"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);

        U16String name = item.GetName();
        std::string nameStr = name.ToUtf8();

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

        // 非表示解除のデモ：以前非表示にしたピボットアイテムを再度表示します
        if (nameStr == "Item3")
        {
            item.SetIsHidden(false);
        }
    }

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

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

    Aspose::Cells::Cleanup();
    return 0;
}

まとめ

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

Cpp: C++を使用してピボットアイテムの絶対位置を指定

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

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

親ノードに関係なくすべてのPivotItemsの位置インデックスを指定するために使用できるPivotItem.GetPosition()プロパティが追加されました。- 同じ親ノード内のPivotItemsの位置インデックスを指定するために使用できるPivotItem.GetPositionInSameParentNode()プロパティが追加されました。
PivotItem.Move(int count, bool isSameParent)メソッドを追加し、ピボットアイテムを上または下に移動させることができます。ここで、countは移動させる位置の数です。countの値が負の場合は上に移動し、正の場合は下に移動します。isSameParentは、移動操作が同じ親ノードで行われるかどうかを示すブール型のパラメータです。
PivotItem.Move(int count)メソッドは廃止されました。したがって、新たに追加されたPivotItem.Move(int count, bool isSameParent)メソッドの使用を推奨します。

以下のサンプルコードは、ピボットテーブルを作成し、同じ親ノード内のピボットアイテムの位置を指定します。ソースExcelと出力Excelをダウンロードして参考にしてください。出力Excelを開くと、「4H12」が親「K11」の0番目の位置にあり、「DIF400」は3番目の位置にあります。同様に、CA32は位置1、AAA3は位置2にあります。

#include <iostream>
#include "Aspose.Cells.h"
using namespace Aspose::Cells;

int main()
{
    Aspose::Cells::Startup();

    // Source directory path
    U16String srcDir(u"..\\Data\\01_SourceDirectory\\");

    // Output directory path
    U16String outDir(u"..\\Data\\02_OutputDirectory\\");

    // Create workbook
    Workbook wb(srcDir + u"source.xlsx");

    // Add new worksheet for pivot table
    WorksheetCollection worksheets = wb.GetWorksheets();
    Worksheet wsPivot = worksheets.Add(u"pvtNew Hardware");
    Worksheet wsData = worksheets.Get(u"New Hardware - Yearly");

    // Get the pivot tables collection for the pivot sheet
    PivotTableCollection pivotTables = wsPivot.GetPivotTables();

    // Add PivotTable to the worksheet
    int index = pivotTables.Add(u"='New Hardware - Yearly'!A1:D621", u"A3", u"HWCounts_PivotTable");

    // Get the PivotTable object
    PivotTable pvtTable = pivotTables.Get(index);

    // Add vendor row field
    pvtTable.AddFieldToArea(PivotFieldType::Row, u"Vendor");

    // Add item row field
    pvtTable.AddFieldToArea(PivotFieldType::Row, u"Item");

    // Add data field
    pvtTable.AddFieldToArea(PivotFieldType::Data, u"2014");

    // Turn off the subtotals for the vendor row field
    PivotField pivotField = pvtTable.GetRowFields().Get(u"Vendor");
    pivotField.SetSubtotals(PivotFieldSubtotalType::None, true);

    // Turn off grand total
    pvtTable.SetShowColumnGrandTotals(false);

    // Refresh and calculate data before modifying pivot items
    pvtTable.CalculateData();

    // Set positions for specific pivot items
    pvtTable.GetRowFields().Get(u"Item").GetPivotItems().Get(u"4H12").SetPositionInSameParentNode(0);
    pvtTable.GetRowFields().Get(u"Item").GetPivotItems().Get(u"DIF400").SetPositionInSameParentNode(3);

    // Recalculate data after modifying pivot items
    pvtTable.CalculateData();

    // Set positions for additional pivot items
    pvtTable.GetRowFields().Get(u"Item").GetPivotItems().Get(u"CA32").SetPositionInSameParentNode(1);
    pvtTable.GetRowFields().Get(u"Item").GetPivotItems().Get(u"AAA3").SetPositionInSameParentNode(2);

    // Save the workbook
    wb.Save(outDir + u"output_out.xlsx");

    Aspose::Cells::Cleanup();
}

ご注意：PivotTable.RefreshDataとPivotTable.CalculateDataメソッドを呼び出す必要があることに注意してください。PivotItem.GetPosition()、PivotItem.GetPositionInSameParentNode()プロパティおよびPivotItem.Move(int count, bool isSameParent)メソッドを使用する前に。

Cpp: C++を使ってピボットテーブルの表示名からセルオブジェクトを取得する

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

Aspose.Cellsは PivotTable::GetCellByDisplayName() メソッドを提供しており、これを使ってピボットフィールドの表示名からセルオブジェクトにアクセスできます。このメソッドはピボットフィールドヘッダーをハイライトまたは書式設定したいときに便利です。この記事では、データフィールドの表示名からセルオブジェクトを取得し、それに書式設定を適用する方法を説明しています。

ピボットテーブルの表示名からセルオブジェクトを取得する

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

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

#include <iostream>
#include "Aspose.Cells.h"
using namespace Aspose::Cells;

int main()
{
    Aspose::Cells::Startup();

    U16String srcDir(u"..\\Data\\01_SourceDirectory\\");
    U16String outDir(u"..\\Data\\02_OutputDirectory\\");

    Workbook workbook(srcDir + u"source.xlsx");
    Worksheet worksheet = workbook.GetWorksheets().Get(0);
    PivotTable pivotTable = worksheet.GetPivotTables().Get(0);

    Cell cell = pivotTable.GetCellByDisplayName(pivotTable.GetDataFields().Get(0).GetDisplayName());

    Style style = cell.GetStyle();
    style.SetForegroundColor(Color::LightBlue());
    style.GetFont().SetColor(Color::Black());

    pivotTable.Format(cell.GetRow(), cell.GetColumn(), style);
    workbook.Save(outDir + u"output_out.xlsx");

    std::cout << "Pivot table formatted successfully!" << std::endl;

    Aspose::Cells::Cleanup();
}

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

Cpp: C++を使用してピボットフィールドをグループ化する

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

可能な使用シナリオ

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

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

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

サンプルコード

#include <iostream>
#include "Aspose.Cells.h"
using namespace Aspose::Cells;

int main()
{
	Aspose::Cells::Startup();

	U16String srcDir(u"../Data/01_SourceDirectory/");
	U16String outDir(u"../Data/02_OutputDirectory/");

	Workbook wb(srcDir + u"sampleGroupPivotFieldsInPivotTable.xlsx");

	Worksheet ws = wb.GetWorksheets().Get(1);

	PivotTable pt = ws.GetPivotTables().Get(0);

	Date dtStart{ 2023, 12, 31, 0, 0, 0, 0 };
	Date dtEnd{ 2025, 9, 5 , 0, 0, 0, 0 };

	Vector<PivotGroupByType> groupTypeList{
		 PivotGroupByType::Months,
		 PivotGroupByType::Quarters
	};

	PivotField field = pt.GetRowFields().Get(0);
	field.GroupBy(dtStart, dtEnd, groupTypeList, 1, true);

	pt.RefreshData();
	pt.CalculateData();

	wb.Save(outDir + u"outputGroupPivotFieldsInPivotTable2.xlsx");

	std::cout << "Pivot field grouped successfully." << std::endl;

	Aspose::Cells::Cleanup();
	return 0;
}

Cpp: C++によるピボットテーブルの非表示とデータの並べ替え

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

ピボットテーブルの非表示とデータの並べ替え

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

#include <iostream>
#include "Aspose.Cells.h"

using namespace Aspose::Cells;

int main()
{
    Aspose::Cells::Startup();

    // Source and output directories
    U16String srcDir(u"..\\Data\\01_SourceDirectory\\");
    U16String outDir(u"..\\Data\\02_OutputDirectory\\");

    // Load the workbook
    Workbook workbook(srcDir + u"PivotTableHideAndSortSample.xlsx");

    // Get the first worksheet
    Worksheet worksheet = workbook.GetWorksheets().Get(0);

    // Get the first pivot table
    PivotTable pivotTable = worksheet.GetPivotTables().Get(0);
    CellArea dataBodyRange = pivotTable.GetDataBodyRange();
    int currentRow = 3;
    int rowsUsed = dataBodyRange.EndRow;

    // Sorting score in descending order
    PivotField field = pivotTable.GetRowFields().Get(0);
    field.SetIsAutoSort(true);
    field.SetIsAscendSort(false);
    field.SetAutoSortField(0);

    pivotTable.CalculateData();

    // Hiding rows with score less than 60
    while (currentRow < rowsUsed)
    {
        Cell cell = worksheet.GetCells().Get(currentRow, 1);
        double score = cell.GetDoubleValue();
        if (score < 60)
        {
            worksheet.GetCells().HideRow(currentRow);
        }
        currentRow++;
    }

    pivotTable.CalculateData();

    // Save the Excel file
    workbook.Save(outDir + u"PivotTableHideAndSort_out.xlsx");

    std::cout << "Pivot table hide and sort completed successfully." << std::endl;

    Aspose::Cells::Cleanup();
}

コードスニペットで使用されるソースと出力のExcelファイルは添付されており、参考にしてください。

ソースファイル

出力ファイル

Cpp: C++を使ったピボットテーブルのカスタムソート

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

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

Aspose.Cells API を使えば、フィールド値に基づくピボットテーブルの並べ替えが可能です。以下のコード例ではサンプルのExcelファイルを読み込み、3つのピボットテーブルを追加します。最初はカスタムソートなし、2つ目は「SeaFood」行フィールドの値に基づくソート、3つ目は「28/07/2000」列フィールドの値に基づくソートです。

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

元のExcelファイル

出力Excelファイル

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

#include <iostream>
#include "Aspose.Cells.h"
using namespace Aspose::Cells;

int main()
{
    Aspose::Cells::Startup();

    // Source directory
    U16String srcDir(u"..\\Data\\01_SourceDirectory\\");
    U16String outDir(u"..\\Data\\02_OutputDirectory\\");

    // Load the workbook
    Workbook wb(srcDir + u"SamplePivotSort.xlsx");

    // Get the first worksheet
    Worksheet sheet = wb.GetWorksheets().Get(0);

    // Get the pivot tables collection
    PivotTableCollection pivotTables = sheet.GetPivotTables();

    // Source PivotTable
    // Add a PivotTable to the worksheet
    int index = pivotTables.Add(u"=Sheet1!A1:C10", u"E3", u"PivotTable2");

    // Access the instance of the newly added PivotTable
    PivotTable pivotTable = pivotTables.Get(index);

    // Unshow grand totals for rows and columns
    pivotTable.SetShowRowGrandTotals(false);
    pivotTable.SetShowColumnGrandTotals(false);

    // Drag the first field to the row area
    pivotTable.AddFieldToArea(PivotFieldType::Row, 1);
    PivotField rowField = pivotTable.GetRowFields().Get(0);
    rowField.SetIsAutoSort(true);
    rowField.SetIsAscendSort(true);

    // Drag the second field to the column area
    pivotTable.AddFieldToArea(PivotFieldType::Column, 0);
    PivotField colField = pivotTable.GetColumnFields().Get(0);
    colField.SetNumberFormat(u"dd/mm/yyyy");
    colField.SetIsAutoSort(true);
    colField.SetIsAscendSort(true);

    // Drag the third field to the data area
    pivotTable.AddFieldToArea(PivotFieldType::Data, 2);

    pivotTable.CalculateData();
    // End of source PivotTable

    // Sort the PivotTable on "SeaFood" row field values
    // Add a PivotTable to the worksheet
    index = pivotTables.Add(u"=Sheet1!A1:C10", u"E10", u"PivotTable2");

    // Access the instance of the newly added PivotTable
    pivotTable = pivotTables.Get(index);

    // Unshow grand totals for rows and columns
    pivotTable.SetShowRowGrandTotals(false);
    pivotTable.SetShowColumnGrandTotals(false);

    // Drag the first field to the row area
    pivotTable.AddFieldToArea(PivotFieldType::Row, 1);
    rowField = pivotTable.GetRowFields().Get(0);
    rowField.SetIsAutoSort(true);
    rowField.SetIsAscendSort(true);

    // Drag the second field to the column area
    pivotTable.AddFieldToArea(PivotFieldType::Column, 0);
    colField = pivotTable.GetColumnFields().Get(0);
    colField.SetNumberFormat(u"dd/mm/yyyy");
    colField.SetIsAutoSort(true);
    colField.SetIsAscendSort(true);
    colField.SetAutoSortField(0);

    // Drag the third field to the data area
    pivotTable.AddFieldToArea(PivotFieldType::Data, 2);

    pivotTable.CalculateData();
    // End of sort the PivotTable on "SeaFood" row field values

    // Sort the PivotTable on "28/07/2000" column field values
    // Add a PivotTable to the worksheet
    index = pivotTables.Add(u"=Sheet1!A1:C10", u"E18", u"PivotTable2");

    // Access the instance of the newly added PivotTable
    pivotTable = pivotTables.Get(index);

    // Unshow grand totals for rows and columns
    pivotTable.SetShowRowGrandTotals(false);
    pivotTable.SetShowColumnGrandTotals(false);

    // Drag the first field to the row area
    pivotTable.AddFieldToArea(PivotFieldType::Row, 1);
    rowField = pivotTable.GetRowFields().Get(0);
    rowField.SetIsAutoSort(true);
    rowField.SetIsAscendSort(true);
    rowField.SetAutoSortField(0);

    // Drag the second field to the column area
    pivotTable.AddFieldToArea(PivotFieldType::Column, 0);
    colField = pivotTable.GetColumnFields().Get(0);
    colField.SetNumberFormat(u"dd/mm/yyyy");
    colField.SetIsAutoSort(true);
    colField.SetIsAscendSort(true);

    // Drag the third field to the data area
    pivotTable.AddFieldToArea(PivotFieldType::Data, 2);

    pivotTable.CalculateData();
    // End of sort the PivotTable on "28/07/2000" column field values

    // Save the Excel file
    wb.Save(outDir + u"out_java.xlsx");

    // Save as PDF
    PdfSaveOptions options;
    options.SetOnePagePerSheet(true);
    wb.Save(outDir + u"out_java.pdf", options);

    Aspose::Cells::Cleanup();
}

Cpp: C++でピボットフィルター

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

可能な使用シナリオ

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

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

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

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

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

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

サンプルコード

#include <iostream>
#include "Aspose.Cells.h"
using namespace Aspose::Cells;

int main()
{
    Aspose::Cells::Startup();

    // Create a new workbook
    Workbook workbook;

    // Get the first worksheet
    Worksheet ws = workbook.GetWorksheets().Get(0);
    Cells cells = ws.GetCells();

    // Set values to cells
    Cell cell = cells.Get(u"A1");
    cell.PutValue(u"Fruit");
    cell = cells.Get(u"B1");
    cell.PutValue(u"Count");

    cell = cells.Get(u"A2");
    cell.PutValue(u"Apple");
    cell = cells.Get(u"A3");
    cell.PutValue(u"Mango");
    cell = cells.Get(u"A4");
    cell.PutValue(u"Blackberry");
    cell = cells.Get(u"A5");
    cell.PutValue(u"Cherry");
    cell = cells.Get(u"A6");
    cell.PutValue(u"Guava");
    cell = cells.Get(u"A7");
    cell.PutValue(u"Carambola");
    cell = cells.Get(u"A8");
    cell.PutValue(u"Banana");
    cell = cells.Get(u"B2");
    cell.PutValue(5);
    cell = cells.Get(u"B3");
    cell.PutValue(3);
    cell = cells.Get(u"B4");
    cell.PutValue(6);
    cell = cells.Get(u"B5");
    cell.PutValue(4);
    cell = cells.Get(u"B6");
    cell.PutValue(5);
    cell = cells.Get(u"B7");
    cell.PutValue(2);
    cell = cells.Get(u"B8");
    cell.PutValue(20);

    // Add a PivotTable to the worksheet
    int32_t i = ws.GetPivotTables().Add(u"=A1:B8", u"D10", u"PivotTable1");

    // Access the instance of the newly added PivotTable
    PivotTable pivotTable = ws.GetPivotTables().Get(i);
    pivotTable.AddFieldToArea(PivotFieldType::Row, 0);

    pivotTable.AddFieldToArea(PivotFieldType::Data, u"Count");
    pivotTable.GetDataFields().Get(0).SetFunction(ConsolidationFunction::Sum);

    PivotField field = pivotTable.GetRowFields().Get(0);
    field.SetIsAutoSort(true);
    field.SetIsAscendSort(false);
    field.SetAutoSortField(0);

    // Add top10 filter
    PivotField filterField = pivotTable.GetRowFields().Get(0);
    filterField.FilterTop10(0, PivotFilterType::Count, false, 5);

    pivotTable.CalculateData();

    // Save the workbook
    workbook.Save(u"filterout.xlsx");

    Aspose::Cells::Cleanup();
    return 0;
}

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

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

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

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

Aspose.Cellsを使用したピボットテーブルでのフィルタのクリア。次のサンプルコードを参照してください。

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

サンプルコード

#include <iostream>
#include "Aspose.Cells.h"
using namespace Aspose::Cells;

int main() {
    Aspose::Cells::Startup();

    // Create a new workbook
    Workbook workbook;

    // Get the first worksheet
    Worksheet ws = workbook.GetWorksheets().Get(0);
    Cells cells = ws.GetCells();

    // Set values to cells
    Cell cell = cells.Get(u"A1");
    cell.PutValue(u"Fruit");
    cell = cells.Get(u"B1");
    cell.PutValue(u"Count");

    cell = cells.Get(u"A2");
    cell.PutValue(u"Apple");
    cell = cells.Get(u"A3");
    cell.PutValue(u"Mango");
    cell = cells.Get(u"A4");
    cell.PutValue(u"Blackberry");
    cell = cells.Get(u"A5");
    cell.PutValue(u"Cherry");
    cell = cells.Get(u"A6");
    cell.PutValue(u"Guava");
    cell = cells.Get(u"A7");
    cell.PutValue(u"Carambola");
    cell = cells.Get(u"A8");
    cell.PutValue(u"Banana");
    cell = cells.Get(u"B2");
    cell.PutValue(5);
    cell = cells.Get(u"B3");
    cell.PutValue(3);
    cell = cells.Get(u"B4");
    cell.PutValue(6);
    cell = cells.Get(u"B5");
    cell.PutValue(4);
    cell = cells.Get(u"B6");
    cell.PutValue(5);
    cell = cells.Get(u"B7");
    cell.PutValue(2);
    cell = cells.Get(u"B8");
    cell.PutValue(20);

    // Add a PivotTable to the worksheet
    int i = ws.GetPivotTables().Add(u"=A1:B8", u"D10", u"PivotTable1");

    // Access the instance of the newly added PivotTable
    PivotTable pivotTable = ws.GetPivotTables().Get(i);
    pivotTable.AddFieldToArea(PivotFieldType::Row, 0);

    pivotTable.AddFieldToArea(PivotFieldType::Data, u"Count");
    pivotTable.GetDataFields().Get(0).SetFunction(ConsolidationFunction::Sum);

    PivotField field = pivotTable.GetRowFields().Get(0);
    field.SetIsAutoSort(true);
    field.SetIsAscendSort(false);
    field.SetAutoSortField(0);

    // Add top10 filter
    PivotField filterField = pivotTable.GetRowFields().Get(0);
    filterField.FilterTop10(0, PivotFilterType::Count, false, 5);

    pivotTable.CalculateData();

    workbook.Save(u"out_add.xlsx");

    // Clear PivotFilter from the specific PivotField
    pivotTable.GetPivotFilters().ClearFilter(field.GetBaseIndex());
    pivotTable.CalculateData();

    workbook.Save(u"out_delete.xlsx");

    Aspose::Cells::Cleanup();
    return 0;
}

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

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

はじめに

ラベルフィルター

日付フィルター

値フィルター

上位 10 フィルター

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

まとめ

関連記事

Cpp: C++を使用してピボットアイテムの絶対位置を指定

Cpp: C++を使ってピボットテーブルの表示名からセルオブジェクトを取得する

** ピボットテーブルの表示名からセルオブジェクトを取得する**

Cpp: C++を使用してピボットフィールドをグループ化する

可能な使用シナリオ

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

サンプルコード

Cpp: C++によるピボットテーブルの非表示とデータの並べ替え

** ピボットテーブルの非表示とデータの並べ替え**

Cpp: C++を使ったピボットテーブルのカスタムソート

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

Cpp: C++でピボットフィルター

可能な使用シナリオ

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

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

サンプルコード

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

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

サンプルコード

ピボットテーブルの表示名からセルオブジェクトを取得する

ピボットテーブルの非表示とデータの並べ替え