Documentation – Вставка сводной таблицы

Nodejscpp: Форматирование сводной таблицы

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

Внешний вид сводной таблицы

Как создать сводную таблицу объясняет, как создать простую сводную таблицу. В этой статье описано, как настроить внешний вид сводной таблицы, устанавливая различные свойства:

Опции формата сводной таблицы
Опции формата полей сводной таблицы
Опции формата данных поля

Как установить параметры форматирования сводной таблицы

Класс PivotTable контролирует общую сводную таблицу и может быть отформатирован различными способами.

Как установить тип автоформата

Microsoft Excel предлагает ряд заранее заданных форматов отчетов. Aspose.Cells for Node.js via C++ также поддерживает эти параметры форматирования. Для доступа к ним:

Установите PivotTable.setIsAutoFormat(value) в true.
Назначьте опцию форматирования из перечисления PivotTableAutoFormatType.

Как устанавливать параметры форматирования

Приведенный ниже пример кода показывает, как отформатировать сводную таблицу для отображения общих итогов для строк и столбцов, а также как установить порядок полей отчета. Он также показывает, как установить пользовательскую строку для пустых значений.

Форматирование внешнего вида вручную

Чтобы вручную форматировать отчет сводной таблицы, вместо использования предустановленных форматов отчетов, используйте методы PivotTable.formatAll(style) и PivotTable.format(row, column, style). Создайте объект стиля для желаемого форматирования, например:

Как установить параметры форматирования поля сводной таблицы

Класс PivotField представляет собой поле в сводной таблице и может быть отформатировано несколькими способами. Приведенный ниже образец кода показывает, как:

Получить строковые поля.
Настроить итоги.
Настроить автосортировку.
Настроить автоотображение.

Как установить формат полей строк/столбцов/страниц

Как установить формат полей данных

Приведенный ниже образец кода показывает, как установить формат отображения и числовой формат для полей данных.

Как очистить поля сводной таблицы

У класса PivotFieldCollection есть метод с именем clear(), который позволяет очистить поля сводной таблицы. Используйте его, когда вам нужно очистить все поля сводной таблицы в областях, например страница, столбец, строка или данные. Приведенный ниже образец кода показывает, как очистить все поля сводной таблицы в области данных.

Nodejscpp: Создание сводных таблиц и сводных графиков

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

Сводная таблица - это интерактивная сводка записей. Например, у вас может быть сотни записей о счетах-фактурах в списке на листе. Сводная таблица может подсчитать счета-фактуры по клиенту, продукту или дате. С помощью Microsoft Excel можно быстро переставить информацию в сводной таблице, перетаскивая кнопки на новую позицию.

Сводный график - это интерактивное графическое представление данных в сводной таблице. Сводные графики были введены в Excel 2000. Использование сводного графика делает понимание данных еще проще, поскольку сводная таблица автоматически создает итоги и подитоги.

Aspose.Cells for Node.js via C++ поддерживает сводные таблицы и сводные диаграммы.

Добавление сводных таблиц и диаграмм с помощью Aspose.Cells for Node.js via C++

Aspose.Cells for Node.js via C++ предоставляет специальный набор классов, используемых для создания сводных таблиц. Эти классы предназначены для создания и настройки объектов сводной таблицы, которые являются основными строительными блоками сводной таблицы:

PivotField, поле в отчете сводной таблицы.
PivotFields, коллекция всех объектов PivotField в сводной таблице.
PivotTable, отчет PivotTable на листе.
PivotTables, коллекция всех объектов PivotTable на листе.

Подготовка к использованию Aspose.Cells for Node.js via C++

Установите Aspose.Cells for Node.js via C++ из NPM, используйте команду: $ npm install aspose.cells.node.
Вы также можете следовать пошаговым инструкциям по установке “Aspose.Cells for Node.js via C++” в вашу среду разработки.

Как добавить сводную таблицу с помощью Aspose.Cells for Node.js via C++

Для создания сводной таблицы с помощью Aspose.Cells for Node.js via C++:

Добавьте некоторые данные в ячейки листа книги Excel с помощью метода put_value объекта Cell. Вы также можете использовать файл-шаблон, уже заполненный данными. Данные будут использоваться в качестве источника данных для сводной таблицы.
Добавьте сводную таблицу на лист с помощью метода add коллекции PivotTables (инкапсулированной в объекте Worksheet).
Обратитесь к новому объекту PivotTable из коллекции PivotTables, передав его индекс. # Используйте любые из инкапсулированных объектов сводной таблицы в объекте PivotTable для управления таблицей.

Приведены примеры кода ниже.

Как добавить сводную диаграмму с помощью библиотеки Aspose.Cells for Node.js via C++

Для создания сводной диаграммы с помощью Aspose.Cells for Node.js via C++:

Добавьте диаграмму.
Установите источник данных диаграммы так, чтобы он ссылался на существующую сводную таблицу в электронной таблице.
Задайте другие атрибуты.

Nodejscpp: Сводная таблица и исходные данные

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

Исходные данные сводной таблицы

Иногда возникают ситуации, когда вы хотите создать отчеты Microsoft Excel с сводными таблицами, использующими данные из разных источников данных (например, базы данных), которые неизвестны на этапе проектирования. В этой статье представлен подход к динамическому изменению источника данных сводной таблицы.

Изменение исходного источника данных сводной таблицы

Создание нового файла шаблона дизайнера.
1. Создайте новый файл шаблона дизайнера, как показано на скриншоте ниже.
2. Затем определите именованный диапазон DataSource, который ссылается на этот диапазон ячеек.
  
  Создание файла шаблона дизайнера и определение именованного диапазона DataSource

Создание сводной таблицы на основе этого именованного диапазона.
1. В Microsoft Excel выберите Данные, затем Сводная таблица и Отчет сводной таблицы и диаграмма.
2. Создайте сводную таблицу на основе созданного в первом шаге именованного диапазона.
  
  Создание сводной таблицы на основе именованного диапазона DataSource

Перетащите соответствующее поле на строку и столбец сводной таблицы, затем создайте результирующую сводную таблицу, как показано на скриншоте ниже.

Создание сводной таблицы на основе соответствующего поля

Щелкните правой кнопкой мыши на сводной таблице и выберите Параметры таблицы.
1. Установите Обновлять при открытии в настройках Параметры данных.
  
  Настройка параметров сводной таблицы

Теперь вы можете сохранить этот файл как файл вашего дизайнерского шаблона.

Пополнение новыми данными и изменение исходных данных сводной таблицы.
1. После создания дизайнерского шаблона используйте следующий код для изменения исходных данных сводной таблицы.

Исполнение приведенного ниже примера кода изменяет исходные данные сводной таблицы.

Nodejscpp: Добавление вычисляемого поля в сводной таблице

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

Возможные сценарии использования

Когда вы создаете сводную таблицу на основе известных данных, вы обнаруживаете, что данные в ней не соответствуют вашим требованиям. Вы хотите объединить эти исходные данные. Например, вам нужно сложить, вычесть, умножить и разделить исходные данные перед тем, как вы их захотите. В этом случае вам нужно создать вычисляемое поле и установить соответствующую формулу для вычислений. Затем выполнить некоторые статистические и другие операции с вычисляемым полем.

Как добавить вычисляемое поле в сводную таблицу в Excel

Чтобы добавить вычисляемое поле в сводную таблицу в Excel, выполните следующие шаги:

Выберите сводную таблицу, к которой вы хотите добавить вычисляемое поле.
Перейдите на вкладку Analyze в контекстном меню сводной таблицы.
Нажмите на “Поля, элементы и наборы” и затем выберите “Вычисляемое поле” в выпадающем меню.
В поле “Имя” введите имя для вычисляемого поля.
В поле “Формула” введите формулу для выполнения расчета, используя соответствующие имена полей сводной таблицы и математические операторы.
Нажмите “ОК”, чтобы создать вычисляемое поле.
Новое вычисляемое поле появится в списке полей сводной таблицы в разделе ‘Значения’.
Перетащите вычисляемое поле в раздел ‘Значения’ сводной таблицы, чтобы отобразить вычисленные значения.

Как добавить вычисляемое поле в сводную таблицу с использованием библиотеки Aspose.Cells for Node.js via C++

Добавьте вычисляемое поле в файл Excel с помощью Aspose.Cells for Node.js via C++. Посмотрите следующий пример кода. После выполнения этого кода в лист будет добавлена сводная таблица с вычисляемым полем.

Задайте исходные данные и создайте сводную таблицу.
Создайте расчетное поле согласно существующему PivotField в сводной таблице.
Добавьте расчетное поле в область данных.
Наконец, сохраните книгу в формате output XLSX.

Образец кода

Nodejscpp: Обновление сводных таблиц в Aspose.Cells for Node.js via C++

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

Aspose.Cells предоставляет многоуровневый API обновления, который позволяет перезагружать данные сводных таблиц на четырёх различных уровнях — от всей рабочей книги до одной сводной таблицы. Начиная с Aspose.Cells for Node.js via C++ v26.7, устаревший метод PivotTable.RefreshData() помечен как нерекомендуемый и должен быть заменён более эффективными API, учитывающими кэш, которые описаны в этой статье.

Введение

Обновление сводной таблицы редко представляет собой одну операцию. «За кулисами» Aspose.Cells поддерживает многоуровневую цепочку данных, которая соединяет исходные данные с отображаемыми значениями на рабочем листе. Понимание этой цепочки — ключ к выбору правильного API обновления для любой ситуации. Четырёхуровневая цепочка данных выглядит так:

Источник данных — исходные диапазоны рабочего листа, запрос к базе данных или диапазон консолидации, где хранятся необработанные значения.
PivotCache — снимок исходных данных в памяти. Каждая сводная таблица строится поверх PivotCache; именно здесь собираются и агрегируются все данные.
PivotTable — объект представления, который определяет поля строк, столбцов, значений и фильтров. PivotTable считывает данные только из своего PivotCache, никогда напрямую из источника данных.
Cells — коллекция Cells рабочего листа, в которую PivotTable визуализирует вычисленные значения и стили. Особенно важным понятием является общий кэш. Когда несколько сводных таблиц в рабочей книге ссылаются на один и тот же исходный диапазон, они используют один экземпляр PivotCache. На один PivotCache может ссылаться множество сводных таблиц, и обновление этого кэша обновляет все зависимые PivotTable одновременно.
PivotCache.SourceType (перечисление PivotTableSourceType) указывает, откуда поступили данные кэша. Начиная с версии 26.7 метод PivotCache.Refresh() поддерживает только типы источников Sheet и Consolidation — то есть данные, которые находятся в диапазонах рабочего листа. Внешние источники (базы данных, внешние подключения и т. д.) пока не могут быть обновлены через API кэша.
Из-за этой цепочки в Aspose.Cells существуют два основных пути обновления:

