Documentation – 在 Aspose.Cells for Node.js via C++ 中添加数据透视表的行字段和列字段

Nodejscpp: 按标签或值筛选数据透视表

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

Aspose.Cells 提供了五种实用的策略来筛选数据透视表中显示的数据。您可以对基于文本的行或列字段应用标签筛选，在字段仅包含日期时间单元格或空白时使用日期筛选，对汇总数字应用值筛选，使用前 10 项筛选按值字段排序，或者使用 IsHidden 属性手动隐藏和取消隐藏各个透视项。每种策略都通过 PivotField 和 PivotItem 类上的专用 API 公开。

简介

数据透视表是强大的分析工具，但原始汇总通常包含的信息远多于您需要呈现的内容。筛选是将数据透视表缩小到特定报告中重要的行、列或值的主要机制。Aspose.Cells for Node.js via C++ 镜像了 Microsoft Excel 中可用的筛选功能，并通过编程方式公开这些功能，以便完全自动化生成报告。

本文涵盖以下筛选策略：

标签筛选 — 根据文本标签筛选行或列字段项。
日期筛选 — 筛选仅包含日期时间值（或空白）的行或列字段。
值筛选 — 根据数据字段的汇总值筛选项。
前 10 项筛选 — 仅显示按值字段排序的前 N 项或后 N 项。
隐藏/取消隐藏透视项 — 手动控制字段中各个项的可见性。

每种方法都使用 PivotField 类上的不同方法或 PivotItem 类上的属性。应用任何筛选后，您必须在数据透视表上调用 refreshData() 和 calculateData()，以便缓存数据和计算值反映新的筛选状态。

标签筛选

标签筛选允许您通过将文本标题与模式进行比较来筛选行或列字段的项。当您只想显示名称以特定字母开头、包含特定单词或匹配其他基于标题条件的项时，这非常有用。

Aspose.Cells 通过 PivotField.filterByLabel(PivotFilterType, string) 方法公开标签筛选。PivotFilterType 枚举包括 CaptionBeginsWith、CaptionContains、CaptionEndsWith、CaptionDoesNotContain、CaptionIsNotBlank、CaptionIsBlank 等值。第二个参数提供用于比较的标签字符串。

以下示例加载包含现有数据透视表的工作簿，应用标签筛选以使仅标题以指定前缀开头的项保持可见，刷新数据透视表，并保存结果。

let fileName = "sample.xlsx";
let prefix = "B";

// 加载包含数据透视表的现有工作簿
let workbook = new AsposeCells.Workbook(fileName);

// 按索引访问工作表（第一个工作表）
let worksheet = workbook.getWorksheets().get(0);

// 按索引访问数据透视表
let pivotTable = worksheet.getPivotTables().get(0);

// 获取第一个行数据透视字段
let rowField = pivotTable.getRowFields().get(0);

// 应用标签筛选器——仅显示标签以所提供前缀开头的行项
rowField.filterByLabel(AsposeCells.PivotFilterType.CaptionBeginsWith, prefix, "");

// 刷新并重新计算数据透视表数据，使筛选器生效
pivotTable.getPivotCache().refresh();

// 将工作簿保存回磁盘
workbook.save(fileName);

日期筛选

日期筛选允许您按基于日期的条件（如今天、上周、本月、下季度或特定日期范围）缩小数据透视表。它们是专门的筛选，仅适用于存储日期时间信息的字段。

日期筛选仅在行或列区域仅包含日期时间单元格或空白值时才有效。如果基础字段包含其他数据类型（如数字或文本），则日期筛选将无法产生预期结果。在应用此筛选之前，请确保字段格式化为日期，并且所有值都是有效的 DateTime 实例或空单元格。

Aspose.Cells 通过 PivotField.filterByDate(PivotFilterType, params DateTime[] values) 方法公开日期筛选。PivotFilterType 枚举包含专门的日期值，如 Today、Yesterday、LastWeek、ThisWeek、NextWeek、LastMonth、ThisMonth、NextMonth、LastQuarter、ThisQuarter、NextQuarter、LastYear、ThisYear、NextYear 和 Between。根据所选的筛选类型，您传递一个或两个 DateTime 值（对于 Between，传递开始和结束日期）。

