GETPIVOTDATA

此函数从数据透视表返回可见数据。它查询数据透视表并根据数据透视表结构获取特定数据，而不是单元格引用。使用此函数的主要优点是它确保返回正确的数据，即使数据透视表布局发生变化。

语法

=GETPIVOTDATA(data_field, pivot_table, [field1, item1, field2, item2], ...)

参数

此函数具有以下参数：

用法

您可以通过在要返回值的单元格中使用 =（等号）来输入 GETPIVOTDATA 函数。您也可以将此功能与其他功能一起使用。

备注：

使用 GETPIVOTTABLE 函数时，注意以下几点：

• #REF! 在以下情况下会出现错误值：- 如果给定的 pivot_table 引用与数据透视表无关。

• 如果提供了 data_field、[field] 或 [item] 参数的无效字段。

• 如果参数不描述可见字段，或者它们包含不显示筛选数据的报表筛选。

• 当有 sigma 值时，data_field 将包含 calc 类型，否则将仅使用字段名称。

返回值

从数据透视表返回可见数据。

示例

下图显示了 GETPIVOTDATA 函数的用法。

以下示例代码显示了 GETPIVOTDATA 函数的用法。

$(document).ready(function () {
     // 初始化Spread
     var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), { sheetCount: 2 });
     spread.suspendPaint();
     // 获取表
     var pivotLayoutSheet = spread.getSheet(0);
     var dataSourceSheet = spread.getSheet(1);
     // 设置表名称
     pivotLayoutSheet.name("PivotLayout");
     dataSourceSheet.name("DataSource");
     // 设置行数
     dataSourceSheet.setRowCount(245);
     // 设置数据源
     dataSourceSheet.setArray(0, 0, pivotDB_UseCase);
     // table中添加数据源
     dataSourceSheet.tables.add('tableSales', 0, 0, 245, 8);
     spread.resumePaint();
     // 初始化数据透视表
     initPivotTable(pivotLayoutSheet);
     // 自动调整两个工作表中的列
     autoFit(pivotLayoutSheet);
     autoFit(dataSourceSheet);
 });

 function initPivotTable(sheet) {
     //添加数据透视表
     var myPivotTable = sheet.pivotTables.add("myPivotTable", "tableSales", 0, 0, GC.Spread.Pivot.PivotTableLayoutType.tabular, GC.Spread.Pivot.PivotTableThemes.dark3);
     myPivotTable.suspendLayout();
     //显示数据透视表的 rowHeader 和 columnHeader
     myPivotTable.options.showRowHeader = true;
     myPivotTable.options.showColumnHeader = true;
     // 添加列字段
     myPivotTable.add("Category", "Category", GC.Spread.Pivot.PivotTableFieldType.columnField);
     // 添加行字段
     myPivotTable.add("Region", "Region", GC.Spread.Pivot.PivotTableFieldType.rowField);
     myPivotTable.add("City", "City", GC.Spread.Pivot.PivotTableFieldType.rowField);
     // 添加 SubtotalType Sum
     myPivotTable.add("Quantity", "Sum of quantity", GC.Spread.Pivot.PivotTableFieldType.valueField, GC.Pivot.SubtotalType.sum);
     // 添加筛选字段
     myPivotTable.add("OrderDate", "OrderDate", GC.Spread.Pivot.PivotTableFieldType.filterField);
          
     var formula1 = '=GETPIVOTDATA("Quantity",$A$3)';
     sheet.setValue(3, 10, 'Total Quantity');
     sheet.setStyle(3, 10, 'introSec');
     sheet.setFormula(3, 11, formula1);

     var formula2 = '=GETPIVOTDATA("Quantity",$A$3,"Category","Bakery")';
     sheet.setValue(4, 10, 'Total Bakery Quantity');
     sheet.setStyle(4, 10, 'introSec');
     sheet.setFormula(4, 11, formula2);

     var formula3 = '=GETPIVOTDATA("Quantity",$A$3,"Region","West")';
     sheet.setValue(5, 10, 'West Region');
     sheet.setStyle(5, 10, 'introSec');
     sheet.setFormula(5, 11, formula3);

     var formula4 = '=GETPIVOTDATA("Quantity",$A$3,"Region","East","City","Jersey")';
     sheet.setValue(6, 10, 'Quantity in Jersey');
     sheet.setStyle(6, 10, 'introSec');
     sheet.setFormula(6, 11, formula4);
     myPivotTable.resumeLayout();
     return myPivotTable;
 }

 function autoFit(sheet) {
     // 自动调整列
     let columnCount = sheet.getColumnCount();
     for (let i = 0; i < columnCount; i++) {
         sheet.autoFitColumn(i);
            }
        }

GETPIVOTDATA 函数还支持溢出，这意味着它可以使用其结果填充多个单元格。 但是， allowDynamicArray 属性应设置为 true 以观察溢出结果。 下图显示了一个数据透视表，它将用于使用 GETPIVOTDATA 函数提取一些有意义的结果。

下图显示了在上述数据透视表中使用 GETPIVOTDATA 函数 结果溢出到多个单元格时的输出。

以下示例代码显示了使用 GETPIVOTDATA 函数获取溢出到多个单元格的结果;

function setGetPivotDataFunction(sheet) {
    spread.options.allowDynamicArray = true;
    var formula = '=GETPIVOTDATA("Sum of quantity",$B$2,"City",{"Jersey";"San Francisco";"Seattle";"Washington, DC"},"Category",C11:C14,"Qt",E3:F3)';
    sheet.setStyle(1, 9, 'introSec');
    sheet.addSpan(1, 9, 2, 8, GC.Spread.Sheets.SheetArea.viewport);
    sheet.setValue(1, 9, 'Returns the spill range of total Bakery, Beverages, Chocolates and Snacks quantity sold in Jersey, San Francisco, Seattle and Washington, DC respectively in the Qtr2 & Qtr3');
    sheet.getCell(1, 9).wordWrap(true);
    sheet.setStyle(4, 9, 'formula');
    sheet.addSpan(4, 9, 2, 8, GC.Spread.Sheets.SheetArea.viewport);
    sheet.getCell(4, 9).wordWrap(true);
    sheet.setValue(4, 9, formula);
    sheet.setFormula(7, 9, formula);
}