Documentation – 数据透视表

Pythonjava: 创建数据透视表

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

创建数据透视表

Aspose.Cells for Python via Java提供了创建数据透视表的功能。要使用Aspose.Cells创建数据透视表，请按照以下步骤操作：

使用Cell对象的setValue属性向工作表单元格添加一些数据。这些数据将用作数据透视表的数据源。
通过调用PivotTableCollection add方法在工作表中添加一个数据透视表。
通过传递PivotTable索引从PivotTableCollection中访问PivotTable对象。
使用PivotTableCollection对象中封装的任何数据透视表对象（如上所述）来管理数据透视表。

以下代码片段演示如何使用Aspose.Cells API创建数据透视表。

Pythonjava: 格式化数据透视表单元格

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

有时，您想要格式化数据透视表单元。例如，您希望将背景颜色应用于数据透视表单元。Aspose.Cells提供了两个方法PivotTable.formatAll()和PivotTable.format()，您可以用于此目的。

PivotTable.formatAll()将样式应用于整个数据透视表，而PivotTable.format()将样式应用于数据透视表的单个单元格。

以下示例代码将整个数据透视表格式化为浅蓝色，然后将第二行表格式化为黄色。

执行代码前的输入数据透视表

执行代码后的输出数据透视表

Pythonjava: 在 Aspose.Cells for Python via Java 中刷新数据透视表和数据透视缓存

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

Aspose.Cells 提供了一个分层刷新 API，使您可以在四个不同的范围内重新加载透视数据——从整个工作簿到单个数据透视表。从 Aspose.Cells for Python via Java v26.7 开始，旧方法 PivotTable.refreshData() 已被标记为过时，应替换为本文中介绍的更高效、支持缓存的 API。

简介

刷新数据透视表很少是单一操作。在后台，Aspose.Cells 维护着一个分层的数据链，将您的原始数据源连接到工作表中呈现的数值。理解这条数据链是为任何场景选择正确刷新 API 的关键。四层数据链如下：

数据源 — 原始的工作表区域、数据库查询或合并区域，原始值存放在此。
PivotCache — 数据源在内存中的快照。每个数据透视表都构建在一个 PivotCache 之上；所有数据都在这里进行收集和聚合。
PivotTable — 定义行、列、值和筛选字段的视图对象。PivotTable 仅从其 PivotCache 读取数据，从不直接从数据源读取。
Cells — 工作表的 Cells，PivotTable 将其计算后的值和样式渲染到这些单元格中。

PivotCache.getSourceType()（枚举 PivotTableSourceType）指示缓存数据的来源。截至 v26.7，PivotCache.refresh() 仅支持 SHEET 和 CONSOLIDATION 源类型——即存放在工作表区域中的数据。外部数据源（数据库、外部连接等）目前尚无法通过缓存 API 进行刷新。

由于这种数据链，Aspose.Cells 中存在两条基本的刷新路径：

PivotTable.calculateData() — 使用已缓存的数据重新计算单个 PivotTable 的显示，无需往返数据源。本文中的所有场景均使用工作表单元格作为源数据，因此源类型为 SHEET，刷新操作的行为如所述。

快速开始

如果您只需要用尽可能短的代码来刷新工作簿中的每个数据透视表，那么一次调用就足够了：

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType
# 创建一个新的工作簿
workbook = Workbook()
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 单元格（2020 和 2021 年 8 行水果数据）
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"
pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
# 分配数据透视字段：Fruit 到行，Year 到列，Amount 到数据
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Column, "Year")
pivotTable.addFieldToArea(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")
jpype.shutdownJVM()

本文其他部分将解释何时应选择范围更窄的 API。

所需导入

本文中的所有 Python 示例都依赖于以下导入，因为透视类型位于 aspose.cells.pivot 命名空间中：

import jpype
import aspose.cells as cells jpype 模块用于引导 JVM，而 aspose.cells 提供了贯穿全文使用的工作簿/工作表/单元格/透视类型。

刷新工作簿中的所有数据透视表

当您需要确保工作簿中的每个数据透视缓存和每个数据透视表都反映最新的源数据时，最简单且最全面的 API 是 Workbook.refreshAll()。单次调用即可遍历整个工作簿——刷新每个 PivotCache 的数据源，然后重新计算每个依赖的 PivotTable。对于一般性的、不在意性能的全文档刷新，推荐使用此方法。下面的示例构建了一个包含 Fruit/Year/Amount 源区域的工作簿，创建一个数据透视表，修改一些源值，然后使用 refreshAll() 通过一次调用使所有内容保持最新。

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType
workbook = Workbook()
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)
pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
pivotTable.addFieldToArea(PivotFieldType.ROW, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.COLUMN, "Year")
pivotTable.addFieldToArea(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")
jpype.shutdownJVM()

刷新单个工作表上的所有数据透视表

有时您只需要刷新位于特定工作表上的数据透视表——例如，当已知其他工作表上的数据透视表与此无关且不应被触碰时。对于这种情况，Aspose.Cells 提供了 Worksheet.refreshPivotTables()，其范围限定于单个 Worksheet 实例。

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType
workbook = Workbook()
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")
# 写入 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
pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
# 分配字段：Fruit 到行，Year 到列，Amount 到数据
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Column, "Year")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
# 修改视图/布局属性——这只是一个表现层的更改，
# 因此不需要通过 PivotCache.Refresh() 重新读取源数据。
pivotTable.setRefreshDataOnOpeningFile(False)
# CalculateData() 会从 PivotCache 中已保存的数据
# 重新渲染此数据透视表的显示（数据 + 样式）。由于源数据未发生变化，
# 不会回溯到源数据——只将缓存中的值重新计算
# 输出到工作表单元格中。
pivotTable.calculateData()
# 将工作簿保存到磁盘
workbook.save("output.xlsx")
jpype.shutdownJVM()

