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

Pythonnet: Filtrera pivottabeller efter etikett eller värde

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

Aspose.Cells erbjuder fem praktiska strategier för att filtrera data som visas i en pivottabell. Du kan tillämpa etikettfilter på textbaserade rad- eller kolumnfält, använda datumfilter när fältet endast innehåller datum-tid-celler eller tomma celler, tillämpa värdefilter mot aggregerade tal, använda topp 10-filter för att rangordna efter ett värdefält, eller manuellt dölja och visa enskilda pivotobjekt med hjälp av egenskapen is_hidden. Varje strategi exponeras genom dedikerade API:er på klasserna PivotField och PivotItem.

Introduktion

Pivottabeller är kraftfulla analysverktyg, men råa sammanfattningar innehåller ofta betydligt mer information än vad du behöver presentera. Filtrering är den primära mekanismen för att begränsa en pivottabell till de rader, kolumner eller värden som är relevanta för en specifik rapport. Aspose.Cells for Python via .NET speglar de filtreringsfunktioner som är tillgängliga i Microsoft Excel och exponerar dem programmatiskt så att rapportgenerering kan automatiseras fullständigt. Följande filtreringsstrategier behandlas i denna artikel:

Etikettfilter — filtrerar rad- eller kolumnfältsobjekt baserat på deras textetiketter.
Datumfilter — filtrerar rad- eller kolumnfält som endast innehåller datum-tid-värden (eller tomma värden).
Värdefilter — filtrerar objekt baserat på de aggregerade värdena i ett datafält.
Topp 10-filter — visar endast de N översta eller understa objekten rangordnade efter ett värdefält.
Dölj / visa pivotobjekt — styr manuellt synligheten för varje enskilt objekt i ett fält. Varje tillvägagångssätt använder en annan metod på klassen PivotField eller en egenskap på klassen PivotItem. Efter att du har tillämpat ett filter måste du anropa refresh_data() och calculate_data() på pivottabellen så att den cachade datan och de beräknade värdena återspeglar det nya filterläget.

Etikettfilter

Ett etikettfilter låter dig filtrera objekten i ett rad- eller kolumnfält genom att jämföra deras textetiketter mot ett mönster. Detta är användbart när du vill visa endast produkter vars namn börjar med en specifik bokstav, innehåller ett visst ord eller uppfyller något annat textbaserat kriterium. Aspose.Cells exponerar etikettfiltrering genom metoden PivotField.filter_by_label(PivotFilterType, label_string). Uppräkningen PivotFilterType innehåller värden som CaptionBeginsWith, CaptionContains, CaptionEndsWith, CaptionDoesNotContain, CaptionIsNotBlank, CaptionIsBlank och så vidare. Det andra argumentet anger den etikettsträng som används för jämförelse. Följande exempel läser in en arbetsbok som innehåller en befintlig pivottabell, tillämpar ett etikettfilter så att endast objekt vars etiketter börjar med ett angivet prefix förblir synliga, uppdaterar pivottabellen och sparar resultatet.

import aspose.cells as ac

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

# Ladda den befintliga arbetsboken som innehåller en pivottabell
workbook = ac.Workbook(fileName)

# Kom åt kalkylbladet via index (första kalkylbladet)
worksheet = workbook.worksheets[0]

# Kom åt pivottabellen via index
pivot_table = worksheet.pivot_tables[0]

# Hämta den första radens PivotField
row_field = pivot_table.row_fields[0]

# Använd etikettfiltret — visa endast radobjekt vars etiketter börjar med det angivna prefixet
row_field.filter_by_label(ac.PivotFilterType.CAPTION_BEGINS_WITH, prefix, "")

# Uppdatera och beräkna om pivottabelldatan så att filtret träder i kraft
pivot_table.pivot_cache.refresh()

# Spara arbetsboken tillbaka till disk
workbook.save(fileName)

Datumfilter

