Filtrera pivottabeller efter etikett eller värde

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:

1. Etikettfilter — filtrerar rad- eller kolumnfältsobjekt baserat på deras textetiketter.
2. Datumfilter — filtrerar rad- eller kolumnfält som bara innehåller datum-tid-värden (eller tomma värden).
3. Värdefilter — filtrerar objekt baserat på de aggregerade värdena i ett datafält.
4. Topp 10-filter — visar endast de N översta eller understa objekten rangordnade efter ett värdefält.
5. 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.