Documentation – Pivot tabeller

Pythonjava: Skapa en pivottabell

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

Skapa en pivottabell

Aspose.Cells för Python via Java ger funktionen att skapa pivottabeller. För att skapa en pivottabell med hjälp av Aspose.Cells, följ följande steg:

Lägg till lite data i kalkylbladsceller genom att använda objektets Cell egenskap setValue. Denna data kommer att användas som datakälla för pivottabellen.
Lägg till en pivottabell till kalkylbladet genom att anropa metoden add i PivotTableCollection, inkapslad i Kalkylblad objekt.
Få åtkomst till PivotTable-objektet från PivotTableCollection genom att passera PivotTable-indexet.
Använd valfritt av pivottabell objekten (beskrivna ovan) inkapslat i PivotTableCollection objekt för att hantera pivottabellen.

Nedanstående kodavsnitt visar hur man skapar en pivottabell med Aspose.Cells API.

Pythonjava: Formatera pivot tabellceller

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

Ibland vill du formatera pivottabellceller. Till exempel vill du tillämpa en bakgrundsfärg på pivottabellceller. Aspose.Cells tillhandahåller två metoder PivotTable.formatAll() och PivotTable.format(), som du kan använda för detta ändamål.

PivotTable.formatAll() tillämpar stilen på hela pivottabellen medan PivotTable.format() tillämpar stilen på en enskild cell i pivottabellen.

Följande kodexempel formaterar hela pivottabellen med en ljusblå färg och formaterar sedan den andra tabellraden gul.

Ingångsförändringstabellen, innan koden körs

Utstegsförändringstabellen, efter att koden har utförts

Pythonjava: Tillämpa stilar på pivottabeller i Aspose.Cells for Python via Java

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

Aspose.Cells stöder tillämpning av både äldre pivot-autoformat (avsedda för .xls-filer) och moderna namngivna eller anpassade pivottabellstilar (avsedda för .xlsx-, .xlsm- och .xlsb-filer). Vilket API du ska anropa beror på det filformat som arbetsboken sparas till, inte det format den lästes in från.

Introduktion

Aspose.Cells exponerar två parallella stil-API:er för pivottabeller. Valet mellan dem styrs av det filformat du sparar arbetsboken till, inte av det format du läser in den från. En arbetsbok som lästs in från en .xls-fil kan sparas om som .xlsx, och i det fallet används det moderna stil-API:t istället för det äldre.

pivotTable.setPivotTableStyleType(int) väljer en av de inbyggda namngivna stilarna (ljust och mörkt tema, inklusive de stilar som lades till i Excel 2017). Dessa förinställningar är skrivskyddade.
pivotTable.setPivotTableStyleName(String) väljer en anpassad stil som du definierar själv via workbook.getWorksheets().getTableStyles().addPivotTableStyle(String). Anpassade stilar krävs när du vill ändra färger, kanter eller teckensnitt utöver vad förinställningarna erbjuder. Dessutom är pivotTable.formatAll(Style) en genväg som tillämpar ett enda Style-objekt på varje cell i pivottabellen och åsidosätter det som har ställts in via någon av stilnamns-API:erna ovan. Detta är användbart när ett enhetligt utseende krävs oavsett underliggande tema.

Tillämpa ett äldre förinställt XLS-autoformat

Metoden setAutoFormatType på en pivottabell accepterar ett värde från uppräkningen com.aspose.cells.pivot.PivotTableAutoFormatType. De tillgängliga värdena är REPORT_1 till REPORT_10, CLASSIC och TABLE_1 till TABLE_10. Följande exempel läser in en ny arbetsbok, fyller i exempeldata för Fruit/Year/Amount, lägger till en pivottabell, tillämpar PivotTableAutoFormatType.REPORT_5 och sparar resultatet som .xls.

Varför inga kolumnfält? Autoformat i rapport-serien (Report1 till Report10, Table1 till Table10) designades i klassisk Excel för endimensionella pivottabeller med endast radfält och värden — de har ingen inbyggd stil för kolumnfältsrubriker. Om din pivottabell behöver kolumnfält, använd de moderna PivotTableStyleType-förinställningarna från Scenario 2 istället, som är designade för den tvådimensionella layout som modern Excel använder.

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, PivotFieldType, PivotTableAutoFormatType
# Scenario 1: Tillämpa ett äldre XLS förinställt autoformat
# API som används: PivotTable.AutoFormatType
# Målfilformat: .xls (äldre)
# För fullständiga exempel och datafiler, vänligen gå till https://github.com/aspose-cells/Aspose.Cells-for-.NET
# Skapa en ny arbetsbok
workbook = Workbook()
# Hämta det första kalkylbladet
sheet = workbook.getWorksheets().get(0)
# Fylla källdata med rubrikrad (Frukt, År, Belopp)
# och 9 datarader som täcker druva, blåbär, kiwi, körsbär över 2020 och 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)
# Lägg till en pivottabell vid destinationscell E3, namngiven "Pivot1", med källintervall A1:C10
pivotIndex = sheet.getPivotTables().add("A1:C10", "E3", "Pivot1")
pivotTable = sheet.getPivotTables().get(pivotIndex)
# Tilldela fält: Frukt -> Rader, Belopp -> Data
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
# Tillämpa det äldre XLS förinställda autoformatet "Report5"
# Obs: Den här egenskapen är endast meningsfull när du sparar som .xls.
# När det sparas som .xlsx/.xlsm/.xlsb ignorerar Excel AutoFormatType
# och använder det som PivotTableStyleType / PivotTableStyleName anger.
pivotTable.setAutoFormatType(PivotTableAutoFormatType.Report5)
# Spara arbetsboken i äldre .xls-format
workbook.save("output.xls")
jpype.shutdownJVM()

Tillämpa en modern namngiven förinställd pivottabellstil

Definiera och tillämpa en anpassad pivottabellstil

De inbyggda förinställningarna kan inte ändras. När du behöver åsidosätta färger, kanter eller teckensnitt måste du definiera en anpassad pivotstil. Arbetsflödet har tre steg:

Lägg till en anpassad stil i arbetsbokens TableStyles-samling via workbook.getWorksheets().getTableStyles().addPivotTableStyle(String name). Detta returnerar indexet för den nyskapade stilen.
Konfigurera stilen genom att lägga till element (såsom WHOLE_TABLE eller GRAND_TOTAL_ROW) via tableStyle.getTableStyleElements().add(TableStyleElementType), och tilldela sedan en Style till varje element via tableStyleElement.setElementStyle(Style).
Tillämpa den anpassade stilen på pivottabellen genom att anropa pivotTable.setPivotTableStyleName(String) med stilens namn. Använd inte setPivotTableStyleType här, eftersom den metoden väljer inbyggda förinställningar.

setPivotTableStyleName och setPivotTableStyleType är inte utbytbara. Använd setPivotTableStyleType för inbyggda förinställningar och setPivotTableStyleName för anpassade stilar som du har definierat via addPivotTableStyle. Att ställa in båda är ofarligt, men endast den som matchar den avsedda källan renderas.