Datumfilter låter dig begränsa en pivottabell efter datumbaserade kriterier som idag, förra veckan, denna månad, nästa kvartal eller ett specifikt datumintervall. De är specialiserade filter som endast fungerar mot fält som lagrar datum-tid-information.

Datumfiltret fungerar endast när rad- eller kolumnområdet endast innehåller datum-tid-celler eller tomma värden. Om det underliggande fältet innehåller andra datatyper som tal eller text kommer datumfiltret inte att ge det förväntade resultatet. Se till att fältet är formaterat som ett datum och att alla värden är giltiga DateTime-instanser eller tomma celler innan du tillämpar detta filter.

Aspose.Cells exponerar datumfiltrering genom metoden PivotField.filter_by_date(PivotFilterType, *date_times). Uppräkningen PivotFilterType innehåller dedikerade datumvärden som Today, Yesterday, LastWeek, ThisWeek, NextWeek, LastMonth, ThisMonth, NextMonth, LastQuarter, ThisQuarter, NextQuarter, LastYear, ThisYear, NextYear och Between. Beroende på vald filtertyp skickar du ett eller två DateTime-värden (för Between skickar du start- och slutdatum). Följande exempel läser in en arbetsbok med en pivottabell vars radområde innehåller ett datumfält, tillämpar ett datumfilter som begränsar de synliga objekten till ett visst datumintervall, uppdaterar pivottabellen och sparar arbetsboken.

from datetime import datetime

input_path = "sample.xlsx"
output_path = "output_filtered.xlsx"

if not os.path.exists(input_path):
    raise FileNotFoundError("Source workbook not found.", input_path)

# Ladda den befintliga arbetsboken som innehåller pivottabellen
workbook = ac.Workbook(input_path)

# Åtkomst till kalkylbladet som innehåller pivottabellen (via index)
worksheet = workbook.worksheets[0]

# Åtkomst till pivottabellen via index
pivot_table = worksheet.pivot_tables[0]

# Hämta datum-PivotField från radområdet
# (Datumfilter fungerar bara när rad-/kolumnområdet endast innehåller datum-tid-celler eller tomma celler)
date_field = pivot_table.row_fields[0]

# Definiera datumpvillkoret för Between-filtret
start_date = datetime(2020, 1, 1)
end_date = datetime(2020, 12, 31)

# Tillämpa datumfiltret på pivotfältet
date_field.filter_by_date(ac.PivotFilterType.DATE_BETWEEN, start_date, end_date)

# Uppdatera och beräkna om pivottabellen så att filtret träder i kraft
pivot_table.pivot_cache.refresh()

# Spara arbetsboken
workbook.save(output_path)

Värdefilter

Värdefilter opererar på de aggregerade värden som en pivottabell beräknar i sitt dataområde. Istället för att matcha textetiketter jämför de numeriska totalsummor mot ett tröskelvärde. Typiska användningsfall inkluderar att visa endast produkter vars summa av försäljning överstiger ett målbelopp eller endast regioner vars antal transaktioner ligger inom ett intervall. Aspose.Cells exponerar värdefiltrering genom metoden PivotField.filter_by_value(value_field, PivotFilterType, *thresholds). Parametern PivotFilterType använder värden som ValueGreaterThan, ValueLessThan, ValueBetween, ValueEqual, ValueNotEqual, ValueGreaterThanOrEqual och ValueLessThanOrEqual. Parametern value_field anger vilket datafält som ska utvärderas, och det sista argumentet (eller de sista argumenten) anger tröskelvärdet (eller tröskelvärdena). Följande exempel läser in en arbetsbok med en pivottabell, tillämpar ett värdefilter som endast behåller objekt vars aggregerade försäljning överstiger ett numeriskt tröskelvärde, uppdaterar pivottabellen och sparar arbetsboken.

import aspose.cells as ac

workbook = ac.Workbook("sample.xlsx")
worksheet = workbook.worksheets[0]
pivot_table = worksheet.pivot_tables[0]

