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

Java: 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 bara 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 egenskapen IsHidden. 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 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 viktiga för en specifik rapport. Aspose.Cells for Java speglar de filtreringsfunktioner som finns i Microsoft Excel och exponerar dem programmatiskt så att rapportgenerering kan automatiseras fullständigt.

Följande filtreringsstrategier behandlas i den här artikeln:

Etikettfilter — filtrerar rad- eller kolumnfältsobjekt baserat på deras textetiketter.
Datumfilter — filtrerar rad- eller kolumnfält som bara 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. När du har tillämpat ett filter måste du anropa refreshData() och calculateData() på pivottabellen så att cachelagrade data och beräknade värden återspeglar det nya filtertillståndet.

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 matchar något annan etikettbaserad kriterium.

Aspose.Cells exponerar etikettfiltrering genom metoden PivotField.filterByLabel(PivotFilterType, String). Uppräkningen PivotFilterType inkluderar 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 com.aspose.cells.*;

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

// Ladda den befintliga arbetsboken som innehåller en pivottabell
Workbook workbook = new Workbook(fileName);

// Hämta kalkylbladet via index (första kalkylbladet)
Worksheet worksheet = workbook.getWorksheets().get(0);

// Hämta pivottabellen via index
PivotTable pivotTable = worksheet.getPivotTables().get(0);

// Hämta det första radens PivotField
PivotField rowField = pivotTable.getRowFields().get(0);

// Tillämpa etikettfiltret - visa endast radobjekt vars etiketter börjar med det angivna prefixet
rowField.filterByLabel(PivotFilterType.CAPTION_BEGINS_WITH, prefix, "");

// Uppdatera och beräkna om pivottabellens data så att filtret träder i kraft
pivotTable.refreshData();

// Spara arbetsboken tillbaka till disken
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 bara 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.filterByDate(PivotFilterType, params DateTime[] values). 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.

import java.io.File;
import java.io.FileNotFoundException;

String inputPath = "sample.xlsx";
String outputPath = "output_filtered.xlsx";

if (!new File(inputPath).exists())
{
    throw new FileNotFoundException("Source workbook not found: " + inputPath);
}

// Ladda den befintliga arbetsboken som innehåller pivottabellen
Workbook workbook = new Workbook(inputPath);

// Kom åt kalkylbladet som innehåller pivottabellen (via index)
Worksheet worksheet = workbook.getWorksheets().get(0);

// Kom åt pivottabellen via index
PivotTable pivotTable = worksheet.getPivotTables().get(0);

// Hämta datum-PivotField från radområdet
// (Datumfilter fungerar bara när rad-/kolumnområdet endast innehåller datum-tidsceller eller tomma celler)
PivotField dateField = pivotTable.getRowFields().get(0);

// Definiera datumvillkoret för Between-filtret
DateTime startDate = new DateTime(2020, 1, 1);
DateTime endDate = new DateTime(2020, 12, 31);

// Tillämpa datumfiltret på pivotfältet
dateField.filterByDate(PivotFilterType.DATE_BETWEEN, startDate, endDate);

// Uppdatera och beräkna om pivottabellen så att filtret träder i kraft
pivotTable.refreshData();

// Spara arbetsboken
workbook.save(outputPath);

Värdefilter

Värdefilter arbetar 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 totaler 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.filterByValue(PivotField valueField, PivotFilterType filterType, params Object[] values). Parametern filterType använder värden som ValueGreaterThan, ValueLessThan, ValueBetween, ValueEqual, ValueNotEqual, ValueGreaterThanOrEqual och ValueLessThanOrEqual. Parametern valueField 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 com.aspose.cells.*;

Workbook workbook = new Workbook("sample.xlsx");
Worksheet worksheet = workbook.getWorksheets().get(0);
PivotTable pivotTable = worksheet.getPivotTables().get(0);

PivotField rowField = pivotTable.getRowFields().get(0);
PivotField dataField = pivotTable.getDataFields().get(0);