以下示例加载一个工作簿，其数据透视表的行区域包含日期字段，应用日期筛选将可见项限制为特定日期范围，刷新数据透视表，并保存工作簿。

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

const inputPath = "sample.xlsx";
const outputPath = "output_filtered.xlsx";

if (!fs.existsSync(inputPath))
{
    throw new Error("源工作簿未找到: " + inputPath);
}

// 加载包含数据透视表的现有工作簿
const workbook = new AsposeCells.Workbook(inputPath);

// 通过索引访问包含数据透视表的工作表
const worksheet = workbook.getWorksheets().get(0);

// 通过索引访问数据透视表
const pivotTable = worksheet.getPivotTables().get(0);

// 从行区域获取日期透视字段
// (日期筛选仅在行/列区域仅包含日期时间单元格或空白时有效)
const dateField = pivotTable.getRowFields().get(0);

// 定义 Between 筛选器的日期条件
const startDate = new Date(2020, 0, 1);
const endDate = new Date(2020, 11, 31);

// 在透视字段上应用日期筛选
dateField.filterByDate(AsposeCells.PivotFilterType.DateBetween, startDate, endDate);

// 刷新并重新计算数据透视表以使筛选生效
pivotTable.getPivotCache().refresh();

// 保留工作簿
workbook.save(outputPath);

值筛选

值筛选对数据透视表在其数据区域中计算的汇总值进行操作。它们不是匹配文本标签，而是将数字总数与阈值进行比较。典型用例包括仅显示销售总额超过目标金额的产品，或仅显示交易计数在某个范围内的区域。

Aspose.Cells 通过 PivotField.filterByValue(PivotField valueField, PivotFilterType filterType, params object[] values) 方法公开值筛选。filterType 参数使用 ValueGreaterThan、ValueLessThan、ValueBetween、ValueEqual、ValueNotEqual、ValueGreaterThanOrEqual 和 ValueLessThanOrEqual 等值。valueField 参数指定应评估哪个数据字段，最后一个参数提供阈值。

以下示例加载一个包含数据透视表的工作簿，应用值筛选仅保留汇总销售超过数字阈值的项，刷新数据透视表，并保存工作簿。

let dataFieldIndex = -1;
for (let i = 0; i < pivotTable.getDataFields().getCount(); i++) {
    if (pivotTable.getDataFields().get(i) === dataField) {
        dataFieldIndex = i;
        break;
    }
}

if (dataFieldIndex >= 0) {
    rowField.filterByValue(dataFieldIndex, AsposeCells.PivotFilterType.ValueGreaterThan, 5000, Number.MAX_VALUE);
}

pivotTable.getPivotCache().refresh();

workbook.save("output.xlsx");

前 10 项筛选

前 10 项筛选是值筛选的一种专门形式，仅基于所选值字段保留最高或最低的 N 个项。它通常用于排名报告，例如"按收入排名前 10 位的产品"或"按销售数量排名后 5 位的区域"。

前 10 项筛选仅在数据透视表的数据区域中有一个或多个值透视字段时才有效。如果没有至少一个值字段，则没有可汇总的度量来对项进行排序，因此无法应用筛选。

Aspose.Cells 通过 PivotField.filterTop10(int itemCount, bool isTop, PivotField valueField, PivotFilterType filterType) 方法公开前 10 项筛选。itemCount 参数定义要保留的项数，isTop 指示是否保留前项（true）或后项（false），valueField 引用用于排序的数据字段，filterType 控制如何计算值（通常为 Sum，但也可以是 Count 和 Percent）。

以下示例加载一个包含数据透视表的工作簿，该数据透视表包含一个值字段，应用前 10 项筛选以仅按销售总和保留最高的 10 个项，刷新数据透视表，并保存工作簿。

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

// 加载包含数据透视表的现有工作簿
const inputPath = "input.xlsx";
const outputPath = "output.xlsx";
const workbook = new AsposeCells.Workbook(inputPath);

// 访问包含数据透视表的工作表（索引 0）
const worksheet = workbook.getWorksheets().get(0);