De tillgängliga TableStyleElementType-värdena inkluderar WHOLE_TABLE, FIRST_ROW, LAST_ROW, FIRST_COLUMN, LAST_COLUMN, GRAND_TOTAL_ROW, GRAND_TOTAL_COLUMN, PAGE_FIELD_LABELS och PAGE_FIELD_VALUES. Följande exempel definierar en anpassad pivotstil med en tunn svart kant på WHOLE_TABLE och ett fetstilt rött teckensnitt på GRAND_TOTAL_ROW, tillämpar den sedan via setPivotTableStyleName och sparar som .xlsx.

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat
from asposecells.api import PivotFieldType, TableStyleElementType, BorderType, CellBorderType
from java.awt import Color
workbook = Workbook()
worksheet = workbook.getWorksheets().get(0)
# Fyll i källdata: rubrikrad + 9 datarader (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)
# Lägg till pivottabell från A1:C10, förankrad vid E3, med namnet "Pivot1"
pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
pivotTable.addFieldToArea(PivotFieldType.ROW, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.COLUMN, "Year")
pivotTable.addFieldToArea(PivotFieldType.DATA, "Amount")
# Steg 1: registrera en ny anpassad pivottabellstil och fånga dess index
styleIndex = workbook.getWorksheets().getTableStyles().addPivotTableStyle("CustomPivotStyle")
tableStyle = workbook.getWorksheets().getTableStyles().get(styleIndex)
# Steg 2: lägg till ett WholeTable-element och tillämpa tunna svarta kanter på alla fyra sidor
wholeTableElementIndex = tableStyle.getTableStyleElements().add(TableStyleElementType.WHOLE_TABLE)
wholeTableElement = tableStyle.getTableStyleElements().get(wholeTableElementIndex)
wholeTableStyle = workbook.createStyle()
wholeTableStyle.getBorders().get(BorderType.TOP_BORDER).setLineStyle(CellBorderType.THIN)
wholeTableStyle.getBorders().get(BorderType.TOP_BORDER).setColor(Color.BLACK)
wholeTableStyle.getBorders().get(BorderType.BOTTOM_BORDER).setLineStyle(CellBorderType.THIN)
wholeTableStyle.getBorders().get(BorderType.BOTTOM_BORDER).setColor(Color.BLACK)
wholeTableStyle.getBorders().get(BorderType.LEFT_BORDER).setLineStyle(CellBorderType.THIN)
wholeTableStyle.getBorders().get(BorderType.LEFT_BORDER).setColor(Color.BLACK)
wholeTableStyle.getBorders().get(BorderType.RIGHT_BORDER).setLineStyle(CellBorderType.THIN)
wholeTableStyle.getBorders().get(BorderType.RIGHT_BORDER).setColor(Color.BLACK)
wholeTableElement.setElementStyle(wholeTableStyle)
# Steg 3: lägg till ett GrandTotalRow-element och tillämpa fet röd text
grandTotalElementIndex = tableStyle.getTableStyleElements().add(TableStyleElementType.GRAND_TOTAL_ROW)
grandTotalElement = tableStyle.getTableStyleElements().get(grandTotalElementIndex)
grandTotalStyle = workbook.createStyle()
grandTotalStyle.getFont().setBold(True)
grandTotalStyle.getFont().setColor(Color.RED)
grandTotalElement.setElementStyle(grandTotalStyle)
# Steg 4: tillämpa den anpassade stilen med namn (INTE via PivotTableStyleType, som är för inbyggda förinställningar)
pivotTable.setPivotTableStyleName("CustomPivotStyle")
workbook.save("output.xlsx")
jpype.shutdownJVM()

Tillämpa en stil på varje pivotcell med FormatAll

pivotTable.formatAll(Style) är en genväg som tillämpar ett enda Style-objekt på varje cell i pivottabellen, inklusive dataområdet, rad- och kolumnrubriker samt totaler. Det som tidigare ställts in via setPivotTableStyleType eller setPivotTableStyleName åsidosätts.

formatAll åsidosätter både setPivotTableStyleType och setPivotTableStyleName. Använd det endast när ett enhetligt, temaoberoende utseende krävs i hela pivottabellen.

Följande exempel skapar en Style med gul solid fyllning, ett fetstilt mörkblått teckensnitt och tunna svarta kanter på alla sidor, tillämpar den sedan med formatAll och sparar som .xlsx.

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, Style
from asposecells.api import Color
from asposecells.api import PivotTable, PivotFieldType
from asposecells.api import BorderType, CellBorderType, BackgroundType
# Scenario 4: Tillämpa en enda Style på varje pivottabellcell med hjälp av FormatAll
# API som används: PivotTable.FormatAll(Style)
# Målformat: .xlsx
# GitHub-referens: se Aspose.Cells-for-.NET repository — exempel på pivottabellformatering
workbook = Workbook()
worksheet = workbook.getWorksheets().get(0)
# Fylla på källdata: rubrikrad (rad 1) + 9 datarader (raderna 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)
# Lägg till pivottabell: källintervall A1:C10, målcell E3, namn "Pivot1"
pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
# Tilldela pivotfält: Fruit -> Radområde, Year -> Kolumnområde, Amount -> Dataområde
pivotTable.addFieldToArea(PivotFieldType.ROW, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.COLUMN, "Year")
pivotTable.addFieldToArea(PivotFieldType.DATA, "Amount")
# Bygg en Style som tvingas på varje cell i pivottabellen
style = workbook.createStyle()
style.setForegroundColor(Color.YELLOW)
style.setPattern(BackgroundType.SOLID)
style.getFont().setIsBold(True)
style.getFont().setColor(Color.DARK_BLUE)
style.getBorders().get(BorderType.TOP_BORDER).setLineStyle(CellBorderType.THIN)
style.getBorders().get(BorderType.TOP_BORDER).setColor(Color.BLACK)
style.getBorders().get(BorderType.BOTTOM_BORDER).setLineStyle(CellBorderType.THIN)
style.getBorders().get(BorderType.BOTTOM_BORDER).setColor(Color.BLACK)
style.getBorders().get(BorderType.LEFT_BORDER).setLineStyle(CellBorderType.THIN)
style.getBorders().get(BorderType.LEFT_BORDER).setColor(Color.BLACK)
style.getBorders().get(BorderType.RIGHT_BORDER).setLineStyle(CellBorderType.THIN)
style.getBorders().get(BorderType.RIGHT_BORDER).setColor(Color.BLACK)
# Tillämpa FormatAll: tvingar denna enda stil på varje cell i pivottabellen,
# åsidosätter eventuell PivotTableStyleType / PivotTableStyleName som tidigare ställts in
pivotTable.formatAll(style)
# Spara arbetsboken i det moderna .xlsx-formatet
workbook.save("output.xlsx")
jpype.shutdownJVM()

Vilket stil-API ska jag använda?

Valet av stil-API beror på vilket filformat du sparar till. Använd tabellen nedan som en snabbreferens.