// Hitta datafältets index manuellt eftersom PivotFieldCollection inte har IndexOf
int dataFieldIndex = -1;
for (int i = 0; i < pivotTable.getDataFields().getCount(); i++)
{
    if (pivotTable.getDataFields().get(i) == dataField)
    {
        dataFieldIndex = i;
        break;
    }
}

if (dataFieldIndex >= 0)
{
    rowField.filterByValue(dataFieldIndex, PivotFilterType.VALUE_GREATER_THAN, 5000, Double.MAX_VALUE);
}

pivotTable.refreshData();

workbook.save("output.xlsx");

Topp 10-filter

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

Topp 10-filtret är endast effektivt när pivottabellen har ett eller flera värde-pivotfä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.filterTop10(int itemCount, boolean isTop, PivotField valueField, PivotFilterType filterType). Parametern itemCount definierar hur många objekt som ska behållas, isTop anger om de översta objekten (true) eller de understa objekten (false) ska behållas, valueField refererar till det datafält som används för rankning, och filterType 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 högsta objekten efter summa av försäljning, uppdaterar pivottabellen och sparar arbetsboken.

import com.aspose.cells.*;

// Ladda den befintliga arbetsboken som innehåller pivottabellen
String inputPath = "input.xlsx";
String outputPath = "output.xlsx";
Workbook workbook = new Workbook(inputPath);

// Kom åt kalkylbladet som innehåller pivottabellen (index 0)
Worksheet worksheet = workbook.getWorksheets().get(0);

// Kom åt pivottabellen via index
PivotTable pivotTable = worksheet.getPivotTables().get(0);

// Bekräfta att det finns minst ett värde-PivotField i dataområdet
if (pivotTable.getDataFields().getCount() == 0)
{
    throw new RuntimeException("Pivot table has no value (data) PivotField.");
}
PivotField valueField = pivotTable.getDataFields().get(0);

// Hämta målets rad-PivotField (fältet vi vill tillämpa Top 10 på)
PivotField rowField = pivotTable.getRowFields().get(0);

// Det första (och enda) datafältet finns på index 0; Top 10 rangordnar efter det.
int valueFieldIndex = 0;

// Tillämpa Top 10-filtret på radfältet:
//   - itemCount   = 10
//   - filterType  = PivotFilterType.SUM
//   - isTop       = true (topp N; false skulle betyda botten N)
//   - valueFieldIndex = indexet för datafältet som används för att rangordna objekten
rowField.filterTop10(10, PivotFilterType.SUM, true, valueFieldIndex);

// Uppdatera pivottabellens data och beräkna om den så att filtret träder i kraft
pivotTable.refreshData();

// 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 IsHidden kan du selektivt undertrycka specifika objekt utan att tillämpa ett formelbaserat filter. Att sätta IsHidden = true döljer objektet från pivottabellen; att sätta IsHidden = false visar det igen och gör det synligt.

Detta tillvägagångssätt är användbart när filterregeln är oregelbunden eller objektspecifik, till exempel att dölja ett fåtal namngivna kategorier som inte ska visas i en viss rapport. Exemplet nedan läser in en pivottabell, döljer ett specifikt objekt med namn, visar hur man visar det igen, uppdaterar pivottabellen och sparar arbetsboken.

import com.aspose.cells.*;

// Ladda en befintlig arbetsbok som innehåller en pivottabell
Workbook workbook = new Workbook("pivot_table_sample.xlsx");

// Öppna det första kalkylbladet som innehåller pivottabellen
Worksheet sheet = workbook.getWorksheets().get(0);

// Öppna pivottabellen via index (den första pivottabellen på arket)
PivotTable pivotTable = sheet.getPivotTables().get(0);

// Hämta mål-PivotField (det första radetikettfältet där vi kommer att dölja/visa objekt)
PivotField pivotField = pivotTable.getRowFields().get(0);