// 按索引访问数据透视表
const pivotTable = worksheet.getPivotTables().get(0);

// 确认数据区域中至少有一个值 PivotField
if (pivotTable.getDataFields().getCount() === 0) {
    throw new Error("数据透视表没有值（数据）PivotField。");
}
const valueField = pivotTable.getDataFields().get(0);

// 获取目标行 PivotField（我们想要对其应用前 10 筛选的字段）
const rowField = pivotTable.getRowFields().get(0);

// 第一个（也是唯一的）数据字段位于索引 0；前 10 按它进行排名。
const valueFieldIndex = 0;

// 对行字段应用前 10 筛选：
//   - itemCount   = 10
//   - filterType  = PivotFilterType.Sum
//   - isTop       = true（前 N；false 表示后 N）
//   - valueFieldIndex = 用于对项进行排名的数据字段的索引
rowField.filterTop10(10, AsposeCells.PivotFilterType.Sum, true, valueFieldIndex);

// 刷新数据透视表数据并重新计算，以使筛选生效
pivotTable.getPivotTableCache().refresh();

// 保存工作簿
workbook.save(outputPath);

通过隐藏或取消隐藏透视项进行筛选

除了结构化筛选 API 之外，Aspose.Cells 还允许您直接控制每个透视项的可见性。通过迭代 PivotField 的 PivotItems 集合并切换 IsHidden 属性，您可以选择性地抑制特定项而无需应用基于公式的筛选。设置 IsHidden = true 会从数据透视表中隐藏该项；设置 IsHidden = false 会取消隐藏该项并使其再次可见。

当筛选规则不规则或特定于项时，此方法很有用，例如隐藏少量不应出现在特定报告中的已命名类别。下面的示例加载一个数据透视表，按名称隐藏特定项，演示如何取消隐藏它，刷新数据透视表，并保存工作簿。

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

// 加载包含数据透视表的现有工作簿
const workbook = new AsposeCells.Workbook("pivot_table_sample.xlsx");

// 访问包含数据透视表的第一个工作表
const sheet = workbook.getWorksheets().get(0);

// 通过索引访问数据透视表（工作表上的第一个数据透视表）
const pivotTable = sheet.getPivotTables().get(0);

// 检索目标 PivotField（我们将对其中的项进行隐藏/取消隐藏的第一个行标签字段）
const pivotField = pivotTable.getRowFields().get(0);

// 遍历所选 PivotField 的 PivotItems 集合
const itemCount = pivotField.getPivotItems().getCount();
for (let i = 0; i < itemCount; i++)
{
    const item = pivotField.getPivotItems().get(i);

    // 隐藏符合特定名称/条件的数据透视项
    if (item.getName() == "Item1" || item.getName() == "Item2")
    {
        item.setIsHidden(true);
    }

    // 演示取消隐藏：重新显示先前隐藏的数据透视项
    if (item.getName() == "Item3")
    {
        item.setIsHidden(false);
    }
}

// 刷新并重新计算数据透视表以使更改生效
pivotTable.getPivotCache().refreshData();

// 保存工作簿 — 隐藏的项保留在底层数据中
// 但会从显示的数据透视表输出中排除
workbook.save("output_pivot_filtered.xlsx");

总结

Aspose.Cells for Node.js via C++ 提供了一套完整的数据透视表筛选功能，与 Microsoft Excel 中的功能相匹配。标签、日期和值筛选涵盖了最常见的分析场景，而前 10 项筛选处理排名报告。当筛选规则不规则时，PivotItem.IsHidden 属性提供灵活的项级后备。结合这些策略 — 例如，应用标签筛选然后隐藏特定项 — 您可以完全通过代码构建精确针对的数据透视表报告。

Aspose.Cells provides five practical strategies for filtering the data displayed in a pivot table…

let fileName = "sample.xlsx";
let prefix = "B";

// 加载包含数据透视表的现有工作簿
let workbook = new AsposeCells.Workbook(fileName);

// 按索引访问工作表（第一个工作表）
let worksheet = workbook.getWorksheets().get(0);

// 按索引访问数据透视表
let pivotTable = worksheet.getPivotTables().get(0);