刷新单个数据透视表

当您希望对单个数据透视表进行细粒度控制时，基于缓存的 API 为您提供了两种选择。选择哪一种取决于实际更改的内容：底层源数据，还是仅数据透视表本身的视图/布局设置。

源数据已更改 — 使用 `PivotCache.refresh()`

如果底层源数据已更改，则正确的入口点是 pivotTable.getPivotCache().refresh()。此调用会将源数据重新读取到缓存中，然后重新计算依赖于该缓存的每个 PivotTable。

仅视图/布局已更改 — 使用 `calculateData()`

如果源数据未更改，但仅修改了数据透视表的视图或布局设置（例如，将某个字段移动到不同的区域，或切换了打开时刷新设置），则无需往返数据源。缓存中已包含正确的数据；只需重新计算呈现的 PivotTable。在这种情况下，pivotTable.calculateData() 是正确的选择。下面的示例修改了数据透视表的非源属性，然后调用 calculateData() 从现有缓存中重新渲染它。一个工作簿通常包含许多共享同一缓存的数据透视表。要枚举它们——例如在执行批量刷新之前，或诊断共享缓存的影响——请使用 PivotCache.getPivotTables()。此方法返回依赖于给定缓存的每个 PivotTable 的集合。

从已过时的 `PivotTable.refreshData()` 迁移

在 Aspose.Cells for Python via Java v26.7 之前，刷新数据透视表的标准方法是对每个数据透视表分别调用 PivotTable.refreshData()。从 v26.7 开始，该方法被标记为过时，应替换为上文介绍的、支持缓存的 API。在真实工作簿中，逐表调用 refreshData() 的方法存在两个问题：

每次调用时都会从源重新获取数据，即使源未发生更改。推荐使用的替代方法如下：下面的示例演示了对于多个共享单一缓存的数据透视表的工作簿，使用新的高效模式。

应使用哪种刷新 API？

下表总结了可用的刷新 API 以及选择每种 API 的时机。

目标	推荐的 API	备注
刷新工作簿中的所有内容	`Workbook.refreshAll()`	一次调用；涵盖所有缓存和数据透视表。
仅刷新单个工作表上的数据透视表	`Worksheet.refreshPivotTables()`	范围限定于单个工作表。
一个缓存的源数据已更改	`pivotTable.getPivotCache().refresh()`	刷新该共享缓存上的所有数据透视表。
仅视图/布局设置已更改	`pivotTable.calculateData()`	跳过不必要的源数据往返。
列出共享缓存上的所有数据透视表	`pivotCache.getPivotTables()`	用于在批量刷新前进行枚举。
在实践中，应优先使用基于缓存的 API，而非已过时的逐表 `refreshData()`。它们能够识别共享缓存，可避免冗余的源数据获取，并允许您选择满足刷新需求的最小范围。

常见陷阱

保存前忘记刷新。 数据透视表仅在其数据链被刷新后才会将其呈现的值写入工作表。如果您修改了源单元格，请在 Workbook.save() 之前调用 PivotCache.Refresh()（或 Workbook.RefreshAll()），否则保存的文件仍将包含旧的聚合值。
对每个表调用已过时的 RefreshData()。 在 v26.7 中，PivotTable.RefreshData() 已被标记为过时，并且每次调用都会重新获取源数据。当多个数据透视表共享一个缓存时，这意味着 N 次冗余的源数据获取。应替换为对每个表进行一次 PivotCache.Refresh()，然后对每个表调用 CalculateData()。
仅布局更改时进行刷新。 如果您仅更改了数据透视表的视图（列顺序、ConsolidationFunction 等）而未触及源数据，则 PivotCache.Refresh() 不必要且速度较慢。调用 pivotTable.CalculateData() 从现有缓存重新渲染。
外部源不受 PivotCache.Refresh() 支持。 如果数据透视表的源来自外部连接（数据库、OLAP 多维数据集等），则在 v26.7 中 PivotCache.Refresh() 无法刷新它——它目前仅支持 Sheet 和 Consolidation 源类型。对于外部源，请重新打开工作簿或从源重建缓存。

using Aspose.Cells;
Workbook workbook = new Workbook("input.xlsx");
workbook.RefreshAll();
workbook.Save("output.xlsx");

Pythonjava: 在 Aspose.Cells for Python via Java 中为数据透视表应用样式

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

Aspose.Cells 支持同时应用传统的数据透视自动格式（用于 .xls 文件）以及现代的命名或自定义数据透视表样式（用于 .xlsx、.xlsm 和 .xlsb 文件）。您应该调用哪个 API 取决于工作簿保存到的文件格式，而不是它加载时的格式。

简介

Aspose.Cells 为数据透视表提供了两个并行的样式 API。它们之间的选择取决于工作簿保存到的文件格式，而不是从中读取的格式。从 .xls 文件加载的工作簿可以重新保存为 .xlsx，在这种情况下，将应用现代样式 API，而不是传统的 API。