row_field = pivot_table.row_fields[0]
data_field = pivot_table.data_fields[0]

# Hitta datafältindex manuellt eftersom PivotFieldCollection inte har IndexOf
data_field_index = -1
for i in range(pivot_table.data_fields.count):
    if pivot_table.data_fields[i] == data_field:
        data_field_index = i
        break

if data_field_index >= 0:
    row_field.filter_by_value(data_field_index, ac.PivotFilterType.VALUE_GREATER_THAN, 5000, float('inf'))

pivot_table.pivot_cache.refresh()

workbook.save("output.xlsx")

Topp 10-filter

Topp 10-filtret är en specialiserad form av värdefilter som endast behåller de N översta eller understa objekten baserat på ett valt värdefält. Det används vanligtvis för rankningsrapporter som “topp 10 produkter efter intäkt” eller “botten 5 regioner efter försäljningsantal”.

Topp 10-filtret är endast effektivt när pivottabellen har ett eller flera värdepivotfält i dataområdet. Utan minst ett värdefält finns det inget aggregerat mått att rangordna objekten mot, och filtret kan inte tillämpas.

Aspose.Cells exponerar topp 10-filtrering genom metoden PivotField.filter_top_10(item_count, is_top, value_field, PivotFilterType). Parametern item_count anger hur många objekt som ska behållas, is_top anger om de översta objekten (True) eller de understa objekten (False) ska behållas, value_field refererar till det datafält som används för rankning, och PivotFilterType styr hur värdet beräknas (vanligtvis Sum, men även Count och Percent). Följande exempel läser in en arbetsbok med en pivottabell som innehåller ett värdefält, tillämpar ett topp 10-filter för att endast behålla de 10 översta objekten efter summa av försäljning, uppdaterar pivottabellen och sparar arbetsboken.

import aspose.cells as ac
import aspose.cells.pivot as acp

# Ladda den befintliga arbetsboken som innehåller pivottabellen
inputPath = "input.xlsx"
outputPath = "output.xlsx"
workbook = ac.Workbook(inputPath)

# Kom åt kalkylbladet som innehåller pivottabellen (index 0)
worksheet = workbook.worksheets[0]

# Kom åt pivottabellen via index
pivotTable = worksheet.pivot_tables[0]

# Bekräfta att det finns minst ett värde-PivotField i dataområdet
if pivotTable.data_fields.count == 0:
    raise Exception("Pivot table has no value (data) PivotField.")
valueField = pivotTable.data_fields[0]

# Hämta målradens PivotField (fältet vi vill tillämpa Topp 10 på)
rowField = pivotTable.row_fields[0]

# Det första (och enda) datafältet är på index 0; Topp 10 rangordnar efter det.
valueFieldIndex = 0

# Tillämpa Topp 10-filtret på radfältet:
#   - itemCount   = 10
#   - filterType  = PivotFilterType.Sum
#   - isTop       = true (topp N; false skulle betyda botten N)
#   - valueFieldIndex = index för datafältet som används för att rangordna poster
rowField.filter_top10(10, acp.PivotFilterType.Sum, True, valueFieldIndex)

# Uppdatera pivottabellens data och beräkna om den så att filtret träder i kraft
pivotTable.pivot_cache.refresh()

# Spara arbetsboken
workbook.save(outputPath)

Filtrera genom att dölja eller visa pivotobjekt

Utöver de strukturerade filter-API:erna låter Aspose.Cells dig styra synligheten för varje enskilt pivotobjekt direkt. Genom att iterera genom PivotItems-samlingen för en PivotField och växla egenskapen is_hidden kan du selektivt undertrycka specifika objekt utan att tillämpa ett formelbaserat filter. Att sätta is_hidden = True döljer objektet från pivottabellen; att sätta is_hidden = False visar det igen och gör det synligt. Detta tillvägagångssätt är användbart när filtreringsregeln är oregelbunden eller objektspecifik, till exempel att dölja ett litet antal namngivna kategorier som inte ska visas i en viss rapport. Exemplet nedan läser in en pivottabell, döljer ett specifikt objekt efter namn, visar hur man visar det igen, uppdaterar pivottabellen och sparar arbetsboken.