// 获取第一个行数据透视字段
let rowField = pivotTable.getRowFields().get(0);

// 应用标签筛选器——仅显示标签以所提供前缀开头的行项
rowField.filterByLabel(AsposeCells.PivotFilterType.CaptionBeginsWith, prefix, "");

// 刷新并重新计算数据透视表数据，使筛选器生效
pivotTable.getPivotCache().refresh();

// 将工作簿保存回磁盘
workbook.save(fileName);javascript
const AsposeCells = require("aspose.cells");
const fs = require("fs");

const inputPath = "sample.xlsx";
const outputPath = "output_filtered.xlsx";

if (!fs.existsSync(inputPath))
{
    throw new Error("源工作簿未找到: " + inputPath);
}

// 加载包含数据透视表的现有工作簿
const workbook = new AsposeCells.Workbook(inputPath);

// 通过索引访问包含数据透视表的工作表
const worksheet = workbook.getWorksheets().get(0);

// 通过索引访问数据透视表
const pivotTable = worksheet.getPivotTables().get(0);

// 从行区域获取日期透视字段
// (日期筛选仅在行/列区域仅包含日期时间单元格或空白时有效)
const dateField = pivotTable.getRowFields().get(0);

// 定义 Between 筛选器的日期条件
const startDate = new Date(2020, 0, 1);
const endDate = new Date(2020, 11, 31);

// 在透视字段上应用日期筛选
dateField.filterByDate(AsposeCells.PivotFilterType.DateBetween, startDate, endDate);

// 刷新并重新计算数据透视表以使筛选生效
pivotTable.getPivotCache().refresh();

// 保留工作簿
workbook.save(outputPath);javascript
let dataFieldIndex = -1;
for (let i = 0; i < pivotTable.getDataFields().getCount(); i++) {
    if (pivotTable.getDataFields().get(i) === dataField) {
        dataFieldIndex = i;
        break;
    }
}

if (dataFieldIndex >= 0) {
    rowField.filterByValue(dataFieldIndex, AsposeCells.PivotFilterType.ValueGreaterThan, 5000, Number.MAX_VALUE);
}

pivotTable.getPivotCache().refresh();

workbook.save("output.xlsx");javascript
const AsposeCells = require("aspose.cells");

// 加载包含数据透视表的现有工作簿
const inputPath = "input.xlsx";
const outputPath = "output.xlsx";
const workbook = new AsposeCells.Workbook(inputPath);

// 访问包含数据透视表的工作表（索引 0）
const worksheet = workbook.getWorksheets().get(0);

// 按索引访问数据透视表
const pivotTable = worksheet.getPivotTables().get(0);

// 确认数据区域中至少有一个值 PivotField
if (pivotTable.getDataFields().getCount() === 0) {
    throw new Error("数据透视表没有值（数据）PivotField。");
}
const valueField = pivotTable.getDataFields().get(0);

// 获取目标行 PivotField（我们想要对其应用前 10 筛选的字段）
const rowField = pivotTable.getRowFields().get(0);

// 第一个（也是唯一的）数据字段位于索引 0；前 10 按它进行排名。
const valueFieldIndex = 0;

// 对行字段应用前 10 筛选：
//   - itemCount   = 10
//   - filterType  = PivotFilterType.Sum
//   - isTop       = true（前 N；false 表示后 N）
//   - valueFieldIndex = 用于对项进行排名的数据字段的索引
rowField.filterTop10(10, AsposeCells.PivotFilterType.Sum, true, valueFieldIndex);

// 刷新数据透视表数据并重新计算，以使筛选生效
pivotTable.getPivotTableCache().refresh();

// 保存工作簿
workbook.save(outputPath);javascript
const AsposeCells = require("aspose.cells");

// 加载包含数据透视表的现有工作簿
const workbook = new AsposeCells.Workbook("pivot_table_sample.xlsx");

// 访问包含数据透视表的第一个工作表
const sheet = workbook.getWorksheets().get(0);

// 通过索引访问数据透视表（工作表上的第一个数据透视表）
const pivotTable = sheet.getPivotTables().get(0);