PivotCache.Refresh() — перезагружает источник → кэш И пересчитывает все зависимые PivotTable за одну операцию.
PivotTable.CalculateData() — пересчитывает отображение одной PivotTable из уже кэшированных данных без обращения к источнику данных. Во всех сценариях в этой статье используются данные из ячеек рабочего листа, поэтому тип источника — Sheet, и операции обновления ведут себя описанным образом.

Необходимые импорты

Во всех примерах JavaScript в этой статье предполагается, что модуль Aspose.Cells for Node.js via C++ уже загружен, а типы сводных таблиц находятся в пространстве имён Aspose.Cells.Pivot. Типичная настройка выглядит так:

const AsposeCells = require("aspose.cells.node");
const { PivotFieldType } = AsposeCells; (или доступ через AsposeCells.Pivot.PivotFieldType)

Обновление всех сводных таблиц в рабочей книге

Если вам нужно убедиться, что каждый кэш сводной таблицы и каждая сводная таблица в рабочей книге отражают самые последние исходные данные, самым простым и комплексным API является Workbook.RefreshAll(). Один вызов обходит всю рабочую книгу — обновляет каждый PivotCache из его источника, а затем пересчитывает каждую зависимую PivotTable. Это рекомендуемый подход для общих полноценных обновлений документа, где производительность не критична. В следующем примере создаётся рабочая книга с исходным диапазоном Fruit/Year/Amount, создаётся одна сводная таблица, изменяются некоторые исходные значения, а затем используется RefreshAll() для обновления всего за один вызов.

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);

// Записать строку заголовка в ячейки A1:C1
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