Målfilformat	API att använda	Anteckningar
`.xls` (äldre)	`pivotTable.setAutoFormatType(int)`	Värden från `com.aspose.cells.pivot.PivotTableAutoFormatType` (t.ex. `REPORT_1`–`REPORT_10`, `CLASSIC`, `TABLE_1`–`TABLE_10`). Ignoreras vid sparning som moderna format.
`.xlsx` / `.xlsm` / `.xlsb` (modern, inbyggd stil)	`pivotTable.setPivotTableStyleType(int)`	Värden från `com.aspose.cells.PivotTableStyleType` (ljust/mörkt tema, inklusive tillägg i Excel 2017).
`.xlsx` / `.xlsm` / `.xlsb` (modern, anpassad stil)	`pivotTable.setPivotTableStyleName(String)` + `tableStyles.addPivotTableStyle(String)`	Använd när de inbyggda förinställningarna inte räcker. Konfigurera via `tableStyleElement.setElementStyle(Style)`.
Valfritt format (enhetlig åsidosättning)	`pivotTable.formatAll(Style)`	Genväg som åsidosätter alla andra stilinställningar i hela pivottabellen.
Vid tvivel, spara som `.xlsx` och använd `setPivotTableStyleType` för inbyggda teman, eller `setPivotTableStyleName` för anpassade teman.

Pythonjava: Uppdatera pivottabeller och pivotcachar i Aspose.Cells for Python via Java

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

Aspose.Cells tillhandahåller ett lagerbaserat uppdaterings-API som låter dig läsa in pivotdata igen i fyra olika omfattningar — från hela arbetsboken ner till en enskild pivottabell. Från och med Aspose.Cells for Python via Java v26.7 är den äldre metoden PivotTable.refreshData() markerad som föråldrad och bör ersättas med de mer effektiva, cache-medvetna API:er som beskrivs i den här artikeln.

Introduktion

Att uppdatera en pivottabell är sällan en enskild åtgärd. Bakom kulisserna underhåller Aspose.Cells en lagerbaserad datakedja som kopplar samman dina ursprungliga källdata med de renderade värden du ser i kalkylbladet. Att förstå denna kedja är nyckeln till att välja rätt uppdaterings-API för varje situation. Den fyra-lagers datakedjan är:

Datakälla — de ursprungliga kalkylbladsintervallen, databasfrågan eller konsolideringsintervallet där råvärdena finns.
PivotCache — den minneslagrade ögonblicksbilden av källdatan. Varje pivottabell är byggd ovanpå en PivotCache; det är här all data samlas in och aggregeras.
PivotTable — vyobjektet som definierar rad-, kolumn-, värde- och filterfält. En PivotTable läser endast från sin PivotCache, aldrig direkt från datakällan.
Cells — kalkylbladets Cells som PivotTable renderar sina beräknade värden och stilar i.

PivotCache.getSourceType() (enum PivotTableSourceType) anger var cache-datan kom ifrån. Från och med v26.7 stödjer PivotCache.refresh() endast källtyperna SHEET och CONSOLIDATION — det vill säga data som finns i kalkylbladsintervall. Externa källor (databaser, externa anslutningar osv.) kan ännu inte uppdateras via cache-API:et.

På grund av denna kedja finns det två grundläggande uppdateringsvägar i Aspose.Cells:

PivotTable.calculateData() — beräknar om en PivotTable:s visning från redan cachad data, utan att gå tillbaka till datakällan. Alla scenarier i den här artikeln använder kalkylbladsceller som källdata, så källtypen är SHEET och uppdateringsåtgärderna fungerar enligt beskrivningen.

Snabbstart

Om du bara behöver den kortaste möjliga koden som uppdaterar varje pivot i arbetsboken räcker ett enda anrop:

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType
# Skapa en ny arbetsbok
workbook = Workbook()
worksheet = workbook.getWorksheets().get(0)
# Skriv rubrikrad i cellerna A1:C1
worksheet.getCells().get("A1").putValue("Fruit")
worksheet.getCells().get("B1").putValue("Year")
worksheet.getCells().get("C1").putValue("Amount")
# Skriv datarader i cellerna A2:C9 (8 rader fruktdata över 2020 och 2021)
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)
# Lägg till en pivottabell: källområde "A1:C9", målcell "E3", namn "Pivot1"
pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
# Tilldela pivotfält: Fruit till Rader, Year till Kolumner, Amount till Data
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Column, "Year")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
# Ändra flera Amount-värden i källdatan för att simulera ändringar
worksheet.getCells().get("C2").putValue(55)
worksheet.getCells().get("C5").putValue(85)
worksheet.getCells().get("C9").putValue(125)
# Uppdatera varje pivottabell/pivotcache i arbetsboken
workbook.refreshAll()
# Spara arbetsboken
workbook.save("output.xlsx")
jpype.shutdownJVM()

Allt annat i den här artikeln förklarar när du bör välja ett snävare API istället.

Obligatoriska importer

Alla Python-exempel i den här artikeln är beroende av följande importer eftersom pivottyperna finns i namnrymden aspose.cells.pivot:

import jpype
import aspose.cells as cells Modulen jpype används för att starta upp JVM, medan aspose.cells exponerar arbetsboks-/kalkylblads-/cell-/pivottyperna som används igenom hela texten.

Uppdatera alla pivottabeller i arbetsboken

När du behöver säkerställa att varje pivotcache och varje pivottabell i arbetsboken återger den senaste källdatan är det enklaste och mest omfattande API:et Workbook.refreshAll(). Ett enda anrop traverserar hela arbetsboken — uppdaterar varje PivotCache från dess källa och beräknar sedan om varje beroende PivotTable. Detta är den rekommenderade metoden för generella, heltäckande uppdateringar där prestanda inte är ett problem. Följande exempel bygger en arbetsbok med ett källintervall Fruit/Year/Amount, skapar en pivottabell, ändrar några källvärden och använder sedan refreshAll() för att uppdatera allt i ett enda anrop.

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType
workbook = Workbook()
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)
pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
pivotTable.addFieldToArea(PivotFieldType.ROW, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.COLUMN, "Year")
pivotTable.addFieldToArea(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")
jpype.shutdownJVM()

Uppdatera alla pivottabeller på ett enskilt kalkylblad

Ibland behöver du bara uppdatera de pivottabeller som finns på ett specifikt kalkylblad — till exempel när pivottabeller på andra kalkylblad är kända för att vara orelaterade och inte bör röras. För detta fall tillhandahåller Aspose.Cells Worksheet.refreshPivotTables(), som är begränsat till en enskild Worksheet-instans.

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType
workbook = Workbook()
worksheet = workbook.getWorksheets().get(0)
# Skriv rubrikrad för Frukt / År / Belopp
worksheet.getCells().get("A1").putValue("Fruit")
worksheet.getCells().get("B1").putValue("Year")
worksheet.getCells().get("C1").putValue("Amount")
# Skriv 8 datarader (raderna 2–9, som passar källintervallet 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)
# Lägg till en pivottabell med namnet "Pivot1" placerad vid målcell E3, med källa från A1:C9
pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
# Tilldela fält: Frukt till Rad, År till Kolumn, Belopp till Data
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Column, "Year")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
# Ändra en egenskap för vy/layout — detta är en ändring som endast påverkar presentationen,
# så den kräver INTE att källdatan läses igen via PivotCache.Refresh().
pivotTable.setRefreshDataOnOpeningFile(False)
# CalculateData() renderar om DENNA pivottabells visning (data + stil) från
# data som redan finns i PivotCache. Eftersom källdatan inte ändrades,
# utförs ingen rundtur till källan — endast de cachelagrade värdena beräknas om
# till kalkylbladsceller.
pivotTable.calculateData()
# Spara arbetsboken till disk
workbook.save("output.xlsx")
jpype.shutdownJVM()