// 检索目标 PivotField（我们将对其中的项进行隐藏/取消隐藏的第一个行标签字段）
const pivotField = pivotTable.getRowFields().get(0);

// 遍历所选 PivotField 的 PivotItems 集合
const itemCount = pivotField.getPivotItems().getCount();
for (let i = 0; i < itemCount; i++)
{
    const item = pivotField.getPivotItems().get(i);

    // 隐藏符合特定名称/条件的数据透视项
    if (item.getName() == "Item1" || item.getName() == "Item2")
    {
        item.setIsHidden(true);
    }

    // 演示取消隐藏：重新显示先前隐藏的数据透视项
    if (item.getName() == "Item3")
    {
        item.setIsHidden(false);
    }
}

// 刷新并重新计算数据透视表以使更改生效
pivotTable.getPivotCache().refreshData();

// 保存工作簿 — 隐藏的项保留在底层数据中
// 但会从显示的数据透视表输出中排除
workbook.save("output_pivot_filtered.xlsx");

总结

Nodejscpp: 指定数据透视项的绝对位置

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

有时用户需要指定数据透视项的绝对位置，Aspose.Cells for Node.js via C++ API提供了几个新属性和一个方法以满足此需求。

添加了PivotItem.setPosition属性，可用于指定所有数据透视项的位置索引，而不论父节点如何。添加了PivotItem.setPositionInSameParentNode属性，可用于指定在同一父节点下的数据透视项的位置索引。
添加了PivotItem.move方法，以根据计数值将项上移或下移，其中计数是要将数据透视项上移或下移的位置数。如果计数值小于零，则数据透视项将上移，如果计数值大于零，则数据透视项将下移，Boolean类型的isSameParent参数指定移动操作是否必须在同一父节点中执行。
已废弃*PivotItem.move(int count)*方法，建议使用新增的方法 PivotItem.move(number, boolean)。

以下示例代码创建了一个数据透视表，然后指定了数据透视项在同一父节点中的位置。您可以下载源Excel和输出Excel文件进行参考。如果打开输出Excel文件，您将看到数据透视项“4H12”位于父节点“K11”中的第0个位置，而“DIF400”位于第3个位置。同样，CA32位于第1个位置，AAA3位于第2个位置。

请注意，在使用PivotItem.setPosition、PivotItem.setPositionInSameParentNode属性和PivotItem.move方法之前，必须先调用PivotTable.RefreshData和PivotTable.CalculateData方法。

Nodejscpp: 根据数据透视表的PivotField显示名称获取单元格对象

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

Aspose.Cells for Node.js via C++提供PivotTable.getCellByDisplayName(string)方法，可以通过显示名称访问数据透视表字段的单元格对象。当你想突出显示或格式化数据透视字段标题时，此方法非常有用。本文介绍如何通过数据字段的显示名称检索单元格对象，并对其应用格式。

如何通过数据透视表的PivotField的DisplayName获取Cell对象

以下代码访问工作表的第一个透视表，然后通过透视表的第二个数据字段的显示名称获取单元格。然后将单元格的填充颜色和字体颜色分别更改为浅蓝色和黑色。下面的屏幕截图显示了代码执行之前和之后透视表的外观。

透视表 - 在之前

透视表 - 在之后

Nodejscpp: 在透视表中对透视字段进行分组

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

可能的使用场景

微软Excel允许对数据透视表的字段进行分组。当有大量与某字段相关的数据时，将它们分成不同的段通常非常有用。Aspose.Cells for Node.js via C++同样支持此功能，使用 PivotTable.groupBy() 方法。

在数据透视表中对字段进行分组

以下示例代码加载示例Excel文件，并使用PivotTable.groupBy()方法对第一个透视字段执行分组。然后刷新和计算透视表的数据，并将工作簿保存为输出Excel文件。屏幕截图显示了示例代码对示例Excel文件的效果。如屏幕截图所示，第一个透视字段现在按月份和季度分组。

示例代码

Nodejscpp: 数据透视表隐藏和排序数据

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

数据透视表隐藏和排序数据

Aspose.Cells for Node.js via C++支持在数据透视表中隐藏和排序数据。以下代码示例展示了如何按降序排序Score列，并隐藏分数低于60的行。

