Questa guida descrive come e perché utilizzare l'API Fogli Google per creare tabelle pivot nei fogli di lavoro.
Che cos'è una tabella pivot?
Le tabelle pivot consentono di riepilogare i dati nel foglio di lavoro, aggregando, ordinando, conteggiando o calcolando la media automaticamente e visualizzando i risultati riepilogati in una nuova tabella. Una tabella pivot agisce come una sorta di query su un set di dati di origine. Questi dati di origine si trovano in un'altra posizione nel foglio di lavoro e la tabella pivot presenta una visualizzazione elaborata dei dati.
Ad esempio, considera il seguente set di dati sulle vendite:
A | B | C | D | E | F | G | |
1 | Categoria elemento | Numero modello | Costo | Quantità | Regione | Commerciale | Data di spedizione |
2 | Ruota | W-24 | 20,50 $ | 4 | Occidentale | Beth | 1/03/2016 |
3 | Porta | D-01X | $15,00 | 2 | Meridionale | Amir | 15/03/2016 |
4 | Motore | ENG-0134 | € 100 | 1 | Nord | Martina | 20/03/2016 |
5 | Frame | FR-0B1 | 34,00 $ | 8 | Orientale | Anna | 12/03/2016 |
6 | Riquadro | P-034 | $ 6,00 | 4 | Nord | Devyn | 2/04/2016 |
7 | Riquadro | P-052 | 11,50 $ | 7 | Orientale | Erik | 16/05/2016 |
8 | Ruota | W-24 | 20,50 $ | 11 | Meridionale | Sheldon | 30/04/2016 |
9 | Motore | ENG-0161 | 330,00 $ | 2 | Nord | Jessica | 2/07/2016 |
10 | Porta | D-01Y | 29,00 $ | 6 | Occidentale | Armando | 13/03/2016 |
11 | Frame | FR-0B1 | 34,00 $ | 9 | Meridionale | Yuliana | 27/02/2016 |
12 | Riquadro | P-102 | 3 $ | 15 | Occidentale | Martina | 18/04/2016 |
13 | Riquadro | P-105 | 8,25 $ | 13 | Occidentale | Jessica | 20/06/2016 |
14 | Motore | ENG-0211 | 283,00 $ | 1 | Nord | Amir | 21/06/2016 |
15 | Porta | D-01X | $15,00 | 2 | Occidentale | Armando | 3/07/2016 |
16 | Frame | FR-0B1 | 34,00 $ | 6 | Meridionale | Martina | 15/07/2016 |
17 | Ruota | W-25 | 20,00 $ | 8 | Meridionale | Anna | 2/05/2016 |
18 | Ruota | W-11 | 29,00 $ | 13 | Orientale | Erik | 19/05/2016 |
19 | Porta | D-05 | 17,70 $ | 7 | Occidentale | Beth | 28/06/2016 |
20 | Frame | FR-0B1 | 34,00 $ | 8 | Nord | Sheldon | 30/03/2016 |
Puoi utilizzare una tabella pivot per creare un report che mostra quanti di ciascun numero di modello sono stati venduti in ogni regione:
Per il codice sorgente utilizzato per generare questa tabella pivot, consulta la sezione Esempio riportata di seguito.
Dopo aver posizionato una tabella pivot in un foglio di lavoro, gli utenti possono modificare in modo interattivo la struttura e i dettagli del riepilogo utilizzando l'interfaccia utente di Fogli.
Utilizzo delle tabelle pivot
Una definizione di tabella pivot è associata a una singola cella su un foglio. Sebbene l'aspetto visualizzato sia costituito da molte celle in altezza e larghezza, in modo programmatico si trova in una coordinata di singola cella. Questa cella diventa l'angolo in alto a sinistra della tabella pivot visualizzata, con l'estensione orizzontale e verticale determinata dalla definizione.
Aggiungere una tabella pivot
Per aggiungere una tabella pivot, utilizza il metodo batchUpdate, fornendo una richiesta updateCells. Utilizza questa richiesta per fornire una definizione di PivotTable come contenuto di una cella, come mostrato di seguito:
"updateCells": {
"rows": {
"values": [{
"pivotTable": MyPivotTable
},
"start": {
"sheetId": sheetId,
"rowIndex": 0,
"columnIndex": 0
},
"fields": "pivotTable"
}
La tabella pivot descritta da MyPivotTable
viene inserita nel foglio specificato, con l'angolo in alto a sinistra nella cella A1
. (altezza e larghezza della tabella pivot sono dinamiche; specifichi solo l'origine).
Il tipo di PivotTable ti consente di specificare:
- Intervallo di dati di origine
- Uno o più campi i cui dati formeranno le righe della tabella pivot
- Uno o più campi i cui dati costituiranno le colonne della tabella pivot
- Criteri di filtro e aggregazione
- Layout tabella pivot
Modifica ed eliminazione delle tabelle pivot
Non esistono richieste esplicite per modificare o eliminare una tabella pivot. Utilizza invece una richiesta updateCells con contenuti di celle diversi:
- Per modificare una tabella pivot, crea una definizione di PivotTable modificata e aggiorna la cella utilizzandola, in modo simile a quando aggiungi una nuova tabella pivot.
- Per eliminare una tabella pivot, aggiorna la cella con valori vuoti. Per un esempio, vedi l'esempio relativo all'eliminazione di una tabella pivot.
casi d'uso
Le tabelle pivot possono essere utilizzate in vari modi in un'ampia gamma di aree, tra cui analisi statistica, applicazioni ERP, report finanziari e così via. I casi d'uso classici delle tabelle pivot includono elementi come:
- Vendite totali per regione e trimestre
- Retribuzione media per titolo e località
- Conteggio degli incidenti per prodotto e ora del giorno
Il numero di potenziali applicazioni delle tabelle pivot è molto ampio ed è potente la capacità di generarle in modo programmatico. Puoi generare tabelle pivot che supportano l'esplorazione interattiva, ma sono personalizzate in base a circostanze specifiche, ad esempio:
- Esplora i dati sugli incidenti relativi alle ultime 24 ore
- Visualizza/analizza dati aggregati corrispondenti all'account attualmente selezionato
- Esaminare i dati di vendita per i territori appartenenti all'utente corrente
Esempio
Questo esempio crea una tabella pivot da un set di dati per produrre il report "numero di modello per regione" mostrato nell'introduzione di questa pagina. Per ulteriori esempi, consulta la pagina di esempio di tabella pivot.