Documentation – Aggiungere campi riga e colonna a una tabella pivot in Aspose.Cells per .NET

Nodejscpp: Filtrare le tabelle pivot per etichetta o valore

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

Aspose.Cells offre cinque strategie pratiche per filtrare i dati visualizzati in una tabella pivot. È possibile applicare filtri per etichetta ai campi di riga o colonna basati su testo, utilizzare filtri per data quando il campo contiene solo celle di tipo data-ora o vuote, applicare filtri per valore rispetto ai numeri aggregati, utilizzare i filtri primi 10 per classificare in base a un campo valore, oppure nascondere e mostrare manualmente i singoli elementi pivot tramite la proprietà IsHidden. Ogni strategia è esposta tramite API dedicate sulle classi PivotField e PivotItem.

Introduzione

Le tabelle pivot sono potenti strumenti di analisi, ma i riepiloghi grezzi spesso contengono molte più informazioni di quelle che è necessario presentare. Il filtraggio è il meccanismo principale per restringere una tabella pivot alle righe, alle colonne o ai valori che interessano per un report specifico. Aspose.Cells for Node.js via C++ rispecchia le funzionalità di filtraggio disponibili in Microsoft Excel, esponendole in modo programmatico così che la generazione dei report possa essere completamente automatizzata.

In questo articolo vengono trattate le seguenti strategie di filtraggio:

Filtro per etichetta — filtra gli elementi di un campo di riga o colonna in base alle loro etichette di testo.
Filtro per data — filtra i campi di riga o colonna che contengono solo valori di tipo data-ora (o vuoti).
Filtro per valore — filtra gli elementi in base ai valori aggregati di un campo dati.
Filtro primi 10 — mostra solo i primi o gli ultimi N elementi classificati in base a un campo valore.
Nascondere/Mostrare elementi pivot — controlla manualmente la visibilità di ciascun singolo elemento in un campo.

Ogni approccio utilizza un metodo diverso sulla classe PivotField oppure una proprietà sulla classe PivotItem. Dopo aver applicato qualsiasi filtro, è necessario chiamare refreshData() e calculateData() sulla tabella pivot in modo che i dati memorizzati nella cache e i valori calcolati riflettano il nuovo stato del filtro.

Filtro per etichetta

Un filtro per etichetta consente di filtrare gli elementi di un campo di riga o colonna confrontando le loro didascalie di testo con un modello. Ciò è utile quando si desidera visualizzare solo i prodotti i cui nomi iniziano con una lettera specifica, contengono una determinata parola o soddisfano un altro criterio basato sulla didascalia.

Aspose.Cells espone il filtraggio per etichetta tramite il metodo PivotField.filterByLabel(PivotFilterType, string). L’enumerazione PivotFilterType include valori come CaptionBeginsWith, CaptionContains, CaptionEndsWith, CaptionDoesNotContain, CaptionIsNotBlank, CaptionIsBlank e così via. Il secondo argomento fornisce la stringa di etichetta utilizzata per il confronto.

L’esempio seguente carica una cartella di lavoro contenente una tabella pivot esistente, applica un filtro per etichetta in modo che solo gli elementi le cui didascalie iniziano con un prefisso specificato rimangano visibili, aggiorna la tabella pivot e salva il risultato.

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

// Carica la cartella di lavoro esistente contenente una tabella pivot
let workbook = new AsposeCells.Workbook(fileName);

// Accedi al foglio di lavoro tramite indice (primo foglio di lavoro)
let worksheet = workbook.getWorksheets().get(0);

// Accedi alla tabella pivot tramite indice
let pivotTable = worksheet.getPivotTables().get(0);

// Recupera il primo PivotField di riga
let rowField = pivotTable.getRowFields().get(0);

// Applica il filtro sulle etichette: mostra solo gli elementi di riga le cui etichette iniziano con il prefisso fornito
rowField.filterByLabel(AsposeCells.PivotFilterType.CaptionBeginsWith, prefix, "");

// Aggiorna e ricalcola i dati della tabella pivot affinché il filtro abbia effetto
pivotTable.getPivotCache().refresh();

// Salva la cartella di lavoro su disco
workbook.save(fileName);

Filtro per data

I filtri per data consentono di restringere una tabella pivot in base a criteri basati sulla data, come oggi, la settimana scorsa, questo mese, il prossimo trimestre o un intervallo di date specifico. Sono filtri specializzati che funzionano solo con campi che memorizzano informazioni di data e ora.

