Documentation – 插入数据透视表

Nodejsjava: 在 Aspose.Cells for Node.js 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.pivotTableStyleType 用于选择内置的命名样式之一(浅色和深色主题,包括 Excel 2017 中新增的样式)。这些预设为只读。
PivotTable.pivotTableStyleName 用于选择您通过 Worksheets.getTableStyles().addPivotTableStyle(...) 自行定义的自定义样式。当您希望修改预置样式之外的颜色、边框或字体时,必须使用自定义样式。此外,PivotTable.formatAll(Style) 是一个快捷方式,可将单个 Style 对象应用于数据透视表的每个单元格,从而覆盖通过上述任一样式名称 API 所设置的内容。当需要统一外观而不考虑底层主题时,此方法非常有用。

应用传统 XLS 预设自动格式

PivotTable.autoFormatType 接受来自 Aspose.Cells.Pivot.PivotTableAutoFormatType 枚举的值。可用值包括 Report1 至 Report10、Classic 以及 Table1 至 Table10。以下示例加载一个新工作簿,填入 Fruit/Year/Amount 示例数据,添加一个数据透视表,应用 PivotTableAutoFormatType.Report5,并将结果保存为 .xls。

为什么没有列字段?Report 系列的自动格式(Report1 至 Report10、Table1 至 Table10)是经典 Excel 中为单维数据透视表设计的,仅包含行字段和值——它们没有为列字段标题提供内置样式。如果您的数据透视表需要列字段,请改用场景 2 中的现代 PivotTableStyleType 预设,这些预设专为现代 Excel 使用的二维布局而设计。

let workbook = new AsposeCells.Workbook();
// 获取第一个工作表
let sheet = workbook.getWorksheets().get(0);
// 填充源数据，包括表头行（Fruit、Year、Amount）
// 以及 9 行数据，涵盖 2020 和 2021 年的葡萄、蓝莓、猕猴桃、樱桃
sheet.getCells().get(0, 0).putValue("Fruit");
sheet.getCells().get(0, 1).putValue("Year");
sheet.getCells().get(0, 2).putValue("Amount");
sheet.getCells().get(1, 0).putValue("grape");
sheet.getCells().get(1, 1).putValue(2020);
sheet.getCells().get(1, 2).putValue(50);
sheet.getCells().get(2, 0).putValue("blueberry");
sheet.getCells().get(2, 1).putValue(2020);
sheet.getCells().get(2, 2).putValue(30);
sheet.getCells().get(3, 0).putValue("kiwi");
sheet.getCells().get(3, 1).putValue(2020);
sheet.getCells().get(3, 2).putValue(25);
sheet.getCells().get(4, 0).putValue("cherry");
sheet.getCells().get(4, 1).putValue(2020);
sheet.getCells().get(4, 2).putValue(40);
sheet.getCells().get(5, 0).putValue("grape");
sheet.getCells().get(5, 1).putValue(2021);
sheet.getCells().get(5, 2).putValue(60);
sheet.getCells().get(6, 0).putValue("blueberry");
sheet.getCells().get(6, 1).putValue(2021);
sheet.getCells().get(6, 2).putValue(35);
sheet.getCells().get(7, 0).putValue("kiwi");
sheet.getCells().get(7, 1).putValue(2021);
sheet.getCells().get(7, 2).putValue(28);
sheet.getCells().get(8, 0).putValue("cherry");
sheet.getCells().get(8, 1).putValue(2021);
sheet.getCells().get(8, 2).putValue(45);
sheet.getCells().get(9, 0).putValue("grape");
sheet.getCells().get(9, 1).putValue(2020);
sheet.getCells().get(9, 2).putValue(45);
// 在目标单元格 E3 添加一个名为 "Pivot1" 的数据透视表，源数据范围为 A1:C10
let pivotIndex = sheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
let pivotTable = sheet.getPivotTables().get(pivotIndex);
// 分配字段：Fruit -> 行，Amount -> 数据
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.ROW, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.DATA, "Amount");
// 应用旧版 XLS 预设自动格式 "Report5"
// 注意：此属性仅在保存为 .xls 格式时有效。
// 当保存为 .xlsx/.xlsm/.xlsb 格式时，Excel 会忽略 AutoFormatType，
// 而使用 PivotTableStyleType / PivotTableStyleName 所指定的样式。
pivotTable.setAutoFormatType(AsposeCells.PivotTableAutoFormatType.REPORT_5);
// 将工作簿保存为旧版 .xls 格式
workbook.save("output.xls");

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

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

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

通过 Worksheets.getTableStyles().addPivotTableStyle(String name) 向工作簿的 TableStyles 集合添加自定义样式。该方法返回新创建样式的索引。
通过 TableStyle.tableStyleElements.add(TableStyleElementType) 添加元素(例如 WholeTable 或 GrandTotalRow)来配置样式,然后通过 TableStyleElement.setElementStyle(Style) 为每个元素分配一个 Style。
通过将 PivotTable.pivotTableStyleName 设置为样式名称,将自定义样式应用于数据透视表。此处不要使用 pivotTableStyleType,因为该属性用于选择内置预设。

pivotTableStyleName 和 pivotTableStyleType 不能互换使用。使用 pivotTableStyleType 选择内置预设,使用 pivotTableStyleName 选择通过 addPivotTableStyle 定义的自定义样式。同时设置两者是无害的,但只有与预期来源匹配的那一个会被渲染。

