Aspose.Cells for C++ における値フィールド

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

データ (値) 領域に基本フィールドを追加することは、ソースデータの集計方法を形作る最初のステップです。Aspose.Cells は PivotTable.AddFieldToArea(PivotFieldType, string) を提供します。このオーバーロードは、定数 PivotFieldType.Data とソース列名を受け取ります。データ領域にフィールドを追加すると、API はそのフィールドを PivotTable.DataFields コレクションに追加された順序で公開します。既定では、数値型のソース列は ConsolidationFunction.Sum で集計され、非数値型の列は Count が既定値となります。

#include "Aspose.Cells.h"

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

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

    Workbook workbook;
    Worksheet worksheet = workbook.GetWorksheets().Get(0);
    worksheet.SetName(u"Data");

    Cells cells = worksheet.GetCells();

    // A1:D1のヘッダー
    cells.Get(0, 0).PutValue(U16String("Category"));
    cells.Get(0, 1).PutValue(U16String("Item"));
    cells.Get(0, 2).PutValue(U16String("Year"));
    cells.Get(0, 3).PutValue(U16String("Amount"));

    // A2:D9のデータ行を、jで分岐するネストループで設定
    for (int i = 1; i <= 8; i++)
    {
        for (int j = 0; j < 4; j++)
        {
            switch (j)
            {
                case 0:
                    cells.Get(i, j).PutValue(U16String(i <= 4 ? "Fruit" : "Vegetable"));
                    break;
                case 1:
                    if (i == 1 || i == 2) cells.Get(i, j).PutValue(U16String("Apple"));
                    else if (i == 3 || i == 4) cells.Get(i, j).PutValue(U16String("Banana"));
                    else if (i == 5 || i == 6) cells.Get(i, j).PutValue(U16String("Carrot"));
                    else cells.Get(i, j).PutValue(U16String("Daikon"));
                    break;
                case 2:
                    cells.Get(i, j).PutValue(2020 + ((i - 1) % 2));
                    break;
                case 3:
                    if (i == 1) cells.Get(i, j).PutValue(100);
                    else if (i == 2) cells.Get(i, j).PutValue(150);
                    else if (i == 3) cells.Get(i, j).PutValue(80);
                    else if (i == 4) cells.Get(i, j).PutValue(90);
                    else if (i == 5) cells.Get(i, j).PutValue(50);
                    else if (i == 6) cells.Get(i, j).PutValue(60);
                    else if (i == 7) cells.Get(i, j).PutValue(40);
                    else cells.Get(i, j).PutValue(45);
                    break;
            }
        }
    }

    // F3にPivotTable1という名前のピボットテーブルを追加
    int pivotIndex = worksheet.GetPivotTables().Add(u"A1:D9", u"F3", u"PivotTable1", true, false);
    PivotTable pivotTable = worksheet.GetPivotTables().Get(pivotIndex);

    // ピボットレイアウト: 行にCategoryとItem、列にYear、データフィールドにAmountを配置
    pivotTable.AddFieldToArea(PivotFieldType::Row, u"Category");
    pivotTable.AddFieldToArea(PivotFieldType::Row, u"Item");
    pivotTable.AddFieldToArea(PivotFieldType::Column, u"Year");
    pivotTable.AddFieldToArea(PivotFieldType::Data, u"Amount");

    pivotTable.CalculateData();
    workbook.Save(u"output_drag.xlsx");

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

集計関数の変更

データ領域に配置された各フィールドは内部的に PivotField インスタンスとしてラップされ、その Function プロパティは ConsolidationFunction 列挙体の値を返します。同じ Function セッターで、利用可能な集計 (Sum、Count、Average、Max、Min、Product、StdDev、StdDevp、Var、Varp など) を切り替えられます。

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

したがって、1 つのデータフィールドを Sum のままにしておきながら、同じソース列を対象とする 2 番目のデータフィールドを Count や Average で追加することが、すべて 1 つのピボット内で行えます。

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

int main() {
    Workbook workbook;
    Worksheet ws = workbook.GetWorksheets().Get(0);
    ws->SetName("Data");
    Vector<String> headers{ "Category", "Item", "Year", "Amount" };
    for (int j = 0; j < 4; j++) ws->GetCells()->Get(0, j)->PutValue(headers[j]);

    Vector<Vector<Object*>> data;
    // データを入力する...
    int pivotIndex = ws->GetPivotTables()->Add("A1:D9", "F3", "PivotTable1", true, false);
    PivotTable pivotTable = ws.GetPivotTables().Get(pivotIndex);
    pivotTable->AddFieldToArea(PivotFieldType::Row, "Category");
    pivotTable->AddFieldToArea(PivotFieldType::Row, "Item");
    pivotTable->AddFieldToArea(PivotFieldType::Column, "Year");
    pivotTable->AddFieldToArea(PivotFieldType::Data, "Amount");
    pivotTable->AddFieldToArea(PivotFieldType::Data, "Amount");
    PivotField countField = pivotTable.GetDataFields().Get(1);
    countField->SetFunction(ConsolidationFunction_Count);
    pivotTable->CalculateData();
    workbook->Save("output_function.xlsx");
}

値フィールドを行軸または列軸に配置する

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

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

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

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

int main() {
    Workbook workbook;
    Worksheet ws = workbook.GetWorksheets().Get(0);
    ws->SetName("Data");
    // ... データを構築 ...
    int pivotIndex = ws->GetPivotTables()->Add("A1:D9", "F3", "PivotTable1", true, false);
    PivotTable pivotTable = ws.GetPivotTables().Get(pivotIndex);
    pivotTable->AddFieldToArea(PivotFieldType::Row, "Category");
    pivotTable->AddFieldToArea(PivotFieldType::Row, "Item");
    pivotTable->AddFieldToArea(PivotFieldType::Column, "Year");
    pivotTable->AddFieldToArea(PivotFieldType::Data, "Amount");
    pivotTable->AddFieldToArea(PivotFieldType::Data, "Amount");
    pivotTable->GetDataFields()->Get(1)->SetFunction(ConsolidationFunction_Count);
    pivotTable->AddFieldToArea(PivotFieldType::Column, pivotTable->GetValuesField());
    pivotTable->CalculateData();
    workbook->Save("output_plot.xlsx");
}