import aspose.cells as ac

# Ladda en befintlig arbetsbok som innehåller en pivottabell
workbook = ac.Workbook("pivot_table_sample.xlsx")

# Öppna det första kalkylbladet som innehåller pivottabellen
sheet = workbook.worksheets[0]

# Öppna pivottabellen via index (den första pivottabellen på bladet)
pivot_table = sheet.pivot_tables[0]

# Hämta mål-PivotField (det första radetikettfältet där vi kommer att dölja/visa objekt)
pivot_field = pivot_table.row_fields[0]

# Iterera genom PivotItems-samlingen för den valda PivotField
item_count = pivot_field.pivot_items.count
for i in range(item_count):
    item = pivot_field.pivot_items[i]

    # Dölj pivotobjekt som matchar ett specifikt namn/kriterium
    if item.name == "Item1" or item.name == "Item2":
        item.is_hidden = True

    # Demonstrera att visa igen: visa ett tidigare dolt pivotobjekt
    if item.name == "Item3":
        item.is_hidden = False

# Uppdatera och beräkna om pivottabellen så att ändringarna träder i kraft
pivot_table.pivot_cache.refresh()

# Spara arbetsboken — dolda objekt finns kvar i underliggande data
# men är exkluderade från den visade pivottabellens utdata
workbook.save("output_pivot_filtered.xlsx")

Sammanfattning

Aspose.Cells for Python via .NET tillhandahåller en komplett uppsättning filtreringsfunktioner för pivottabeller som matchar de som finns i Microsoft Excel. Etikett-, datum- och värdefilter täcker de vanligaste analysscenarierna, medan topp 10-filtret hanterar rankningsrapporter. När filtreringsregeln är oregelbunden erbjuder egenskapen PivotItem.is_hidden ett flexibelt reservalternativ på objektnivå. Genom att kombinera dessa strategier — till exempel att tillämpa ett etikettfilter och sedan dölja specifika objekt — kan du bygga exakt riktade pivottabellrapporter helt från kod.

Pythonnet: Hämta Cell objektet genom visningsnamn för PivotField i PivotTable

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

Aspose.Cells for Python via .NET tillhandahåller PivotTable.get_cell_by_display_name(display_name)-metoden som du kan använda för att komma åt cellobjektet genom visningsnamnet för pivottabellfält. Denna metod är användbar när du vill markera eller formatera rubriken för ditt pivottabellfält. Denna artikel förklarar hur du hämtar cellobjektet genom visningsnamnet för datafältet och sedan tillämpar formatering på det.

Hur man får cellobjektet genom visningsnamn för PivotField av PivotTable

Följande kod får åtkomst till den första pivottabellen i kalkylarket och sedan får cellen genom visningsnamn för det andra datafältet i pivottabellen. Det ändrar sedan fyllningsfärgen och teckensnittsfärgen på cellen till ljusblått och svart, respektive. Nedan visas skärmbilderna hur pivottabellen ser ut före och efter att koden har utförts.

Pivot-tabel - Före

Pivot-tabel - Efter

Pythonnet: Gruppera Pivot Fields i PivotTable

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

Möjliga användningsscenario

Microsoft Excel tillåter dig att gruppera pivottabellens fält. När det finns en stor mängd data relaterad till ett pivottabellfält är det ofta användbart att gruppera dem i avsnitt. Aspose.Cells for Python via .NET ger också denna funktion med hjälp av metoden PivotTable.set_manual_group_field().

Hur man grupperar Pivot-fält i pivottabellen

Följande exempelkod laddar den provpå Excel-filen och utför gruppering på det första pivotfältet med PivotTable.set_manual_group_field()-metoden. Sedan uppdaterar och beräknar det pivotabellens data och sparar arbetsboken som utdata Excel-fil. Skärmbilden visar effekten av exempelkoden på den provpå Excel-filen. Som du kan se på skärmbilden är det första pivotfältet nu grupperat efter månader och kvartal.