可用的 TableStyleElementType 值包括 WholeTable、FirstRow、LastRow、FirstColumn、LastColumn、GrandTotalRow、GrandTotalColumn、PageFieldLabels 和 PageFieldValues。以下示例定义了一个自定义数据透视表样式,在 WholeTable 上使用细黑边框,在 GrandTotalRow 上使用粗体红色字体,然后通过 pivotTableStyleName 应用该样式并保存为 .xlsx。

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
// 填充源数据：标题行 + 9 行数据 (A1:C10)
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");
worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);
worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(200);
worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(300);
worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(400);
worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(500);
worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(600);
worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(700);
worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(800);
worksheet.getCells().get("A10").putValue("Grape");
worksheet.getCells().get("B10").putValue(2021);
worksheet.getCells().get("C10").putValue(900);
// 添加数据透视表，源数据为 A1:C10，锚定在 E3，名称为 "Pivot1"
let pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.ROW, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.COLUMN, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.DATA, "Amount");
// 步骤 1：注册一个新的自定义数据透视表样式并捕获其索引
let styleIndex = workbook.getWorksheets().getTableStyles().addPivotTableStyle("CustomPivotStyle");
let tableStyle = workbook.getWorksheets().getTableStyles().get(styleIndex);
// 步骤 2：添加一个 WholeTable 元素并在四边应用细黑色边框
let wholeTableElementIndex = tableStyle.getTableStyleElements().add(AsposeCells.TableStyleElementType.WHOLE_TABLE);
let wholeTableElement = tableStyle.getTableStyleElements().get(wholeTableElementIndex);
let wholeTableStyle = workbook.createStyle();
let topBorder = wholeTableStyle.getBorders().get(AsposeCells.BorderType.TOP_BORDER);
topBorder.setLineStyle(AsposeCells.CellBorderType.THIN);
topBorder.setColor(AsposeCells.Color.BLACK);
let bottomBorder = wholeTableStyle.getBorders().get(AsposeCells.BorderType.BOTTOM_BORDER);
bottomBorder.setLineStyle(AsposeCells.CellBorderType.THIN);
bottomBorder.setColor(AsposeCells.Color.BLACK);
let leftBorder = wholeTableStyle.getBorders().get(AsposeCells.BorderType.LEFT_BORDER);
leftBorder.setLineStyle(AsposeCells.CellBorderType.THIN);
leftBorder.setColor(AsposeCells.Color.BLACK);
let rightBorder = wholeTableStyle.getBorders().get(AsposeCells.BorderType.RIGHT_BORDER);
rightBorder.setLineStyle(AsposeCells.CellBorderType.THIN);
rightBorder.setColor(AsposeCells.Color.BLACK);
wholeTableElement.setElementStyle(wholeTableStyle);
// 步骤 3：添加一个 GrandTotalRow 元素并应用粗体红色字体
let grandTotalElementIndex = tableStyle.getTableStyleElements().add(AsposeCells.TableStyleElementType.GRAND_TOTAL_ROW);
let grandTotalElement = tableStyle.getTableStyleElements().get(grandTotalElementIndex);
let grandTotalStyle = workbook.createStyle();
grandTotalStyle.getFont().setBold(true);
grandTotalStyle.getFont().setColor(AsposeCells.Color.RED);
grandTotalElement.setElementStyle(grandTotalStyle);
// 步骤 4：按名称应用自定义样式（不要使用 PivotTableStyleType，那是用于内置预设样式的）
pivotTable.setPivotTableStyleName("CustomPivotStyle");
workbook.save("output.xlsx");

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

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

formatAll 会覆盖 pivotTableStyleType 和 pivotTableStyleName。仅当需要在整个数据透视表中获得统一且不依赖主题的外观时才使用它。

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

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
// 填充源数据：表头行（第1行）+ 9行数据（第2-10行）
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");
worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(5000);
worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(3000);
worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(4000);
worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(2000);
worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(6000);
worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(3500);
worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(4500);
worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(2500);
worksheet.getCells().get("A10").putValue("Grape");
worksheet.getCells().get("B10").putValue(2021);
worksheet.getCells().get("C10").putValue(5500);
// 添加数据透视表：源数据区域 A1:C10，目标单元格 E3，名称 "Pivot1"
let pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);
// 分配透视字段：Fruit -> 行区域，Year -> 列区域，Amount -> 数据区域
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
// 创建一个将强制应用于数据透视表每个单元格的样式
let style = workbook.createStyle();
style.setForegroundColor(AsposeCells.Color.Yellow);
style.setPattern(AsposeCells.BackgroundType.Solid);
style.getFont().setIsBold(true);
style.getFont().setColor(AsposeCells.Color.DarkBlue);
style.getBorders().get(AsposeCells.BorderType.TopBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.TopBorder).setColor(AsposeCells.Color.Black);
style.getBorders().get(AsposeCells.BorderType.BottomBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.BottomBorder).setColor(AsposeCells.Color.Black);
style.getBorders().get(AsposeCells.BorderType.LeftBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.LeftBorder).setColor(AsposeCells.Color.Black);
style.getBorders().get(AsposeCells.BorderType.RightBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.RightBorder).setColor(AsposeCells.Color.Black);
// 应用 FormatAll：强制将此单个样式应用于数据透视表的每个单元格，
// 覆盖之前设置的任何 PivotTableStyleType / PivotTableStyleName
pivotTable.formatAll(style);
// 以现代 .xlsx 格式保存工作簿
workbook.save("output.xlsx");

应该使用哪种样式 API?

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

