Documentation – Refresh Pivot Tables and Pivot Caches in Aspose.Cells for C++

Cpp: Refresh and Calculate Pivot Table having Calculated Items with C++

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

Aspose.Cells now supports refreshing and calculating a pivot table having calculated items. Please use the PivotTable.RefreshData() and PivotTable.CalculateData() as usual to perform this function.

Refresh and Calculate Pivot Table having Calculated Items

The following sample code loads the source Excel file which contains a pivot table having three calculated items such as “add”, “div”, and “div2”. First, we change the value of cell D2 to 20, then refresh and calculate the pivot table using Aspose.Cells APIs, and then save the workbook in PDF format. The results in the output PDF show that Aspose.Cells refreshed and calculated the pivot table having calculated items successfully. You can verify this using Microsoft Excel by manually putting the value 20 in cell D2 and then refreshing the pivot table via the Alt+F5 shortcut key or by clicking the Refresh button on the pivot table.

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

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

    // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-C

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

    // Load source Excel file containing a pivot table having calculated items
    U16String sampleFilePath = srcDir + u"sample.xlsx";
    Workbook workbook(sampleFilePath);

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

    // Change the value of cell D2
    sheet.GetCells().Get(u"D2").PutValue(20);

    // Refresh and calculate all the pivot tables inside this sheet
    PivotTableCollection pivotTables = sheet.GetPivotTables();
    for (int32_t i = 0; i < pivotTables.GetCount(); ++i)
    {
        PivotTable pt = pivotTables.Get(i);
        pt.RefreshData();
        pt.CalculateData();
    }

    // Save the workbook **as a** PDF
    U16String outputFilePath = srcDir + u"RefreshAndCalculateItems_out.pdf";
    workbook.Save(outputFilePath, SaveFormat::Pdf);

    std::cout << "Workbook saved successfully!" << std::endl;

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

Cpp: Find and Refresh the Nested or Child Pivot Tables of a Parent Pivot Table with C++

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

Possible Usage Scenarios

Sometimes, one pivot table uses another pivot table as a data source, so it is called a child pivot table or nested pivot table. You can find the child pivot tables of a parent pivot table using the PivotTable::GetChildren() method.

Find and Refresh the Nested or Child Pivot Tables of a Parent Pivot Table

The following sample code loads the sample Excel file that contains three pivot tables. The bottom two pivot tables are children of the above pivot table, as shown in this screenshot. The code finds the child pivot tables using the PivotTable::GetChildren() method and then refreshes them one by one.

Sample Code

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

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

    // Load sample Excel file
    U16String inputFilePath = u"sampleFindAndRefreshNestedOrChildrenPivotTables.xlsx";
    Workbook wb(inputFilePath);

    // Access first worksheet
    Worksheet ws = wb.GetWorksheets().Get(0);

    // Access third pivot table
    PivotTable ptParent = ws.GetPivotTables().Get(2);

    // Access the children of the parent pivot table
    Vector<PivotTable> ptChildren = ptParent.GetChildren();

    // Refresh all the child pivot tables
    int count = ptChildren.GetLength();
    for (int idx = 0; idx < count; idx++)
    {
        // Access the child pivot table
        PivotTable ptChild = ptChildren[idx];

        // Refresh the child pivot table
        ptChild.RefreshData();
        ptChild.CalculateData();
    }

    std::cout << "Children pivot tables refreshed successfully!" << std::endl;

    Aspose::Cells::Cleanup();
}

Cpp: Get Pivot Table refresh date and refresh‑by‑who information with C++

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

Aspose.Cells now supports fetching the refresh date and refresh‑by‑who information from a workbook.

PivotTable.GetRefreshDate() returns the date on which the PivotTable report was last refreshed. Similarly, the PivotTable.GetRefreshedByWho() property returns the name of the user who last refreshed the report. The following example demonstrates this feature, and the sample file can be downloaded via the link below.

SourcePivotTable.xlsx

Sample Code

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

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

std::string Date_To_String(const Aspose::Cells::Date& date) {
    char buffer[100];
    snprintf(buffer, sizeof(buffer), "%04d-%02d-%02d %02d:%02d:%02d",
             date.year, date.month, date.day, date.hour, date.minute, date.second);
    return buffer;
}

std::string convert_u16_to_string(const char16_t* str) {
    std::wstring_convert<std::codecvt_utf8_utf16<char16_t>, char16_t> converter;
    return converter.to_bytes(str);
}

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

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

    Workbook workbook(srcDir + u"sourcePivotTable.xlsx");

    Worksheet worksheet = workbook.GetWorksheets().Get(0);

    PivotTable pivotTable = worksheet.GetPivotTables().Get(0);

    std::cout << "Pivot table refresh by who = " << convert_u16_to_string(pivotTable.GetRefreshedByWho().GetData()) << std::endl;

    std::cout << "Pivot table refresh date = " << Date_To_String(pivotTable.GetRefreshDate()) << std::endl;

    Aspose::Cells::Cleanup();
}