// Записать строки данных в ячейки A2:C9 (8 строк данных о фруктах за 2020 и 2021 годы)
worksheet.getCells().get("A2").putValue("grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(50);

worksheet.getCells().get("A3").putValue("blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(60);

worksheet.getCells().get("A4").putValue("kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(70);

worksheet.getCells().get("A5").putValue("cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(80);

worksheet.getCells().get("A6").putValue("grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(90);

worksheet.getCells().get("A7").putValue("blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(100);

worksheet.getCells().get("A8").putValue("kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(110);

worksheet.getCells().get("A9").putValue("cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(120);

// Добавить сводную таблицу: исходный диапазон "A1:C9", ячейка назначения "E3", имя "Pivot1"
let pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

// Назначить поля сводной таблицы: Fruit в строки, Year в столбцы, Amount в данные
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// Изменить несколько значений Amount в исходных данных для имитации изменений
worksheet.getCells().get("C2").putValue(55);
worksheet.getCells().get("C5").putValue(85);
worksheet.getCells().get("C9").putValue(125);

// Обновить все сводные таблицы / кэш сводных таблиц в книге
workbook.refreshAll();

// Сохранить книгу
workbook.save("output.xlsx");

Обновление всех сводных таблиц на одном рабочем листе

Иногда требуется обновить только сводные таблицы, расположенные на одном конкретном рабочем листе — например, когда известно, что сводные таблицы на других рабочих листах не связаны с ними и не должны быть затронуты. Для этого случая Aspose.Cells предоставляет Worksheet.RefreshPivotTables(), который ограничен одним экземпляром Worksheet. Это более избирательный подход по сравнению с Workbook.RefreshAll(): обновляются только сводные таблицы на целевом рабочем листе, а сводные таблицы на других рабочих листах остаются нетронутыми. В следующем примере заполняются те же исходные данные Fruit/Year/Amount, на первом рабочем листе добавляется сводная таблица, изменяются некоторые исходные значения, а затем обновляются только сводные таблицы на этом рабочем листе.

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);

worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

worksheet.getCells().get("A2").putValue("grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);

worksheet.getCells().get("A3").putValue("blueberry");
worksheet.getCells().get("B3").putValue(2021);
worksheet.getCells().get("C3").putValue(150);

worksheet.getCells().get("A4").putValue("kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(200);

worksheet.getCells().get("A5").putValue("cherry");
worksheet.getCells().get("B5").putValue(2021);
worksheet.getCells().get("C5").putValue(120);

worksheet.getCells().get("A6").putValue("grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(180);

worksheet.getCells().get("A7").putValue("blueberry");
worksheet.getCells().get("B7").putValue(2020);
worksheet.getCells().get("C7").putValue(130);

worksheet.getCells().get("A8").putValue("kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(220);

worksheet.getCells().get("A9").putValue("cherry");
worksheet.getCells().get("B9").putValue(2020);
worksheet.getCells().get("C9").putValue(140);

let pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

worksheet.getCells().get("C2").putValue(300);
worksheet.getCells().get("C5").putValue(250);
worksheet.getCells().get("C9").putValue(400);

worksheet.refreshPivotTables();

workbook.save("output.xlsx");

Обновление одной сводной таблицы

Когда требуется детальный контроль над одной сводной таблицей, API на основе кэша предоставляет два варианта. Выбор между ними зависит от того, что именно изменилось: исходные данные или только параметры представления/макета самой сводной таблицы.

Изменились исходные данные — используйте `PivotCache.Refresh()`

Если исходные данные изменились, правильной точкой входа является pivotTable.PivotCache.Refresh(). Этот вызов повторно считывает исходные данные в кэш, а затем пересчитывает каждую PivotTable, зависящую от этого кэша.

Поскольку сводные таблицы совместно используют один экземпляр PivotCache, вызов PivotCache.Refresh() пересчитывает все сводные таблицы, построенные на этом же кэше — а не только ту, на которую вы ссылаетесь. Если две сводные таблицы используют один и тот же исходный диапазон, обновление одного кэша обновляет обе.

В следующем примере создаются две сводные таблицы на одном исходном диапазоне для демонстрации поведения общего кэша, изменяются некоторые исходные значения, а затем выполняется обновление через ссылку на один кэш.

const AsposeCells = require("aspose.cells");

// Создаём новую рабочую книгу и получаем доступ к первому рабочему листу
const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);

// Записываем строку заголовков: Fruit / Year / Amount
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

// Записываем примерно 9 строк данных (виноград / черника / киви / вишня за 2020-2021 годы)
worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);

worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(200);

worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(300);

worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(400);

worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(500);

worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(600);

worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(700);

worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(800);

// Добавляем первую сводную таблицу "Pivot1" с привязкой к ячейке E3, исходный диапазон A1:C9
const pivotIndex1 = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
const pivotTable1 = worksheet.getPivotTables().get(pivotIndex1);

// Назначаем поля для Pivot1
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// Добавляем ВТОРУЮ сводную таблицу "Pivot2" с привязкой к E15, используя ТОТ ЖЕ исходный диапазон A1:C9
// Pivot1 и Pivot2 используют общий PivotCache, так как исходный диапазон одинаковый.
const pivotIndex2 = worksheet.getPivotTables().add("A1:C9", "E15", "Pivot2");
const pivotTable2 = worksheet.getPivotTables().get(pivotIndex2);

// Назначаем те же поля для Pivot2
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// Изменяем несколько значений Amount в исходных данных, чтобы имитировать изменение данных
worksheet.getCells().get("C2").putValue(150);
worksheet.getCells().get("C4").putValue(350);
worksheet.getCells().get("C7").putValue(650);

// Обновляем общий PivotCache.
// Поскольку Pivot1 и Pivot2 используют общий PivotCache, этот единственный вызов
// обновляет ОБЕ сводные таблицы (данные + стиль) из обновлённого источника.
pivotTable1.getPivotCache().refresh();

// Сохраняем рабочую книгу
workbook.save("output.xlsx");

Изменились только представление/макет — используйте `CalculateData()`

Если исходные данные не изменились, но были изменены только параметры представления или макета сводной таблицы (например, поле было перемещено в другую область или переключён параметр обновления при открытии), нет необходимости повторно обращаться к источнику данных. Кэш уже содержит правильные данные; требуется только пересчёт отображаемой PivotTable. В этом случае правильным выбором является pivotTable.CalculateData(). Это позволяет избежать ненужного обращения к источнику и значительно быстрее, когда многие сводные таблицы используют один и тот же кэш. В следующем примере изменяется свойство сводной таблицы, не связанное с источником, а затем вызывается CalculateData() для её повторной визуализации из существующего кэша.

var workbook = new AsposeCells.Workbook();
var worksheet = workbook.getWorksheets().get(0);

// Записать строку заголовков: Фрукт / Год / Сумма
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

// Записать 8 строк данных (строки 2–9, соответствуют диапазону источника A1:C9)
worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);

worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(200);

worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(300);

worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(400);

worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(150);

worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(250);

worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(350);

worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(450);

// Добавить сводную таблицу с именем "Pivot1", расположенную в ячейке E3, с источником данных A1:C9
var pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
var pivotTable = worksheet.getPivotTables().get(pivotIndex);

// Назначить поля: Fruit — в строки, Year — в столбцы, Amount — в данные
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Data, "Amount");

// Изменить свойство представления/макета — это изменение только для отображения,
// поэтому оно НЕ требует повторного чтения исходных данных через PivotCache.Refresh().
pivotTable.setRefreshDataOnOpeningFile(false);

// Метод CalculateData() заново отображает отображение ЭТОЙ сводной таблицы (данные + стиль)
// на основе данных, уже хранящихся в PivotCache. Поскольку исходные данные не изменились,
// обращения к источнику не происходит — пересчитываются только кэшированные значения
// в ячейках листа.
pivotTable.calculateData();

// Сохранить книгу на диск
workbook.save("output.xlsx");

Получение всех сводных таблиц, использующих один и тот же PivotCache

Рабочая книга часто содержит множество сводных таблиц, которые все построены поверх одного общего кэша. Чтобы перечислить их — например, перед выполнением пакетного обновления или для диагностики влияния общего кэша — используйте PivotCache.GetPivotTables(). Этот метод возвращает коллекцию всех PivotTable, зависящих от данного кэша. Это также самый прямой способ убедиться, что две сводные таблицы действительно используют один и тот же экземпляр PivotCache: вы можете сравнить ссылки на кэши или просто перебрать коллекцию, возвращаемую GetPivotTables(), и увидеть, какие сводные таблицы в ней присутствуют. В следующем примере создаются две сводные таблицы на одном исходном диапазоне, проверяется, что они используют один и тот же экземпляр кэша, а затем перечисляются сводные таблицы этого кэша.

Миграция с устаревшего `PivotTable.RefreshData()`

До Aspose.Cells for Node.js via C++ v26.7 стандартным способом обновления сводной таблицы был вызов PivotTable.RefreshData() для каждой сводной таблицы отдельно. Начиная с версии 26.7 этот метод помечен как нерекомендуемый и должен быть заменён описанными выше API, учитывающими кэш. Есть две причины, по которым подход с вызовом RefreshData() для каждой таблицы по отдельности является проблематичным в реальных рабочих книгах:

Он каждый раз заново извлекает данные из источника, даже если источник не изменился.
Каждый вызов обновляет весь общий кэш. Когда многие сводные таблицы используют один кэш, повторные вызовы RefreshData() для каждой сводной таблицы приводят к многократному повторному извлечению одного и того же кэша, что очень медленно. Рекомендуемые замены:
Обновить ВСЕ сводные таблицы в рабочей книге → используйте workbook.refreshAll();
Обновить НЕКОТОРЫЕ из них → используйте pivotTable.PivotCache.Refresh(); для одного кэша. Поскольку кэш общий, этот единственный вызов обновляет каждую сводную таблицу, построенную поверх этого кэша. Другие сводные таблицы, которые используют уже обновлённый кэш, можно безопасно пропустить.
Изменились только параметры представления/макета сводной таблицы → используйте pivotTable.CalculateData();, чтобы повторно отрисовать данные из существующего кэша без обращения к источнику. В следующем примере демонстрируется новый эффективный шаблон для рабочих книг с несколькими сводными таблицами, использующими один общий кэш.

let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);

// --- Формируем исходные данные: Фрукт / Год / Сумма (заголовок + 9 строк) ---
sheet.getCells().get("A1").putValue("Fruit");
sheet.getCells().get("B1").putValue("Year");
sheet.getCells().get("C1").putValue("Amount");

sheet.getCells().get("A2").putValue("Grape");      sheet.getCells().get("B2").putValue(2020); sheet.getCells().get("C2").putValue(1000);
sheet.getCells().get("A3").putValue("Blueberry");  sheet.getCells().get("B3").putValue(2020); sheet.getCells().get("C3").putValue(2000);
sheet.getCells().get("A4").putValue("Kiwi");       sheet.getCells().get("B4").putValue(2020); sheet.getCells().get("C4").putValue(1500);
sheet.getCells().get("A5").putValue("Cherry");     sheet.getCells().get("B5").putValue(2020); sheet.getCells().get("C5").putValue(2500);
sheet.getCells().get("A6").putValue("Grape");      sheet.getCells().get("B6").putValue(2021); sheet.getCells().get("C6").putValue(3000);
sheet.getCells().get("A7").putValue("Blueberry");  sheet.getCells().get("B7").putValue(2021); sheet.getCells().get("C7").putValue(1800);
sheet.getCells().get("A8").putValue("Kiwi");       sheet.getCells().get("B8").putValue(2021); sheet.getCells().get("C8").putValue(2200);
sheet.getCells().get("A9").putValue("Cherry");     sheet.getCells().get("B9").putValue(2021); sheet.getCells().get("C9").putValue(2700);

// --- Добавляем первую сводную таблицу (Pivot1) в ячейку E3 ---
let idx1 = sheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
let pivotTable1 = sheet.getPivotTables().get(idx1);
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// --- Добавляем ВТОРУЮ сводную таблицу (Pivot2) на ТОТ ЖЕ диапазон источника ---
// Обе таблицы Pivot1 и Pivot2 используют ОДИН общий PivotCache.
// Это именно тот сценарий, в котором устаревший подход с RefreshData()
// для каждой таблицы становится неэффективным: обновление одной таблицы
// заново загружает весь общий кэш, поэтому обновление N таблиц выполняет
// ту же дорогостоящую загрузку N раз.
let idx2 = sheet.getPivotTables().add("A1:C9", "E15", "Pivot2");
let pivotTable2 = sheet.getPivotTables().get(idx2);
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// --- Изменяем несколько значений Amount в исходных данных ---
sheet.getCells().get("C2").putValue(5000);   // Grape  2020
sheet.getCells().get("C5").putValue(7500);   // Cherry 2020
sheet.getCells().get("C9").putValue(9500);   // Cherry 2021

// --- УСТАРЕВШИЙ шаблон (до версии 26.7) — PivotTable.RefreshData() ---
// pivotTable1.RefreshData();  // повторно загружает из источника, обновляет весь кэш
// pivotTable2.RefreshData();  // загружает СНОВА — кэш уже актуален!
// Каждый вызов перестраивает общий кэш, поэтому N таблиц = N избыточных загрузок.

// --- НОВЫЙ шаблон v26.7+: обновить кэш ОДИН раз, затем при необходимости перерисовывать ---
// Один вызов PivotCache.Refresh() подтягивает изменённые значения в общий
// кэш И пересчитывает отображение КАЖДОЙ сводной таблицы, которая на него ссылается.
// Поскольку Pivot1 и Pivot2 используют один PivotCache, этот единственный вызов
// обновляет обе таблицы — повторного обращения к источнику не требуется.
pivotTable1.getPivotCache().refresh();

// CalculateData() только перерисовывает отображение сводной таблицы (данные + стиль)
// на основе данных, уже хранящихся в кэше — он НЕ обращается к источнику.
// Мы вызываем его для Pivot2 здесь исключительно для демонстрации API: после того
// как кэш был обновлён один раз, любую зависимую таблицу можно перерисовать без
// повторного обращения к источнику. Используйте CalculateData() отдельно, когда
// изменились только параметры вида/макета сводной таблицы, а кэш уже актуален.
pivotTable2.calculateData();

workbook.save("output.xlsx");

Какой API обновления мне следует использовать?

В таблице ниже приведены доступные API обновления и случаи, когда следует выбирать каждый из них.

Цель	Рекомендуемый API	Примечания
Обновить всё в рабочей книге	`Workbook.RefreshAll()`	Один вызов; охватывает все кэши и таблицы.
Обновить только сводные таблицы на одном листе	`Worksheet.RefreshPivotTables()`	Ограничено одним рабочим листом.
Изменились исходные данные для одного кэша	`pivotTable.PivotCache.Refresh()`	Обновляет ВСЕ сводные таблицы на этом общем кэше.
Изменились только параметры представления/макета	`pivotTable.CalculateData()`	Пропускает ненужное обращение к источнику.
Получить список всех сводных таблиц на общем кэше	`pivotCache.GetPivotTables()`	Используйте для перечисления перед массовым обновлением.
На практике отдавайте предпочтение API на основе кэша, а не устаревшему `RefreshData()` для каждой таблицы отдельно. Они учитывают общие кэши, избегают избыточных обращений к источнику и позволяют выбрать минимальную область, удовлетворяющую вашим требованиям к обновлению.

Nodejscpp: Применить стили к сводным таблицам в Aspose.Cells для .NET

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

Aspose.Cells поддерживает применение как устаревших автоформатов сводных таблиц (предназначенных для файлов .xls), так и современных именованных или пользовательских стилей сводных таблиц (предназначенных для файлов .xlsx, .xlsm и .xlsb). Вызываемый API зависит от формата файла, в который сохраняется рабочая книга, а не от формата, из которого она была загружена.

Введение

Aspose.Cells предоставляет два параллельных API стилей для сводных таблиц. Выбор между ними определяется форматом файла, в который вы сохраняете рабочую книгу, а не форматом, из которого она была прочитана. Рабочая книга, загруженная из файла .xls, может быть повторно сохранена как .xlsx, и в этом случае применяется современный API стилей, а не устаревший.

Для устаревшего вывода .xls используйте свойство PivotTable.AutoFormatType вместе с перечислением Aspose.Cells.Pivot.PivotTableAutoFormatType. Этот API соответствует выбору автоформата, который классический Excel предлагал для сводных таблиц.

Для современного вывода .xlsx, .xlsm и .xlsb доступны два варианта API стилей:

PivotTable.PivotTableStyleType выбирает один из встроенных именованных стилей (светлые и тёмные темы, включая стили, добавленные в Excel 2017). Эти предустановки доступны только для чтения.
PivotTable.PivotTableStyleName выбирает пользовательский стиль, который вы определяете самостоятельно через Workbook.Worksheets.TableStyles.AddPivotTableStyle(...). Пользовательские стили необходимы, когда требуется изменить цвета, границы или шрифты сверх того, что предлагают предустановки.

Кроме того, PivotTable.FormatAll(Style) — это сокращение, которое применяет один объект Style к каждой ячейке сводной таблицы, переопределяя всё, что было задано через любой из API имён стилей выше. Это полезно, когда требуется единообразный внешний вид вне зависимости от базовой темы.

Применение устаревшего предустановленного автоформата XLS

PivotTable.AutoFormatType принимает значение из перечисления Aspose.Cells.Pivot.PivotTableAutoFormatType. Доступные значения: от Report1 до Report10, Classic и от Table1 до Table10.

AutoFormatType учитывается только при сохранении рабочей книги как .xls. Когда та же рабочая книга сохраняется как .xlsx, .xlsm или .xlsb, Excel игнорирует это свойство и возвращается к настройкам PivotTableStyleType и PivotTableStyleName.

Следующий пример загружает новую рабочую книгу, заполняет образец данных Fruit/Year/Amount, добавляет сводную таблицу, применяет PivotTableAutoFormatType.Report5 и сохраняет результат как .xls.

Почему нет полей столбцов? Автоформаты серии Report (Report1–Report10, Table1–Table10) были разработаны в классическом Excel для одномерных сводных таблиц — только с полями строк и значениями, без встроенного оформления для заголовков полей столбцов. Если сводной таблице нужны поля столбцов, используйте современные предустановки PivotTableStyleType из Сценария 2 ниже — они рассчитаны на двумерную раскладку современного Excel.

const AsposeCells = require("aspose.cells");

// Сценарий 1: Применение предустановленного автоформата из старого формата XLS
// Используемый API: PivotTable.AutoFormatType
// Целевой формат файла: .xls (устаревший)
// Полные примеры и файлы данных доступны по ссылке https://github.com/aspose-cells/Aspose.Cells-for-.NET

// Создание новой книги
const workbook = new AsposeCells.Workbook();

// Получение первого листа
const sheet = workbook.getWorksheets().get(0);

// Заполнение исходных данных строкой заголовков (Fruit, Year, Amount)
// и 9 строками данных, охватывающими grape, blueberry, kiwi, cherry за 2020 и 2021 годы
sheet.getCells().get(0, 0).putValue("Fruit");
sheet.getCells().get(0, 1).putValue("Year");
sheet.getCells().get(0, 2).putValue("Amount");

sheet.getCells().get(1, 0).putValue("grape");
sheet.getCells().get(1, 1).putValue(2020);
sheet.getCells().get(1, 2).putValue(50);

sheet.getCells().get(2, 0).putValue("blueberry");
sheet.getCells().get(2, 1).putValue(2020);
sheet.getCells().get(2, 2).putValue(30);

sheet.getCells().get(3, 0).putValue("kiwi");
sheet.getCells().get(3, 1).putValue(2020);
sheet.getCells().get(3, 2).putValue(25);

sheet.getCells().get(4, 0).putValue("cherry");
sheet.getCells().get(4, 1).putValue(2020);
sheet.getCells().get(4, 2).putValue(40);

sheet.getCells().get(5, 0).putValue("grape");
sheet.getCells().get(5, 1).putValue(2021);
sheet.getCells().get(5, 2).putValue(60);

sheet.getCells().get(6, 0).putValue("blueberry");
sheet.getCells().get(6, 1).putValue(2021);
sheet.getCells().get(6, 2).putValue(35);

sheet.getCells().get(7, 0).putValue("kiwi");
sheet.getCells().get(7, 1).putValue(2021);
sheet.getCells().get(7, 2).putValue(28);

sheet.getCells().get(8, 0).putValue("cherry");
sheet.getCells().get(8, 1).putValue(2021);
sheet.getCells().get(8, 2).putValue(45);

sheet.getCells().get(9, 0).putValue("grape");
sheet.getCells().get(9, 1).putValue(2020);
sheet.getCells().get(9, 2).putValue(45);

// Добавление сводной таблицы в ячейку назначения E3, с именем "Pivot1", использующей исходный диапазон A1:C10
const pivotIndex = sheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
const pivotTable = sheet.getPivotTables().get(pivotIndex);

// Назначение полей: Fruit -> Строки, Year -> Столбцы, Amount -> Данные
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// Применение предустановленного автоформата из старого формата XLS "Report5"
// Примечание: Это свойство имеет смысл только при сохранении в формате .xls.
// При сохранении в форматах .xlsx/.xlsm/.xlsb Excel игнорирует AutoFormatType
// и использует то, что указано в PivotTableStyleType / PivotTableStyleName.
pivotTable.setAutoFormatType(AsposeCells.PivotTableAutoFormatType.Report5);

// Сохранение книги в устаревшем формате .xls
workbook.save("output.xls");

Применение современного именованного предустановленного стиля сводной таблицы

PivotTable.PivotTableStyleType принимает значение из перечисления Aspose.Cells.PivotTableStyleType. Перечисление охватывает светлые темы от PivotTableStyleLight1 до PivotTableStyleLight28 и тёмные темы от PivotTableStyleDark1 до PivotTableStyleDark28. Стили, добавленные в Excel 2017 (вторая волна светлых и тёмных тем), доступны через то же перечисление.

Это рекомендуемый API для любого современного формата файлов. В отличие от устаревшего автоформата, выбранный здесь стиль точно отображается Excel и сохраняется при циклическом обмене через другие инструменты Office.

Следующий пример использует те же данные Fruit/Year/Amount, создаёт идентичную сводную таблицу, применяет PivotTableStyleDark1 и сохраняет рабочую книгу как .xlsx.

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);

// Строка заголовков: Фрукт / Год / Количество
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

// 9 строк данных: Фрукт / Год / Количество
worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);

worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(150);

worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(200);

worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(180);

worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(120);

worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(170);

worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(210);

worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(190);

worksheet.getCells().get("A10").putValue("Grape");
worksheet.getCells().get("B10").putValue(2021);
worksheet.getCells().get("C10").putValue(130);

// Добавить сводную таблицу в ячейке E3 с именем "Pivot1", источник данных — A1:C10
let pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

// Назначить поля сводной таблицы: Fruit -> область строк, Year -> область столбцов, Amount -> область данных
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// Применить современный именованный стиль сводной таблицы из набора Excel 2007+.
// PivotTableStyleType — корректный API для файлов .xlsx / .xlsm / .xlsb; AutoFormatType
// игнорируется Excel для этих форматов. PivotTableStyleDark1 принадлежит семейству тёмных тем
// (PivotTableStyleDark1..PivotTableStyleDark28), и то же перечисление также предоставляет
// новые светлые/тёмные темы Excel 2017 (PivotTableStyleLight1..Light28 / Dark1..Dark28).
pivotTable.setPivotTableStyleType(AsposeCells.PivotTableStyleType.PivotTableStyleDark1);

// Сохранить как современный .xlsx — это формат, для которого PivotTableStyleType имеет значение.
workbook.save("output.xlsx");

Определение и применение пользовательского стиля сводной таблицы

Встроенные предустановки не могут быть изменены. Когда необходимо переопределить цвета, границы или шрифты, следует определить пользовательский стиль сводной таблицы. Рабочий процесс состоит из трёх шагов:

Добавьте пользовательский стиль в коллекцию TableStyles рабочей книги через Workbook.Worksheets.TableStyles.AddPivotTableStyle(string name). Это возвращает индекс вновь созданного стиля.
Настройте стиль, добавляя элементы (такие как WholeTable или GrandTotalRow) через TableStyle.TableStyleElements.Add(TableStyleElementType), затем назначьте Style каждому элементу через TableStyleElement.SetElementStyle(Style).
Примените пользовательский стиль к сводной таблице, установив PivotTable.PivotTableStyleName равным имени стиля. Не используйте здесь PivotTableStyleType, так как это свойство выбирает встроенные предустановки.

PivotTableStyleName и PivotTableStyleType не взаимозаменяемы. Используйте PivotTableStyleType для встроенных предустановок и PivotTableStyleName для пользовательских стилей, определённых через AddPivotTableStyle. Установка обоих безвредна, но отображается только тот, который соответствует предполагаемому источнику.

Доступные значения TableStyleElementType включают WholeTable, FirstRow, LastRow, FirstColumn, LastColumn, GrandTotalRow, GrandTotalColumn, PageFieldLabels и PageFieldValues.

Следующий пример определяет пользовательский стиль сводной таблицы с тонкой чёрной границей для WholeTable и жирным красным шрифтом для GrandTotalRow, затем применяет его через PivotTableStyleName и сохраняет как .xlsx.

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);

// Заполнение исходных данных: строка заголовка + 9 строк данных (A1:C10)
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);

worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(200);

worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(300);

worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(400);

worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(500);

worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(600);

worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(700);

worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(800);

worksheet.getCells().get("A10").putValue("Grape");
worksheet.getCells().get("B10").putValue(2021);
worksheet.getCells().get("C10").putValue(900);

// Добавление сводной таблицы с источником A1:C10, привязанной к E3, с именем "Pivot1"
let pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// Шаг 1: зарегистрировать новый пользовательский стиль сводной таблицы и сохранить его индекс
let styleIndex = workbook.getWorksheets().getTableStyles().addPivotTableStyle("CustomPivotStyle");
let tableStyle = workbook.getWorksheets().getTableStyles().get(styleIndex);

// Шаг 2: добавить элемент WholeTable и применить тонкие чёрные границы со всех четырёх сторон
let wholeTableElementIndex = tableStyle.getTableStyleElements().add(AsposeCells.TableStyleElementType.WholeTable);
let wholeTableElement = tableStyle.getTableStyleElements().get(wholeTableElementIndex);
let wholeTableStyle = workbook.createStyle();
wholeTableStyle.getBorders().get(AsposeCells.BorderType.TopBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.TopBorder).setColor(AsposeCells.Color.Black);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.BottomBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.BottomBorder).setColor(AsposeCells.Color.Black);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.LeftBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.LeftBorder).setColor(AsposeCells.Color.Black);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.RightBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.RightBorder).setColor(AsposeCells.Color.Black);
wholeTableElement.setElementStyle(wholeTableStyle);