目标文件格式	要使用的 API	备注
`.xls`(传统)	`PivotTable.autoFormatType`	值来自 `Aspose.Cells.Pivot.PivotTableAutoFormatType`(例如 `Report1`–`Report10`、`Classic`、`Table1`–`Table10`)。在保存为现代格式时将被忽略。
`.xlsx` / `.xlsm` / `.xlsb`(现代,内置样式)	`PivotTable.pivotTableStyleType`	值来自 `Aspose.Cells.PivotTableStyleType`(浅色/深色主题,包括 Excel 2017 新增内容)。
`.xlsx` / `.xlsm` / `.xlsb`(现代,自定义样式)	`PivotTable.pivotTableStyleName` + `Worksheets.getTableStyles().addPivotTableStyle(...)`	当内置预设不够用时使用。通过 `TableStyleElement.setElementStyle(...)` 进行配置。
任何格式(统一覆盖)	`PivotTable.formatAll(Style)`	快捷方式,可覆盖整个数据透视表中的所有其他样式设置。
如有疑问,请保存为 `.xlsx`,并对内置主题使用 `pivotTableStyleType`,对自定义主题使用 `pivotTableStyleName`。

Nodejsjava: 在 Aspose.Cells for Node.js via Java 中刷新数据透视表和数据透视缓存

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

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

简介

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

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

PivotCache.SourceType（枚举 PivotTableSourceType）指示缓存数据的来源。在 v26.7 中，PivotCache.Refresh() 仅支持 Sheet 和 Consolidation 源类型——也就是说，仅支持位于工作表区域中的数据。外部源（数据库、外部连接等）目前尚无法通过缓存 API 进行刷新。

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

PivotTable.CalculateData() — 基于已缓存的数据重新计算单个 PivotTable 的显示内容，无需往返访问数据源。本文中的所有场景均使用工作表单元格作为源数据，因此源类型为 Sheet，刷新操作的行为与所述一致。

快速入门

如果您只需要使用最短的代码来刷新工作簿中的每个数据透视表，只需一次调用即可：

const aspose = require('aspose.cells');
const workbook = new aspose.cells.Workbook("input.xlsx");
workbook.refreshAll();
workbook.save("output.xlsx");

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

必需的导入

const aspose = require('aspose.cells');
或者使用特定的导入：const { Workbook, Cells, PivotTableSourceType } = require('aspose.cells');

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

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

const AsposeCells = require("aspose.cells");
// 创建一个新的工作簿
const workbook = new AsposeCells.Workbook();
const 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"
const pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
const pivotTable = worksheet.getPivotTables().get(pivotIndex);
// 分配数据透视表字段：Fruit 到行，Year 到列，Amount 到数据
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
// 修改源数据中的若干 Amount 值以模拟变化
worksheet.getCells().get("C2").putValue(55);
worksheet.getCells().get("C5").putValue(85);
worksheet.getCells().get("C9").putValue(125);
// 刷新工作簿中的所有数据透视表/数据透视缓存
workbook.refreshAll();
// 保存工作簿
workbook.save("output.xlsx");

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