// Iterera genom PivotItems-samlingen för den valda PivotField
int itemCount = pivotField.getPivotItems().getCount();
for (int i = 0; i < itemCount; i++)
{
    PivotItem item = pivotField.getPivotItems().get(i);

    // Dölj pivotobjekt som matchar ett specifikt namn/villkor
    if (item.getName() == "Item1" || item.getName() == "Item2")
    {
        item.setHidden(true);
    }

    // Demonstrera att visa igen: visa ett tidigare dolt pivotobjekt
    if (item.getName() == "Item3")
    {
        item.setHidden(false);
    }
}

// Uppdatera och beräkna om pivottabellen så att ändringarna träder i kraft
pivotTable.refreshData();

// Spara arbetsboken - dolda objekt finns kvar i underliggande data
// men är exkluderade från den visade pivottabellutdata
workbook.save("output_pivot_filtered.xlsx");

Sammanfattning

Aspose.Cells for Java erbjuder en komplett uppsättning filtreringsfunktioner för pivottabeller som motsvarar de som finns i Microsoft Excel. Etikett-, datum- och värdefilter täcker de vanligaste analysscenarierna, medan topp 10-filtret hanterar rankningsrapporter. När filterregeln är oregelbunden erbjuder egenskapen PivotItem.IsHidden 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.

Java: Anpassad sortering i Pivot tabell

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

Anpassad sortering i Pivot-tabell

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

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

Källa Excel-fil

Utdata Excel-fil

Utdata PDF-fil

Java: Ange den absoluta positionen för Pivot Item

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

Ibland behöver användaren ange den absoluta positionen för pivotobjekten. Aspose.Cells API har exponerat några nya egenskaper och en metod för att uppfylla detta användarkrav.

Lagt till egenskapen PivotItem.setPosition() som kan användas för att ange positionens index för alla PivotItems oavsett föräldernod. Lagt till egenskapen PivotItem.setPositionInSameParentNode() som kan användas för att ange positionens index för PivotItems under samma föräldernod.
Tillagt PivotItem.move(int count, boolean isSameParent)-metod för att flytta objektet uppåt eller nedåt baserat på räkningsvärdet, där räkningen är antalet positioner att flytta PivotItem uppåt eller nedåt. Om räkningsvärdet är mindre än noll flyttas objektet uppåt medan om räkningsvärdet är större än noll kommer PivotItem att flyttas nedåt, Boolean-typen ärSameParent- parameter som anger om flyttoperationen måste utföras i samma föräldernod eller inte.
Ogiltigförklarade metoden PivotItem.move(int count), därför rekommenderas det att istället använda den nyttillagda metoden PivotItem.move(int count, boolean isSameParent).

Observera att det är nödvändigt att anropa metoderna PivotTable.refreshData and PivotTable.calculateData innan du använder egenskaperna PivotItem.setPosition(), PivotItem.setPositionInSameParentNode() och metoden PivotItem.move(int count, boolean isSameParent).

Exempelkod

Följande exempelkod skapar en pivot-tabell och anger sedan pivotobjektens positioner i samma föräldernod.

Java: Gruppera Pivot Fields i PivotTable

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

Möjliga användningsscenario

Microsoft Excel gör det möjligt att gruppera pivotfält i pivot-tabellen. När det finns en stor mängd data relaterad till ett pivotfält, är det ofta användbart att gruppera dem i sektioner. Aspose.Cells tillhandahåller också denna funktion med hjälp av metoden PivotTable.setManualGroupField().

Gruppera Pivot Fields i PivotTable

Följande kodexempel laddar in den exempelvisk filen och grupperar sedan det första pivotfältet med hjälp av metoden PivotTable.setManualGroupField(). Sedan uppdateras och beräknas data i pivot-tabellen och arbetsboken sparas som den utdataexempelviska filen. Skärmbilden visar effekten av kodexemplet på exempelvisk filen. Som du kan se i skärmbilden är det första pivotfältet nu grupperat efter månader och kvartal.

Exempelkod

Java: Pivottabell Dölj och Sortera data

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

Pivottabell Dölj och Sortera data