Il filtro per data funziona solo quando l’area di riga o di colonna contiene esclusivamente celle di tipo data-ora o valori vuoti. Se il campo sottostante contiene altri tipi di dati, come numeri o testo, il filtro per data non produrrà il risultato atteso. Assicurarsi che il campo sia formattato come data e che tutti i valori siano istanze DateTime valide oppure celle vuote prima di applicare questo filtro.

Aspose.Cells espone il filtraggio per data tramite il metodo PivotField.filterByDate(PivotFilterType, params DateTime[] values). L’enumerazione PivotFilterType contiene valori di data dedicati come Today, Yesterday, LastWeek, ThisWeek, NextWeek, LastMonth, ThisMonth, NextMonth, LastQuarter, ThisQuarter, NextQuarter, LastYear, ThisYear, NextYear e Between. A seconda del tipo di filtro scelto, si passano uno o due valori DateTime (per Between, si passano la data di inizio e la data di fine).

L’esempio seguente carica una cartella di lavoro con una tabella pivot la cui area di riga contiene un campo data, applica un filtro per data che limita gli elementi visibili a un particolare intervallo di date, aggiorna la tabella pivot e salva la cartella di lavoro.

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);
}

// Carica la cartella di lavoro esistente che contiene la tabella pivot
const workbook = new AsposeCells.Workbook(inputPath);

// Accedi al foglio di lavoro che contiene la tabella pivot (per indice)
const worksheet = workbook.getWorksheets().get(0);

// Accedi alla tabella pivot per indice
const pivotTable = worksheet.getPivotTables().get(0);

// Recupera il PivotField della data dall'area delle righe
// (Il filtro per data funziona solo quando l'area delle righe/colonne contiene solo celle di data-ora o vuote)
const dateField = pivotTable.getRowFields().get(0);

// Definisci il criterio della data per il filtro Between
const startDate = new Date(2020, 0, 1);
const endDate = new Date(2020, 11, 31);

// Applica il filtro per data sul campo pivot
dateField.filterByDate(AsposeCells.PivotFilterType.DateBetween, startDate, endDate);

// Aggiorna e ricalcola la tabella pivot affinché il filtro abbia effetto
pivotTable.getPivotCache().refresh();

// Salva la cartella di lavoro
workbook.save(outputPath);

Filtro per valore

I filtri per valore operano sui valori aggregati che una tabella pivot calcola nella propria area dati. Invece di confrontare etichette di testo, confrontano i totali numerici rispetto a una soglia. Casi d’uso tipici includono la visualizzazione solo dei prodotti la cui somma delle vendite supera un importo target oppure solo delle regioni il cui conteggio di transizioni rientra in un intervallo.

Aspose.Cells espone il filtraggio per valore tramite il metodo PivotField.filterByValue(PivotField valueField, PivotFilterType filterType, params object[] values). Il parametro filterType utilizza valori come ValueGreaterThan, ValueLessThan, ValueBetween, ValueEqual, ValueNotEqual, ValueGreaterThanOrEqual e ValueLessThanOrEqual. Il parametro valueField specifica quale campo dati deve essere valutato, mentre il/i valore/i finale/i fornisce la soglia o le soglie.

L’esempio seguente carica una cartella di lavoro con una tabella pivot, applica un filtro per valore che mantiene solo gli elementi le cui vendite aggregate superano una soglia numerica, aggiorna la tabella pivot e salva la cartella di lavoro.

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");

Filtro primi 10

Il filtro primi 10 è una forma specializzata di filtro per valore che mantiene solo i primi o gli ultimi N elementi in base a un campo valore scelto. È comunemente utilizzato per report di classificazione, come “i primi 10 prodotti per ricavi” o “le ultime 5 regioni per conteggio delle vendite”.

Il filtro primi 10 è efficace solo quando la tabella pivot dispone di uno o più campi pivot di valore nell’area dati. Senza almeno un campo valore, non esiste una misura aggregata rispetto alla quale classificare gli elementi e il filtro non può essere applicato.

Aspose.Cells espone il filtraggio primi 10 tramite il metodo PivotField.filterTop10(int itemCount, bool isTop, PivotField valueField, PivotFilterType filterType). Il parametro itemCount definisce quanti elementi mantenere, isTop indica se mantenere gli elementi superiori (true) o inferiori (false), valueField fa riferimento al campo dati utilizzato per la classificazione e filterType controlla come viene calcolato il valore (tipicamente Sum, ma anche Count e Percent).