// Шаг 3: добавить элемент GrandTotalRow и применить жирный красный шрифт
let grandTotalElementIndex = tableStyle.getTableStyleElements().add(AsposeCells.TableStyleElementType.GrandTotalRow);
let grandTotalElement = tableStyle.getTableStyleElements().get(grandTotalElementIndex);
let grandTotalStyle = workbook.createStyle();
grandTotalStyle.getFont().setIsBold(true);
grandTotalStyle.getFont().setColor(AsposeCells.Color.Red);
grandTotalElement.setElementStyle(grandTotalStyle);

// Шаг 4: применить пользовательский стиль по имени (НЕ через PivotTableStyleType, который предназначен для встроенных предустановок)
pivotTable.setPivotTableStyleName("CustomPivotStyle");

workbook.save("output.xlsx");

Применение одного стиля к каждой ячейке сводной таблицы с помощью FormatAll

PivotTable.FormatAll(Style) — это сокращение, которое применяет один объект Style к каждой ячейке сводной таблицы, включая область данных, заголовки строк и столбцов, а также итоги. Всё, что было ранее задано через PivotTableStyleType или PivotTableStyleName, переопределяется.

FormatAll переопределяет как PivotTableStyleType, так и PivotTableStyleName. Используйте его только тогда, когда требуется единообразный, независимый от темы внешний вид во всей сводной таблице.