Uppdatera en enskild pivottabell

När du vill ha finkornig kontroll över en enskild pivottabell ger det cache-baserade API:et dig två alternativ. Valet mellan dem beror på vad som faktiskt har ändrats: underliggande källdata, eller bara pivottabellens visnings-/layoutinställningar.

Källdata har ändrats — använd `PivotCache.refresh()`

Om de underliggande källdatan har ändrats är rätt startpunkt pivotTable.getPivotCache().refresh(). Detta anrop läser om källdatan till cachen och beräknar sedan om alla PivotTable som är beroende av den cachen.

Endast visning/layout har ändrats — använd `calculateData()`

Om källdatan inte har ändrats men endast pivottabellens visnings- eller layoutinställningar har modifierats (till exempel att ett fält har flyttats till ett annat område, eller att en inställning för uppdatering-vid-öppning har växlats), finns det inget behov av att gå tillbaka till datakällan. Cachen har redan rätt data; bara den renderade PivotTable behöver beräknas om. I detta fall är pivotTable.calculateData() rätt val. Följande exempel modifierar en icke-källegenskap hos pivottabellen och anropar sedan calculateData() för att rendera om den från den befintliga cachen. En arbetsbok innehåller ofta många pivottabeller som alla ligger ovanpå en delad cache. För att enumerera dem — till exempel innan du utför en batchuppdatering, eller för att diagnostisera påverkan av delad cache — använd PivotCache.getPivotTables(). Den här metoden returnerar samlingen av alla PivotTable som är beroende av den givna cachen.

Migrera från den föråldrade `PivotTable.refreshData()`

Före Aspose.Cells for Python via Java v26.7 var standardsättet att uppdatera en pivottabell att anropa PivotTable.refreshData() på varje pivottabell individuellt. Från och med v26.7 är den metoden markerad som föråldrad och bör ersättas med de cache-medvetna API:er som beskrivs ovan. Det finns två anledningar till att refreshData()-metoden per tabell är problematisk i verkliga arbetsböcker:

Den hämtar data från källan varje gång den anropas, även när källan inte har ändrats. De rekommenderade ersättningarna är: Följande exempel demonstrerar det nya effektiva mönstret för arbetsböcker med flera pivottabeller som delar en enda cache.

Vilket uppdaterings-API bör jag använda?

Tabellen nedan sammanfattar de tillgängliga uppdaterings-API:erna och när du ska välja varje.

Mål	Rekommenderat API	Anteckningar
Uppdatera allt i arbetsboken	`Workbook.refreshAll()`	Ett anrop; täcker alla cachar och tabeller.
Uppdatera endast pivottabeller på ett enskilt blad	`Worksheet.refreshPivotTables()`	Begränsat till ett kalkylblad.
Källdata har ändrats för en cache	`pivotTable.getPivotCache().refresh()`	Uppdaterar ALLA pivottabeller på den delade cachen.
Endast visnings-/layoutinställningar har ändrats	`pivotTable.calculateData()`	Hoppar över onödiga källanrop.
Lista alla pivottabeller på en delad cache	`pivotCache.getPivotTables()`	Använd för att enumerera före bulkuppdatering.
I praktiken bör du föredra de cache-baserade API:erna framför den föråldrade `refreshData()` per tabell. De är medvetna om delade cachar, de undviker redundanta källhämtningar och de låter dig välja den minsta omfattning som uppfyller ditt uppdateringsbehov.

Vanliga fallgropar

Glömmer att uppdatera innan du sparar. En pivottabell skriver bara sina renderade värden till kalkylbladet när dess datakedja uppdateras. Om du modifierar källceller, anropa PivotCache.Refresh() (eller Workbook.RefreshAll()) före Workbook.save(), annars innehåller den sparade filen fortfarande de gamla aggregerade värdena.
Anropar den föråldrade RefreshData() per tabell. I v26.7 är PivotTable.RefreshData() markerad som föråldrad och hämtar om källan vid varje anrop. Med flera pivottabeller som delar en cache innebär detta N redundanta källhämtningar. Ersätt med ett enda PivotCache.Refresh() följt av CalculateData() per tabell.
Uppdaterar när bara layouten har ändrats. Om du bara ändrade en pivottabells visning (kolumnordning, ConsolidationFunction osv.) utan att röra källdatan, är PivotCache.Refresh() onödigt och långsamt. Anropa pivotTable.CalculateData() för att rendera om från den befintliga cachen.
Extern källa stöds inte av PivotCache.Refresh(). Om pivottabellens källa kommer från en extern anslutning (databas, OLAP-kub osv.) kan PivotCache.Refresh() inte uppdatera den i v26.7 — den stöder för närvarande endast källtyperna Sheet och Consolidation. För externa källor, öppna arbetsboken igen eller bygg om cachen från källan.

using Aspose.Cells;
Workbook workbook = new Workbook("input.xlsx");
workbook.RefreshAll();
workbook.Save("output.xlsx");

Pythonjava: Lägga till rad- och kolumnfält i en pivottabell i Aspose.Cells för .NET

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

Lägga till ett fält i rad- eller kolumnregionen

Metoden PivotTable.addFieldToArea(PivotFieldType fieldType, String fieldName) flyttar ett basfält från källdatan till en av de fyra pivotregionerna. Argumentet fieldType accepterar ett av följande PivotFieldType-värden.

ROW — fält som placeras vertikalt till vänster
COLUMN — fält som placeras horisontellt överst
DATA — fält vars värden aggregeras
PAGE — fält som används som rapportfilter När fält har lagts till kan du komma åt dem via metoderna PivotTable.getRowFields() och PivotTable.getColumnFields(). Varje metod returnerar en PivotFieldCollection. Fältet på index 0 i RowFields är det yttersta radfältet, och efterföljande index representerar fält som är nästlade inuti det. Samma indexkonvention gäller för ColumnFields. Ordningen på fältnästning spelar roll. Att lägga till Category i radregionen först och sedan Item skapar en pivot vars yttre gruppering är Category och vars inre gruppering är Item. Att vända på ordningen vänder på hierarkin.

Pivotfältets delsummor

Metoden PivotField.setSubtotals(PivotFieldSubtotalType subtotalType, boolean shown) styr vilka delsummarader som visas för ett pivotfält. Varje anrop växlar en enskild delsummatyp oberoende. Att skicka shown = true visar delsummoraden, medan shown = false döljer den. Eftersom varje anrop endast påverkar en typ, bygger upprepade anrop med olika subtotalType-värden en anpassad delmängd av delsummor. Enumen PivotFieldSubtotalType definierar de tillgängliga typerna av delsummor.