L’esempio seguente carica una cartella di lavoro con una tabella pivot che contiene un campo valore, applica un filtro primi 10 per mantenere solo i 10 elementi più alti in base alla somma delle vendite, aggiorna la tabella pivot e salva la cartella di lavoro.

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

// Carica la cartella di lavoro esistente che contiene la tabella pivot
const inputPath = "input.xlsx";
const outputPath = "output.xlsx";
const workbook = new AsposeCells.Workbook(inputPath);

// Accedi al foglio di lavoro che contiene la tabella pivot (indice 0)
const worksheet = workbook.getWorksheets().get(0);

// Accedi alla tabella pivot tramite indice
const pivotTable = worksheet.getPivotTables().get(0);

// Verifica che ci sia almeno un PivotField di valore nell'area dati
if (pivotTable.getDataFields().getCount() === 0) {
    throw new Error("Pivot table has no value (data) PivotField.");
}
const valueField = pivotTable.getDataFields().get(0);

// Recupera il PivotField di riga di destinazione (il campo a cui vogliamo applicare Top 10)
const rowField = pivotTable.getRowFields().get(0);

// Il primo (e unico) campo dati è all'indice 0; Top 10 classifica in base ad esso.
const valueFieldIndex = 0;

// Applica il filtro Top 10 sul campo di riga:
//   - itemCount   = 10
//   - filterType  = PivotFilterType.Sum
//   - isTop       = true (top N; false significherebbe bottom N)
//   - valueFieldIndex = l'indice del campo dati utilizzato per classificare gli elementi
rowField.filterTop10(10, AsposeCells.PivotFilterType.Sum, true, valueFieldIndex);

// Aggiorna i dati della tabella pivot e ricalcolala affinché il filtro abbia effetto
pivotTable.getPivotTableCache().refresh();

// Salva la cartella di lavoro
workbook.save(outputPath);

Filtrare nascondendo o mostrando elementi pivot

Oltre alle API di filtraggio strutturato, Aspose.Cells consente di controllare direttamente la visibilità di ciascun singolo elemento pivot. Iterando attraverso la raccolta PivotItems di un PivotField e attivando/disattivando la proprietà IsHidden, è possibile eliminare selettivamente elementi specifici senza applicare un filtro basato su formule. Impostando IsHidden = true l’elemento viene nascosto nella tabella pivot; impostando IsHidden = false l’elemento viene mostrato nuovamente.

Questo approccio è utile quando la regola di filtraggio è irregolare o specifica per un elemento, come nascondere un numero limitato di categorie denominate che non devono apparire in un determinato report. L’esempio seguente carica una tabella pivot, nasconde un elemento specifico per nome, mostra come mostrarlo nuovamente, aggiorna la tabella pivot e salva la cartella di lavoro.

Cells = require("aspose.cells");

// Carica una cartella di lavoro esistente contenente una tabella pivot
const workbook = new AsposeCells.Workbook("pivot_table_sample.xlsx");

// Accedi al primo foglio di lavoro che contiene la tabella pivot
const sheet = workbook.getWorksheets().get(0);

// Accedi alla tabella pivot per indice (la prima tabella pivot nel foglio)
const pivotTable = sheet.getPivotTables().get(0);

// Recupera il PivotField di destinazione (il primo campo etichetta di riga in cui nasconderemo/mostreremo gli elementi)
const pivotField = pivotTable.getRowFields().get(0);

// Itera attraverso la raccolta PivotItems del PivotField selezionato
const itemCount = pivotField.getPivotItems().getCount();
for (let i = 0; i < itemCount; i++)
{
    const item = pivotField.getPivotItems().get(i);

    // Nascondi gli elementi pivot che corrispondono a un nome/criterio specifico
    if (item.getName() == "Item1" || item.getName() == "Item2")
    {
        item.setIsHidden(true);
    }

    // Dimostra come mostrare nuovamente: rivisualizza un elemento pivot precedentemente nascosto
    if (item.getName() == "Item3")
    {
        item.setIsHidden(false);
    }
}

// Aggiorna e ricalcola la tabella pivot in modo che le modifiche abbiano effetto
pivotTable.getPivotCache().refreshData();