Следующий пример создаёт Style с жёлтой сплошной заливкой, жирным тёмно-синим шрифтом и тонкими чёрными границами со всех сторон, затем применяет его с помощью FormatAll и сохраняет как .xlsx.

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);

// Заполнить исходные данные: строка заголовка (строка 1) + 9 строк данных (строки 2-10)
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(5000);

worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(3000);

worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(4000);

worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(2000);

worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(6000);

worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(3500);

worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(4500);

worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(2500);

worksheet.getCells().get("A10").putValue("Grape");
worksheet.getCells().get("B10").putValue(2021);
worksheet.getCells().get("C10").putValue(5500);

// Добавить сводную таблицу: исходный диапазон A1:C10, ячейка назначения E3, имя "Pivot1"
let pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

// Назначить поля сводной таблицы: Fruit -> область строк, Year -> область столбцов, Amount -> область данных
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// Создать стиль, который будет принудительно применён к каждой ячейке сводной таблицы
let style = workbook.createStyle();
style.setForegroundColor(AsposeCells.Color.Yellow);
style.setPattern(AsposeCells.BackgroundType.Solid);
style.getFont().setIsBold(true);
style.getFont().setColor(AsposeCells.Color.DarkBlue);
style.getBorders().get(AsposeCells.BorderType.TopBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.TopBorder).setColor(AsposeCells.Color.Black);
style.getBorders().get(AsposeCells.BorderType.BottomBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.BottomBorder).setColor(AsposeCells.Color.Black);
style.getBorders().get(AsposeCells.BorderType.LeftBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.LeftBorder).setColor(AsposeCells.Color.Black);
style.getBorders().get(AsposeCells.BorderType.RightBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.RightBorder).setColor(AsposeCells.Color.Black);

// Применить FormatAll: принудительно применяет этот единственный стиль к каждой ячейке сводной таблицы,
// переопределяя любой ранее установленный PivotTableStyleType / PivotTableStyleName
pivotTable.formatAll(style);

// Сохранить книгу в современном формате .xlsx
workbook.save("output.xlsx");

Какой API стилей следует использовать?

Выбор API стилей зависит от формата файла, в который вы сохраняете. Используйте приведённую ниже таблицу в качестве краткого справочника.

Целевой формат файла	Используемый API	Примечания
`.xls` (устаревший)	`PivotTable.AutoFormatType`	Значения из `Aspose.Cells.Pivot.PivotTableAutoFormatType` (например, `Report1`–`Report10`, `Classic`, `Table1`–`Table10`). Игнорируется при сохранении в современных форматах.
`.xlsx` / `.xlsm` / `.xlsb` (современный, встроенный стиль)	`PivotTable.PivotTableStyleType`	Значения из `Aspose.Cells.PivotTableStyleType` (светлые/тёмные темы, включая дополнения Excel 2017).
`.xlsx` / `.xlsm` / `.xlsb` (современный, пользовательский стиль)	`PivotTable.PivotTableStyleName` + `Worksheets.TableStyles.AddPivotTableStyle(...)`	Используйте, когда встроенных предустановок недостаточно. Настройка через `TableStyleElement.SetElementStyle(...)`.
Любой формат (единообразное переопределение)	`PivotTable.FormatAll(Style)`	Сокращение, переопределяющее все остальные настройки стилей во всей сводной таблице.

В случае сомнений сохраняйте как .xlsx и используйте PivotTableStyleType для встроенных тем или PivotTableStyleName для пользовательских тем.

Nodejscpp: Добавить поля строк и столбцов сводной таблицы в Aspose.Cells для .NET

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

Добавление поля в область строк или столбцов

Метод PivotTable.AddFieldToArea(PivotFieldType fieldType, string fieldName) перемещает базовое поле из исходных данных в одну из четырёх областей сводной таблицы. Аргумент fieldType принимает одно из следующих значений PivotFieldType.

Row — поля, размещённые вертикально слева
Column — поля, размещённые горизонтально сверху
Data — поля, значения которых агрегируются
Page — поля, используемые как фильтры отчёта

После добавления полей вы можете получить к ним доступ через свойства PivotTable.RowFields и PivotTable.ColumnFields. Каждое свойство возвращает коллекцию PivotFieldCollection. Поле с индексом 0 в RowFields является внешним полем строки, а последующие индексы представляют поля, вложенные в него. То же соглашение об индексации применяется к ColumnFields.

Порядок вложенности полей имеет значение. Добавление Category в область строк первым, а затем Item приводит к созданию сводной таблицы, в которой внешняя группировка — Category, а внутренняя — Item. Изменение порядка на обратный меняет иерархию.

Промежуточные итоги полей сводной таблицы

Метод PivotField.SetSubtotals(PivotFieldSubtotalType subtotalType, bool shown) управляет тем, какие строки промежуточных итогов отображаются для поля сводной таблицы. Каждый вызов переключает отдельный тип промежуточного итога независимо. Передача shown = true отображает промежуточный итог, а shown = false скрывает его. Поскольку каждый вызов затрагивает только один тип, многократный вызов метода с разными значениями subtotalType формирует пользовательское подмножество промежуточных итогов.

Перечисление PivotFieldSubtotalType определяет доступные виды промежуточных итогов.

Automatic — Aspose.Cells выбирает значение по умолчанию (как правило, Sum для числовых полей)
None — подавить все строки промежуточных итогов
Sum
Count
Average
Max
Min
Product
StdDev
StdDevp
Var
Varp

Промежуточные итоги отображаются только при наличии двух или более полей сводной таблицы в области строк (или в области столбцов). У единственного поля нет ничего осмысленного для подведения промежуточного итога между группами, поэтому в этом случае вызовы SetSubtotals не имеют видимого эффекта. Поэтому в этой статье во всех примерах размещаются два поля строк (Category внешнее, Item внутреннее), чтобы граница промежуточного итога между каждой группой Category была видна.

Сценарий 1 — автоматические (по умолчанию) промежуточные итоги

Если SetSubtotals вообще не вызывается, Aspose.Cells применяет выбор Automatic для числовых полей. Следующий пример явно подтверждает это поведение, вызывая SetSubtotals(PivotFieldSubtotalType.Automatic, true) для внешнего поля строки Category.

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

worksheet.getCells().get(0, 0).putValue("Category");
worksheet.getCells().get(0, 1).putValue("Item");
worksheet.getCells().get(0, 2).putValue("Year");
worksheet.getCells().get(0, 3).putValue("Amount");

worksheet.getCells().get(1, 0).putValue("Fruit");
worksheet.getCells().get(1, 1).putValue("Apple");
worksheet.getCells().get(1, 2).putValue(2020);
worksheet.getCells().get(1, 3).putValue(100);

worksheet.getCells().get(2, 0).putValue("Fruit");
worksheet.getCells().get(2, 1).putValue("Apple");
worksheet.getCells().get(2, 2).putValue(2021);
worksheet.getCells().get(2, 3).putValue(150);

worksheet.getCells().get(3, 0).putValue("Fruit");
worksheet.getCells().get(3, 1).putValue("Banana");
worksheet.getCells().get(3, 2).putValue(2020);
worksheet.getCells().get(3, 3).putValue(80);

worksheet.getCells().get(4, 0).putValue("Fruit");
worksheet.getCells().get(4, 1).putValue("Banana");
worksheet.getCells().get(4, 2).putValue(2021);
worksheet.getCells().get(4, 3).putValue(90);

worksheet.getCells().get(5, 0).putValue("Vegetable");
worksheet.getCells().get(5, 1).putValue("Carrot");
worksheet.getCells().get(5, 2).putValue(2020);
worksheet.getCells().get(5, 3).putValue(50);

worksheet.getCells().get(6, 0).putValue("Vegetable");
worksheet.getCells().get(6, 1).putValue("Carrot");
worksheet.getCells().get(6, 2).putValue(2021);
worksheet.getCells().get(6, 3).putValue(60);

worksheet.getCells().get(7, 0).putValue("Vegetable");
worksheet.getCells().get(7, 1).putValue("Daikon");
worksheet.getCells().get(7, 2).putValue(2020);
worksheet.getCells().get(7, 3).putValue(40);

worksheet.getCells().get(8, 0).putValue("Vegetable");
worksheet.getCells().get(8, 1).putValue("Daikon");
worksheet.getCells().get(8, 2).putValue(2021);
worksheet.getCells().get(8, 3).putValue(45);

let pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

let categoryField = pivotTable.getRowFields().get(0);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.Automatic, true);

pivotTable.calculateData();

workbook.save("output_automatic.xlsx");

Сценарий 2 — подавление всех промежуточных итогов (None)

Вызов SetSubtotals(PivotFieldSubtotalType.None, true) удаляет все строки промежуточных итогов из сводной таблицы, оставляя только строки полей и общий итог внизу. Это полезно, когда требуются необработанные сгруппированные данные без каких-либо строк итогов.

const AsposeCells = require("aspose.cells");

const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

const headers = ["Category", "Item", "Year", "Amount"];
for (let j = 0; j < headers.length; j++) {
    worksheet.getCells().get(0, j).putValue(headers[j]);
}

const data = [
    ["Fruit",     "Apple",  2020, 100],
    ["Fruit",     "Apple",  2021, 150],
    ["Fruit",     "Banana", 2020, 80],
    ["Fruit",     "Banana", 2021, 90],
    ["Vegetable", "Carrot", 2020, 50],
    ["Vegetable", "Carrot", 2021, 60],
    ["Vegetable", "Daikon", 2020, 40],
    ["Vegetable", "Daikon", 2021, 45]
];

for (let i = 0; i < data.length; i++) {
    for (let j = 0; j < data[i].length; j++) {
        worksheet.getCells().get(i + 1, j).putValue(data[i][j]);
    }
}

const pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1");
const pivotTable = worksheet.getPivotTables().get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

const categoryField = pivotTable.getRowFields().get(0);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.None, true);
pivotTable.calculateData();

workbook.save("output_none.xlsx");

Сценарий 3 — пользовательское подмножество промежуточных итогов (Sum + Average)

Вы не ограничены единственным типом промежуточного итога. Каждый вызов SetSubtotals действует независимо для одного типа, поэтому двойной вызов метода — один раз с Sum и один раз с Average — формирует пользовательское подмножество из двух строк промежуточных итогов для каждой группы Category.

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