有时您仅需刷新位于特定工作表上的数据透视表——例如，当已知其他工作表上的数据透视表与此无关且不应被修改时。针对这种情况，Aspose.Cells 提供了 Worksheet.RefreshPivotTables()，其作用域限定在单个 Worksheet 实例上。

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");
worksheet.getCells().get("A2").putValue("grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);
worksheet.getCells().get("A3").putValue("blueberry");
worksheet.getCells().get("B3").putValue(2021);
worksheet.getCells().get("C3").putValue(150);
worksheet.getCells().get("A4").putValue("kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(200);
worksheet.getCells().get("A5").putValue("cherry");
worksheet.getCells().get("B5").putValue(2021);
worksheet.getCells().get("C5").putValue(120);
worksheet.getCells().get("A6").putValue("grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(180);
worksheet.getCells().get("A7").putValue("blueberry");
worksheet.getCells().get("B7").putValue(2020);
worksheet.getCells().get("C7").putValue(130);
worksheet.getCells().get("A8").putValue("kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(220);
worksheet.getCells().get("A9").putValue("cherry");
worksheet.getCells().get("B9").putValue(2020);
worksheet.getCells().get("C9").putValue(140);
let pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
worksheet.getCells().get("C2").putValue(300);
worksheet.getCells().get("C5").putValue(250);
worksheet.getCells().get("C9").putValue(400);
worksheet.refreshPivotTables();
workbook.save("output.xlsx");

刷新单个数据透视表

当您希望对单个数据透视表进行精细控制时，基于缓存的 API 提供了两种选择。两者之间的选择取决于实际发生变化的内容：是底层源数据发生了变化，还是仅数据透视表本身的视图/布局设置发生了变化。

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

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

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

如果源数据未发生变化，仅数据透视表的视图或布局设置被修改（例如，将字段移动到不同的区域，或切换了打开时刷新设置），则无需往返访问数据源。缓存已包含正确的数据；仅需重新计算呈现的 PivotTable。在这种情况下，pivotTable.CalculateData() 是正确的选择。以下示例修改数据透视表的非源属性，然后调用 CalculateData() 以基于现有缓存重新渲染。

var workbook = new AsposeCells.Workbook();
var 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
var pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
var pivotTable = worksheet.getPivotTables().get(pivotIndex);
// 分配字段：Fruit 分配到行，Year 分配到列，Amount 分配到数据
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
// 修改视图/布局属性——这只是一个展示层面的更改，
// 因此不需要通过 PivotCache.Refresh() 重新读取数据源。
pivotTable.setRefreshDataOnOpeningFile(false);
// CalculateData() 会使用 PivotCache 中已保存的数据重新渲染
// 此数据透视表的显示（数据和样式）。因为数据源没有变化，
// 不会对数据源进行往返读取——只将缓存中的值重新计算
// 到工作表单元格中。
pivotTable.calculateData();
// 将工作簿保存到磁盘
workbook.save("output.xlsx");

一个工作簿通常包含许多数据透视表，它们都基于同一个共享缓存。要枚举它们——例如在执行批量刷新之前，或诊断共享缓存的影响——可使用 PivotCache.GetPivotTables()。此方法返回依赖指定缓存的每个 PivotTable 的集合。

从过时的 `PivotTable.RefreshData()` 迁移

在 Aspose.Cells for Node.js via Java v26.7 之前，刷新数据透视表的标准方式是对每个数据透视表单独调用 PivotTable.RefreshData()。从 v26.7 开始，该方法被标记为过时，应替换为上文介绍的基于缓存的 API。在真实工作簿中，按表调用 RefreshData() 的方法存在两个问题：

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

我应该使用哪种刷新 API？

下表总结了可用的刷新 API 及其适用场景。

目标	推荐 API	备注
刷新工作簿中的所有内容	`Workbook.RefreshAll()`	一次调用即可覆盖所有缓存和表。
仅刷新单个工作表上的数据透视表	`Worksheet.RefreshPivotTables()`	作用域限定于单个工作表。
单个缓存的源数据已更改	`pivotTable.PivotCache.Refresh()`	刷新该共享缓存上的所有数据透视表。
仅视图/布局设置已更改	`pivotTable.CalculateData()`	跳过不必要的源数据往返。
列出共享缓存上的所有数据透视表	`pivotCache.GetPivotTables()`	用于在批量刷新前枚举。
在实际应用中，建议优先使用基于缓存的 API，而不是过时的按表刷新 `RefreshData()`。这些 API 能够感知共享缓存，可避免冗余的源数据获取，并允许您选择满足刷新需求的最小作用域。

常见陷阱

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

Nodejsjava: 在 Aspose.Cells for Node.js 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) 来明确确认此行为。

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");
worksheet.getCells().get(0, 0).putValue("Category");
worksheet.getCells().get(0, 1).putValue("Item");
worksheet.getCells().get(0, 2).putValue("Year");
worksheet.getCells().get(0, 3).putValue("Amount");
worksheet.getCells().get(1, 0).putValue("Fruit");
worksheet.getCells().get(1, 1).putValue("Apple");
worksheet.getCells().get(1, 2).putValue(2020);
worksheet.getCells().get(1, 3).putValue(100);
worksheet.getCells().get(2, 0).putValue("Fruit");
worksheet.getCells().get(2, 1).putValue("Apple");
worksheet.getCells().get(2, 2).putValue(2021);
worksheet.getCells().get(2, 3).putValue(150);
worksheet.getCells().get(3, 0).putValue("Fruit");
worksheet.getCells().get(3, 1).putValue("Banana");
worksheet.getCells().get(3, 2).putValue(2020);
worksheet.getCells().get(3, 3).putValue(80);
worksheet.getCells().get(4, 0).putValue("Fruit");
worksheet.getCells().get(4, 1).putValue("Banana");
worksheet.getCells().get(4, 2).putValue(2021);
worksheet.getCells().get(4, 3).putValue(90);
worksheet.getCells().get(5, 0).putValue("Vegetable");
worksheet.getCells().get(5, 1).putValue("Carrot");
worksheet.getCells().get(5, 2).putValue(2020);
worksheet.getCells().get(5, 3).putValue(50);
worksheet.getCells().get(6, 0).putValue("Vegetable");
worksheet.getCells().get(6, 1).putValue("Carrot");
worksheet.getCells().get(6, 2).putValue(2021);
worksheet.getCells().get(6, 3).putValue(60);
worksheet.getCells().get(7, 0).putValue("Vegetable");
worksheet.getCells().get(7, 1).putValue("Daikon");
worksheet.getCells().get(7, 2).putValue(2020);
worksheet.getCells().get(7, 3).putValue(40);
worksheet.getCells().get(8, 0).putValue("Vegetable");
worksheet.getCells().get(8, 1).putValue("Daikon");
worksheet.getCells().get(8, 2).putValue(2021);
worksheet.getCells().get(8, 3).putValue(45);
let pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
let categoryField = pivotTable.getRowFields().get(0);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.Automatic, true);
pivotTable.calculateData();
workbook.save("output_automatic.xlsx");

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

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

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");
let headers = ["Category", "Item", "Year", "Amount"];
for (let j = 0; j < headers.length; j++)
{
    worksheet.getCells().get(0, j).putValue(headers[j]);
}
let data = [
    ["Fruit", "Apple", 2020, 100],
    ["Fruit", "Apple", 2021, 150],
    ["Fruit", "Banana", 2020, 80],
    ["Fruit", "Banana", 2021, 90],
    ["Vegetable", "Carrot", 2020, 50],
    ["Vegetable", "Carrot", 2021, 60],
    ["Vegetable", "Daikon", 2020, 40],
    ["Vegetable", "Daikon", 2021, 45]
];
for (let i = 0; i < data.length; i++)
{
    for (let j = 0; j < data[i].length; j++)
    {
        worksheet.getCells().get(i + 1, j).putValue(data[i][j]);
    }
}
let pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
let categoryField = pivotTable.getRowFields().get(0);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.None, true);
pivotTable.calculateData();
workbook.save("output_none.xlsx");

场景 3 — 自定义小计子集(总和 + 平均值)

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

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");
worksheet.getCells().get("A1").putValue("Category");
worksheet.getCells().get("B1").putValue("Item");
worksheet.getCells().get("C1").putValue("Year");
worksheet.getCells().get("D1").putValue("Amount");
worksheet.getCells().get(1, 0).putValue("Fruit");
worksheet.getCells().get(1, 1).putValue("Apple");
worksheet.getCells().get(1, 2).putValue(2020);
worksheet.getCells().get(1, 3).putValue(100);
worksheet.getCells().get(2, 0).putValue("Fruit");
worksheet.getCells().get(2, 1).putValue("Apple");
worksheet.getCells().get(2, 2).putValue(2021);
worksheet.getCells().get(2, 3).putValue(150);
worksheet.getCells().get(3, 0).putValue("Fruit");
worksheet.getCells().get(3, 1).putValue("Banana");
worksheet.getCells().get(3, 2).putValue(2020);
worksheet.getCells().get(3, 3).putValue(80);
worksheet.getCells().get(4, 0).putValue("Fruit");
worksheet.getCells().get(4, 1).putValue("Banana");
worksheet.getCells().get(4, 2).putValue(2021);
worksheet.getCells().get(4, 3).putValue(90);
worksheet.getCells().get(5, 0).putValue("Vegetable");
worksheet.getCells().get(5, 1).putValue("Carrot");
worksheet.getCells().get(5, 2).putValue(2020);
worksheet.getCells().get(5, 3).putValue(50);
worksheet.getCells().get(6, 0).putValue("Vegetable");
worksheet.getCells().get(6, 1).putValue("Carrot");
worksheet.getCells().get(6, 2).putValue(2021);
worksheet.getCells().get(6, 3).putValue(60);
worksheet.getCells().get(7, 0).putValue("Vegetable");
worksheet.getCells().get(7, 1).putValue("Daikon");
worksheet.getCells().get(7, 2).putValue(2020);
worksheet.getCells().get(7, 3).putValue(40);
worksheet.getCells().get(8, 0).putValue("Vegetable");
worksheet.getCells().get(8, 1).putValue("Daikon");
worksheet.getCells().get(8, 2).putValue(2021);
worksheet.getCells().get(8, 3).putValue(45);
let pivotTables = worksheet.getPivotTables();
let pivotIndex = pivotTables.add("A1:D9", "F3", "PivotTable1");
let pivotTable = pivotTables.get(pivotIndex);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
let categoryField = pivotTable.getRowFields().get(0);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.Sum, true);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.Average, true);
pivotTable.calculateData();
workbook.save("output_custom.xlsx");