pivotTable.setPivotTableStyleType(int) 用于选择内置的命名样式之一（浅色和深色主题，包括 Excel 2017 中新增的样式）。这些预设是只读的。
pivotTable.setPivotTableStyleName(String) 用于选择您通过 workbook.getWorksheets().getTableStyles().addPivotTableStyle(String) 自行定义的自定义样式。当您希望修改预设提供的颜色、边框或字体时，必须使用自定义样式。此外，pivotTable.formatAll(Style) 是一个快捷方式，可将单个 Style 对象应用于数据透视表的每个单元格，覆盖通过上述任一样式名称 API 设置的内容。当需要无论底层主题如何都呈现统一外观时，这非常有用。

应用传统的 XLS 预设自动格式

数据透视表上的 setAutoFormatType 方法接受来自 com.aspose.cells.pivot.PivotTableAutoFormatType 枚举的值。可用值为 REPORT_1 到 REPORT_10、CLASSIC，以及 TABLE_1 到 TABLE_10。以下示例加载一个新工作簿，填充 Fruit/Year/Amount 示例数据，添加一个数据透视表，应用 PivotTableAutoFormatType.REPORT_5，并将结果保存为 .xls。

为什么没有列字段？ Report 系列自动格式（Report1 到 Report10，Table1 到 Table10）是为经典 Excel 中的单维数据透视表（仅包含行字段和值）设计的——它们没有为列字段标头提供内置样式。如果您的数据透视表需要列字段，请改用方案 2 中的现代 PivotTableStyleType 预设，这些预设是为现代 Excel 使用的二维布局而设计的。

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, PivotFieldType, PivotTableAutoFormatType
# Scenario 1: Apply a legacy XLS preset autoformat
# API in use: PivotTable.AutoFormatType
# Target file format: .xls (legacy)
# For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
# Create a new workbook
workbook = Workbook()
# Get the first worksheet
sheet = workbook.getWorksheets().get(0)
# Populate the source data with header row (Fruit, Year, Amount)
# and 9 data rows covering grape, blueberry, kiwi, cherry across 2020 and 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)
# Add a pivot table at destination cell E3, named "Pivot1", using source range A1:C10
pivotIndex = sheet.getPivotTables().add("A1:C10", "E3", "Pivot1")
pivotTable = sheet.getPivotTables().get(pivotIndex)
# Assign fields: Fruit -> Rows, Amount -> Data
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
# Apply the legacy XLS preset autoformat "Report5"
# Note: This property is only meaningful when saving as .xls.
# When saved as .xlsx/.xlsm/.xlsb, Excel ignores AutoFormatType
# and uses whatever PivotTableStyleType / PivotTableStyleName specifies.
pivotTable.setAutoFormatType(PivotTableAutoFormatType.Report5)
# Save the workbook in legacy .xls format
workbook.save("output.xls")
jpype.shutdownJVM()

应用现代命名预设数据透视表样式

定义并应用自定义数据透视表样式

无法修改内置预设。当您需要覆盖颜色、边框或字体时，必须定义自定义数据透视样式。该工作流包含三个步骤：

通过 workbook.getWorksheets().getTableStyles().addPivotTableStyle(String name) 向工作簿的 TableStyles 集合添加自定义样式。这将返回新创建样式的索引。
通过 tableStyle.getTableStyleElements().add(TableStyleElementType) 添加元素（例如 WHOLE_TABLE 或 GRAND_TOTAL_ROW）来配置样式，然后通过 tableStyleElement.setElementStyle(Style) 为每个元素分配 Style。
通过使用样式的名称调用 pivotTable.setPivotTableStyleName(String) 将自定义样式应用于数据透视表。此处不要使用 setPivotTableStyleType，因为该方法选择的是内置预设。

setPivotTableStyleName 和 setPivotTableStyleType 不能互换使用。对于内置预设，请使用 setPivotTableStyleType；对于通过 addPivotTableStyle 定义的自定义样式，请使用 setPivotTableStyleName。同时设置两者是无害的，但只有与预期来源匹配的那个会被渲染。

