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

Nodejscpp: 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 de data som visas i en pivottabell. Du kan använda etikettfilter på textbaserade rad- eller kolumnfält, använda datumfilter när fältet endast innehåller datum-/tidsceller eller tomma celler, använda 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 analytiska verktyg, 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 Node.js via C++ 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-/tidsvärden (eller tomma celler).
Värdefilter — filtrerar objekt baserat på de aggregerade värdena i ett datafält.
Topp 10-filter — visar endast de översta eller understa N objekten rangordnade efter ett värdefält.
Dölj / visa pivotobjekt — manuellt styr 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 refreshData() och calculateData() på pivottabellen så att de cachelagrade data och beräknade värdena å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 textbeskrivningar 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 beskrivningsbaserat kriterium. Aspose.Cells exponerar etikettfiltrering genom metoden PivotField.filterByLabel(PivotFilterType, 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örelsen. Följande exempel läser in en arbetsbok som innehåller en befintlig pivottabell, tillämpar ett etikettfilter så att endast objekt vars beskrivningar börjar med ett angivet prefix förblir synliga, uppdaterar pivottabellen och sparar resultatet.

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

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

// Åtkomst till kalkylbladet via index (första kalkylbladet)
let worksheet = workbook.getWorksheets().get(0);

// Åtkomst till pivottabellen via index
let pivotTable = worksheet.getPivotTables().get(0);

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

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

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

// Spara arbetsboken tillbaka till disk
workbook.save(fileName);

Datumfilter

Datumfilter låter dig begränsa en pivottabell efter datumbaserade kriterier så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-/tidsinformation.

Datumfiltret fungerar endast när rad- eller kolumnområdet endast innehåller datum-/tidsceller eller tomma värden. Om det underliggande fältet innehåller andra datatyper så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 så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.

const AsposeCells = require("aspose.cells");
const fs = require("fs");

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

if (!fs.existsSync(inputPath))
{
    throw new Error("Source workbook not found: " + inputPath);
}

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

// Öppna kalkylbladet som innehåller pivottabellen (via index)
const worksheet = workbook.getWorksheets().get(0);

// Öppna pivottabellen via index
const 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)
const dateField = pivotTable.getRowFields().get(0);

// Definiera datumvillkoret för Between-filtret
const startDate = new Date(2020, 0, 1);
const endDate = new Date(2020, 11, 31);

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

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

// 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 totalsummor mot ett tröskelvärde. Typiska användningsfall inkluderar att endast visa 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 så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.

let dataFieldIndex = -1;
for (let i = 0; i < pivotTable.getDataFields().getCount(); i++) {
    if (pivotTable.getDataFields().get(i) === dataField) {
        dataFieldIndex = i;
        break;
    }
}

if (dataFieldIndex >= 0) {
    rowField.filterByValue(dataFieldIndex, AsposeCells.PivotFilterType.ValueGreaterThan, 5000, Number.MAX_VALUE);
}

pivotTable.getPivotCache().refresh();

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 rangordningsrapporter så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.filterTop10(int itemCount, bool isTop, PivotField valueField, PivotFilterType filterType). Parametern itemCount anger 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 rangordning, 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.

const AsposeCells = require("aspose.cells");

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

// Få åtkomst till kalkylbladet som innehåller pivottabellen (index 0)
const worksheet = workbook.getWorksheets().get(0);

// Få åtkomst till pivottabellen via index
const 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 Error("Pivot table has no value (data) PivotField.");
}
const valueField = pivotTable.getDataFields().get(0);

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

// Det första (och enda) datafältet finns vid index 0; Topp 10 rangordnar efter det.
const 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 = indexet för det datafält som används för att rangordna objekt
rowField.filterTop10(10, AsposeCells.PivotFilterType.Sum, true, valueFieldIndex);

// Uppdatera pivottabellens data och beräkna om den så att filtret träder i kraft
pivotTable.getPivotTableCache().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 samlingen PivotItems för ett PivotField och växla egenskapen IsHidden kan du selektivt utelämna specifika objekt utan att tillämpa ett formelbaserat filter. Genom att sätta IsHidden = true döljs objektet från pivottabellen; genom att sätta IsHidden = false visas det igen och blir 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.

const AsposeCells = require("aspose.cells");

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

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

// Hämta pivottabellen via index (den första pivottabellen på arket)
const pivotTable = sheet.getPivotTables().get(0);

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

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

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

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

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

// Spara arbetsboken — dolda objekt finns kvar i underliggande data
// men exkluderas från den visade pivottabellens utdata
workbook.save("output_pivot_filtered.xlsx");