回顾

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

Nodejsjava: Aspose.Cells for Node.js via Java 中的值字段

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

值字段是每个数据透视表的核心，是用于汇总源数据的数值聚合。在 Aspose.Cells for Node.js via Java 中，数据透视表的数据区域通过 PivotTable.addFieldToArea 添加基础字段来填充，放置在该区域中的每个字段都可以拥有自己的汇总函数。当存在两个或多个数据字段时，Aspose.Cells 公开了一个特殊的聚合字段 PivotTable.getValuesField()，它可以作为基础字段绘制到行或列轴上，让您能够更精细地控制值字段在布局中的显示方式。

将字段添加到数据区域

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

const AsposeCells = require("aspose.cells");
const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");
const headers = ["Category", "Item", "Year", "Amount"];
for (let j = 0; j < headers.length; j++) {
    worksheet.getCells().get(0, j).putValue(headers[j]);
}
const data = [
    ["Fruit",     "Apple",  2020, 100],
    ["Fruit",     "Apple",  2021, 150],
    ["Fruit",     "Banana", 2020,  80],
    ["Fruit",     "Banana", 2021,  90],
    ["Vegetable", "Carrot", 2020,  50],
    ["Vegetable", "Carrot", 2021,  60],
    ["Vegetable", "Daikon", 2020,  40],
    ["Vegetable", "Daikon", 2021,  45]
];
for (let i = 0; i < data.length; i++) {
    for (let j = 0; j < data[i].length; j++) {
        worksheet.getCells().get(i + 1, j).putValue(data[i][j]);
    }
}
const pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1", true, false);
const pivotTable = worksheet.getPivotTables().get(pivotIndex);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.calculateData();
workbook.save("output_drag.xlsx");

更改汇总函数

放置在数据区域中的每个字段在内部都会被包装为一个 PivotField 实例，其 getFunction() 属性返回 ConsolidationFunction 枚举中的某个值。同一个 setFunction() setter 允许您在可用的聚合函数之间切换，包括 SUM、COUNT、AVERAGE、MAX、MIN、PRODUCT、STD_DEV、STD_DEVP、VAR 和 VARP。

更改 Function 仅影响聚合方式，源列本身不会改变。

因此，您可以在同一个数据透视表中保留一个使用 SUM 的数据字段，同时添加另一个指向同一源列但使用 COUNT 或 AVERAGE 的数据字段。

const AsposeCells = require("aspose.cells");
const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");
const headers = ["Category", "Item", "Year", "Amount"];
for (let j = 0; j < headers.length; j++) {
    worksheet.getCells().get(0, j).putValue(headers[j]);
}
const data = [
    ["Fruit",     "Apple",  2020, 100],
    ["Fruit",     "Apple",  2021, 150],
    ["Fruit",     "Banana", 2020,  80],
    ["Fruit",     "Banana", 2021,  90],
    ["Vegetable", "Carrot", 2020,  50],
    ["Vegetable", "Carrot", 2021,  60],
    ["Vegetable", "Daikon", 2020,  40],
    ["Vegetable", "Daikon", 2021,  45]
];
for (let i = 0; i < data.length; i++) {
    for (let j = 0; j < data[i].length; j++) {
        worksheet.getCells().get(i + 1, j).putValue(data[i][j]);
    }
}
const pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1", true, false);
const pivotTable = worksheet.getPivotTables().get(pivotIndex);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.getDataFields().get(1).setFunction(AsposeCells.ConsolidationFunction.Count);
pivotTable.calculateData();
workbook.save("output_function.xlsx");

将值字段绘制到行或列轴上

