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

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

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

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

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

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

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

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

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

Microsoft Excel предлагает несколько различных предустановленных форматов отчетов. Aspose.Cells for Python via .NET также поддерживает эти варианты форматирования. Чтобы получить к ним доступ:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Aspose.Cells для Python via .NET поддерживает сводные таблицы и сводные диаграммы.

Добавление сводных таблиц и диаграмм с использованием Aspose.Cells для Python Excel Library.

Aspose.Cells для Python via .NET предоставляет особый набор классов, используемых для создания сводных таблиц. Эти классы используются для создания и установки объектов PivotTable, которые являются основными строительными блоками объекта PivotTable:

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

Подготовка к использованию Aspose.Cells для Python via .NET

Установите Aspose.Cells для Python via .NET с pypi, используя команду: $ pip install aspose-cells-python.
Вы также можете следовать пошаговым инструкциям о том, как установить “Aspose.Cells для Python via .NET” в свою среду разработки.

Как добавить сводную таблицу, используя Aspose.Cells для Python Excel Library

Чтобы создать сводную таблицу с помощью Aspose.Cells для Python via .NET:

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

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

Как добавить сводную диаграмму с использованием Aspose.Cells для Python Excel Library

Чтобы создать сводную диаграмму с помощью Aspose.Cells для Python via .NET:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Добавить вычисляемое поле в файл Excel с помощью Aspose.Cells для Python via .NET. Пожалуйста, ознакомьтесь с примером кода ниже. После выполнения примера кода к рабочему листу добавляется сводная таблица с вычисляемым полем.

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

Образец кода

Pythonnet: Обновление сводных таблиц в Aspose.Cells for Python via .NET

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

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

Введение

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

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

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

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

Все примеры Python в этой статье начинаются со следующих трёх операторов импорта, поскольку типы сводных таблиц находятся в пространстве имён aspose.cells.pivot:

import sys
import aspose.cells
import aspose.cells.pivot

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

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

.cells as ac

# Создать новую рабочую книгу
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

# Записать строку заголовка в ячейки A1:C1
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