AUTOMATIC — Aspose.Cells väljer standardvalet (vanligtvis SUM för numeriska fält)
NONE — undertryck alla delsummarader
SUM
COUNT
AVERAGE
MAX
MIN
PRODUCT
STD_DEV
STD_DEVP
VAR
VARP

Delsummor renderas endast när det finns två eller fler pivotfält i radregionen (eller i kolumnregionen). Ett enskilt fält har inget meningsfullt att beräkna delsummor mellan, så anrop till setSubtotals har ingen synlig effekt i det fallet. Den här artikeln placerar därför två radfält (Category ytterst, Item innerst) i varje exempel så att delsummogränsen mellan varje Category-grupp är synlig.

Scenario 1 — Automatiska (standard) delsummor

När du inte anropar setSubtotals alls, tillämpar Aspose.Cells valet AUTOMATIC på numeriska fält. Följande exempel bekräftar uttryckligen detta beteende genom att anropa setSubtotals(PivotFieldSubtotalType.AUTOMATIC, true) på det yttre Category-radfältet.

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, PivotTable, PivotField, PivotFieldType, PivotFieldSubtotalType
workbook = Workbook()
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)
pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
pivotTable.addFieldToArea(PivotFieldType.ROW, "Category")
pivotTable.addFieldToArea(PivotFieldType.ROW, "Item")
pivotTable.addFieldToArea(PivotFieldType.COLUMN, "Year")
pivotTable.addFieldToArea(PivotFieldType.DATA, "Amount")
categoryField = pivotTable.getRowFields().get(0)
categoryField.setSubtotals(PivotFieldSubtotalType.AUTOMATIC, True)
pivotTable.calculateData()
workbook.save("output_automatic.xlsx")
jpype.shutdownJVM()

Scenario 2 — Undertrycka alla delsummor (None)

Att anropa setSubtotals(PivotFieldSubtotalType.NONE, true) tar bort varje delsummarad från pivottabellen och lämnar endast fältraderna och totalsumman längst ner. Detta är användbart när du vill ha den råa grupperade datan utan några sammanfattningsrader.

Scenario 3 — Anpassad delmängd av delsummor (Sum + Average)

Du är inte begränsad till en enskild delsummatyp. Varje setSubtotals-anrop verkar oberoende på en typ, så att anropa metoden två gånger — en gång med SUM och en gång med AVERAGE — skapar en anpassad delmängd av två delsummarader för varje Category-grupp.

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotTableCollection, PivotTable, PivotFieldType, PivotField, PivotFieldSubtotalType
workbook = Workbook()
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)
pivotTables = worksheet.getPivotTables()
pivotIndex = pivotTables.add("A1:D9", "F3", "PivotTable1")
pivotTable = pivotTables.get(pivotIndex)
pivotTable.addFieldToArea(PivotFieldType.Row, "Category")
pivotTable.addFieldToArea(PivotFieldType.Row, "Item")
pivotTable.addFieldToArea(PivotFieldType.Column, "Year")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
categoryField = pivotTable.getRowFields().get(0)
categoryField.setSubtotals(PivotFieldSubtotalType.Sum, True)
categoryField.setSubtotals(PivotFieldSubtotalType.Average, True)
pivotTable.calculateData()
workbook.save("output_custom.xlsx")
jpype.shutdownJVM()

Sammanfattning

De tre scenarierna ovan delar samma dataset och pivottabellstruktur. Den enda skillnaden mellan dem är setSubtotals-anropet som tillämpas på det yttre Category-radfältet. Kom ihåg tvåfältsregeln: ett enskilt fält i en region har inget att beräkna delsummor mellan, så placera alltid minst två fält i rad- eller kolumnregionen när du vill att setSubtotals ska ha en synlig effekt. The CODE_BLOCK comments are HTML comment placeholders with descriptions. The instruction says: “HTML Comment Placeholders (CRITICAL): The document contains `` HTML comments. These are CODE BLOCK PLACEHOLDERS — you MUST preserve them EXACTLY as-is in your translation. Do NOT remove, modify, or translate them.” The title is: “Row and Column Fields in Aspose.Cells for Python via Java” This contains the product name “Aspose.Cells for Python via Java” which must be preserved exactly. That’s correct - I’m not translating it because it contains the product name which must stay. “ONLY translate the VALUES of title, description, and keywords.” But also: “The following product names must appear EXACTLY as-is throughout the document” But the title contains the product name. If I translate “Row and Column Fields” to “Rad- och kolumnfält”, then I’d have: “Rad- och kolumnfält in Aspose.Cells for Python via Java” This should be fine. The product name “Aspose.Cells for Python via Java” appears exactly once. And linktitle: “Rad- och kolumnfält” linktitle: Rad- och kolumnfält keywords: “Aspose.Cells, Python via Java, pivottabell, radfält, kolumnfält, PivotField, setSubtotals, PivotFieldSubtotalType, delsummor” Translated: “Lär dig hur du lägger till basfält i rad- och kolumnregionerna i en pivottabell och styr pivotfältets delsummor med PivotField.setSubtotals i Aspose.Cells for Python via Java.”

All API names: ✓
All enum values: ✓
All method names: ✓
All shortcodes: ✓
All HTML comments: ✓
All URLs: ✓

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType, PivotFieldSubtotalType
workbook = Workbook()
worksheet = workbook.getWorksheets().get(0)
worksheet.setName("Data")
headers = ["Category", "Item", "Year", "Amount"]
for j in range(len(headers)):
    worksheet.getCells().get(0, j).putValue(headers[j])
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 i in range(len(data)):
    for j in range(len(data[0])):
        worksheet.getCells().get(i + 1, j).putValue(data[i][j])
pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
pivotTable.addFieldToArea(PivotFieldType.ROW, "Category")
pivotTable.addFieldToArea(PivotFieldType.ROW, "Item")
pivotTable.addFieldToArea(PivotFieldType.COLUMN, "Year")
pivotTable.addFieldToArea(PivotFieldType.DATA, "Amount")
categoryField = pivotTable.getRowFields().get(0)
categoryField.setSubtotals(PivotFieldSubtotalType.NONE, True)
pivotTable.calculateData()
workbook.save("output_none.xlsx")
jpype.shutdownJVM()

Pythonjava: Värdefält i Aspose.Cells for Python via Java

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

Lägga till ett fält i dataregionen

Att lägga till ett basfält i data- (värde-)regionen är det första steget i att forma hur en pivottabell aggregerar din källdata. Aspose.Cells exponerar PivotTable.addFieldToArea(PivotFieldType, string), en överlagring som accepterar konstanten PivotFieldType.DATA och källkolonnens namn. När ett fält har lagts till i dataregionen exponerar API:t det via samlingen PivotTable.DataFields, i den ordning som fälten lades till. Som standard sammanfattas en numerisk källkolumn med ConsolidationFunction.SUM, medan en icke-numerisk kolumn som standard blir COUNT.