worksheet.getCells().get("A1").putValue("Category");
worksheet.getCells().get("B1").putValue("Item");
worksheet.getCells().get("C1").putValue("Year");
worksheet.getCells().get("D1").putValue("Amount");

worksheet.getCells().get(1, 0).putValue("Fruit");
worksheet.getCells().get(1, 1).putValue("Apple");
worksheet.getCells().get(1, 2).putValue(2020);
worksheet.getCells().get(1, 3).putValue(100);

worksheet.getCells().get(2, 0).putValue("Fruit");
worksheet.getCells().get(2, 1).putValue("Apple");
worksheet.getCells().get(2, 2).putValue(2021);
worksheet.getCells().get(2, 3).putValue(150);

worksheet.getCells().get(3, 0).putValue("Fruit");
worksheet.getCells().get(3, 1).putValue("Banana");
worksheet.getCells().get(3, 2).putValue(2020);
worksheet.getCells().get(3, 3).putValue(80);

worksheet.getCells().get(4, 0).putValue("Fruit");
worksheet.getCells().get(4, 1).putValue("Banana");
worksheet.getCells().get(4, 2).putValue(2021);
worksheet.getCells().get(4, 3).putValue(90);

worksheet.getCells().get(5, 0).putValue("Vegetable");
worksheet.getCells().get(5, 1).putValue("Carrot");
worksheet.getCells().get(5, 2).putValue(2020);
worksheet.getCells().get(5, 3).putValue(50);

worksheet.getCells().get(6, 0).putValue("Vegetable");
worksheet.getCells().get(6, 1).putValue("Carrot");
worksheet.getCells().get(6, 2).putValue(2021);
worksheet.getCells().get(6, 3).putValue(60);

worksheet.getCells().get(7, 0).putValue("Vegetable");
worksheet.getCells().get(7, 1).putValue("Daikon");
worksheet.getCells().get(7, 2).putValue(2020);
worksheet.getCells().get(7, 3).putValue(40);

worksheet.getCells().get(8, 0).putValue("Vegetable");
worksheet.getCells().get(8, 1).putValue("Daikon");
worksheet.getCells().get(8, 2).putValue(2021);
worksheet.getCells().get(8, 3).putValue(45);

let pivotTables = worksheet.getPivotTables();
let pivotIndex = pivotTables.add("A1:D9", "F3", "PivotTable1");
let pivotTable = pivotTables.get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

let categoryField = pivotTable.getRowFields().get(0);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.Sum, true);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.Average, true);

pivotTable.calculateData();

workbook.save("output_custom.xlsx");

Резюме

Все три приведённых выше сценария используют один и тот же набор данных и структуру сводной таблицы. Единственное различие между ними — вызов SetSubtotals, применяемый к внешнему полю строки Category. Помните правило двух полей: у единственного поля в области нет ничего, между чем можно подвести промежуточный итог, поэтому всегда размещайте как минимум два поля в области строк или столбцов, если хотите, чтобы SetSubtotals имел видимый эффект.

Nodejscpp: Управление полями значений сводной таблицы в Aspose.Cells для .NET

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

Добавление поля в область данных

Добавление базового поля в область данных (значений) — это первый шаг в формировании того, как сводная таблица агрегирует исходные данные. Aspose.Cells предоставляет метод PivotTable.addFieldToArea(PivotFieldType, string), перегрузку, которая принимает константу PivotFieldType.Data и имя исходного столбца. После добавления поля в область данных API предоставляет к нему доступ через коллекцию PivotTable.getDataFields() в порядке добавления полей. По умолчанию числовой исходный столбец агрегируется функцией ConsolidationFunction.Sum, а нечисловой — Count.

const AsposeCells = require("aspose.cells");

const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

// Заголовки в A1:D1
worksheet.getCells().get(0, 0).putValue("Category");
worksheet.getCells().get(0, 1).putValue("Item");
worksheet.getCells().get(0, 2).putValue("Year");
worksheet.getCells().get(0, 3).putValue("Amount");

// Строки данных A2:D9 с использованием вложенных циклов с ветвлением по j
for (let i = 1; i <= 8; i++) {
 for (let j = 0; j < 4; j++) {
 switch (j) {
 case 0:
 worksheet.getCells().get(i, j).putValue(i <= 4 ? "Fruit" : "Vegetable");
 break;
 case 1:
 if (i === 1 || i === 2) worksheet.getCells().get(i, j).putValue("Apple");
 else if (i === 3 || i === 4) worksheet.getCells().get(i, j).putValue("Banana");
 else if (i === 5 || i === 6) worksheet.getCells().get(i, j).putValue("Carrot");
 else worksheet.getCells().get(i, j).putValue("Daikon");
 break;
 case 2:
 worksheet.getCells().get(i, j).putValue(2020 + ((i - 1) % 2));
 break;
 case 3:
 if (i === 1) worksheet.getCells().get(i, j).putValue(100);
 else if (i === 2) worksheet.getCells().get(i, j).putValue(150);
 else if (i === 3) worksheet.getCells().get(i, j).putValue(80);
 else if (i === 4) worksheet.getCells().get(i, j).putValue(90);
 else if (i === 5) worksheet.getCells().get(i, j).putValue(50);
 else if (i === 6) worksheet.getCells().get(i, j).putValue(60);
 else if (i === 7) worksheet.getCells().get(i, j).putValue(40);
 else worksheet.getCells().get(i, j).putValue(45);
 break;
 }
 }
}

// Добавить сводную таблицу в F3 с именем PivotTable1
const pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1", true, false);
const pivotTable = worksheet.getPivotTables().get(pivotIndex);

// Структура сводной таблицы: Category и Item в строках, Year в столбцах, Amount в качестве поля данных
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Data, "Amount");

pivotTable.calculateData();
workbook.save("output_drag.xlsx");

Изменение функции итогов

Каждое поле, помещённое в область данных, внутренне оборачивается как экземпляр PivotField, а его свойство getFunction() возвращает значение из перечисления ConsolidationFunction. Тот же сеттер setFunction() позволяет переключаться между доступными агрегатами, включая Sum, Count, Average, Max, Min, Product, StdDev, StdDevp, Var и Varp.

Изменение функции итогов влияет только на агрегат, исходный столбец не изменяется.

Таким образом, вы можете оставить одно поле данных как Sum, добавив второе поле данных, ссылающееся на тот же исходный столбец, но использующее Count или Average, — всё это в одной сводной таблице.

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

worksheet.getCells().get(0, 0).putValue("Category");
worksheet.getCells().get(0, 1).putValue("Item");
worksheet.getCells().get(0, 2).putValue("Year");
worksheet.getCells().get(0, 3).putValue("Amount");

for (let i = 1; i <= 8; i++)
{
 for (let j = 0; j <= 3; j++)
 {
 if (j == 0)
 {
 worksheet.getCells().get(i, j).putValue(i <= 5 ? "Fruit" : "Vegetable");
 }
 else if (j == 1)
 {
 let items = ["Apple", "Apple", "Banana", "Banana", "Carrot", "Carrot", "Daikon", "Daikon"];
 worksheet.getCells().get(i, j).putValue(items[i - 1]);
 }
 else if (j == 2)
 {
 let years = [2020, 2021, 2020, 2021, 2020, 2021, 2020, 2021];
 worksheet.getCells().get(i, j).putValue(years[i - 1]);
 }
 else
 {
 let amounts = [100, 150, 80, 90, 50, 60, 40, 45];
 worksheet.getCells().get(i, j).putValue(amounts[i - 1]);
 }
 }
}

let pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1", true, false);
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

let countField = pivotTable.getDataFields().get(1);
countField.setFunction(AsposeCells.ConsolidationFunction.Count);

pivotTable.calculateData();

workbook.save("output_function.xlsx");

Размещение полей значений на оси строк или столбцов

Когда сводная таблица содержит два или более полей данных, Aspose.Cells предоставляет дополнительное виртуальное поле, называемое PivotTable.getValuesField. Это виртуальное поле представляет собой агрегат каждого поля данных, находящегося в области данных. Его можно перетащить в область строк или столбцов как базовое поле сводной таблицы, что удобно для расположения нескольких мер рядом.

PivotTable.getValuesField() не работает, если поле значений отсутствует или является единственным.

Приведённые ниже сценарии демонстрируют три полных примера, которые показывают каждую из описанных выше возможностей на одной и той же структуре сводной таблицы.

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

worksheet.getCells().get(0, 0).putValue("Category");
worksheet.getCells().get(0, 1).putValue("Item");
worksheet.getCells().get(0, 2).putValue("Year");
worksheet.getCells().get(0, 3).putValue("Amount");

let categories = ["Fruit", "Fruit", "Fruit", "Fruit", "Vegetable", "Vegetable", "Vegetable", "Vegetable"];
let items = ["Apple", "Apple", "Banana", "Banana", "Carrot", "Carrot", "Daikon", "Daikon"];
let years = [2020, 2021, 2020, 2021, 2020, 2021, 2020, 2021];
let amounts = [100, 150, 80, 90, 50, 60, 40, 45];

for (let i = 1; i <= 8; i++)
{
 for (let j = 0; j <= 3; j++)
 {
 if (j == 0) worksheet.getCells().get(i, j).putValue(categories[i - 1]);
 else if (j == 1) worksheet.getCells().get(i, j).putValue(items[i - 1]);
 else if (j == 2) worksheet.getCells().get(i, j).putValue(years[i - 1]);
 else worksheet.getCells().get(i, j).putValue(amounts[i - 1]);
 }
}

let pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1", true, false);
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

pivotTable.getDataFields().get(1).setFunction(AsposeCells.ConsolidationFunction.Count);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, pivotTable.getValuesField());

pivotTable.calculateData();
workbook.save("output_plot.xlsx");

Nodejscpp: Добавить поля фильтров в сводную таблицу в Aspose.Cells для .NET

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

Aspose.Cells поддерживает полный жизненный цикл полей фильтра в сводных таблицах. Вы можете добавить поле фильтра через высокоуровневый удобный API или через низкоуровневую коллекцию PageFields, управлять фильтром страниц в режиме одиночного выбора, очищать его для отображения всех элементов страницы или переключать поле в режим множественного выбора, чтобы пользователи могли выбирать несколько элементов страницы одновременно через интерфейс с флажками в Excel.

Введение