// Salva la cartella di lavoro — gli elementi nascosti rimangono nei dati sottostanti
// ma sono esclusi dall'output della tabella pivot visualizzata
workbook.save("output_pivot_filtered.xlsx");

Riepilogo

Aspose.Cells for Node.js via C++ fornisce un set completo di funzionalità di filtraggio delle tabelle pivot che corrispondono a quelle disponibili in Microsoft Excel. I filtri per etichetta, per data e per valore coprono gli scenari analitici più comuni, mentre il filtro primi 10 gestisce i report di classificazione. Quando la regola di filtraggio è irregolare, la proprietà PivotItem.IsHidden offre un fallback flessibile a livello di elemento. Combinando queste strategie, ad esempio applicando un filtro per etichetta e poi nascondendo elementi specifici, è possibile creare report di tabelle pivot mirati con precisione interamente da codice.

Nodejscpp: Specificare la posizione assoluta dell elemento pivot

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

A volte, gli utenti devono specificare la posizione assoluta degli elementi pivot, l’API di Aspose.Cells for Node.js via C++ ha introdotto alcune nuove proprietà e un metodo per soddisfare questa esigenza.

Aggiunta la proprietà PivotItem.setPosition che può essere utilizzata per specificare l’indice di posizione in tutti i PivotItems indipendentemente dal nodo genitore. Aggiunta la proprietà PivotItem.setPositionInSameParentNode che può essere utilizzata per specificare l’indice di posizione nei PivotItems sotto lo stesso nodo genitore.
Aggiunta del metodo PivotItem.move per spostare l’elemento su o giù in base al valore del conteggio, dove il conteggio è il numero di posizioni per spostare l’elemento pivot su o giù. Se il valore del conteggio è inferiore a zero, l’elemento verrà spostato verso l’alto mentre se il valore del conteggio è maggiore di zero, l’elemento pivot si sposterà verso il basso, il parametro di tipo Boolean isSameParent specifica se l’operazione di spostamento deve essere eseguita nello stesso nodo padre o meno.
Il metodo PivotItem.move(int count) è stato desueto, pertanto si consiglia di usare invece il nuovo metodo PivotItem.move(number, boolean).

Il seguente codice di esempio crea una tabella pivot e specifica quindi le posizioni degli elementi pivot nello stesso nodo padre. Puoi scaricare i file Excel di origine e Excel di output per il tuo riferimento. Se apri il file Excel di output, vedrai che l’elemento pivot “4H12” si trova nella posizione 0 nel padre “K11” e “DIF400” si trova nella terza posizione. Allo stesso modo, CA32 si trova nella posizione 1 e AAA3 è nella posizione 2

Si prega di notare che è necessario chiamare i metodi PivotTable.RefreshData e PivotTable.CalculateData prima di utilizzare le proprietà PivotItem.setPosition, PivotItem.setPositionInSameParentNode e il metodo PivotItem.move.

Nodejscpp: Ottieni l oggetto Cell tramite DisplayName di PivotField di PivotTable

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

Aspose.Cells for Node.js via C++ fornisce il metodo PivotTable.getCellByDisplayName(string) che puoi usare per accedere all’oggetto cella tramite nome visuale del campo pivot. Questo metodo è utile quando si vuole evidenziare o formattare l’intestazione del campo pivot. Questo articolo spiega come recuperare l’oggetto cella tramite il nome visuale del campo dati e applicare successivamente la formattazione.

Come ottenere l’oggetto Cell tramite DisplayName di PivotField di PivotTable

Il codice seguente accede alla prima tabella pivot del foglio di lavoro e ottiene la cella per nome visualizzato del secondo campo dati della tabella pivot. Cambia quindi il colore di riempimento e il colore del carattere della cella rispettivamente in azzurro chiaro e nero. Di seguito sono mostrati gli screenshot di come appare la tabella pivot prima e dopo l’esecuzione del codice.

Tabella Pivot - Prima

Tabella Pivot - Dopo

Nodejscpp: Raggruppa i campi pivot nella tabella pivot

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

Possibili Scenari di Utilizzo

Microsoft Excel ti permette di raggruppare campi pivot della tabella pivot. Quando ci sono molti dati correlati a un campo pivot, è spesso utile raggrupparli in sezioni. Aspose.Cells for Node.js via C++ supporta anche questa funzione usando il metodo PivotTable.groupBy().

Come raggruppare i campi pivot nella tabella pivot