import aspose.cells as ac
from aspose.cells.pivot import PivotFieldType
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"
headers = ["Category", "Item", "Year", "Amount"]
for j, h in enumerate(headers):
    worksheet.cells.get(0, j).put_value(h)
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 i, row in enumerate(data):
    for j, val in enumerate(row):
        worksheet.cells.get(i + 1, j).put_value(val)
pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1", True, False)
pivot_table = worksheet.pivot_tables[pivot_index]
pivot_table.add_field_to_area(PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(PivotFieldType.DATA, "Amount")
pivot_table.calculate_data()
workbook.save("output_drag.xlsx")

Ändra sammanfattningsfunktionen

Varje fält som placeras i dataregionen omsluts internt som en PivotField-instans, och dess Function-egenskap returnerar ett värde från enum ConsolidationFunction. Samma Function-setter låter dig växla mellan tillgängliga aggregat, inklusive SUM, COUNT, AVERAGE, MAX, MIN, PRODUCT, STDDEV, STDDEVP, VAR och VARP.

Att ändra Function påverkar bara aggregatet, källkolumnen ändras inte.

Du kan därför lämna ett datafält som SUM medan du lägger till ett andra datafält som riktar sig mot samma källkolumn men använder COUNT eller AVERAGE, allt i en enda pivot.

import aspose.cells as ac
from aspose.cells.pivot import PivotFieldType, ConsolidationFunction
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"
headers = ["Category", "Item", "Year", "Amount"]
for j, h in enumerate(headers):
    worksheet.cells.get(0, j).put_value(h)
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 i, row in enumerate(data):
    for j, val in enumerate(row):
        worksheet.cells.get(i + 1, j).put_value(val)
pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1", True, False)
pivot_table = worksheet.pivot_tables[pivot_index]
pivot_table.add_field_to_area(PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(PivotFieldType.DATA, "Amount")
pivot_table.add_field_to_area(PivotFieldType.DATA, "Amount")
pivot_table.data_fields[1].function = ConsolidationFunction.COUNT
pivot_table.calculate_data()
workbook.save("output_function.xlsx")

Visa värdefält på rad- eller kolumnaxeln

När en pivottabell innehåller två eller flera datafält exponerar Aspose.Cells ett ytterligare virtuellt fält kallat PivotTable.ValuesField. Detta virtuella fält representerar aggregatet av alla datafält som finns i dataregionen. Du kan dra det till rad- eller kolumnregionen som ett baspivotfält, vilket är användbart för att lägga ut flera mått sida vid sida.

PivotTable.ValuesField fungerar inte om det inte finns något eller endast ett värdefält.

Scenarierna nedan går igenom tre heltäckande exempel som demonstrerar varje funktion som beskrivs ovan mot samma pivotstruktur.

import aspose.cells as ac
from aspose.cells.pivot import PivotFieldType, ConsolidationFunction
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "Data"
headers = ["Category", "Item", "Year", "Amount"]
for j, h in enumerate(headers):
    worksheet.cells.get(0, j).put_value(h)
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 i, row in enumerate(data):
    for j, val in enumerate(row):
        worksheet.cells.get(i + 1, j).put_value(val)
pivot_index = worksheet.pivot_tables.add("A1:D9", "F3", "PivotTable1", True, False)
pivot_table = worksheet.pivot_tables[pivot_index]
pivot_table.add_field_to_area(PivotFieldType.ROW, "Category")
pivot_table.add_field_to_area(PivotFieldType.ROW, "Item")
pivot_table.add_field_to_area(PivotFieldType.COLUMN, "Year")
pivot_table.add_field_to_area(PivotFieldType.DATA, "Amount")
pivot_table.add_field_to_area(PivotFieldType.DATA, "Amount")
pivot_table.data_fields[1].function = ConsolidationFunction.COUNT
pivot_table.add_field_to_area(PivotFieldType.COLUMN, pivot_table.values_field)
pivot_table.calculate_data()
workbook.save("output_plot.xlsx")

Pythonjava: Lägga till filterfält i en pivottabell i Aspose.Cells för .NET

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

Aspose.Cells stöder hela livscykeln för filterfält i pivottabeller. Du kan lägga till ett filterfält via ett högnivå-API eller via den underliggande page_fields-samlingen, och du kan driva sidfiltret i enkelvalsläge, rensa det för att visa alla sidobjekt, eller växla fältet till flerval så att användare kan välja flera sidobjekt samtidigt via kryssrutegränssnittet i Excel.

Introduktion

Ett filterfält är ett pivotfält som styr vilken delmängd av källdatan som pivotkroppen visar. Slutanvändare ser det som en rullgardinsmeny överst i en renderad pivot i Excel, och val av ett av de tillgängliga sidobjekten bygger om pivotkroppen så att endast posterna som tillhör det sidobjektet sammanfattas. Ett pivotfält blir ett filterfält när det registreras som PivotFieldType.PAGE snarare än PivotFieldType.ROW, PivotFieldType.COLUMN eller PivotFieldType.DATA. Ett filterfält kan fungera i två beteenden. I standardbeteendet enkelval är endast ett sidobjekt synligt åt gången, så pivotkroppen sammanfattar exakt en delmängd. I beteendet flerval exponerar fältet en kryssrutelista, och pivotkroppen sammanfattar unionen av varje ikryssat sidobjekt. Samma källfält kan flyttas fram och tillbaka mellan dessa beteenden genom att växla en enskild egenskap. Aspose.Cells for Python via Java exponerar två likvärdiga sätt att registrera ett filterfält. Det högnivå-API:et är PivotTable.add_field_to_area(PivotFieldType.PAGE, "fieldName"), som tar källkolonnens namn och lägger till fältet i ett enda anrop. Det underliggande API:et är PivotTable.page_fields.add(PivotField), som används när du redan har en PivotField-referens och vill lägga till samma fältinstans i filterområdet. Båda API:erna fyller slutligen samma page_fields-samling, och resten av denna artikel visar hur du väljer mellan dem och hur du driver varje filtreringsläge.

Lägga till ett filterfält

Det finns två sätt att registrera ett pivotfält i filterområdet. Det högnivåanropet tar källkolonnens namn som en sträng och är den vanligaste vägen. Det underliggande anropet accepterar en befintlig PivotField-instans och är bekvämt när samma fältobjekt måste återanvändas i flera pivotområden. Båda anropen placerar fältet i PivotTable.page_fields, varefter det visas som sidans rullgardinsmeny överst i den renderade pivoten.

Lägga till ett filterfält med add_field_to_area

Följande exempel bygger en liten Fruit / Year / Amount-dataset, placerar en pivottabell i cell E3 med Fruit i radområdet, Amount i dataområdet och Year i filterområdet, uppdaterar pivoten och sparar arbetsboken.

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, PivotFieldType
# Skapa en ny arbetsbok
workbook = Workbook()
worksheet = workbook.getWorksheets().get(0)
worksheet.setName("Data")
# Ställ in rubrikraden
worksheet.getCells().get("A1").putValue("Fruit")
worksheet.getCells().get("B1").putValue("Year")
worksheet.getCells().get("C1").putValue("Amount")
# Fyll i 9 rader med exempeldata: Frukt, År, Belopp
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 i in range(len(data)):
    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])