поле фильтра — это поле сводной таблицы, которое управляет тем, какое подмножество исходных данных отображается в теле сводной таблицы. Конечные пользователи видят его как раскрывающийся список в верхней части отображённой сводной таблицы в Excel, и выбор одного из доступных элементов страницы перестраивает тело сводной таблицы так, чтобы суммировались только записи, принадлежащие этому элементу страницы. Поле сводной таблицы становится полем страницы, когда оно зарегистрировано как PivotFieldType.Page, а не как PivotFieldType.Row, PivotFieldType.Column или PivotFieldType.Data.

поле фильтра может работать в двух режимах. В режиме одиночного выбора по умолчанию одновременно виден только один элемент страницы, поэтому тело сводной таблицы суммирует ровно одно подмножество. В режиме множественного выбора поле отображает список с флажками, и тело сводной таблицы суммирует объединение всех отмеченных элементов страницы. Одно и то же исходное поле можно переключать между этими режимами, изменяя значение одного свойства.

Aspose.Cells for Node.js via C++ предоставляет два эквивалентных способа регистрации поля фильтраы. Высокоуровневый API — это PivotTable.addFieldToArea(PivotFieldType.Page, "fieldName"), который принимает имя исходного столбца и добавляет поле одним вызовом. Низкоуровневый API — это PivotTable.pageFields.add(PivotField), который используется, когда у вас уже есть ссылка на PivotField и вы хотите добавить тот же экземпляр поля в область фильтраы. Оба API в итоге заполняют одну и ту же коллекцию PageFields, и далее в этой статье показано, как выбирать между ними и как управлять каждым режимом фильтрации.

Добавление поля фильтраы

Существует два способа зарегистрировать поле сводной таблицы в области страницы. Высокоуровневый вызов принимает имя исходного столбца в виде строки и является наиболее распространённым путём. Низкоуровневый вызов принимает существующий экземпляр PivotField и удобен, когда тот же объект поля должен использоваться в нескольких областях сводной таблицы. Оба вызова помещают поле в PivotTable.pageFields, после чего оно появляется как раскрывающийся список страницы в верхней части отображённой сводной таблицы.

Добавление поля фильтраы с помощью addFieldToArea

Следующий пример создаёт небольшой набор данных Fruit / Year / Amount, размещает сводную таблицу в ячейке E3 с Fruit в области строк, Amount в области данных и Year в области страницы, обновляет сводную таблицу и сохраняет рабочую книгу.

var workbook = new AsposeCells.Workbook();
var worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

// Настраиваем строку заголовка
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

// Заполняем 9 строк образцами данных: Фрукт, Год, Количество
var data = [
    [ "apple", 2020, 100 ],
    [ "banana", 2021, 200 ],
    [ "apple", 2021, 150 ],
    [ "grape", 2020, 120 ],
    [ "orange", 2022, 180 ],
    [ "banana", 2020, 90 ],
    [ "grape", 2021, 130 ],
    [ "apple", 2022, 170 ],
    [ "orange", 2021, 110 ]
];

for (var i = 0; i < data.length; i++)
{
    worksheet.getCells().get(i + 1, 0).putValue(data[i][0]);
    worksheet.getCells().get(i + 1, 1).putValue(data[i][1]);
    worksheet.getCells().get(i + 1, 2).putValue(data[i][2]);
}

// Добавляем сводную таблицу с привязкой к ячейке E3
var pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "PivotTable1");
var pivotTable = worksheet.getPivotTables().get(pivotIndex);

// Добавляем поля в области: Fruit как строка, Amount как данные, Year как поле страницы
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");

// Обновляем и вычисляем данные сводной таблицы
pivotTable.calculateData();

// Сохраняем книгу
workbook.save("pageFieldSample.xlsx");

Добавление поля фильтраы с помощью pageFields.add

Когда вы уже работаете с экземпляром PivotField, вы можете передать его напрямую в PivotTable.pageFields.add. Сводная таблица и поле фильтра создаются точно так же, как в предыдущем сценарии; только последняя регистрация в области страницы заменяется вызовом низкоуровневого API.

let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);

// Заголовки
sheet.getCells().get("A1").putValue("Fruit");
sheet.getCells().get("B1").putValue("Year");
sheet.getCells().get("C1").putValue("Amount");

// Пример данных (9 строк)
sheet.getCells().get("A2").putValue("apple");     sheet.getCells().get("B2").putValue("2020"); sheet.getCells().get("C2").putValue(100);
sheet.getCells().get("A3").putValue("apple");     sheet.getCells().get("B3").putValue("2021"); sheet.getCells().get("C3").putValue(150);
sheet.getCells().get("A4").putValue("apple");     sheet.getCells().get("B4").putValue("2022"); sheet.getCells().get("C4").putValue(200);
sheet.getCells().get("A5").putValue("grape");     sheet.getCells().get("B5").putValue("2020"); sheet.getCells().get("C5").putValue(300);
sheet.getCells().get("A6").putValue("grape");     sheet.getCells().get("B6").putValue("2021"); sheet.getCells().get("C6").putValue(400);
sheet.getCells().get("A7").putValue("grape");     sheet.getCells().get("B7").putValue("2022"); sheet.getCells().get("C7").putValue(500);
sheet.getCells().get("A8").putValue("blueberry"); sheet.getCells().get("B8").putValue("2020"); sheet.getCells().get("C8").putValue(250);
sheet.getCells().get("A9").putValue("blueberry"); sheet.getCells().get("B9").putValue("2021"); sheet.getCells().get("C9").putValue(350);
sheet.getCells().get("A10").putValue("blueberry");sheet.getCells().get("B10").putValue("2022"); sheet.getCells().get("C10").putValue(450);

// Добавить сводную таблицу в E3, охватывающую A1:C10
let pivotIndex = sheet.getPivotTables().add("E3", "A1:C10", "PivotTable1");
let pivotTable = sheet.getPivotTables().get(pivotIndex);

// Fruit -> Строка, Amount -> Данные (Year будет добавлен в область Страница ниже)
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// Низкоуровневый подход: получить существующее PivotField Year из BaseFields
// и зарегистрировать его в области Страница через PageFields.Add(PivotField).
let yearField = pivotTable.getBaseFields().get("Year");
pivotTable.getPageFields().add(yearField);

// Обновить, чтобы новое поле страницы отразилось в сохранённой книге
pivotTable.calculateData();

workbook.save("output.xlsx");

Фильтрация с одиночным выбором (отображение одного элемента страницы)

В режиме одиночного выбора по умолчанию поле фильтра отображается как один раскрывающийся список, и целочисленное значение PivotField.currentPageItem выбирает, какой элемент страницы управляет телом сводной таблицы. Присвоение конкретного индекса выбирает этот один элемент; присвоение специального значения 0x7FFD (десятичное 32765) снимает фильтр, так что все элементы страницы суммируются одновременно. Одиночный выбор используется по умолчанию; вам не нужно включать его явно.

Отображение всех элементов

Установка currentPageItem на магическое значение 0x7FFD эквивалентна снятию фильтра страницы: тело сводной таблицы суммирует все элементы страницы, как если бы фильтр не был применён.

let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);

// Заполнение данных Fruit/Year/Amount
sheet.getCells().get("A1").putValue("Fruit");
sheet.getCells().get("B1").putValue("Year");
sheet.getCells().get("C1").putValue("Amount");

let data = [
    ["Apple", 2022, 100],
    ["Apple", 2023, 150],
    ["Banana", 2022, 80],
    ["Banana", 2023, 120],
    ["Cherry", 2022, 200],
    ["Cherry", 2023, 250]
];

for (let r = 0; r < data.length; r++) {
    for (let c = 0; c < data[r].length; c++) {
        sheet.getCells().get(r + 1, c).putValue(data[r][c]);
    }
}

// Создание сводной таблицы в E3
let pivotTables = sheet.getPivotTables();
let index = pivotTables.add("=A1:C7", "E3", "PivotTable1");
let pivotTable = pivotTables.get(index);

// Настройка полей сводной таблицы: Fruit→Строка, Amount→Данные, Year→Страница
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");

pivotTable.calculateData();

// Сброс фильтра страницы, чтобы каждый элемент поля страницы был виден.
// 0x7FFD (десятичное 32765) — это специальное значение-маркер, означающее "все элементы" —
// эквивалентно выбору "(Все)" в раскрывающемся списке поля страницы Excel.
pivotTable.getPageFields().get(0).setCurrentPageItem(0x7FFD);

workbook.save("output.xlsx");

Отображение одного конкретного элемента

Установка currentPageItem на реальный индекс выбирает только этот один элемент страницы. Индекс — это позиция элемента в отсортированном списке элементов поля фильтраы, поэтому, например, 1 выбирает второй элемент после сортировки.

var workbook = new AsposeCells.Workbook();
var sheet = workbook.getWorksheets().get(0);
var cells = sheet.getCells();

// Добавляем пример данных (Фрукт/Год/Количество)
cells.get("A1").putValue("Fruit");
cells.get("B1").putValue("Year");
cells.get("C1").putValue("Amount");

cells.get("A2").putValue("Apple");
cells.get("B2").putValue("2020");
cells.get("C2").putValue("100");

cells.get("A3").putValue("Apple");
cells.get("B3").putValue("2021");
cells.get("C3").putValue("150");

cells.get("A4").putValue("Banana");
cells.get("B4").putValue("2020");
cells.get("C4").putValue("200");

cells.get("A5").putValue("Banana");
cells.get("B5").putValue("2021");
cells.get("C5").putValue("250");

// Добавляем сводную таблицу в ячейку E3
var pivotTables = sheet.getPivotTables();
var pivotIndex = pivotTables.add("A1:C5", "E3", "PivotTable1");
var pivotTable = pivotTables.get(pivotIndex);

// Добавляем поля: Fruit→Строка, Amount→Данные, Year→Страница
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");

// Операции, специфичные для поля страницы
pivotTable.getPageFields().get(0).setCurrentPageItem(1); // 1 = второй элемент в отсортированном порядке (например, "2021")

// Обновляем и пересчитываем сводную таблицу
pivotTable.calculateData();

workbook.save("output.xlsx");

Фильтрация с множественным выбором

