Указание абсолютного положения элемента сводной таблицы

Иногда пользователю необходимо указать абсолютное положение элементов сводной таблицы, API Aspose.Cells for Node.js via C++ внедрил несколько новых свойств и метод для реализации этой потребности.

• Добавлено свойство PivotItem.setPosition, которое можно использовать для указания индекса позиции во всех PivotItems независимо от родительского узла. Добавлено свойство PivotItem.setPositionInSameParentNode, которое можно использовать для указания индекса позиции в PivotItems под тем же родительским узлом.
• Добавлен метод PivotItem.move для перемещения элемента вверх или вниз на основе значения счетчика, где счетчик - количество позиций для перемещения элемента сводной таблицы вверх или вниз. Если значение счетчика меньше нуля, элемент будет перемещен вверх, а если значение счетчика больше нуля, элемент сводной таблицы переместится вниз, параметр типа Boolean isSameParent указывает на то, должна ли операция перемещения выполняться в одном и том же родительском узле или нет.
• Устарел метод PivotItem.move(int count), поэтому рекомендуется использовать недавно добавленный метод PivotItem.move(number, boolean).

В следующем демонстрационном коде создается сводная таблица, после чего указываются позиции элементов сводной таблицы в том же родительском узле. Вы можете загрузить исходный файл Excel и выходной файл Excel для вашего справочника. Если вы откроете выходной файл Excel, вы увидите, что элемент сводной таблицы “4H12” находится в 0-й позиции в родителе “K11”, а “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");

Обратите внимание, что необходимо вызвать методы PivotTable.RefreshData и PivotTable.CalculateData перед использованием свойств PivotItem.setPosition, PivotItem.setPositionInSameParentNode и метода PivotItem.move.