Aspose.Cells stödjer att gömma och sortera data i pivottabellen. Följande kodsnutt demonstrerar denna funktion genom att sortera kolumnen Score i fallande ordning och sedan gömma raderna med ett värde mindre än 60.

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

Källfil

Utfilsfil

Java: Pivottfilter

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 behöver du lära dig och använda filter. Det kan hjälpa dig att effektivt filtrera ut önskad data. Genom att använda Aspose.Cells Java API kan du lägga till filter på fältvärden i pivot tabeller.

Lägg till filter i pivottabell i Excel

Lägg till filter i pivottabell i Excel, följ dessa steg:

Välj den pivot-tabell du vill rensa filtret på.
Klicka på nedåtpilen för filtret du vill lägga till i pivottabellen.
Välj “Topp 10” från rullgardinsmenyn.
Ange visningsläge och antalet filter.

Lägg till filter i pivottabell

Se följande exempelkod. Den ställer in datan och skapar en PivotTable baserat på den. Sedan läggs ett filter på radfältet i pivot tabellen. Slutligen sparas arbetsboken i output XLSX-formatet. Efter att exempelkoden har körts har en pivot-tabell med top10-filter lagts till i kalkylbladet.

Exempelkod

Rensa filter i pivottabell 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.

Rensa filter i pivottabell

Vänligen se följande exempelkod. Det ställer in datat och skapar en PivotTabell baserad på det. Lägg sedan till ett filter på radfältet i Pivot-tabellen. Slutligen sparar den arbetsboken i formatet output XLSX. Efter att ha utfört exempelkoden har en pivot-tabell med top10-filter lagts till i kalkylarket. Efter att ha lagt till ett filter, när vi behöver oberikatat data kan vi rensa filtret på ett specifikt pivoton. Efter att ha utfört koden för att rensa filtret, kommer filtret på det specifika pivotelementet rensas. Var vänlig och kolla output XLSX.

Exempelkod

Java: 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 de data du vill ha. Genom att använda Aspose.Cells API kan du operaera filter på fältvärden i Pivot-tabeller.

Rensa 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.

Rensa filter i Pivot-tabellen

Exempelkod

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

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

Aspose.Cells tillhandahåller metoden PivotTable.getCellByDisplayName() som du kan använda för att komma åt cellobjektet efter displaynamnet för pivottabelfältet. Denna metod är användbar när du vill markera eller formatera rubriken för ditt pivottabelfält. Denna artikel förklarar hur du hämtar cellobjektet efter displaynamnet för datafältet och därefter tillämpar formatering.

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

Den följande koden får åtkomst till den första pivottabellen i kalkylbladet och hämtar sedan cellen via visningsnamnet för det andra datavärdet i pivottabellen. Sedan ändrar den fyllfärgen och teckensnittsfärgen på cellen till ljusblått respektive svart. Nedan visas skärmbilderna på hur pivottabellen ser ut före och efter kodens exekvering.

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

Java: Filtrera pivottabeller efter etikett eller värde

Introduktion

Etikettfilter

Datumfilter

Värdefilter

Topp 10-filter

Filtrera genom att dölja eller visa pivotobjekt

Sammanfattning

Java: Anpassad sortering i Pivot tabell

Anpassad sortering i Pivot-tabell

Java: Ange den absoluta positionen för Pivot Item

Exempelkod

Java: Gruppera Pivot Fields i PivotTable

Möjliga användningsscenario

Gruppera Pivot Fields i PivotTable

Exempelkod

Java: Pivottabell Dölj och Sortera data

Pivottabell Dölj och Sortera data

Java: Pivottfilter

Möjliga användningsscenario

Lägg till filter i pivottabell i Excel

Lägg till filter i pivottabell

Exempelkod

Rensa filter i pivottabell i Excel

Rensa filter i pivottabell

Exempelkod

Java: Rensa filter i pivot tabell

Möjliga användningsscenario

Rensa filter i pivot-tabell i Excel

Rensa filter i Pivot-tabellen

Exempelkod

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

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

Pivot-tabell - Innan

Pivot-tabell - Efter