Il codice di esempio seguente carica il file Excel di esempio e esegue il raggruppamento sul primo campo pivot utilizzando il metodo PivotTable.groupBy(). Aggiorna quindi e calcola i dati della tabella pivot e salva il foglio di calcolo come file Excel di output. Lo screenshot mostra l’effetto del codice di esempio sul file Excel di esempio. Come si può vedere dallo screenshot, il primo campo pivot è ora raggruppato per mesi e trimestri.

Codice di Esempio

Nodejscpp: Nascondere e ordinare i dati della tabella pivot

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

Nascondi e ordina i datidelle tabelle pivot

Aspose.Cells for Node.js via C++ supporta nascondere e ordinare i dati nella tabella pivot. Il seguente frammento di codice illustra questa funzione ordinando la colonna Score in ordine decrescente e quindi nascondendo le righe con un punteggio inferiore a 60.

I file excel di origine e di output utilizzati nello snippet di codice sono allegati per riferimento.

File di origine

File di output

Nodejscpp: Aggiungere Filtro nella Tabella Pivot

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

Possibili Scenari di Utilizzo

Quando crei una tabella pivot con dati noti e vuoi filtrarla, devi imparare e usare il filtro. Può aiutarti a filtrare efficacemente i dati desiderati. Usando l’API Aspose.Cells for Node.js via C++, puoi aggiungere un filtro sui valori dei campi nelle tabelle pivot.

Aggiungi filtro in tabella pivot usando Aspose.Cells for Node.js via C++

Si prega di consultare il codice di esempio seguente. Imposta i dati e crea una tabella pivot basata su di essi. Quindi aggiungi un filtro sul campo di riga della tabella pivot. Infine, salvare il libro di lavoro nel formato output XLSX. Dopo aver eseguito il codice di esempio, viene aggiunta una tabella pivot con filtro top10 al foglio di lavoro.

Codice di Esempio

Nodejscpp: Elimina filtro nella tabella pivot

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

Possibili Scenari di Utilizzo

Quando crei una tabella pivot con dati noti e vuoi filtrarla, devi imparare e usare il filtro. Può aiutarti a filtrare efficacemente i dati desiderati. Usando l’API Aspose.Cells for Node.js via C++, puoi operare il filtro sui valori dei campi nelle tabelle pivot.

Come eliminare il filtro nella tabella pivot in Excel

Elimina filtro nella tabella pivot in Excel, segui questi passaggi:

Seleziona la tabella pivot da cui desideri eliminare il filtro.
Fai clic sulla freccia a discesa per il filtro che desideri eliminare nella tabella pivot.
Seleziona “Elimina filtro” dal menu a discesa.
Se desideri eliminare tutti i filtri dalla tabella pivot, puoi anche fare clic sul pulsante “Elimina filtri” nella scheda Analizza tabella pivot nel nastro di Excel.

Come cancellare il filtro in una tabella pivot usando Aspose.Cells for Node.js via C++

Cancella il filtro in una tabella pivot usando Aspose.Cells for Node.js via C++. Consulta il seguente esempio di codice.

Impostare i dati e creare una tabella pivot basata su di essi.
Aggiungere un filtro sul campo di riga della tabella pivot.
Salvare il workbook nel formato output XLSX. Dopo aver eseguito il codice di esempio, una tabella pivot con filtro top10 viene aggiunta al foglio di lavoro.
Cancella il filtro su un campo pivot specifico. Dopo aver eseguito il codice per cancellare il filtro, il filtro sul campo pivot specifico verrà cancellato. Si prega di controllare il output XLSX.

Codice di Esempio

Nodejscpp: Ordinamento personalizzato nella Tabella Pivot

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

Come impostare un ordinamento personalizzato nella tabella pivot utilizzando la libreria Aspose.Cells for Node.js via C++

Utilizzando l’API Aspose.Cells for Node.js via C++, puoi ordinare le tabelle pivot sui valori dei campi. Il seguente frammento di codice carica il file excel di esempio e aggiunge tre tabelle pivot. La prima tabella pivot è senza ordinamento personalizzato, la seconda è ordinata sui valori del campo riga “SeaFood” e la terza sui valori del campo colonna “28/07/2000”.

Il file di origine e i file di output di esempio possono essere scaricati da qui per testare il codice di esempio:

File Excel di Origine

File Excel di Output

File PDF di Output