Фильтрация с множественным выбором превращает раскрывающийся список страницы в список с флажками и позволяет конечному пользователю выбирать несколько элементов страницы одновременно. Aspose.Cells предоставляет два свойства, которые работают вместе. PivotField.isMultipleItemSelectionAllowed должно быть установлено в true, прежде чем интерфейс множественного выбора начнёт действовать. После его включения PivotItem.isHidden управляет тем, какие элементы отображаются в списке с флажками, поэтому вы можете либо показать все элементы, либо включить в белый список только конкретные элементы.

Код ниже включает множественный выбор для того же поля фильтраы Year, созданного в сценарии 1a, а затем демонстрирует два шаблона: Часть A показывает все элементы страницы, оставляя isHidden равным false для каждой записи, тогда как Часть B включает в белый список только выбранные вами исходные значения и скрывает все остальные через блок switch (pivotItems[i].getStringValue()).

let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);
let cells = sheet.getCells();

// Пример данных: Фрукт | Год | Количество
cells.get(0, 0).putValue("Fruit");
cells.get(0, 1).putValue("Year");
cells.get(0, 2).putValue("Amount");

let data = [
    ["apple", "2019", "100"],
    ["apple", "2020", "150"],
    ["apple", "2021", "200"],
    ["banana", "2019", "110"],
    ["banana", "2020", "160"],
    ["banana", "2021", "210"],
    ["grape", "2019", "120"],
    ["grape", "2020", "170"],
    ["grape", "2021", "220"]
];

for (let i = 0; i < data.length; i++) {
    cells.get(i + 1, 0).putValue(data[i][0]);
    cells.get(i + 1, 1).putValue(parseInt(data[i][1]));
    cells.get(i + 1, 2).putValue(parseInt(data[i][2]));
}

let pivotSheet = workbook.getWorksheets().add("Pivot");
let pivots = pivotSheet.getPivotTables();
let pivotIndex = pivots.add("E3", "A1:C10", "PivotTable1");
let pivotTable = pivots.get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");

// — Включить множественный выбор в поле страницы
pivotTable.getPageFields().get(0).setIsMultipleItemSelectionAllowed(true);

// Часть A — выбрать ВСЕ элементы (сделать каждый элемент видимым)
let pivotItems = pivotTable.getPageFields().get(0).getPivotItems();
for (let i = 0; i < pivotItems.getCount(); i++) {
    pivotItems.get(i).setIsHidden(false);
}

// Часть B — выбрать только конкретные элементы по исходному значению
for (let i = 0; i < pivotItems.getCount(); i++) {
    switch (pivotItems.get(i).getStringValue()) {
        case "2020":
        case "grape":
        case "blueberry":
            pivotItems.get(i).setIsHidden(false);
            break;
        default:
            pivotItems.get(i).setIsHidden(true);
            break;
    }
}

pivotTable.calculateData();

workbook.save("output.xlsx");

Примечание: При использовании фильтрации с множественным выбором через PivotItem.isHidden, по крайней мере один PivotItem должен оставаться видимым (isHidden == false). Если все элементы скрыты, Excel либо аварийно завершает работу при открытии файла, либо отображает пустую сводную таблицу. Всегда проверяйте, что ваш белый список множественного выбора включает хотя бы один элемент из ваших исходных данных.

Какой API и какой режим следует использовать?

Таблица ниже обобщает, когда использовать каждый API и режим, чтобы вы могли выбрать правильную комбинацию без необходимости читать каждый сценарий подробно.

Сценарий / Вариант использования	Рекомендуемый API	Используемое свойство	Примечания
Добавить поле фильтра по имени исходного столбца (наиболее распространённый случай)	`PivotTable.addFieldToArea(PivotFieldType.Page, "fieldName")`	n/a	Высокоуровневый, однострочный. Используйте его, если вам не нужна ссылка на `PivotField`.
Добавить поле фильтра, когда у вас уже есть объект `PivotField`	`PivotTable.pageFields.add(PivotField)`	n/a	Используйте, когда объект поля был получен в другом месте или должен использоваться повторно.
Фильтрация до одного элемента страницы (режим по умолчанию)	`PivotField.currentPageItem`	установить на конкретный индекс	Например, `1` показывает второй элемент в отсортированном списке.
Показать все элементы / снять фильтр страницы	`PivotField.currentPageItem`	установить на `0x7FFD`	Магическое значение `0x7FFD` (десятичное 32765) является маркером «все элементы».
Включить интерфейс множественного выбора в Excel	`PivotField.isMultipleItemSelectionAllowed`	установить в `true`	Требуется до того, как любые вызовы `isHidden` вступят в силу.
Скрыть / показать отдельные элементы в списке множественного выбора	`PivotItem.isHidden`	устанавливается для каждого элемента	По крайней мере один элемент должен оставаться видимым (`isHidden == false`).

Всегда помните об ограничении видимости при настройке фильтрации с множественным выбором. Если каждый PivotItem в поле фильтра с множественным выбором скрыт, Excel аварийно завершает работу при открытии или отображает пустую сводную таблицу. Создавайте свой белый список на основе исходных данных так, чтобы хотя бы один элемент оставался видимым, и ваши сохранённые рабочие книги будут надёжно открываться на любом компьютере.

Nodejscpp: Удалить сводную таблицу из листа

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

Aspose.Cells for Node.js via C++ предоставляет функцию удаления сводной таблицы или ее отключения из рабочего листа. Можно удалить сводную таблицу с помощью объекта сводной таблицы или по ее позиции. Пожалуйста, используйте метод Worksheet.getPivotTables().remove(pivotTable) для удаления сводной таблицы через объект сводной таблицы и метод Worksheet.getPivotTables().removeAt(index, keepData) для удаления объекта сводной таблицы по ее позиции в коллекции сводных таблиц.

Как удалить сводную таблицу из рабочего листа с помощью Aspose.Cells for Node.js via C++

В следующем примере кода удаляются две сводные таблицы с листа. Сначала удаляется сводная таблица, используя метод Worksheet.getPivotTables().remove(pivotTable), а затем удаляется сводная таблица, используя метод Worksheet.getPivotTables().removeAt(index, keepData)

Nodejscpp: Сохранить сводную таблицу в файле ODS

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

Aspose.Cells for Node.js via C++ предоставляет возможность сохранять сводные таблицы в файлах ODS. Для этого просто преобразуйте рабочую книгу с существующей сводной таблицей или создайте новую и сохраните файл в формате ODS. Перед сохранением обязательно вызовите PivotTable.calculateData, чтобы убедиться, что сводная таблица отрисована в итоговом файле ODS. Следующий пример демонстрирует сохранение сводной таблицы в файле ODS.

Образец кода

Выходной файл, сгенерированный вышеуказанным кодом, прикреплен для вашего справки.

Файл ODS результатов

Documentation – Вставка сводной таблицы

Nodejscpp: Форматирование сводной таблицы

Внешний вид сводной таблицы

Как установить параметры форматирования сводной таблицы

Как установить тип автоформата

Как устанавливать параметры форматирования

Форматирование внешнего вида вручную

Как установить параметры форматирования поля сводной таблицы

Как установить формат полей строк/столбцов/страниц

Как установить формат полей данных

Как очистить поля сводной таблицы

Nodejscpp: Создание сводных таблиц и сводных графиков

Добавление сводных таблиц и диаграмм с помощью Aspose.Cells for Node.js via C++

Подготовка к использованию Aspose.Cells for Node.js via C++

Как добавить сводную таблицу с помощью Aspose.Cells for Node.js via C++

Как добавить сводную диаграмму с помощью библиотеки Aspose.Cells for Node.js via C++

Nodejscpp: Сводная таблица и исходные данные

Исходные данные сводной таблицы

Изменение исходного источника данных сводной таблицы

Nodejscpp: Добавление вычисляемого поля в сводной таблице

Возможные сценарии использования

Как добавить вычисляемое поле в сводную таблицу в Excel

Как добавить вычисляемое поле в сводную таблицу с использованием библиотеки Aspose.Cells for Node.js via C++

Образец кода

Nodejscpp: Обновление сводных таблиц в Aspose.Cells for Node.js via C++

Введение

Необходимые импорты

Обновление всех сводных таблиц в рабочей книге

Обновление всех сводных таблиц на одном рабочем листе

Обновление одной сводной таблицы

Изменились исходные данные — используйте PivotCache.Refresh()

Изменились только представление/макет — используйте CalculateData()

Получение всех сводных таблиц, использующих один и тот же PivotCache

Миграция с устаревшего PivotTable.RefreshData()

Какой API обновления мне следует использовать?

Nodejscpp: Применить стили к сводным таблицам в Aspose.Cells для .NET

Введение

Применение устаревшего предустановленного автоформата XLS

Применение современного именованного предустановленного стиля сводной таблицы

Определение и применение пользовательского стиля сводной таблицы

Применение одного стиля к каждой ячейке сводной таблицы с помощью FormatAll

Какой API стилей следует использовать?

Nodejscpp: Добавить поля строк и столбцов сводной таблицы в Aspose.Cells для .NET

Добавление поля в область строк или столбцов

Промежуточные итоги полей сводной таблицы

Сценарий 1 — автоматические (по умолчанию) промежуточные итоги

Сценарий 2 — подавление всех промежуточных итогов (None)

Сценарий 3 — пользовательское подмножество промежуточных итогов (Sum + Average)

Резюме

Nodejscpp: Управление полями значений сводной таблицы в Aspose.Cells для .NET

Добавление поля в область данных

Изменение функции итогов

Размещение полей значений на оси строк или столбцов

Nodejscpp: Добавить поля фильтров в сводную таблицу в Aspose.Cells для .NET

Введение

Добавление поля фильтраы

Добавление поля фильтраы с помощью addFieldToArea

Добавление поля фильтраы с помощью pageFields.add

Фильтрация с одиночным выбором (отображение одного элемента страницы)

Отображение всех элементов

Отображение одного конкретного элемента

Фильтрация с множественным выбором

Какой API и какой режим следует использовать?

Nodejscpp: Удалить сводную таблицу из листа

Как удалить сводную таблицу из рабочего листа с помощью Aspose.Cells for Node.js via C++

Nodejscpp: Сохранить сводную таблицу в файле ODS

Образец кода

Изменились исходные данные — используйте `PivotCache.Refresh()`

Изменились только представление/макет — используйте `CalculateData()`

Миграция с устаревшего `PivotTable.RefreshData()`