当数据透视表包含两个或多个数据字段时，Aspose.Cells 会公开一个额外的虚拟字段 PivotTable.getValuesField()。该虚拟字段代表数据区域中所有数据字段的聚合结果。您可以将其作为基础数据透视字段拖到行或列区域，这在并排布局多个度量值时非常有用。

如果没有值字段或仅有一个值字段，PivotTable.getValuesField() 将无法使用。

下面的场景通过三个端到端示例，在同一数据透视表结构上演示上文介绍的每项功能。

const AsposeCells = require("aspose.cells");
const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");
const headers = ["Category", "Item", "Year", "Amount"];
for (let j = 0; j < headers.length; j++) {
    worksheet.getCells().get(0, j).putValue(headers[j]);
}
const data = [
    ["Fruit",     "Apple",  2020, 100],
    ["Fruit",     "Apple",  2021, 150],
    ["Fruit",     "Banana", 2020,  80],
    ["Fruit",     "Banana", 2021,  90],
    ["Vegetable", "Carrot", 2020,  50],
    ["Vegetable", "Carrot", 2021,  60],
    ["Vegetable", "Daikon", 2020,  40],
    ["Vegetable", "Daikon", 2021,  45]
];
for (let i = 0; i < data.length; i++) {
    for (let j = 0; j < data[i].length; j++) {
        worksheet.getCells().get(i + 1, j).putValue(data[i][j]);
    }
}
const pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1", true, false);
const pivotTable = worksheet.getPivotTables().get(pivotIndex);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.getDataFields().get(1).setFunction(AsposeCells.ConsolidationFunction.Count);
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, pivotTable.getValuesField());
pivotTable.calculateData();
workbook.save("output_plot.xlsx");

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

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

Aspose.Cells 支持数据透视表中筛选字段的完整生命周期。您可以通过高级便捷 API 或通过低级别的 PageFields 集合来添加筛选字段，并且可以以单选模式驱动页面过滤器、清除它以显示每个筛选项，或者将字段切换为多选模式，以便用户能够通过 Excel 中的复选框 UI 一次选择多个筛选项。

介绍

筛选字段是一种数据透视字段，它控制数据透视表主体显示源数据的哪个子集。最终用户在 Excel 中将其视为已渲染数据透视表顶部的下拉列表，选择可用的筛选项之一后，数据透视表主体会重新构建，以便仅汇总属于该筛选项的记录。当数据透视字段注册为 PivotFieldType.Page 而非 PivotFieldType.Row、PivotFieldType.Column 或 PivotFieldType.Data 时，它就成为筛选字段。筛选字段可以以两种行为运行。在默认的单选行为下，一次仅显示一个筛选项，因此数据透视表主体仅汇总一个子集。在多选行为下，该字段显示一个复选框列表，数据透视表主体汇总所有已勾选筛选项的并集。通过切换单个属性，相同的源字段可以在这些行为之间来回切换。 Aspose.Cells for Node.js via Java 提供了两种等效的方式来注册筛选字段。高级 API 是 pivotTable.addFieldToArea(PivotFieldType.Page, "fieldName")，它接受源列名并在单次调用中添加该字段。低级 API 是 pivotTable.getPageFields().add(PivotField)，当您已经持有 PivotField 引用并希望将同一字段实例添加到筛选区域时使用。这两个 API 最终都会填充相同的 PageFields 集合，本文的其余部分将演示如何在这两者之间进行选择以及如何驱动每种过滤模式。

添加筛选字段

有两种方法可以在筛选区域中注册数据透视字段。高级调用接受源列名称作为字符串，是最常用的路径。低级调用接受现有的 PivotField 实例，当必须在多个数据透视区域中重用同一字段对象时非常方便。这两个调用都会将字段放入 pivotTable.getPageFields()，之后该字段将作为已渲染数据透视表顶部的页面下拉列表显示。

使用 addFieldToArea 添加筛选字段

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

var workbook = new AsposeCells.Workbook();
var worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");
// 设置表头行
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");
// 填充 9 行示例数据：Fruit、Year、Amount
var data = [
    [ "apple", 2020, 100 ],
    [ "banana", 2021, 200 ],
    [ "apple", 2021, 150 ],
    [ "grape", 2020, 120 ],
    [ "orange", 2022, 180 ],
    [ "banana", 2020, 90 ],
    [ "grape", 2021, 130 ],
    [ "apple", 2022, 170 ],
    [ "orange", 2021, 110 ]
];
for (var i = 0; i < data.length; i++)
{
    worksheet.getCells().get(i + 1, 0).putValue(data[i][0]);
    worksheet.getCells().get(i + 1, 1).putValue(data[i][1]);
    worksheet.getCells().get(i + 1, 2).putValue(data[i][2]);
}
// 在单元格 E3 处添加数据透视表
var pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "PivotTable1");
var pivotTable = worksheet.getPivotTables().get(pivotIndex);
// 将字段添加到相应区域：Fruit 作为行字段，Amount 作为数据字段，Year 作为页字段
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");
// 刷新并计算数据透视表数据
pivotTable.calculateData();
// 保存工作簿
workbook.save("pageFieldSample.xlsx");

使用 getPageFields().add 添加筛选字段

当您已经使用 PivotField 实例时，可以将其直接传递给 pivotTable.getPageFields().add。数据透视表和筛选字段的构造方式与前面的场景完全相同；仅最终的筛选区域注册被替换为低级 API 调用。