# Записать строки данных в ячейки A2:C9 (8 строк данных о фруктах за 2020 и 2021 годы)
worksheet.cells["A2"].put_value("grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(50)

worksheet.cells["A3"].put_value("blueberry")
worksheet.cells["B3"].put_value(2020)
worksheet.cells["C3"].put_value(60)

worksheet.cells["A4"].put_value("kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(70)

worksheet.cells["A5"].put_value("cherry")
worksheet.cells["B5"].put_value(2020)
worksheet.cells["C5"].put_value(80)

worksheet.cells["A6"].put_value("grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(90)

worksheet.cells["A7"].put_value("blueberry")
worksheet.cells["B7"].put_value(2021)
worksheet.cells["C7"].put_value(100)

worksheet.cells["A8"].put_value("kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(110)

worksheet.cells["A9"].put_value("cherry")
worksheet.cells["B9"].put_value(2021)
worksheet.cells["C9"].put_value(120)

# Добавить сводную таблицу: исходный диапазон "A1:C9", ячейка назначения "E3", имя "Pivot1"
pivot_index = worksheet.pivot_tables.add("A1:C9", "E3", "Pivot1")
pivot_table = worksheet.pivot_tables[pivot_index]

# Назначить поля сводной таблицы: Fruit в строки, Year в столбцы, Amount в данные
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# Изменить несколько значений Amount в исходных данных для имитации изменений
worksheet.cells["C2"].put_value(55)
worksheet.cells["C5"].put_value(85)
worksheet.cells["C9"].put_value(125)

# Обновить все сводные таблицы / кэши сводных таблиц в рабочей книге
workbook.refresh_all()

# Сохранить рабочую книгу
workbook.save("output.xlsx")

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

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

import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

worksheet.cells["A2"].put_value("grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(100)

worksheet.cells["A3"].put_value("blueberry")
worksheet.cells["B3"].put_value(2021)
worksheet.cells["C3"].put_value(150)

worksheet.cells["A4"].put_value("kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(200)

worksheet.cells["A5"].put_value("cherry")
worksheet.cells["B5"].put_value(2021)
worksheet.cells["C5"].put_value(120)

worksheet.cells["A6"].put_value("grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(180)

worksheet.cells["A7"].put_value("blueberry")
worksheet.cells["B7"].put_value(2020)
worksheet.cells["C7"].put_value(130)

worksheet.cells["A8"].put_value("kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(220)

worksheet.cells["A9"].put_value("cherry")
worksheet.cells["B9"].put_value(2020)
worksheet.cells["C9"].put_value(140)

pivot_index = worksheet.pivot_tables.add("A1:C9", "E3", "Pivot1")
pivot_table = worksheet.pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

worksheet.cells["C2"].put_value(300)
worksheet.cells["C5"].put_value(250)
worksheet.cells["C9"].put_value(400)

worksheet.refresh_pivot_tables()

workbook.save("output.xlsx")

Обновить одну сводную таблицу

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

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

Если изменились базовые исходные данные, правильной точкой входа является pivot_table.pivot_cache.refresh(). Этот вызов перечитывает исходные данные в кэш, а затем пересчитывает все PivotTable, зависящие от этого кэша.

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

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

import aspose.cells as ac

# Создаём новую рабочую книгу и получаем доступ к первому листу
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

# Записываем строку заголовков: Fruit / Year / Amount
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

# Записываем примерно 9 строк данных (grape / blueberry / kiwi / cherry за 2020-2021 годы)
worksheet.cells["A2"].put_value("Grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(100)

worksheet.cells["A3"].put_value("Blueberry")
worksheet.cells["B3"].put_value(2020)
worksheet.cells["C3"].put_value(200)

worksheet.cells["A4"].put_value("Kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(300)

worksheet.cells["A5"].put_value("Cherry")
worksheet.cells["B5"].put_value(2020)
worksheet.cells["C5"].put_value(400)

worksheet.cells["A6"].put_value("Grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(500)

worksheet.cells["A7"].put_value("Blueberry")
worksheet.cells["B7"].put_value(2021)
worksheet.cells["C7"].put_value(600)

worksheet.cells["A8"].put_value("Kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(700)

worksheet.cells["A9"].put_value("Cherry")
worksheet.cells["B9"].put_value(2021)
worksheet.cells["C9"].put_value(800)

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

# Назначаем поля для Pivot1
pivotTable1.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivotTable1.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivotTable1.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

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

# Назначаем те же поля для Pivot2
pivotTable2.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivotTable2.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivotTable2.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# Изменяем несколько значений ячеек Amount в исходных данных, чтобы имитировать изменение данных
worksheet.cells["C2"].put_value(150)
worksheet.cells["C4"].put_value(350)
worksheet.cells["C7"].put_value(650)

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

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

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

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

ells as ac
import aspose.cells.pivot as acp

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

# Записать строку заголовков Fruit / Year / Amount
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

# Записать 8 строк данных (строки 2-9, соответствует исходному диапазону A1:C9)
worksheet.cells["A2"].put_value("Grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(100)

worksheet.cells["A3"].put_value("Blueberry")
worksheet.cells["B3"].put_value(2020)
worksheet.cells["C3"].put_value(200)

worksheet.cells["A4"].put_value("Kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(300)

worksheet.cells["A5"].put_value("Cherry")
worksheet.cells["B5"].put_value(2020)
worksheet.cells["C5"].put_value(400)

worksheet.cells["A6"].put_value("Grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(150)

worksheet.cells["A7"].put_value("Blueberry")
worksheet.cells["B7"].put_value(2021)
worksheet.cells["C7"].put_value(250)

worksheet.cells["A8"].put_value("Kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(350)

worksheet.cells["A9"].put_value("Cherry")
worksheet.cells["B9"].put_value(2021)
worksheet.cells["C9"].put_value(450)

# Добавить сводную таблицу с именем "Pivot1" в ячейку назначения E3, источник данных A1:C9
pivot_index = worksheet.pivot_tables.add("A1:C9", "E3", "Pivot1")
pivot_table = worksheet.pivot_tables[pivot_index]

# Назначить поля: Fruit — в строки, Year — в столбцы, Amount — в данные
pivot_table.add_field_to_area(acp.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(acp.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(acp.PivotFieldType.DATA, "Amount")

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

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

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

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

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

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

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

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

import aspose.cells as ac

# Создаём новую книгу и обращаемся к первому листу
workbook = ac.Workbook()
sheet = workbook.worksheets[0]

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

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

# --- Добавляем первую сводную таблицу (Pivot1) в ячейку-приёмник E3 ---
idx1 = sheet.pivot_tables.add("A1:C9", "E3", "Pivot1")
pivot_table1 = sheet.pivot_tables[idx1]
pivot_table1.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table1.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table1.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# --- Добавляем ВТОРУЮ сводную таблицу (Pivot2) на ТОТ ЖЕ диапазон источника ---
# Таблицы Pivot1 и Pivot2 совместно используют ОДИН базовый PivotCache.
# Это именно тот сценарий, в котором устаревший подход с RefreshData()
# на каждой таблице становится неэффективным: обновление одной таблицы
# заново загружает весь общий кэш, поэтому обновление N таблиц выполняет
# одну и ту же дорогостоящую загрузку N раз.
idx2 = sheet.pivot_tables.add("A1:C9", "E15", "Pivot2")
pivot_table2 = sheet.pivot_tables[idx2]
pivot_table2.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table2.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table2.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# --- Изменяем несколько значений Amount в исходных данных ---
sheet.cells["C2"].put_value(5000)   # Grape  2020
sheet.cells["C5"].put_value(7500)   # Cherry 2020
sheet.cells["C9"].put_value(9500)   # Cherry 2021

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

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

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

workbook.save("output.xlsx")

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

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

Цель	Рекомендуемый API	Примечания
Обновить всё в рабочей книге	`Workbook.refresh_all()`	Один вызов; охватывает все кэши и таблицы.
Обновить только сводные таблицы на одном листе	`Worksheet.refresh_pivot_tables()`	Ограничено одним листом.
Изменились исходные данные для одного кэша	`pivot_table.pivot_cache.refresh()`	Обновляет ВСЕ сводные таблицы на этом общем кэше.
Изменились только параметры представления/макета	`pivot_table.calculate_data()`	Пропускает ненужное обращение к источнику.
Получить список всех сводных таблиц на общем кэше	`pivot_cache.get_pivot_tables()`	Используйте для перечисления перед массовым обновлением.
На практике отдавайте предпочтение API на основе кэша, а не устаревшему методу `refresh_data()` для отдельных таблиц. Они учитывают общие кэши, избегают избыточных обращений к источнику и позволяют выбрать минимальный объём, удовлетворяющий вашим требованиям к обновлению.

Pythonnet: Применить стили к сводным таблицам в 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.auto_format_type вместе с перечислением aspose.cells.pivot.PivotTableAutoFormatType. Этот API соответствует выбору автоформата, который предлагал классический Excel для сводных таблиц.

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

PivotTable.pivot_table_style_type выбирает один из встроенных именованных стилей (светлые и тёмные темы, включая стили, добавленные в Excel 2017). Эти предустановки доступны только для чтения.
PivotTable.pivot_table_style_name выбирает пользовательский стиль, который вы определяете самостоятельно через workbook.worksheets.table_styles.add_pivot_table_style(...). Пользовательские стили необходимы, когда требуется изменить цвета, границы или шрифты за пределы того, что предлагают предустановки.

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

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

PivotTable.auto_format_type принимает значение из перечисления aspose.cells.pivot.PivotTableAutoFormatType. Доступные значения: REPORT_1 — REPORT_10, CLASSIC и TABLE_1 — TABLE_10.

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

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

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

import aspose.cells as ac

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

# Создаём новую книгу
workbook = ac.Workbook()

# Получаем первый лист
sheet = workbook.worksheets[0]

# Заполняем исходные данные строкой заголовков (Fruit, Year, Amount)
# и 9 строками данных, охватывающими grape, blueberry, kiwi, cherry за 2020 и 2021 годы
sheet.cells[0, 0].put_value("Fruit")
sheet.cells[0, 1].put_value("Year")
sheet.cells[0, 2].put_value("Amount")

sheet.cells[1, 0].put_value("grape")
sheet.cells[1, 1].put_value(2020)
sheet.cells[1, 2].put_value(50)

sheet.cells[2, 0].put_value("blueberry")
sheet.cells[2, 1].put_value(2020)
sheet.cells[2, 2].put_value(30)

sheet.cells[3, 0].put_value("kiwi")
sheet.cells[3, 1].put_value(2020)
sheet.cells[3, 2].put_value(25)

sheet.cells[4, 0].put_value("cherry")
sheet.cells[4, 1].put_value(2020)
sheet.cells[4, 2].put_value(40)

sheet.cells[5, 0].put_value("grape")
sheet.cells[5, 1].put_value(2021)
sheet.cells[5, 2].put_value(60)

sheet.cells[6, 0].put_value("blueberry")
sheet.cells[6, 1].put_value(2021)
sheet.cells[6, 2].put_value(35)

sheet.cells[7, 0].put_value("kiwi")
sheet.cells[7, 1].put_value(2021)
sheet.cells[7, 2].put_value(28)

sheet.cells[8, 0].put_value("cherry")
sheet.cells[8, 1].put_value(2021)
sheet.cells[8, 2].put_value(45)

sheet.cells[9, 0].put_value("grape")
sheet.cells[9, 1].put_value(2020)
sheet.cells[9, 2].put_value(45)

# Добавляем сводную таблицу в ячейку назначения E3 с именем "Pivot1", используя исходный диапазон A1:C10
pivot_index = sheet.pivot_tables.add("A1:C10", "E3", "Pivot1")
pivot_table = sheet.pivot_tables[pivot_index]

# Назначаем поля: Fruit -> строки, Year -> столбцы, Amount -> данные
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# Применяем предустановленный автоформат устаревшего XLS "Report5"
# Примечание: Это свойство имеет смысл только при сохранении в формате .xls.
# При сохранении в формате .xlsx/.xlsm/.xlsb Excel игнорирует AutoFormatType
# и использует то, что указано в PivotTableStyleType / PivotTableStyleName.
pivot_table.auto_format_type = ac.PivotTableAutoFormatType.REPORT5

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

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

PivotTable.pivot_table_style_type принимает значение из перечисления aspose.cells.PivotTableStyleType. Перечисление охватывает светлые темы PIVOT_TABLE_STYLE_LIGHT_1 — PIVOT_TABLE_STYLE_LIGHT_28 и тёмные темы PIVOT_TABLE_STYLE_DARK_1 — PIVOT_TABLE_STYLE_DARK_28. Стили, добавленные в Excel 2017 (вторая волна светлых и тёмных тем), доступны через то же перечисление.

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

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

import aspose.cells as ac

# Сценарий 2: Применение современного именованного предустановленного стиля Excel 2007+ с помощью PivotTableStyleType.
# Целевой формат файла: .xlsx. Перечисление PivotTableStyleType находится в пространстве имён Aspose.Cells
# (не в Aspose.Cells.Pivot) — поэтому нам не нужны никакие дополнительные using для него.
# Ссылка на GitHub: https://github.com/aspose-cells/Aspose.Cells-for-.NET/blob/master/Examples/CSharp/PivotTables/ApplyStyleToPivotTable2.cs

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

# Строка заголовков: Fruit / Year / Amount
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

# 9 строк данных Fruit / Year / Amount
worksheet.cells["A2"].put_value("Grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(100)

worksheet.cells["A3"].put_value("Blueberry")
worksheet.cells["B3"].put_value(2020)
worksheet.cells["C3"].put_value(150)

worksheet.cells["A4"].put_value("Kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(200)

worksheet.cells["A5"].put_value("Cherry")
worksheet.cells["B5"].put_value(2020)
worksheet.cells["C5"].put_value(180)

worksheet.cells["A6"].put_value("Grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(120)

worksheet.cells["A7"].put_value("Blueberry")
worksheet.cells["B7"].put_value(2021)
worksheet.cells["C7"].put_value(170)

worksheet.cells["A8"].put_value("Kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(210)

worksheet.cells["A9"].put_value("Cherry")
worksheet.cells["B9"].put_value(2021)
worksheet.cells["C9"].put_value(190)

worksheet.cells["A10"].put_value("Grape")
worksheet.cells["B10"].put_value(2021)
worksheet.cells["C10"].put_value(130)

# Добавление сводной таблицы в E3 с именем "Pivot1", источник данных — A1:C10
pivot_index = worksheet.pivot_tables.add("A1:C10", "E3", "Pivot1")
pivot_table = worksheet.pivot_tables[pivot_index]

# Назначение полей сводной таблицы: Fruit -> область строк, Year -> область столбцов, Amount -> область данных
pivot_table.add_field_to_area(ac.PivotFieldType.Row, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.Column, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.Data, "Amount")

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

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

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

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

Добавьте пользовательский стиль в коллекцию table_styles рабочей книги через workbook.worksheets.table_styles.add_pivot_table_style(name). Это вернёт индекс вновь созданного стиля.
Настройте стиль, добавляя элементы (такие как WHOLE_TABLE или GRAND_TOTAL_ROW) через table_style.table_style_elements.add(TableStyleElementType), затем назначьте Style каждому элементу через table_style_element.set_element_style(Style).
Примените пользовательский стиль к сводной таблице, установив PivotTable.pivot_table_style_name равным имени стиля. Не используйте здесь pivot_table_style_type, поскольку это свойство выбирает встроенные предустановки.

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

Доступные значения TableStyleElementType включают WHOLE_TABLE, FIRST_ROW, LAST_ROW, FIRST_COLUMN, LAST_COLUMN, GRAND_TOTAL_ROW, GRAND_TOTAL_COLUMN, PAGE_FIELD_LABELS и PAGE_FIELD_VALUES.

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

import aspose.cells as ac
import System.Drawing

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

# Заполняем исходные данные: строка заголовка + 9 строк данных (A1:C10)
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

worksheet.cells["A2"].put_value("Grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(100)

worksheet.cells["A3"].put_value("Blueberry")
worksheet.cells["B3"].put_value(2020)
worksheet.cells["C3"].put_value(200)

worksheet.cells["A4"].put_value("Kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(300)

worksheet.cells["A5"].put_value("Cherry")
worksheet.cells["B5"].put_value(2020)
worksheet.cells["C5"].put_value(400)

worksheet.cells["A6"].put_value("Grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(500)

worksheet.cells["A7"].put_value("Blueberry")
worksheet.cells["B7"].put_value(2021)
worksheet.cells["C7"].put_value(600)

worksheet.cells["A8"].put_value("Kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(700)

worksheet.cells["A9"].put_value("Cherry")
worksheet.cells["B9"].put_value(2021)
worksheet.cells["C9"].put_value(800)

worksheet.cells["A10"].put_value("Grape")
worksheet.cells["B10"].put_value(2021)
worksheet.cells["C10"].put_value(900)

# Добавляем сводную таблицу с источником A1:C10, привязанную к E3, с именем "Pivot1"
pivot_index = worksheet.pivot_tables.add("A1:C10", "E3", "Pivot1")
pivot_table = worksheet.pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# Шаг 1: регистрируем новый пользовательский стиль сводной таблицы и сохраняем его индекс
style_index = workbook.worksheets.table_styles.add_pivot_table_style("CustomPivotStyle")
table_style = workbook.worksheets.table_styles[style_index]

# Шаг 2: добавляем элемент WholeTable и применяем тонкие чёрные границы со всех четырёх сторон
whole_table_element_index = table_style.table_style_elements.add(ac.TableStyleElementType.WHOLE_TABLE)
whole_table_element = table_style.table_style_elements[whole_table_element_index]
whole_table_style = workbook.create_style()
whole_table_style.borders[ac.BorderType.TOP_BORDER].line_style = ac.CellBorderType.THIN
whole_table_style.borders[ac.BorderType.TOP_BORDER].color = System.Drawing.Color.Black
whole_table_style.borders[ac.BorderType.BOTTOM_BORDER].line_style = ac.CellBorderType.THIN
whole_table_style.borders[ac.BorderType.BOTTOM_BORDER].color = System.Drawing.Color.Black
whole_table_style.borders[ac.BorderType.LEFT_BORDER].line_style = ac.CellBorderType.THIN
whole_table_style.borders[ac.BorderType.LEFT_BORDER].color = System.Drawing.Color.Black
whole_table_style.borders[ac.BorderType.RIGHT_BORDER].line_style = ac.CellBorderType.THIN
whole_table_style.borders[ac.BorderType.RIGHT_BORDER].color = System.Drawing.Color.Black
whole_table_element.set_element_style(whole_table_style)

# Шаг 3: добавляем элемент GrandTotalRow и применяем жирный красный шрифт
grand_total_element_index = table_style.table_style_elements.add(ac.TableStyleElementType.GRAND_TOTAL_ROW)
grand_total_element = table_style.table_style_elements[grand_total_element_index]
grand_total_style = workbook.create_style()
grand_total_style.font.is_bold = True
grand_total_style.font.color = System.Drawing.Color.Red
grand_total_element.set_element_style(grand_total_style)

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

workbook.save("output.xlsx")

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

PivotTable.format_all(Style) представляет собой удобный метод, который применяет единственный объект Style к каждой ячейке сводной таблицы, включая область данных, заголовки строк и столбцов, а также итоги. Всё, что ранее было установлено через pivot_table_style_type или pivot_table_style_name, переопределяется.

format_all переопределяет и pivot_table_style_type, и pivot_table_style_name. Используйте его только тогда, когда требуется единообразный, не зависящий от темы внешний вид для всей сводной таблицы.

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

from System.Drawing import Color
import aspose.cells as ac
from aspose.cells.pivot import PivotFieldType
from aspose.cells import BackgroundType, CellBorderType, BorderType

# Сценарий 4: Применение единого стиля ко всем ячейкам сводной таблицы с помощью FormatAll
# Используемый API: PivotTable.FormatAll(Style)
# Целевой формат: .xlsx
# Ссылка на GitHub: см. репозиторий Aspose.Cells-for-.NET — примеры стилизации сводных таблиц

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]

# Заполнение исходных данных: строка заголовков (строка 1) + 9 строк данных (строки 2-10)
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

worksheet.cells["A2"].put_value("Grape")
worksheet.cells["B2"].put_value(2020)
worksheet.cells["C2"].put_value(5000)

worksheet.cells["A3"].put_value("Blueberry")
worksheet.cells["B3"].put_value(2020)
worksheet.cells["C3"].put_value(3000)

worksheet.cells["A4"].put_value("Kiwi")
worksheet.cells["B4"].put_value(2020)
worksheet.cells["C4"].put_value(4000)

worksheet.cells["A5"].put_value("Cherry")
worksheet.cells["B5"].put_value(2020)
worksheet.cells["C5"].put_value(2000)

worksheet.cells["A6"].put_value("Grape")
worksheet.cells["B6"].put_value(2021)
worksheet.cells["C6"].put_value(6000)

worksheet.cells["A7"].put_value("Blueberry")
worksheet.cells["B7"].put_value(2021)
worksheet.cells["C7"].put_value(3500)

worksheet.cells["A8"].put_value("Kiwi")
worksheet.cells["B8"].put_value(2021)
worksheet.cells["C8"].put_value(4500)

worksheet.cells["A9"].put_value("Cherry")
worksheet.cells["B9"].put_value(2021)
worksheet.cells["C9"].put_value(2500)

worksheet.cells["A10"].put_value("Grape")
worksheet.cells["B10"].put_value(2021)
worksheet.cells["C10"].put_value(5500)

# Добавление сводной таблицы: исходный диапазон A1:C10, целевая ячейка E3, имя "Pivot1"
pivot_index = worksheet.pivot_tables.add("A1:C10", "E3", "Pivot1")
pivot_table = worksheet.pivot_tables[pivot_index]

# Назначение полей сводной таблицы: Fruit -> область строк, Year -> область столбцов, Amount -> область данных
pivot_table.add_field_to_area(PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(PivotFieldType.DATA, "Amount")

# Создание стиля, который будет принудительно применён к каждой ячейке сводной таблицы
style = workbook.create_style()
style.foreground_color = Color.Yellow
style.pattern = BackgroundType.SOLID
style.font.is_bold = True
style.font.color = Color.DarkBlue
style.borders[BorderType.TOP_BORDER].line_style = CellBorderType.THIN
style.borders[BorderType.TOP_BORDER].color = Color.Black
style.borders[BorderType.BOTTOM_BORDER].line_style = CellBorderType.THIN
style.borders[BorderType.BOTTOM_BORDER].color = Color.Black
style.borders[BorderType.LEFT_BORDER].line_style = CellBorderType.THIN
style.borders[BorderType.LEFT_BORDER].color = Color.Black
style.borders[BorderType.RIGHT_BORDER].line_style = CellBorderType.THIN
style.borders[BorderType.RIGHT_BORDER].color = Color.Black

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

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

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

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

Целевой формат файла	Используемый API	Примечания
`.xls` (устаревший)	`PivotTable.auto_format_type`	Значения из `aspose.cells.pivot.PivotTableAutoFormatType` (например, `REPORT_1`–`REPORT_10`, `CLASSIC`, `TABLE_1`–`TABLE_10`). Игнорируется при сохранении в современных форматах.
`.xlsx` / `.xlsm` / `.xlsb` (современный, встроенный стиль)	`PivotTable.pivot_table_style_type`	Значения из `aspose.cells.PivotTableStyleType` (светлые/тёмные темы, включая дополнения Excel 2017).
`.xlsx` / `.xlsm` / `.xlsb` (современный, пользовательский стиль)	`PivotTable.pivot_table_style_name` + `worksheets.table_styles.add_pivot_table_style(...)`	Используйте, когда встроенных предустановок недостаточно. Настройка через `table_style_element.set_element_style(...)`.
Любой формат (единообразное переопределение)	`PivotTable.format_all(Style)`	Удобный метод, который переопределяет все остальные настройки стилей для всей сводной таблицы.

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

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

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

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

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

ROW — поля, размещаемые вертикально слева
COLUMN — поля, размещаемые горизонтально сверху
DATA — поля, значения которых агрегируются
PAGE — поля, используемые в качестве фильтров отчёта

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

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

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

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

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

AUTOMATIC — Aspose.Cells выбирает вариант по умолчанию (как правило, SUM для числовых полей)
NONE — подавить все строки промежуточных итогов
SUM
COUNT
AVERAGE
MAX
MIN
PRODUCT
STDDEV
STDDEVP
VAR
VARP

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

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

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

import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

worksheet.cells[0, 0].put_value("Category")
worksheet.cells[0, 1].put_value("Item")
worksheet.cells[0, 2].put_value("Year")
worksheet.cells[0, 3].put_value("Amount")

worksheet.cells[1, 0].put_value("Fruit")
worksheet.cells[1, 1].put_value("Apple")
worksheet.cells[1, 2].put_value(2020)
worksheet.cells[1, 3].put_value(100)

worksheet.cells[2, 0].put_value("Fruit")
worksheet.cells[2, 1].put_value("Apple")
worksheet.cells[2, 2].put_value(2021)
worksheet.cells[2, 3].put_value(150)

worksheet.cells[3, 0].put_value("Fruit")
worksheet.cells[3, 1].put_value("Banana")
worksheet.cells[3, 2].put_value(2020)
worksheet.cells[3, 3].put_value(80)

worksheet.cells[4, 0].put_value("Fruit")
worksheet.cells[4, 1].put_value("Banana")
worksheet.cells[4, 2].put_value(2021)
worksheet.cells[4, 3].put_value(90)

worksheet.cells[5, 0].put_value("Vegetable")
worksheet.cells[5, 1].put_value("Carrot")
worksheet.cells[5, 2].put_value(2020)
worksheet.cells[5, 3].put_value(50)

worksheet.cells[6, 0].put_value("Vegetable")
worksheet.cells[6, 1].put_value("Carrot")
worksheet.cells[6, 2].put_value(2021)
worksheet.cells[6, 3].put_value(60)

worksheet.cells[7, 0].put_value("Vegetable")
worksheet.cells[7, 1].put_value("Daikon")
worksheet.cells[7, 2].put_value(2020)
worksheet.cells[7, 3].put_value(40)

worksheet.cells[8, 0].put_value("Vegetable")
worksheet.cells[8, 1].put_value("Daikon")
worksheet.cells[8, 2].put_value(2021)
worksheet.cells[8, 3].put_value(45)

pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1")
pivot_table = worksheet.pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

category_field = pivot_table.row_fields[0]
category_field.set_subtotals(ac.PivotFieldSubtotalType.AUTOMATIC, True)

pivot_table.calculate_data()

workbook.save("output_automatic.xlsx")

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

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

import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

headers = ["Category", "Item", "Year", "Amount"]
for j in range(len(headers)):
    worksheet.cells[0, j].put_value(headers[j])

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 i in range(len(data)):
    for j in range(len(data[i])):
        worksheet.cells[i + 1, j].put_value(data[i][j])

pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1")
pivot_table = worksheet.pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

category_field = pivot_table.row_fields[0]
for st in [ac.PivotFieldSubtotalType.SUM, ac.PivotFieldSubtotalType.COUNT, ac.PivotFieldSubtotalType.AVERAGE, ac.PivotFieldSubtotalType.MAX, ac.PivotFieldSubtotalType.MIN, ac.PivotFieldSubtotalType.PRODUCT]:
    category_field.set_subtotals(st, True)
pivot_table.calculate_data()

workbook.save("output_none.xlsx")

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

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

import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

worksheet.cells["A1"].put_value("Category")
worksheet.cells["B1"].put_value("Item")
worksheet.cells["C1"].put_value("Year")
worksheet.cells["D1"].put_value("Amount")

worksheet.cells[1, 0].put_value("Fruit")
worksheet.cells[1, 1].put_value("Apple")
worksheet.cells[1, 2].put_value(2020)
worksheet.cells[1, 3].put_value(100)

worksheet.cells[2, 0].put_value("Fruit")
worksheet.cells[2, 1].put_value("Apple")
worksheet.cells[2, 2].put_value(2021)
worksheet.cells[2, 3].put_value(150)

worksheet.cells[3, 0].put_value("Fruit")
worksheet.cells[3, 1].put_value("Banana")
worksheet.cells[3, 2].put_value(2020)
worksheet.cells[3, 3].put_value(80)

worksheet.cells[4, 0].put_value("Fruit")
worksheet.cells[4, 1].put_value("Banana")
worksheet.cells[4, 2].put_value(2021)
worksheet.cells[4, 3].put_value(90)

worksheet.cells[5, 0].put_value("Vegetable")
worksheet.cells[5, 1].put_value("Carrot")
worksheet.cells[5, 2].put_value(2020)
worksheet.cells[5, 3].put_value(50)

worksheet.cells[6, 0].put_value("Vegetable")
worksheet.cells[6, 1].put_value("Carrot")
worksheet.cells[6, 2].put_value(2021)
worksheet.cells[6, 3].put_value(60)

worksheet.cells[7, 0].put_value("Vegetable")
worksheet.cells[7, 1].put_value("Daikon")
worksheet.cells[7, 2].put_value(2020)
worksheet.cells[7, 3].put_value(40)

worksheet.cells[8, 0].put_value("Vegetable")
worksheet.cells[8, 1].put_value("Daikon")
worksheet.cells[8, 2].put_value(2021)
worksheet.cells[8, 3].put_value(45)

pivot_tables = worksheet.pivot_tables
pivot_index = pivot_tables.add("A1:D9", "F3", "PivotTable1")
pivot_table = pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

category_field = pivot_table.row_fields[0]
category_field.set_subtotals(ac.PivotFieldSubtotalType.SUM, True)
category_field.set_subtotals(ac.PivotFieldSubtotalType.AVERAGE, True)

pivot_table.calculate_data()

workbook.save("output_custom.xlsx")

Резюме

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

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

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

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

Добавление базового поля в область данных (значений) — это первый шаг в формировании того, как сводная таблица агрегирует исходные данные. Aspose.Cells предоставляет метод PivotTable.add_field_to_area(PivotFieldType, str), перегрузку, которая принимает константу PivotFieldType.DATA и имя исходного столбца. Как только поле добавлено в область данных, API предоставляет к нему доступ через коллекцию PivotTable.data_fields в порядке добавления полей. По умолчанию числовой исходный столбец агрегируется с помощью ConsolidationFunction.SUM, а для нечислового столбца по умолчанию используется Count.

from aspose.cells.pivot import PivotFieldType

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

# Заголовки в A1:D1
worksheet.cells[0, 0].put_value("Category")
worksheet.cells[0, 1].put_value("Item")
worksheet.cells[0, 2].put_value("Year")
worksheet.cells[0, 3].put_value("Amount")

# Строки данных A2:D9 с использованием вложенных циклов с ветвлением по j
for i in range(1, 9):
    for j in range(4):
        if j == 0:
            worksheet.cells[i, j].put_value("Fruit" if i <= 4 else "Vegetable")
        elif j == 1:
            if i == 1 or i == 2:
                worksheet.cells[i, j].put_value("Apple")
            elif i == 3 or i == 4:
                worksheet.cells[i, j].put_value("Banana")
            elif i == 5 or i == 6:
                worksheet.cells[i, j].put_value("Carrot")
            else:
                worksheet.cells[i, j].put_value("Daikon")
        elif j == 2:
            worksheet.cells[i, j].put_value(2020 + ((i - 1) % 2))
        elif j == 3:
            if i == 1:
                worksheet.cells[i, j].put_value(100)
            elif i == 2:
                worksheet.cells[i, j].put_value(150)
            elif i == 3:
                worksheet.cells[i, j].put_value(80)
            elif i == 4:
                worksheet.cells[i, j].put_value(90)
            elif i == 5:
                worksheet.cells[i, j].put_value(50)
            elif i == 6:
                worksheet.cells[i, j].put_value(60)
            elif i == 7:
                worksheet.cells[i, j].put_value(40)
            else:
                worksheet.cells[i, j].put_value(45)

# Добавить сводную таблицу в F3 с именем PivotTable1
pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1", True, False)
pivot_table = worksheet.pivot_tables[pivot_index]

# Расположение сводной таблицы: Category и Item в строках, Year в столбцах, Amount как поле данных
pivot_table.add_field_to_area(PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(PivotFieldType.DATA, "Amount")

pivot_table.calculate_data()
workbook.save("output_drag.xlsx")

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

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

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

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

import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

headers = ["Category", "Item", "Year", "Amount"]
for j in range(len(headers)):
    worksheet.cells[0, j].put_value(headers[j])

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 i in range(len(data)):
    for j in range(len(data[i])):
        worksheet.cells[i + 1, j].put_value(data[i][j])

pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1", True, False)
pivot_table = worksheet.pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")

pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

count_field = pivot_table.data_fields[1]
count_field.function = ac.ConsolidationFunction.COUNT

pivot_table.calculate_data()

workbook.save("output_function.xlsx")

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

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

PivotTable.values_field не работает, если полей значений нет или имеется только одно.

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

import aspose.cells as ac

workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

headers = ["Category", "Item", "Year", "Amount"]
for j in range(len(headers)):
    worksheet.cells[0, j].put_value(headers[j])

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 i in range(len(data)):
    for j in range(len(data[i])):
        worksheet.cells[i + 1, j].put_value(data[i][j])

pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1", True, False)
pivot_table = worksheet.pivot_tables[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")
pivot_table.data_fields[1].function = ac.ConsolidationFunction.COUNT

# Построить поля значений по оси столбцов.
pivot_table.add_field_to_area(ac.PivotFieldType.COLUMN, pivot_table.values_field)

pivot_table.calculate_data()

workbook.save("output_plot.xlsx")

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

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

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

Введение

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

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

Aspose.Cells for Python via .NET предоставляет два эквивалентных способа регистрации поля фильтраы. Высокоуровневый API — это PivotTable.add_field_to_area(PivotFieldType.PAGE, "field_name"), который принимает имя исходного столбца и добавляет поле одним вызовом. Низкоуровневый API — это PivotTable.page_fields.add(PivotField), который используется, когда у вас уже есть ссылка на PivotField и вы хотите добавить тот же экземпляр поля в область фильтраы. Оба API в итоге заполняют одну и ту же коллекцию page_fields, и далее в этой статье показано, как выбирать между ними и как управлять каждым режимом фильтрации.

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

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

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

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

import aspose.cells as ac

# Создать новую книгу
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"

# Настроить строку заголовка
worksheet.cells["A1"].put_value("Fruit")
worksheet.cells["B1"].put_value("Year")
worksheet.cells["C1"].put_value("Amount")

# Заполнить 9 строк образцов данных: Fruit, Year, Amount
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 i in range(len(data)):
    worksheet.cells[i + 1, 0].put_value(data[i][0])
    worksheet.cells[i + 1, 1].put_value(data[i][1])
    worksheet.cells[i + 1, 2].put_value(data[i][2])

# Добавить сводную таблицу, привязанную к ячейке E3
pivot_index = worksheet.pivot_tables.add("A1:C10", "E3", "PivotTable1")
pivot_table = worksheet.pivot_tables[pivot_index]

# Добавить поля в их области: Fruit как строка, Amount как данные, Year как поле страницы
pivot_table.add_field_to_area(ac.PivotFieldType.Row, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.Data, "Amount")
pivot_table.add_field_to_area(ac.PivotFieldType.Page, "Year")

# Обновить и вычислить данные сводной таблицы
pivot_table.calculate_data()

# Сохранить книгу
workbook.save("pageFieldSample.xlsx")

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

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

import aspose.cells as ac

# — Сводная таблица и поле страницы создаются точно так же, как в
#   Сценарии 1a (данные Фрукт/Год/Сумма, сводная в E3, Фрукт→Строка,
#   Сумма→Данные). Ниже мы получаем PivotField Год из коллекции
#   BaseFields и передаём его в PageFields.Add — низкоуровневую
#   альтернативу AddFieldToArea. Результат функционально
#   идентичен Сценарию 1a.

workbook = ac.Workbook()
sheet = workbook.worksheets[0]

# Заголовки
sheet.cells["A1"].put_value("Fruit")
sheet.cells["B1"].put_value("Year")
sheet.cells["C1"].put_value("Amount")

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

# Добавить сводную таблицу в E3, охватывающую A1:C10
pivot_index = sheet.pivot_tables.add("E3", "A1:C10", "PivotTable1")
pivot_table = sheet.pivot_tables[pivot_index]

# Фрукт -> Строка, Сумма -> Данные (Год будет добавлен на Страницу ниже)
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")

# Низкоуровневый подход: получить существующий PivotField Год из BaseFields
# и зарегистрировать его в области Страница через PageFields.Add(PivotField).
year_field = pivot_table.base_fields["Year"]
pivot_table.page_fields.add(year_field)

# Обновить, чтобы новое поле страницы отразилось в сохранённой книге
pivot_table.calculate_data()

workbook.save("output.xlsx")

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

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

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

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

import aspose.cells as ac

# Создать новую рабочую книгу
workbook = ac.Workbook()
sheet = workbook.worksheets[0]

# Заполнить данные Fruit/Year/Amount
sheet.cells["A1"].put_value("Fruit")
sheet.cells["B1"].put_value("Year")
sheet.cells["C1"].put_value("Amount")

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

for r in range(len(data)):
    for c in range(len(data[r])):
        sheet.cells[r + 1, c].put_value(data[r][c])

# Создать сводную таблицу в E3
pivot_tables = sheet.pivot_tables
index = pivot_tables.add("=A1:C7", "E3", "PivotTable1")
pivot_table = pivot_tables[index]

# Настроить поля сводной таблицы: Fruit→Строка, Amount→Данные, Year→Страница
pivot_table.add_field_to_area(ac.PivotFieldType.Row, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.Data, "Amount")
pivot_table.add_field_to_area(ac.PivotFieldType.Page, "Year")

pivot_table.calculate_data()

# Очистить фильтр страницы, чтобы каждый элемент в поле страницы был виден.
# 0x7FFD (десятичное 32765) — это специальное значение-маркер, означающее «все элементы» —
# эквивалентно выбору «(Все)» в раскрывающемся списке поля страницы Excel.
pivot_table.page_fields[0].current_page_item = 0x7FFD

workbook.save("output.xlsx")

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

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

import aspose.cells as ac

# Создать рабочую книгу
workbook = ac.Workbook()
sheet = workbook.worksheets[0]
cells = sheet.cells

# Добавить образец данных (Фрукт/Год/Сумма)
cells["A1"].put_value("Fruit")
cells["B1"].put_value("Year")
cells["C1"].put_value("Amount")

cells["A2"].put_value("Apple")
cells["B2"].put_value("2020")
cells["C2"].put_value("100")

cells["A3"].put_value("Apple")
cells["B3"].put_value("2021")
cells["C3"].put_value("150")

cells["A4"].put_value("Banana")
cells["B4"].put_value("2020")
cells["C4"].put_value("200")

cells["A5"].put_value("Banana")
cells["B5"].put_value("2021")
cells["C5"].put_value("250")

# Добавить сводную таблицу в E3
pivot_tables = sheet.pivot_tables
pivot_index = pivot_tables.add("A1:C5", "E3", "PivotTable1")
pivot_table = pivot_tables[pivot_index]

# Добавить поля: Фрукт→Строка, Сумма→Данные, Год→Страница
pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")
pivot_table.add_field_to_area(ac.PivotFieldType.PAGE, "Year")

# Операции, специфичные для поля страницы
pivot_table.page_fields[0].current_page_item = 1  # 1 = второй элемент в порядке сортировки (например, "2021")

# Обновить и вычислить сводную таблицу
pivot_table.calculate_data()

workbook.save("output.xlsx")

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

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

Приведённый ниже код включает множественный выбор для того же поля фильтраы Year, созданного в Сценарии 1a, а затем демонстрирует два шаблона: Часть A показывает каждый элемент страницы, оставляя is_hidden установленным в False для каждой записи, тогда как Часть B включает в белый список только выбранные вами исходные значения и скрывает всё остальное через блок if / elif, который проверяет pivot_items[i].get_string_value().

import aspose.cells as ac

# — Сводная таблица и поле страницы построены точно так же, как в
#   Сценарии 1a (данные Fruit/Year/Amount, сводная в E3, Fruit→Строка,
#   Amount→Данные, Year→Страница через AddFieldToArea).
#   Ниже мы применяем множественный выбор для фильтрации поля страницы.

workbook = ac.Workbook()
sheet = workbook.worksheets[0]
cells = sheet.cells

# Пример данных: Fruit | Year | Amount
cells[0, 0].put_value("Fruit")
cells[0, 1].put_value("Year")
cells[0, 2].put_value("Amount")

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 i in range(len(data)):
    cells[i + 1, 0].put_value(data[i][0])
    cells[i + 1, 1].put_value(int(data[i][1]))
    cells[i + 1, 2].put_value(int(data[i][2]))

pivot_sheet = workbook.worksheets.add("Pivot")
pivots = pivot_sheet.pivot_tables
pivot_index = pivots.add("E3", "A1:C10", "PivotTable1")
pivot_table = pivots[pivot_index]

pivot_table.add_field_to_area(ac.PivotFieldType.ROW, "Fruit")
pivot_table.add_field_to_area(ac.PivotFieldType.DATA, "Amount")
pivot_table.add_field_to_area(ac.PivotFieldType.PAGE, "Year")

# — Включить множественный выбор для поля страницы
pivot_table.page_fields[0].is_multiple_item_selection_allowed = True

# Часть A — выбрать ВСЕ элементы (сделать каждый элемент видимым)
pivot_items = pivot_table.page_fields[0].pivot_items
for i in range(pivot_items.count):
    pivot_items[i].is_hidden = False

# Часть B — выбрать только определённые элементы по исходному значению
for i in range(pivot_items.count):
    value = pivot_items[i].get_string_value()
    if value == "2020" or value == "grape" or value == "blueberry":
        pivot_items[i].is_hidden = False
    else:
        pivot_items[i].is_hidden = True

pivot_table.calculate_data()

workbook.save("output.xlsx")

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

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

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

Сценарий / Вариант использования	Рекомендуемый API	Используемое свойство	Примечания
Добавление поля фильтраы по имени исходного столбца (наиболее распространённый случай)	`PivotTable.add_field_to_area(PivotFieldType.PAGE, "field_name")`	n/a	Высокоуровневый, однострочный. Используйте его, если вам не нужна ссылка на `PivotField`.
Добавление поля фильтраы, когда у вас уже есть объект `PivotField`	`PivotTable.page_fields.add(PivotField)`	n/a	Используйте, когда объект поля был получен в другом месте или должен быть повторно использован.
Фильтрация до одного элемента страницы (режим по умолчанию)	`PivotField.current_page_item`	установить в конкретный индекс	Например, `1` показывает второй элемент в отсортированном списке.
Отображение всех элементов / очистка фильтра страницы	`PivotField.current_page_item`	установить в `0x7FFD`	Магическое значение `0x7FFD` (десятичное 32765) является меткой-заполнителем для «всех элементов».
Включение интерфейса множественного выбора в Excel	`PivotField.is_multiple_item_selection_allowed`	установить в `True`	Требуется до того, как любые вызовы `is_hidden` вступят в силу.
Скрытие / отображение отдельных элементов в списке множественного выбора	`PivotItem.is_hidden`	установить для каждого элемента	Хотя бы один элемент должен оставаться видимым (`is_hidden == False`).

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

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

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

Aspose.Cells для Python via .NET предоставляет возможность удалить или удалить сводную таблицу из электронной таблицы. Вы можете удалить сводную таблицу, используя объект сводной таблицы или позицию сводной таблицы. Пожалуйста, используйте метод Worksheet.pivot_tables.remove(pivot_table) для удаления сводной таблицы с использованием объекта сводной таблицы и метод Worksheet.pivot_tables.remove_at(index, keep_data) для удаления объекта сводной таблицы по его позиции в коллекции сводных таблиц.

Как удалить сводную таблицу из электронной таблицы с использованием библиотеки Aspose.Cells для Excel Python

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

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

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

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

Aspose.Cells для Python via .NET предоставляет возможность сохранять сводную таблицу в файлах ODS. Для этого просто конвертируйте книгу с существующей сводной таблицей или создайте новую сводную таблицу и сохраните файл в формате ODS. Обязательно вызовите PivotTable.calculate_data перед сохранением, чтобы убедиться, что сводная таблица отображается в выходном файле ODS. Приведенный ниже фрагмент кода демонстрирует сохранение сводной таблицы в файле ODS.

Образец кода

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Добавление сводных таблиц и диаграмм с использованием Aspose.Cells для Python Excel Library.

Подготовка к использованию Aspose.Cells для Python via .NET

Как добавить сводную таблицу, используя Aspose.Cells для Python Excel Library

Как добавить сводную диаграмму с использованием Aspose.Cells для Python Excel Library

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

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

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

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

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

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

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

Образец кода

Pythonnet: Обновление сводных таблиц в Aspose.Cells for Python via .NET

Введение

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

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

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

Обновить одну сводную таблицу

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

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

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

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

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

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

Введение

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

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

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

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

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

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

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

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

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

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

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

Резюме

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

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

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

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

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

Введение

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

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

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

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

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

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

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

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

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

Как удалить сводную таблицу из электронной таблицы с использованием библиотеки Aspose.Cells для Excel Python

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

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

Образец кода

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

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

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