Sammanfattning

Aspose.Cells for Node.js via C++ erbjuder 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 analytiska scenarierna, medan topp 10-filtret hanterar rangordningsrapporter. När filtreringsregeln ä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.

Nodejscpp: Specificera den absoluta positionen för pivotposten

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

Ibland behöver användaren ange pivottitemättets absoluta position, API:et för Aspose.Cells for Node.js via C++ har introducerat några nya egenskaper och en metod för att tillgodose användarens krav.

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.
Lagt till metoden PivotItem.move för att flytta posten upp eller ner baserat på räkningsvärdet, där räkningsvärdet är antalet positioner att flytta PivotItem upp eller ner. Om räkningsvärdet är mindre än noll kommer posten att flyttas upp, medan om räkningsvärdet är större än noll kommer PivotItem att flyttas ner, Boolean typen isSameParent-parameter specificerar om flytoperationen måste utföras i samma föräldernod eller inte.
Obsoletade metoden PivotItem.move(number, boolean) PivotItem.move(int count) därför rekommenderas det att använda den nyare tillagda metoden PivotItem.move(number, boolean) istället.

Följande provkod skapar en pivottabell och sedan specificerar den pivotpostens positioner i samma föräldernod. Du kan ladda ner käll-Excel- och utdata-Excel-filer för din referens. Om du öppnar utdata-Excel-filen kommer du att se att pivotposten “4H12” är på 0: e position i förälder “K11” och “DIF400” är på 3: e position. På samma sätt är CA32 på position 1 och AAA3 är på position 2.

Observera att det är nödvändigt att använda metoderna PivotItem.setPosition och PivotItem.setPositionInSameParentNode i början av applikationen, det vill säga; innan du kallar några andra objekt i Aspose.Cells API.

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

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

Aspose.Cells for Node.js via C++ tillhandahåller PivotTable.getCellByDisplayName(string) metoden som du kan använda för att komma åt cell-objektet via displaynamnet för pivottabelfältet. Denna metod är användbar när du vill markera eller formatera rubriken för pivottabelfältet. Denna artikel förklarar hur man hämtar cell-objektet via displaynamnet för dataramen och sedan tillämpar formatering på den.

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

Nodejscpp: Gruppera Pivot Fields i PivotTable

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

Möjliga användningsscenario

Microsoft Excel tillåter att du grupperar pivottabelfält i pivottabellen. När det finns mycket data relaterad till ett pivottabelfält kan det vara användbart att gruppera dem i sektioner. Aspose.Cells for Node.js via C++ tillhandahåller också denna funktion med hjälp av PivotTable.groupBy() metoden.

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.groupBy()-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

Nodejscpp: Pivottabell Dölj och Sortera data

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

Pivottabell Dölj och Sortera data

Aspose.Cells for Node.js via C++ stöder att dölja och sortera data i pivottabellen. Följande kodsnutt visar denna funktion genom att sortera Score-kolumnen i fallande ordning och sedan dölja rader med poäng mindre än 60.

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

Källfil

Utgångsfil

Nodejscpp: Anpassad sortering i Pivot tabell

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

Hur man ställer in anpassad sortering i pivot-tabell med Aspose.Cells for Node.js via C++-biblioteket

Genom att använda Aspose.Cells for Node.js via C++ API kan du sortera pivot-tabeller på fältvärden. Följande kodavsnitt laddar ett exempel-Excel och lägger till tre pivot-tabeller. Den första utan anpassad sortering, den andra sorteras på “SeaFood”-radsfältvärden, och den tredje sorteras 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

Nodejscpp: Lägg till filter i pivot tabell

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

Möjliga användningsscenario

När du skapar en pivottabell med känd data och vill filtrera pivottabellen måste du lära dig och använda filter. Det kan hjälpa dig att effektivt filtrera bort de data du vill ha. Genom att använda Aspose.Cells for Node.js via C++ API kan du lägga till filter på fältvärden i pivottabeller.

Lägg till filter i pivottabell med Aspose.Cells for Node.js via C++

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

Nodejscpp: Rensa filter i pivot tabell

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

Möjliga användningsscenario

När du skapar en pivottabell med känd data och vill filtrera pivottabellen måste du lära dig och använda filter. Det kan hjälpa dig att effektivt filtrera bort de data du vill ha. Med Aspose.Cells for Node.js via C++ API kan du operera filter på fältvärden i pivottabeller.

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 for Node.js via C++

Rensa filter i Pivot-tabell med hjälp av Aspose.Cells for Node.js via C++. 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.