可用的 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 上使用粗体红色字体，然后通过 setPivotTableStyleName 应用该样式并保存为 .xlsx。

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat
from asposecells.api import PivotFieldType, TableStyleElementType, BorderType, CellBorderType
from java.awt import Color
workbook = Workbook()
worksheet = workbook.getWorksheets().get(0)
# Populate source data: header row + 9 data rows (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)
# Add pivot table sourced from A1:C10, anchored at E3, named "Pivot1"
pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
pivotTable.addFieldToArea(PivotFieldType.ROW, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.COLUMN, "Year")
pivotTable.addFieldToArea(PivotFieldType.DATA, "Amount")
# Step 1: register a new custom pivot table style and capture its index
styleIndex = workbook.getWorksheets().getTableStyles().addPivotTableStyle("CustomPivotStyle")
tableStyle = workbook.getWorksheets().getTableStyles().get(styleIndex)
# Step 2: add a WholeTable element and apply thin black borders on all four sides
wholeTableElementIndex = tableStyle.getTableStyleElements().add(TableStyleElementType.WHOLE_TABLE)
wholeTableElement = tableStyle.getTableStyleElements().get(wholeTableElementIndex)
wholeTableStyle = workbook.createStyle()
wholeTableStyle.getBorders().get(BorderType.TOP_BORDER).setLineStyle(CellBorderType.THIN)
wholeTableStyle.getBorders().get(BorderType.TOP_BORDER).setColor(Color.BLACK)
wholeTableStyle.getBorders().get(BorderType.BOTTOM_BORDER).setLineStyle(CellBorderType.THIN)
wholeTableStyle.getBorders().get(BorderType.BOTTOM_BORDER).setColor(Color.BLACK)
wholeTableStyle.getBorders().get(BorderType.LEFT_BORDER).setLineStyle(CellBorderType.THIN)
wholeTableStyle.getBorders().get(BorderType.LEFT_BORDER).setColor(Color.BLACK)
wholeTableStyle.getBorders().get(BorderType.RIGHT_BORDER).setLineStyle(CellBorderType.THIN)
wholeTableStyle.getBorders().get(BorderType.RIGHT_BORDER).setColor(Color.BLACK)
wholeTableElement.setElementStyle(wholeTableStyle)
# Step 3: add a GrandTotalRow element and apply bold red font
grandTotalElementIndex = tableStyle.getTableStyleElements().add(TableStyleElementType.GRAND_TOTAL_ROW)
grandTotalElement = tableStyle.getTableStyleElements().get(grandTotalElementIndex)
grandTotalStyle = workbook.createStyle()
grandTotalStyle.getFont().setBold(True)
grandTotalStyle.getFont().setColor(Color.RED)
grandTotalElement.setElementStyle(grandTotalStyle)
# Step 4: apply the custom style by name (NOT by PivotTableStyleType, which is for built-in presets)
pivotTable.setPivotTableStyleName("CustomPivotStyle")
workbook.save("output.xlsx")
jpype.shutdownJVM()

使用 FormatAll 将一种样式应用于每个数据透视表单元格

pivotTable.formatAll(Style) 是一个快捷方式，可将单个 Style 对象应用于数据透视表的每个单元格，包括数据区域、行和列标头以及总计。先前通过 setPivotTableStyleType 或 setPivotTableStyleName 设置的内容都将被覆盖。

formatAll 会覆盖 setPivotTableStyleType 和 setPivotTableStyleName。仅在整个数据透视表需要统一的、与主题无关的外观时才使用它。

以下示例创建一个 Style，具有黄色实心填充、粗体深蓝色字体以及四周的细黑色边框，然后使用 formatAll 应用该样式并保存为 .xlsx。

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, Style
from asposecells.api import Color
from asposecells.api import PivotTable, PivotFieldType
from asposecells.api import BorderType, CellBorderType, BackgroundType
# Scenario 4: Apply a single Style to every pivot table cell using FormatAll
# API in use: PivotTable.FormatAll(Style)
# Target format: .xlsx
# GitHub reference: see Aspose.Cells-for-.NET repository — pivot table styling examples
workbook = Workbook()
worksheet = workbook.getWorksheets().get(0)
# Populate source data: header row (row 1) + 9 data rows (rows 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)
# Add pivot table: source range A1:C10, destination cell E3, name "Pivot1"
pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
# Assign pivot fields: Fruit -> Row area, Year -> Column area, Amount -> Data area
pivotTable.addFieldToArea(PivotFieldType.ROW, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.COLUMN, "Year")
pivotTable.addFieldToArea(PivotFieldType.DATA, "Amount")
# Build a Style that will be forced onto every cell of the pivot table
style = workbook.createStyle()
style.setForegroundColor(Color.YELLOW)
style.setPattern(BackgroundType.SOLID)
style.getFont().setIsBold(True)
style.getFont().setColor(Color.DARK_BLUE)
style.getBorders().get(BorderType.TOP_BORDER).setLineStyle(CellBorderType.THIN)
style.getBorders().get(BorderType.TOP_BORDER).setColor(Color.BLACK)
style.getBorders().get(BorderType.BOTTOM_BORDER).setLineStyle(CellBorderType.THIN)
style.getBorders().get(BorderType.BOTTOM_BORDER).setColor(Color.BLACK)
style.getBorders().get(BorderType.LEFT_BORDER).setLineStyle(CellBorderType.THIN)
style.getBorders().get(BorderType.LEFT_BORDER).setColor(Color.BLACK)
style.getBorders().get(BorderType.RIGHT_BORDER).setLineStyle(CellBorderType.THIN)
style.getBorders().get(BorderType.RIGHT_BORDER).setColor(Color.BLACK)
# Apply FormatAll: forces this single style onto every cell of the pivot table,
# overriding any PivotTableStyleType / PivotTableStyleName previously set
pivotTable.formatAll(style)
# Save the workbook in the modern .xlsx format
workbook.save("output.xlsx")
jpype.shutdownJVM()

我应该使用哪个样式 API？

样式 API 的选择取决于您要保存到的文件格式。请使用下表作为快速参考。