Exempelkod

Pythonnet: Pivottabell Dölj och Sortera data

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

Pivottabell Dölj och Sortera data med hjälp av Aspose.Cells för Python Excel-bibliotek

Aspose.Cells för Python via .NET stödjer att dölja och sortera data i pivottabellen. Följande kodsnutt demonstrerar denna funktion genom att sortera kolumnen Score i fallande ordning och sedan dölja raderna med ett poäng mindre än 60.

Käll- och utdata-excelfilerna som används i kodsnutten är bifogade för referens.

Källfil

Utgångsfil

Pythonnet: Anpassad sortering i Pivot tabell

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

Hur man ställer in anpassad sortering i pivot-tabell med hjälp av Aspose.Cells för Python Excel Library

Genom att använda Aspose.Cells för Python via .NET API kan du sortera pivot-tabeller efter fältvärden. Följande kodsnutt laddar den provexfilen och lägger till tre pivot-tabeller. Den första pivot-tabellen är utan anpassad sortering, den andra pivot-tabellen är sorterad på “SeaFood” radfältvärden och den tredje pivot-tabellen är sorterad på “28/07/2000” kolumnfältvärden.

Provfil och utdatafiler kan laddas ner här för att testa provkoden:

Källa Excelfil

Utmatnings-excelfil

Utmatnings-PD-fil

Exempelkod

Pythonnet: Lägg till filter i pivot tabell

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

Möjliga användningsscenario

När du skapar en pivot-tabell med kända data och vill filtrera pivot-tabellen, behöver du lära dig och använda filter. Det kan hjälpa dig att effektivt filtrera ut den data du vill ha. Genom att använda Aspose.Cells for Python via .NET API kan du lägga till filter på fältvärden i Pivot Tabeller.

Lägg till filter i pivot tabell med hjälp av Aspose.Cells för Python Excel-bibliotek

Se följande exempelkod. Den anger datan och skapar en pivot-tabell baserad på den. Sedan läggs ett filter på radfältet i pivot-tabellen. Slutligen sparas arbetsboken i utmatnings XLSX format. Efter att ha kört exempelkoden läggs en pivottabell med topp10-filter till arbetsbladet.

Exempelkod

Pythonnet: Rensa filter i pivot tabell

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

Möjliga användningsscenario

När du skapar en pivot-tabell med känd data och vill filtrera pivot-tabellen, måste du lära dig och använda filter. Det kan hjälpa dig att effektivt filtrera ut den data du vill ha. Genom att använda Aspose.Cells för Python via .NET API kan du utföra filter på fältvärden i Pivot-tabeller.

Hur man rensar filter i pivot-tabell i Excel

Rensa filter i pivot-tabell i Excel, följ dessa steg:

Välj den pivot-tabell du vill rensa filtret på.
Klicka på nedåtpilen för filtret som du vill rensa i pivot-tabellen.
Välj “Rensa filter” från rullgardinsmenyn.
Om du vill rensa alla filter från pivottabellen kan du också klicka på knappen “Rensa filter” på fliken PivotTable Analyze i Excel-ribbon.

Hur man rensar filter i pivot-tabell med Aspose.Cells för Python Excel-bibliotek

Rensa filter i pivot-tabell med hjälp av Aspose.Cells för Python via .NET. Se följande exempelkod.

Ställ in datan och skapa en pivottabell baserad på det.
Lägg till ett filter på radfältet i pivottabellen.
Spara arbetsboken i utdata XLSX -format. Efter att exemplet har körts läggs en pivottabell med top10-filter till i arket.
Rensa filtret på ett specifikt pivotfält. Efter att koden har körts för att rensa filtret kommer filtret på det specifika pivotfältet att rensas. Vänligen kontrollera utdata XLSX.