let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);
// 表头
sheet.getCells().get("A1").putValue("Fruit");
sheet.getCells().get("B1").putValue("Year");
sheet.getCells().get("C1").putValue("Amount");
// 示例数据（9行）
sheet.getCells().get("A2").putValue("apple");    sheet.getCells().get("B2").putValue("2020"); sheet.getCells().get("C2").putValue(100);
sheet.getCells().get("A3").putValue("apple");    sheet.getCells().get("B3").putValue("2021"); sheet.getCells().get("C3").putValue(150);
sheet.getCells().get("A4").putValue("apple");    sheet.getCells().get("B4").putValue("2022"); sheet.getCells().get("C4").putValue(200);
sheet.getCells().get("A5").putValue("grape");    sheet.getCells().get("B5").putValue("2020"); sheet.getCells().get("C5").putValue(300);
sheet.getCells().get("A6").putValue("grape");    sheet.getCells().get("B6").putValue("2021"); sheet.getCells().get("C6").putValue(400);
sheet.getCells().get("A7").putValue("grape");    sheet.getCells().get("B7").putValue("2022"); sheet.getCells().get("C7").putValue(500);
sheet.getCells().get("A8").putValue("blueberry"); sheet.getCells().get("B8").putValue("2020"); sheet.getCells().get("C8").putValue(250);
sheet.getCells().get("A9").putValue("blueberry"); sheet.getCells().get("B9").putValue("2021"); sheet.getCells().get("C9").putValue(350);
sheet.getCells().get("A10").putValue("blueberry");sheet.getCells().get("B10").putValue("2022"); sheet.getCells().get("C10").putValue(450);
// 在E3位置添加数据透视表，覆盖A1:C10
let pivotIndex = sheet.getPivotTables().add("E3", "A1:C10", "PivotTable1");
let pivotTable = sheet.getPivotTables().get(pivotIndex);
// 水果 -> 行，金额 -> 数据（年份将放在下面的页面区域）
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
// 底层方法：从BaseFields中获取现有的年份透视字段
// 并通过PageFields.Add(PivotField)将其注册到页面区域
let yearField = pivotTable.getBaseFields().get("Year");
pivotTable.getPageFields().add(yearField);
// 刷新数据，使新的页面字段在保存的工作簿中生效
pivotTable.calculateData();
workbook.save("output.xlsx");

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

在默认的单选行为下，筛选字段呈现为单个下拉列表，PivotField.CurrentPageItem 整数选择哪个筛选项驱动数据透视表主体。分配特定索引会选取该单项；分配特殊哨兵值 0x7FFD（十进制 32765）会清除过滤器，从而一次性汇总每个筛选项。单选是默认行为；您无需显式启用它。

显示所有项

将 CurrentPageItem 设置为魔术值 0x7FFD 等同于清除页面过滤器，数据透视表主体将汇总每个筛选项，就好像没有应用过滤器一样。

var workbook = new AsposeCells.Workbook();
var sheet = workbook.getWorksheets().get(0);
// 填充 Fruit/Year/Amount 数据
sheet.getCells().get("A1").putValue("Fruit");
sheet.getCells().get("B1").putValue("Year");
sheet.getCells().get("C1").putValue("Amount");
var data = [
    ["Apple", 2022, 100],
    ["Apple", 2023, 150],
    ["Banana", 2022, 80],
    ["Banana", 2023, 120],
    ["Cherry", 2022, 200],
    ["Cherry", 2023, 250]
];
for (var r = 0; r < data.length; r++) {
    for (var c = 0; c < data[r].length; c++) {
        sheet.getCells().get(r + 1, c).putValue(data[r][c]);
    }
}
// 在 E3 创建数据透视表
var pivotTables = sheet.getPivotTables();
var index = pivotTables.add("=A1:C7", "E3", "PivotTable1");
var pivotTable = pivotTables.get(index);
// 配置透视字段：Fruit→行，Amount→数据，Year→页
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");
pivotTable.calculateData();
// 清除页面筛选，以便页面字段中的每个项都可见。
// 0x7FFD（十进制 32765）是表示"所有项"的特殊哨兵值 —
// 相当于在 Excel 的页面字段下拉列表中选择"(全部)"。
pivotTable.getPageFields().get(0).setCurrentPageItem(0x7FFD);
workbook.save("output.xlsx");

显示一个特定项

将 CurrentPageItem 设置为实际索引会仅选取该单个筛选项。该索引是项目在筛选字段排序项列表中的位置，因此例如 1 选择排序后的第二项。

var workbook = new AsposeCells.Workbook();
var sheet = workbook.getWorksheets().get(0);
var cells = sheet.getCells();
// 添加示例数据（水果/年份/金额）
cells.get("A1").setValue("Fruit");
cells.get("B1").setValue("Year");
cells.get("C1").setValue("Amount");
cells.get("A2").setValue("Apple");
cells.get("B2").setValue("2020");
cells.get("C2").setValue("100");
cells.get("A3").setValue("Apple");
cells.get("B3").setValue("2021");
cells.get("C3").setValue("150");
cells.get("A4").setValue("Banana");
cells.get("B4").setValue("2020");
cells.get("C4").setValue("200");
cells.get("A5").setValue("Banana");
cells.get("B5").setValue("2021");
cells.get("C5").setValue("250");
// 在 E3 处添加数据透视表
var pivotTables = sheet.getPivotTables();
var pivotIndex = pivotTables.add("A1:C5", "E3", "PivotTable1");
var pivotTable = pivotTables.get(pivotIndex);
// 添加字段：水果→行，金额→数据，年份→页
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");
// 页字段特定操作
pivotTable.getPageFields().get(0).setCurrentPageItem(1); // 1 = 排序顺序中的第二项（例如"2021"）
// 刷新并计算数据透视表
pivotTable.calculateData();
workbook.save("output.xlsx");

多选过滤