目标文件格式	使用的 API	备注
`.xls`（传统）	`pivotTable.setAutoFormatType(int)`	取值来自 `com.aspose.cells.pivot.PivotTableAutoFormatType`（例如 `REPORT_1`–`REPORT_10`、`CLASSIC`、`TABLE_1`–`TABLE_10`）。保存为现代格式时将被忽略。
`.xlsx` / `.xlsm` / `.xlsb`（现代，内置样式）	`pivotTable.setPivotTableStyleType(int)`	取值来自 `com.aspose.cells.PivotTableStyleType`（浅色/深色主题，包括 Excel 2017 新增的样式）。
`.xlsx` / `.xlsm` / `.xlsb`（现代，自定义样式）	`pivotTable.setPivotTableStyleName(String)` + `tableStyles.addPivotTableStyle(String)`	在内置预设不够用时使用。通过 `tableStyleElement.setElementStyle(Style)` 进行配置。
任何格式（统一覆盖）	`pivotTable.formatAll(Style)`	快捷方式，可覆盖整个数据透视表上的所有其他样式设置。
如有疑问，请保存为 `.xlsx` 并使用 `setPivotTableStyleType` 应用内置主题，或使用 `setPivotTableStyleName` 应用自定义主题。

Pythonjava: 在 Aspose.Cells for Python via Java 中添加数据透视表的行字段和列字段

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

向行或列区域添加字段

PivotTable.addFieldToArea(PivotFieldType fieldType, String fieldName) 方法将基础字段从源数据移动到四个数据透视区域之一。fieldType 参数接受以下 PivotFieldType 值之一。

ROW — 垂直显示在左侧的字段
COLUMN — 水平显示在顶部的字段
DATA — 其值被聚合的字段
PAGE — 用作报表筛选器的字段添加字段后,可以通过 PivotTable.getRowFields() 和 PivotTable.getColumnFields() 方法访问它们。每个方法返回一个 PivotFieldCollection。RowFields 中索引为 0 的字段是最外层的行字段,后续索引表示嵌套在其内的字段。相同的索引约定也适用于 ColumnFields。字段的嵌套顺序很重要。先将 Category 添加到行区域,然后再添加 Item,会生成一个外层分组为 Category、内层分组为 Item 的数据透视表。反转顺序则会使层次结构反转。

透视字段小计

PivotField.setSubtotals(PivotFieldSubtotalType subtotalType, boolean shown) 方法控制哪些小计行显示在透视字段上。每次调用都会独立切换一种小计类型。传递 shown = true 会显示小计,而 shown = false 会隐藏小计。由于每次调用仅影响一种类型,因此使用不同的 subtotalType 值多次调用该方法可以构建自定义的小计子集。 PivotFieldSubtotalType 枚举定义了可用的小计种类。

AUTOMATIC — Aspose.Cells 选择默认选项(通常对数值字段为 SUM)
NONE — 抑制所有小计行
SUM
COUNT
AVERAGE
MAX
MIN
PRODUCT
STD_DEV
STD_DEVP
VAR
VARP

只有当行区域(或列区域)中包含两个或更多数据透视字段时,小计才会呈现。单个字段没有可供小计的有意义内容,因此在这种情况下 setSubtotals 调用不会有可见效果。因此,本文在每个示例中放置两个行字段(Category 在外层,Item 在内层),以便显示每个 Category 组之间的小计边界。

场景 1 — 自动(默认)小计

如果完全不调用 setSubtotals,Aspose.Cells 会将 AUTOMATIC 选项应用于数值字段。以下示例通过在外层 Category 行字段上调用 setSubtotals(PivotFieldSubtotalType.AUTOMATIC, true) 来显式确认此行为。

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, PivotTable, PivotField, PivotFieldType, PivotFieldSubtotalType
workbook = Workbook()
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)
pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
pivotTable.addFieldToArea(PivotFieldType.ROW, "Category")
pivotTable.addFieldToArea(PivotFieldType.ROW, "Item")
pivotTable.addFieldToArea(PivotFieldType.COLUMN, "Year")
pivotTable.addFieldToArea(PivotFieldType.DATA, "Amount")
categoryField = pivotTable.getRowFields().get(0)
categoryField.setSubtotals(PivotFieldSubtotalType.AUTOMATIC, True)
pivotTable.calculateData()
workbook.save("output_automatic.xlsx")
jpype.shutdownJVM()

场景 2 — 抑制所有小计(None)

调用 setSubtotals(PivotFieldSubtotalType.NONE, true) 会从数据透视表中移除所有小计行,仅保留字段行和底部的总计行。当您希望获取原始分组数据而没有任何汇总行时,这非常有用。

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType, PivotFieldSubtotalType
workbook = Workbook()
worksheet = workbook.getWorksheets().get(0)
worksheet.setName("Data")
headers = ["Category", "Item", "Year", "Amount"]
for j in range(len(headers)):
    worksheet.getCells().get(0, j).putValue(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[0])):
        worksheet.getCells().get(i + 1, j).putValue(data[i][j])
pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
pivotTable.addFieldToArea(PivotFieldType.ROW, "Category")
pivotTable.addFieldToArea(PivotFieldType.ROW, "Item")
pivotTable.addFieldToArea(PivotFieldType.COLUMN, "Year")
pivotTable.addFieldToArea(PivotFieldType.DATA, "Amount")
categoryField = pivotTable.getRowFields().get(0)
categoryField.setSubtotals(PivotFieldSubtotalType.NONE, True)
pivotTable.calculateData()
workbook.save("output_none.xlsx")
jpype.shutdownJVM()

场景 3 — 自定义小计子集(Sum + Average)

