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

有时用户需要指定数据透视项的绝对位置，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个位置。

//For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
const AsposeCells = require("aspose.cells.node");

var wb = new AsposeCells.Workbook("source.xlsx");
var wsPivot = wb.getWorksheets().add("pvtNew Hardware");
var wsData = wb.getWorksheets().get("New Hardware - Yearly");

// Get the pivottables collection for the pivot sheet
var pivotTables = wsPivot.getPivotTables();

// Add PivotTable to the worksheet
var index = pivotTables.add("='New Hardware - Yearly'!A1:D621", "A3", "HWCounts_PivotTable");

// Get the PivotTable object
var pvtTable = pivotTables.get(index);

// Add vendor row field
pvtTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Vendor");

// Add item row field
pvtTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");

// Add data field
pvtTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "2014");

// Turn off the subtotals for the vendor row field
var pivotField = pvtTable.getRowFields().get("Vendor");
pivotField.setSubtotals(AsposeCells.PivotFieldSubtotalType.None, true);

// Turn off grand total
pvtTable.setColumnGrand(false);

/*
 * Please call the PivotTable.refreshData() and PivotTable.calculateData()
 * before using PivotItem.setPosition,
 * PivotItem.setPositionInSameParentNode and PivotItem.move methods.
*/
pvtTable.refreshData();
pvtTable.calculateData();

pvtTable.getRowFields().get("Item").getPivotItems().get("4H12").setPositionInSameParentNode(0);
pvtTable.getRowFields().get("Item").getPivotItems().get("DIF400").setPositionInSameParentNode(3);

/* 
 * As a result of using PivotItem.setPositionInSameParentNode,
 * it will change the original sort sequence.
 * So when you use PivotItem.setPositionInSameParentNode in another parent node.
 * You need call the method named "calculateData" again. 
*/
pvtTable.calculateData();

pvtTable.getRowFields().get("Item").getPivotItems().get("CA32").setPositionInSameParentNode(1);
pvtTable.getRowFields().get("Item").getPivotItems().get("AAA3").setPositionInSameParentNode(2);

// Save file
wb.save("output_out.xlsx");

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