# Lägg till en pivottabell förankrad vid cell E3
pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "PivotTable1")
pivotTable = worksheet.getPivotTables().get(pivotIndex)
# Lägg till fält i deras områden: Frukt som Rad, Belopp som Data, År som Sidfält
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
pivotTable.addFieldToArea(PivotFieldType.Page, "Year")
# Uppdatera och beräkna pivottabellens data
pivotTable.calculateData()
# Spara arbetsboken
workbook.save("pageFieldSample.xlsx")
jpype.shutdownJVM()

Lägga till ett filterfält med page_fields.add

När du redan arbetar med en PivotField-instans kan du skicka den direkt till PivotTable.page_fields.add. Pivottabellen och filterfältet konstrueras exakt som i föregående scenario; endast den slutliga registreringen i filterområdet ersätts med det underliggande API-anropet.

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotTable, PivotField, PivotFieldType
# — Pivottabellen och sidfältet konstrueras exakt som i
#   Scenario 1a (Fruit/Year/Amount-data, pivot vid E3, Fruit→Row,
#   Amount→Data). Nedan hämtar vi Year PivotField från
#   BaseFields-samlingen och skickar det till PageFields.Add — det
#   lågnivå-alternativet till AddFieldToArea. Resultatet är
#   funktionellt identiskt med Scenario 1a.
workbook = Workbook()
sheet = workbook.getWorksheets().get(0)
# Rubriker
sheet.getCells().get("A1").putValue("Fruit")
sheet.getCells().get("B1").putValue("Year")
sheet.getCells().get("C1").putValue("Amount")
# Exempeldata (9 rader)
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)
# Lägg till pivottabell vid E3 som täcker A1:C10
pivotIndex = sheet.getPivotTables().add("E3", "A1:C10", "PivotTable1")
pivotTable = sheet.getPivotTables().get(pivotIndex)
# Fruit -> Row, Amount -> Data (Year kommer att gå till Page nedan)
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
# Lågnivå-metod: hämta det befintliga Year PivotField från BaseFields
# och registrera det i Page-området via PageFields.Add(PivotField).
yearField = pivotTable.getBaseFields().get("Year")
pivotTable.getPageFields().add(yearField)
# Uppdatera så att det nya sidfältet återspeglas i den sparade arbetsboken
pivotTable.calculateData()
workbook.save("output.xlsx")
jpype.shutdownJVM()

Enkelvalsfiltrering (Visa ett sidobjekt)

I standardbeteendet för enkelval renderas filterfältet som en enda rullgardinsmeny och heltalet PivotField.current_page_item väljer vilket sidobjekt som driver pivotkroppen. Att tilldela ett specifikt index väljer det ena objektet; att tilldela det speciella sentinelvärdet 0x7FFD (decimalt 32765) rensar filtret så att alla sidobjekt sammanfattas på en gång. Enkelval är standard; du behöver inte aktivera det explicit.

Visa alla objekt

Att sätta current_page_item till magiska värdet 0x7FFD är likvärdigt med att rensa sidfiltret: pivotkroppen sammanfattar varje sidobjekt som om inget filter tillämpades.

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType
# Skapa en ny arbetsbok
workbook = Workbook()
sheet = workbook.getWorksheets().get(0)
# Fyll i Fruit/Year/Amount-data
sheet.getCells().get("A1").putValue("Fruit")
sheet.getCells().get("B1").putValue("Year")
sheet.getCells().get("C1").putValue("Amount")
data = [
    ["Apple", 2022, 100],
    ["Apple", 2023, 150],
    ["Banana", 2022, 80],
    ["Banana", 2023, 120],
    ["Cherry", 2022, 200],
    ["Cherry", 2023, 250]
]
for r in range(len(data)):
    for c in range(len(data[r])):
        sheet.getCells().get(r + 1, c).putValue(data[r][c])
# Skapa pivottabell vid E3
pivotTables = sheet.getPivotTables()
index = pivotTables.add("=A1:C7", "E3", "PivotTable1")
pivotTable = pivotTables.get(index)
# Konfigurera pivotfält: Fruit→Rad, Amount→Data, Year→Sida
pivotTable.addFieldToArea(PivotFieldType.ROW, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.DATA, "Amount")
pivotTable.addFieldToArea(PivotFieldType.PAGE, "Year")
pivotTable.calculateData()
# Rensa sidfiltret så att alla objekt i sidfältet syns.
# 0x7FFD (decimal 32765) är det speciella sentinelvärdet som betyder "alla objekt" —
# motsvarar att välja "(Alla)" i Excel:s sidfält-rullmeny.
pivotTable.getPageFields().get(0).setCurrentPageItem(0x7FFD)
workbook.save("output.xlsx")
jpype.shutdownJVM()

Visa ett specifikt objekt

Att sätta current_page_item till ett verkligt index väljer bara det ena sidobjektet. Indexet är positionen för objektet i filterfältets sorterade objektlista, så till exempel 1 väljer det andra objektet efter sortering.

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType
# Create workbook
workbook = Workbook()
sheet = workbook.getWorksheets().get(0)
cells = sheet.getCells()
# Add sample data (Fruit/Year/Amount)
cells.get("A1").putValue("Fruit")
cells.get("B1").putValue("Year")
cells.get("C1").putValue("Amount")
cells.get("A2").putValue("Apple")
cells.get("B2").putValue("2020")
cells.get("C2").putValue("100")
cells.get("A3").putValue("Apple")
cells.get("B3").putValue("2021")
cells.get("C3").putValue("150")
cells.get("A4").putValue("Banana")
cells.get("B4").putValue("2020")
cells.get("C4").putValue("200")
cells.get("A5").putValue("Banana")
cells.get("B5").putValue("2021")
cells.get("C5").putValue("250")
# Add pivot table at E3
pivotTables = sheet.getPivotTables()
pivotIndex = pivotTables.add("A1:C5", "E3", "PivotTable1")
pivotTable = pivotTables.get(pivotIndex)
# Add fields: Fruit→Row, Amount→Data, Year→Page
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
pivotTable.addFieldToArea(PivotFieldType.Page, "Year")
# Page-field-specific operations
pivotTable.getPageFields().get(0).setCurrentPageItem(1) # 1 = second item in sorted order (e.g. "2021")
# Refresh and calculate pivot table
pivotTable.calculateData()
workbook.save("output.xlsx")
jpype.shutdownJVM()

Flervalsfiltrering