您不仅限于使用单一小计类型。每次 setSubtotals 调用独立作用于一种类型,因此两次调用该方法(一次使用 SUM,一次使用 AVERAGE)将为每个 Category 组生成包含两种小计行的自定义子集。

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotTableCollection, PivotTable, PivotFieldType, PivotField, PivotFieldSubtotalType
workbook = Workbook()
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)
pivotTables = worksheet.getPivotTables()
pivotIndex = pivotTables.add("A1:D9", "F3", "PivotTable1")
pivotTable = pivotTables.get(pivotIndex)
pivotTable.addFieldToArea(PivotFieldType.Row, "Category")
pivotTable.addFieldToArea(PivotFieldType.Row, "Item")
pivotTable.addFieldToArea(PivotFieldType.Column, "Year")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
categoryField = pivotTable.getRowFields().get(0)
categoryField.setSubtotals(PivotFieldSubtotalType.Sum, True)
categoryField.setSubtotals(PivotFieldSubtotalType.Average, True)
pivotTable.calculateData()
workbook.save("output_custom.xlsx")
jpype.shutdownJVM()

小结

上述三个场景共享相同的数据集和数据透视表结构。它们之间唯一的区别是应用于外层 Category 行字段的 setSubtotals 调用。请记住"两个字段"规则:区域中的单个字段没有可供小计的内容,因此当您希望 setSubtotals 产生可见效果时,务必在行或列区域中至少放置两个字段。

Pythonjava: Aspose.Cells for Python via Java 中的值字段

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

向数据区域添加字段

将基础字段添加到数据（值）区域是塑造数据透视表如何聚合源数据的第一步。Aspose.Cells 公开 PivotTable.addFieldToArea(PivotFieldType, string)，这是一个接受常量 PivotFieldType.DATA 和源列名称的重载。一旦字段被添加到数据区域，API 会通过 PivotTable.DataFields 集合按字段添加顺序公开它们。默认情况下，数值型源列使用 ConsolidationFunction.SUM 进行汇总，而非数值列默认为 COUNT。