多选过滤将页面下拉列表转换为复选框列表，并允许最终用户同时选择多个筛选项。Aspose.Cells 公开了两个协同工作的属性。必须先将 PivotField.IsMultipleItemSelectionAllowed 设置为 true，多选 UI 才会生效。启用后，PivotItem.IsHidden 控制哪些项出现在复选框列表中，因此您可以显示每个项或仅将特定项加入白名单。以下代码在场景 1a 中构建的同一 Year 筛选字段上启用多选，然后展示两种模式：Part A 通过将每个条目的 IsHidden 设置为 false 来显示每个筛选项，而 Part B 通过 switch (pivotItems[i].getStringValue()) 块仅将您选择的源值加入白名单并隐藏其他所有项。

const AsposeCells = require("aspose.cells");
// — 数据透视表和页面字段的构建与场景 1a 完全相同
//   （水果/年份/金额数据，数据透视表位于 E3，水果→行，
//   金额→数据，年份→通过 AddFieldToArea 设置为页面字段）。
//   下面我们在页面字段上应用多选过滤。
const workbook = new AsposeCells.Workbook();
const sheet = workbook.getWorksheets().get(0);
const cells = sheet.getCells();
// 示例数据：水果 | 年份 | 金额
cells.get(0, 0).putValue("Fruit");
cells.get(0, 1).putValue("Year");
cells.get(0, 2).putValue("Amount");
const data = [
    ["apple",  "2019", "100"],
    ["apple",  "2020", "150"],
    ["apple",  "2021", "200"],
    ["banana", "2019", "110"],
    ["banana", "2020", "160"],
    ["banana", "2021", "210"],
    ["grape",  "2019", "120"],
    ["grape",  "2020", "170"],
    ["grape",  "2021", "220"]
];
for (let i = 0; i < data.length; i++) {
    cells.get(i + 1, 0).putValue(data[i][0]);
    cells.get(i + 1, 1).putValue(parseInt(data[i][1]));
    cells.get(i + 1, 2).putValue(parseInt(data[i][2]));
}
const pivotSheet = workbook.getWorksheets().add("Pivot");
const pivots = pivotSheet.getPivotTables();
const pivotIndex = pivots.add("E3", "A1:C10", "PivotTable1");
const pivotTable = pivots.get(pivotIndex);
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.ROW, "Fruit");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.DATA, "Amount");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.PAGE, "Year");
// — 在页面字段上启用多选
pivotTable.getPageFields().get(0).setMultipleItemSelectionAllowed(true);
// 部分 A — 选择所有项目（使每个项目可见）
const pivotItems = pivotTable.getPageFields().get(0).getPivotItems();
for (let i = 0; i < pivotItems.getCount(); i++) {
    pivotItems.get(i).setHidden(false);
}
// 部分 B — 仅按源值选择特定项目
for (let i = 0; i < pivotItems.getCount(); i++) {
    switch (pivotItems.get(i).getStringValue()) {
        case "2020":
        case "grape":
        case "blueberry":
            pivotItems.get(i).setHidden(false);
            break;
        default:
            pivotItems.get(i).setHidden(true);
            break;
    }
}
pivotTable.calculateData();
workbook.save("output.xlsx");

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

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

下表总结了何时使用每个 API 和模式，以便您无需详细阅读每个场景即可选择正确的组合。

场景 / 用例	推荐 API	使用的属性	备注
按源列名添加筛选字段（最常见）	`pivotTable.addFieldToArea(PivotFieldType.Page, "fieldName")`	n/a	高级单行 API。除非需要 `PivotField` 引用，否则请使用此方法。
在已拥有 `PivotField` 对象时添加筛选字段	`pivotTable.getPageFields().add(PivotField)`	n/a	当字段对象是从其他位置获取或需要重用时使用。
过滤到单个筛选项（默认模式）	`PivotField.CurrentPageItem`	设置为特定索引	例如，`1` 显示排序列表中的第二项。
显示所有项 / 清除页面过滤器	`PivotField.CurrentPageItem`	设置为 `0x7FFD`	魔术值 `0x7FFD`（十进制 32765）是 “所有项” 的哨兵值。
在 Excel 中启用多选 UI	`PivotField.IsMultipleItemSelectionAllowed`	设置为 `true`	在任何 `IsHidden` 调用生效之前必需。
在多选列表中隐藏 / 显示各个项	`PivotItem.IsHidden`	按项设置	至少必须保留一项可见（`IsHidden == false`）。

配置多选过滤时，请始终记住可见性约束。如果多选筛选字段中的每个 PivotItem 都被隐藏，Excel 在打开时崩溃或呈现空白的数据透视表。根据源数据构建您的白名单，使至少一项保持可见，这样您保存的工作簿将在每台机器上可靠地打开。

Documentation – 插入数据透视表

Nodejsjava: 在 Aspose.Cells for Node.js via Java 中为数据透视表应用样式

简介

应用传统 XLS 预设自动格式

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

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

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

应该使用哪种样式 API?

Nodejsjava: 在 Aspose.Cells for Node.js via Java 中刷新数据透视表和数据透视缓存

简介

快速入门

必需的导入

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

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

刷新单个数据透视表

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

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

从过时的 PivotTable.RefreshData() 迁移

我应该使用哪种刷新 API？

常见陷阱

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

将字段添加到行或列区域

数据透视字段小计

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

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

场景 3 — 自定义小计子集(总和 + 平均值)

回顾

Nodejsjava: Aspose.Cells for Node.js via Java 中的值字段

将字段添加到数据区域

更改汇总函数

将值字段绘制到行或列轴上

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

介绍

添加筛选字段

使用 addFieldToArea 添加筛选字段

使用 getPageFields().add 添加筛选字段

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

显示所有项

显示一个特定项

多选过滤

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

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

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

从过时的 `PivotTable.RefreshData()` 迁移