示例代码中使用的源和输出Excel文件已附上供参考。

源文件

输出文件

Nodejscpp: 在数据透视表中添加筛选器

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

可能的使用场景

当你创建了已知数据的数据透视表并想筛选数据透视表时，你需要学习并使用筛选器。它可以帮助你有效筛选出所需数据。使用Aspose.Cells for Node.js via C++ API，你可以在字段值上添加筛选器。

在数据透视表中添加筛选器使用Aspose.Cells for Node.js via C++

请参阅以下示例代码。它设置数据并基于它创建数据透视表。然后在数据透视表的行字段上添加筛选器。最后，以[filterout.xlsx]格式保存工作簿。执行示例代码后，工作表中将添加一个带有Top10筛选器的数据透视表。

示例代码

Nodejscpp: 数据透视表中的自定义排序

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

如何使用 Aspose.Cells for Node.js via C++ 设置自定义排序在数据透视表中

通过使用 Aspose.Cells for Node.js via C++ API，可以对数据透视表中的字段值进行排序。下面的代码片段加载示例Excel文件并添加了三个数据透视表。第一个没有自定义排序，第二个是基于“SeaFood”行字段值排序，第三个是基于“28/07/2000”列字段值排序。

可从此处下载示例源文件和输出文件以测试示例代码：

源Excel文件

输出Excel文件

输出PDF文件

示例代码

Nodejscpp: 清除数据透视表中的筛选器

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

可能的使用场景

当你创建了已知数据的数据透视表并想筛选数据时，你需要学习并使用筛选器。它可以帮助你有效筛选出所需数据。使用Aspose.Cells for Node.js via C++ API，你可以对数据透视表中的字段值进行筛选。

如何在Excel中清除数据透视表中的筛选器

在 Excel 中清除数据透视表中的筛选，按照以下步骤操作：

选择要清除筛选的数据透视表。
单击数据透视表中要清除筛选的下拉箭头。
从下拉菜单中选择“清除筛选”。
如果您要清除数据透视表中的所有筛选，还可以在 Excel 的“数据透视表分析”选项卡上单击“清除筛选”按钮。

如何使用Aspose.Cells for Node.js via C++清除数据透视表中的筛选器。

使用Aspose.Cells for Node.js via C++清除数据透视表中的筛选器。请参见下面的示例代码。

设置数据并创建基于该数据的数据透视表。
在数据透视表的行字段上添加筛选。
以 output XLSX 格式保存工作簿。执行示例代码后，将在工作表中添加带有 top10 筛选的数据透视表。
清除特定数据透视字段上的筛选。执行清除筛选的代码后，将清除特定数据透视字段上的筛选。请检查 output XLSX。

Documentation – 在 Aspose.Cells for Node.js via C++ 中添加数据透视表的行字段和列字段

Nodejscpp: 按标签或值筛选数据透视表

简介

标签筛选

日期筛选

值筛选

前 10 项筛选

通过隐藏或取消隐藏透视项进行筛选

总结

总结

Nodejscpp: 指定数据透视项的绝对位置

Nodejscpp: 根据数据透视表的PivotField显示名称获取单元格对象

如何通过数据透视表的PivotField的DisplayName获取Cell对象

Nodejscpp: 在透视表中对透视字段进行分组

可能的使用场景

在数据透视表中对字段进行分组

示例代码

Nodejscpp: 数据透视表隐藏和排序数据

数据透视表隐藏和排序数据

Nodejscpp: 在数据透视表中添加筛选器

可能的使用场景

在数据透视表中添加筛选器 使用Aspose.Cells for Node.js via C++

示例代码

Nodejscpp: 数据透视表中的自定义排序

如何使用 Aspose.Cells for Node.js via C++ 设置自定义排序在数据透视表中

示例代码

Nodejscpp: 清除数据透视表中的筛选器

可能的使用场景

如何在Excel中清除数据透视表中的筛选器

如何使用Aspose.Cells for Node.js via C++清除数据透视表中的筛选器。

示例代码

在数据透视表中添加筛选器使用Aspose.Cells for Node.js via C++