Flervalsfiltrering förvandlar sidans rullgardinsmeny till en kryssrutelista och låter slutanvändaren välja flera sidobjekt samtidigt. Aspose.Cells exponerar två egenskaper som fungerar tillsammans. PivotField.is_multiple_item_selection_allowed måste sättas till True innan flervalsgränssnittet överhuvudtaget får effekt. När det är aktiverat styr PivotItem.is_hidden vilka objekt som visas i kryssrutelistan, så du kan antingen visa varje objekt eller vitlista endast specifika objekt. Koden nedan aktiverar flerval på samma Year-filterfält som byggdes i Scenario 1a, och visar sedan två mönster: Del A visar varje sidobjekt genom att lämna is_hidden satt till False för varje post, medan Del B vitlistar endast de källvärden du väljer och döljer allt annat via ett switch (pivot_items[i].get_string_value())-block.

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook
from asposecells.api import Workbook, Worksheet, Cells, Range, SaveFormat, PivotFieldType
import os
import re
# — Pivottabellen och sidfältet konstrueras exakt som i
#   Scenario 1a (Frukt/År/Belopp-data, pivot vid E3, Frukt→Rad,
#   Belopp→Data, År→Sida via AddFieldToArea).
#   Nedan tillämpar vi flervalsfiltrering på sidfältet.
workbook = Workbook()
sheet = workbook.getWorksheets().get(0)
cells = sheet.getCells()
# Exempeldata: Frukt | År | Belopp
cells.get(0, 0).putValue("Fruit")
cells.get(0, 1).putValue("Year")
cells.get(0, 2).putValue("Amount")
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 i in range(len(data)):
    cells.get(i + 1, 0).putValue(data[i][0])
    cells.get(i + 1, 1).putValue(int(data[i][1]))
    cells.get(i + 1, 2).putValue(int(data[i][2]))
pivotSheet = workbook.getWorksheets().add("Pivot")
pivots = pivotSheet.getPivotTables()
pivotIndex = pivots.add("E3", "A1:C10", "PivotTable1")
pivotTable = pivots.get(pivotIndex)
pivotTable.addFieldToArea(PivotFieldType.Row, "Fruit")
pivotTable.addFieldToArea(PivotFieldType.Data, "Amount")
pivotTable.addFieldToArea(PivotFieldType.Page, "Year")
# — Aktivera flerval på sidfältet
pivotTable.getPageFields().get(0).setMultipleItemSelectionAllowed(True)
# Del A — välj ALLA objekt (gör varje objekt synligt)
pivotItems = pivotTable.getPageFields().get(0).getPivotItems()
for i in range(pivotItems.getCount()):
    pivotItems.get(i).setHidden(False)
# Del B — välj endast specifika objekt efter källvärde
for i in range(pivotItems.getCount()):
    value = pivotItems.get(i).getStringValue()
    if value == "2020" or value == "grape" or value == "blueberry":
        pivotItems.get(i).setHidden(False)
    else:
        pivotItems.get(i).setHidden(True)
pivotTable.calculateData()
workbook.save("output.xlsx")
jpype.shutdownJVM()

Obs: När du använder flervalsfiltrering via PivotItem.is_hidden måste minst en PivotItem förbli synlig (is_hidden == False). Om varje objekt är dolt kraschar antingen Excel när filen öppnas eller renderas en tom pivot. Verifiera alltid att din flervalsvitlista inkluderar minst ett objekt från din källdata.

Vilket API och vilket läge ska jag använda?

Tabellen nedan sammanfattar när du ska använda varje API och läge så att du kan välja rätt kombination utan att läsa varje scenario i detalj.

Scenario / Användningsfall	Rekommenderat API	Egenskap som används	Anteckningar
Lägg till ett filterfält efter källkolonnnamn (vanligast)	`PivotTable.add_field_to_area(PivotFieldType.PAGE, "fieldName")`	n/a	Högnivå, en rad. Använd detta om du inte behöver en `PivotField`-referens.
Lägg till ett filterfält när du redan har ett `PivotField`-objekt	`PivotTable.page_fields.add(PivotField)`	n/a	Använd när fältobjektet erhölls annorstädes eller behöver återanvändas.
Filtrera till ett enskilt sidobjekt (standardläge)	`PivotField.current_page_item`	sätt till ett specifikt index	Till exempel visar `1` det andra objektet i den sorterade listan.
Visa alla objekt / rensa sidfiltret	`PivotField.current_page_item`	sätt till `0x7FFD`	Det magiska värdet `0x7FFD` (decimalt 32765) är sentinelvärdet för “alla objekt”.
Aktivera flervalsgränssnitt i Excel	`PivotField.is_multiple_item_selection_allowed`	sätt till `True`	Krävs innan några `is_hidden`-anrop får effekt.
Dölj / visa enskilda objekt i en flervalslista	`PivotItem.is_hidden`	sätt per objekt	Minst ett objekt måste förbli synligt (`is_hidden == False`).

Kom alltid ihåg synlighetsbegränsningen när du konfigurerar flervalsfiltrering. Om varje PivotItem i ett flervalsfilterfält är dolt kraschar Excel vid öppning eller renderar en tom pivot. Bygg din vitlista mot din källdata så att minst ett objekt förblir synligt, och dina sparade arbetsböcker kommer att öppnas tillförlitligt på varje maskin.

Documentation – Pivot tabeller

Pythonjava: Skapa en pivottabell

Skapa en pivottabell

Pythonjava: Formatera pivot tabellceller

Pythonjava: Tillämpa stilar på pivottabeller i Aspose.Cells for Python via Java

Introduktion

Tillämpa ett äldre förinställt XLS-autoformat

Tillämpa en modern namngiven förinställd pivottabellstil

Definiera och tillämpa en anpassad pivottabellstil

Tillämpa en stil på varje pivotcell med FormatAll

Vilket stil-API ska jag använda?

Pythonjava: Uppdatera pivottabeller och pivotcachar i Aspose.Cells for Python via Java

Introduktion

Snabbstart

Obligatoriska importer

Uppdatera alla pivottabeller i arbetsboken

Uppdatera alla pivottabeller på ett enskilt kalkylblad

Uppdatera en enskild pivottabell

Källdata har ändrats — använd PivotCache.refresh()

Endast visning/layout har ändrats — använd calculateData()

Migrera från den föråldrade PivotTable.refreshData()

Vilket uppdaterings-API bör jag använda?

Vanliga fallgropar

Pythonjava: Lägga till rad- och kolumnfält i en pivottabell i Aspose.Cells för .NET

Lägga till ett fält i rad- eller kolumnregionen

Pivotfältets delsummor

Scenario 1 — Automatiska (standard) delsummor

Scenario 2 — Undertrycka alla delsummor (None)

Scenario 3 — Anpassad delmängd av delsummor (Sum + Average)

Sammanfattning

Pythonjava: Värdefält i Aspose.Cells for Python via Java

Lägga till ett fält i dataregionen

Ändra sammanfattningsfunktionen

Visa värdefält på rad- eller kolumnaxeln

Pythonjava: Lägga till filterfält i en pivottabell i Aspose.Cells för .NET

Introduktion

Lägga till ett filterfält

Lägga till ett filterfält med add_field_to_area

Lägga till ett filterfält med page_fields.add

Enkelvalsfiltrering (Visa ett sidobjekt)

Visa alla objekt

Visa ett specifikt objekt

Flervalsfiltrering

Vilket API och vilket läge ska jag använda?

Källdata har ändrats — använd `PivotCache.refresh()`

Endast visning/layout har ändrats — använd `calculateData()`

Migrera från den föråldrade `PivotTable.refreshData()`