import aspose.cells as ac
from aspose.cells.pivot import PivotFieldType
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"
headers = ["Category", "Item", "Year", "Amount"]
for j, h in enumerate(headers):
    worksheet.cells.get(0, j).put_value(h)
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, row in enumerate(data):
    for j, val in enumerate(row):
        worksheet.cells.get(i + 1, j).put_value(val)
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(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 setter 可用于在可用的聚合之间切换，包括 SUM、COUNT、AVERAGE、MAX、MIN、PRODUCT、STDDEV、STDDEVP、VAR 和 VARP。

更改 Function 仅影响聚合，源列不会更改。

因此，您可以让一个数据字段保持为 SUM，同时添加另一个针对同一源列但使用 COUNT 或 AVERAGE 的数据字段，所有这些都可以在同一个透视表中完成。

import aspose.cells as ac
from aspose.cells.pivot import PivotFieldType, ConsolidationFunction
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"
headers = ["Category", "Item", "Year", "Amount"]
for j, h in enumerate(headers):
    worksheet.cells.get(0, j).put_value(h)
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, row in enumerate(data):
    for j, val in enumerate(row):
        worksheet.cells.get(i + 1, j).put_value(val)
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(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.add_field_to_area(PivotFieldType.DATA, "Amount")
pivot_table.data_fields[1].function = ConsolidationFunction.COUNT
pivot_table.calculate_data()
workbook.save("output_function.xlsx")

将值字段绘制到行或列轴

当数据透视表包含两个或更多数据字段时，Aspose.Cells 会公开一个名为 PivotTable.ValuesField 的额外虚拟字段。该虚拟字段表示数据区域中每个数据字段的聚合。您可以将其作为基础透视字段拖动到行或列区域，这对于并排排列多个度量值非常有用。

PivotTable.ValuesField 在没有或仅有一个值字段时不起作用。

下面的场景演练了三个端到端示例，针对相同的数据透视结构演示上述每个功能。

import aspose.cells as ac
from aspose.cells.pivot import PivotFieldType, ConsolidationFunction
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"
headers = ["Category", "Item", "Year", "Amount"]
for j, h in enumerate(headers):
    worksheet.cells.get(0, j).put_value(h)
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, row in enumerate(data):
    for j, val in enumerate(row):
        worksheet.cells.get(i + 1, j).put_value(val)
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(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.add_field_to_area(PivotFieldType.DATA, "Amount")
pivot_table.data_fields[1].function = ConsolidationFunction.COUNT
pivot_table.add_field_to_area(PivotFieldType.COLUMN, pivot_table.values_field)
pivot_table.calculate_data()
workbook.save("output_plot.xlsx")

Pythonjava: 在 Aspose.Cells for Python via Java 中向数据透视表添加筛选字段

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

Aspose.Cells 支持数据透视表中筛选字段的完整生命周期。您可以通过高级便捷 API 或底层 page_fields 集合添加筛选字段，可以以单选模式驱动筛选、清除筛选以显示所有筛选项，或者将字段切换为多选模式，以便用户通过 Excel 中的复选框界面一次选择多个筛选项。

简介

筛选字段是一种数据透视字段，用于控制数据透视表主体显示源数据的哪些子集。最终用户在 Excel 中渲染的数据透视表顶部将其视为一个下拉列表，选择某个可用的筛选项会重新构建数据透视表主体，使其仅汇总属于该筛选项的记录。当数据透视字段注册为 PivotFieldType.PAGE 而非 PivotFieldType.ROW、PivotFieldType.COLUMN 或 PivotFieldType.DATA 时，它就成为筛选字段。

添加筛选字段

使用 add_field_to_area 添加筛选字段

以下示例构建一个小的 Fruit / Year / Amount 数据集，在 E3 单元格放置一个数据透视表，将 Fruit 放在行区域，将 Amount 放在数据区域，将 Year 放在筛选区域，然后刷新数据透视表并保存工作簿。

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, PivotFieldType
# 创建新工作簿
workbook = Workbook()
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 行示例数据：水果、年份、数量
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.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 单元格添加数据透视表
pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "PivotTable1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
# 将字段添加到对应区域：水果作为行字段，数量作为数据字段，年份作为页字段
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
pivotTable.addFieldToArea(PivotFieldType.Page, "Year")
# 刷新并计算数据透视表数据
pivotTable.calculateData()
# 保存工作簿
workbook.save("pageFieldSample.xlsx")
jpype.shutdownJVM()

使用 page_fields.add 添加筛选字段

当您已经使用 PivotField 实例时，可以将其直接传递给 PivotTable.page_fields.add。数据透视表和筛选字段的构建方式与上一场景完全相同；只是最终的筛选区域注册替换为底层 API 调用。

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotTable, PivotField, PivotFieldType
# — 透视表和页面字段的构建方式与场景 1a 完全相同
#   (水果/年份/金额数据,透视表位于 E3,水果→行,
#   金额→数据)。下面我们从 BaseFields 集合中
#   获取 Year PivotField 并将其传递给 PageFields.Add —
#   这是 AddFieldToArea 的底层替代方案。其结果
#   与场景 1a 在功能上完全相同。
workbook = Workbook()
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 的透视表
pivotIndex = sheet.getPivotTables().add("E3", "A1:C10", "PivotTable1")
pivotTable = sheet.getPivotTables().get(pivotIndex)
# 水果 -> 行,金额 -> 数据(年份将在下面添加到页面)
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
# 底层方法:从 BaseFields 中获取已存在的 Year PivotField,
# 并通过 PageFields.Add(PivotField) 将其注册到页面区域。
yearField = pivotTable.getBaseFields().get("Year")
pivotTable.getPageFields().add(yearField)
# 刷新数据以使新的页面字段反映在保存的工作簿中
pivotTable.calculateData()
workbook.save("output.xlsx")
jpype.shutdownJVM()

单选筛选（显示一个筛选项）

在默认的单选行为下，筛选字段呈现为单个下拉列表，PivotField.current_page_item 整数用于选择驱动数据透视表主体的筛选项。分配特定索引会选择该项；分配特殊标记值 0x7FFD（十进制 32765）会清除筛选，以便同时汇总所有筛选项。单选是默认模式，无需显式启用。

显示所有项

将 current_page_item 设置为魔法值 0x7FFD 等同于清除筛选：数据透视表主体将汇总每个筛选项，就好像没有应用筛选一样。

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType
# 创建新工作簿
workbook = Workbook()
sheet = workbook.getWorksheets().get(0)
# 填充水果/年份/数量数据
sheet.getCells().get("A1").putValue("Fruit")
sheet.getCells().get("B1").putValue("Year")
sheet.getCells().get("C1").putValue("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.getCells().get(r + 1, c).putValue(data[r][c])
# 在 E3 创建数据透视表
pivotTables = sheet.getPivotTables()
index = pivotTables.add("=A1:C7", "E3", "PivotTable1")
pivotTable = pivotTables.get(index)
# 配置数据透视字段：水果→行，数量→数据，年份→页
pivotTable.addFieldToArea(PivotFieldType.ROW, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.DATA, "Amount")
pivotTable.addFieldToArea(PivotFieldType.PAGE, "Year")
pivotTable.calculateData()
# 清除页面筛选，以便显示页面字段中的所有项目。
# 0x7FFD（十进制 32765）是表示"所有项目"的特殊哨兵值 —
# 等同于在 Excel 的页字段下拉菜单中选择"(全部)"。
pivotTable.getPageFields().get(0).setCurrentPageItem(0x7FFD)
workbook.save("output.xlsx")
jpype.shutdownJVM()

显示一个特定项

将 current_page_item 设置为实际索引仅选择该筛选项。该索引是筛选字段已排序项列表中该项的位置，因此例如 1 选择排序后的第二项。

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType
# Create workbook
workbook = Workbook()
sheet = workbook.getWorksheets().get(0)
cells = sheet.getCells()
# Add sample data (Fruit/Year/Amount)
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")
# Add pivot table at E3
pivotTables = sheet.getPivotTables()
pivotIndex = pivotTables.add("A1:C5", "E3", "PivotTable1")
pivotTable = pivotTables.get(pivotIndex)
# Add fields: Fruit→Row, Amount→Data, Year→Page
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
pivotTable.addFieldToArea(PivotFieldType.Page, "Year")
# Page-field-specific operations
pivotTable.getPageFields().get(0).setCurrentPageItem(1) # 1 = second item in sorted order (e.g. "2021")
# Refresh and calculate pivot table
pivotTable.calculateData()
workbook.save("output.xlsx")
jpype.shutdownJVM()

多选筛选

多选筛选将筛选下拉列表转换为复选框列表，允许最终用户同时选择多个筛选项。Aspose.Cells 公开了两个协同工作的属性。必须先将 PivotField.is_multiple_item_selection_allowed 设置为 True，多选界面才会生效。启用后，PivotItem.is_hidden 控制哪些项出现在复选框列表中，因此您可以显示所有项或仅将特定项加入白名单。

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType
import os
import re
# — 数据透视表和页字段的构造方式与
#   场景 1a 完全相同（Fruit/Year/Amount 数据，透视表位于 E3，Fruit→行，
#   Amount→数据，Year→页通过 AddFieldToArea）。
#   下面我们对页字段应用多选筛选。
workbook = Workbook()
sheet = workbook.getWorksheets().get(0)
cells = sheet.getCells()
# 示例数据：Fruit | Year | Amount
cells.get(0, 0).putValue("Fruit")
cells.get(0, 1).putValue("Year")
cells.get(0, 2).putValue("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.get(i + 1, 0).putValue(data[i][0])
    cells.get(i + 1, 1).putValue(int(data[i][1]))
    cells.get(i + 1, 2).putValue(int(data[i][2]))
pivotSheet = workbook.getWorksheets().add("Pivot")
pivots = pivotSheet.getPivotTables()
pivotIndex = pivots.add("E3", "A1:C10", "PivotTable1")
pivotTable = pivots.get(pivotIndex)
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
pivotTable.addFieldToArea(PivotFieldType.Page, "Year")
# — 在页字段上启用多选
pivotTable.getPageFields().get(0).setMultipleItemSelectionAllowed(True)
# Part A — 选择所有项（使每个项都可见）
pivotItems = pivotTable.getPageFields().get(0).getPivotItems()
for i in range(pivotItems.getCount()):
    pivotItems.get(i).setHidden(False)
# Part B — 按源值仅选择特定项
for i in range(pivotItems.getCount()):
    value = pivotItems.get(i).getStringValue()
    if value == "2020" or value == "grape" or value == "blueberry":
        pivotItems.get(i).setHidden(False)
    else:
        pivotItems.get(i).setHidden(True)
pivotTable.calculateData()
workbook.save("output.xlsx")
jpype.shutdownJVM()

**注意：**当通过 PivotItem.is_hidden 使用多选筛选时，至少必须保留一个 PivotItem 可见（is_hidden == False）。如果每个项都隐藏，则 Excel 在打开文件时崩溃或呈现空白数据透视表。始终验证您的多选白名单包含源数据中的至少一个项。

应该使用哪个 API 和哪种模式？

下表汇总了何时使用每个 API 和模式，以便您可以挑选合适的组合而无需详细阅读每个场景。

场景/用例	推荐 API	使用的属性	备注
按源列名称添加筛选字段（最常见）	`PivotTable.add_field_to_area(PivotFieldType.PAGE, "fieldName")`	不适用	高级 API，一行代码。除非需要 `PivotField` 引用，否则请使用此方法。
当您已经有 `PivotField` 对象时添加筛选字段	`PivotTable.page_fields.add(PivotField)`	不适用	当字段对象是在其他地方获取或需要重用时使用。
筛选到单个筛选项（默认模式）	`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 在打开时崩溃或呈现空白数据透视表。根据源数据构建白名单，确保至少有一项保持可见，这样保存的工作簿将在每台计算机上可靠打开。

Documentation – 数据透视表

Pythonjava: 创建数据透视表

创建数据透视表

Pythonjava: 格式化数据透视表单元格

Pythonjava: 在 Aspose.Cells for Python via Java 中刷新数据透视表和数据透视缓存

简介

快速开始

所需导入

刷新工作簿中的所有数据透视表

刷新单个工作表上的所有数据透视表

刷新单个数据透视表

源数据已更改 — 使用 PivotCache.refresh()

仅视图/布局已更改 — 使用 calculateData()

从已过时的 PivotTable.refreshData() 迁移

应使用哪种刷新 API？

常见陷阱

Pythonjava: 在 Aspose.Cells for Python via Java 中为数据透视表应用样式

简介

应用传统的 XLS 预设自动格式

应用现代命名预设数据透视表样式

定义并应用自定义数据透视表样式

使用 FormatAll 将一种样式应用于每个数据透视表单元格

我应该使用哪个样式 API？

Pythonjava: 在 Aspose.Cells for Python via Java 中添加数据透视表的行字段和列字段

向行或列区域添加字段

透视字段小计

场景 1 — 自动(默认)小计

场景 2 — 抑制所有小计(None)

场景 3 — 自定义小计子集(Sum + Average)

小结

Pythonjava: Aspose.Cells for Python via Java 中的值字段

向数据区域添加字段

更改汇总函数

将值字段绘制到行或列轴

Pythonjava: 在 Aspose.Cells for Python via Java 中向数据透视表添加筛选字段

简介

添加筛选字段

使用 add_field_to_area 添加筛选字段

使用 page_fields.add 添加筛选字段

单选筛选（显示一个筛选项）

显示所有项

显示一个特定项

多选筛选

应该使用哪个 API 和哪种模式？

源数据已更改 — 使用 `PivotCache.refresh()`

仅视图/布局已更改 — 使用 `calculateData()`

从已过时的 `PivotTable.refreshData()` 迁移