Questa pagina è stata tradotta dall'API Cloud Translation.

Class DataSourcePivotTable

Accedi e modifica la tabella pivot dell'origine dati esistente. Per creare una nuova tabella pivot dell'origine dati, usa Range.createDataSourcePivotTable(dataSource).

Utilizza questa classe solo con dati collegati a un database.

Metodi

Metodo	Tipo restituito	Breve descrizione
`addColumnGroup(columnName)`	`PivotGroup`	Aggiunge un nuovo gruppo di colonne pivot in base alla colonna dell'origine dati specificata.
`addFilter(columnName, filterCriteria)`	`PivotFilter`	Aggiunge un nuovo filtro in base alla colonna dell'origine dati specificata con i criteri di filtro specificati.
`addPivotValue(columnName)`	`PivotValue`	Aggiunge un nuovo valore pivot in base alla colonna dell'origine dati specificata senza alcuna funzione di aggregazione.
`addPivotValue(columnName, summarizeFunction)`	`PivotValue`	Aggiunge un nuovo valore pivot in base alla colonna dell'origine dati specificata con la funzione di aggregazione specificata.
`addRowGroup(columnName)`	`PivotGroup`	Aggiunge un nuovo gruppo di righe pivot in base alla colonna dell'origine dati specificata.
`asPivotTable()`	`PivotTable`	Restituisce la tabella pivot dell'origine dati come oggetto tabella pivot normale.
`cancelDataRefresh()`	`DataSourcePivotTable`	Annullamento dell'aggiornamento dei dati associato a questo oggetto se è in esecuzione.
`forceRefreshData()`	`DataSourcePivotTable`	Aggiorna i dati di questo oggetto indipendentemente dallo stato corrente.
`getDataSource()`	`DataSource`	Recupera l'origine dati a cui è collegato l'oggetto.
`getStatus()`	`DataExecutionStatus`	Recupera lo stato di esecuzione dei dati dell'oggetto.
`refreshData()`	`DataSourcePivotTable`	Aggiorna i dati dell'oggetto.
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	Attende il completamento dell'esecuzione corrente e termina dopo il numero di secondi specificato.

Documentazione dettagliata

`addColumnGroup(columnName)`

Aggiunge un nuovo gruppo di colonne pivot in base alla colonna dell'origine dati specificata.

Parametri

Nome	Tipo	Descrizione
`columnName`	`String`	Il nome della colonna dell'origine dati su cui si basa il gruppo pivot.

Invio

PivotGroup: il nuovo gruppo pivot.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addFilter(columnName, filterCriteria)`

Aggiunge un nuovo filtro in base alla colonna dell'origine dati specificata con i criteri di filtro specificati.

Parametri

Nome	Tipo	Descrizione
`columnName`	`String`	Il nome della colonna dell'origine dati su cui si basa il filtro.
`filterCriteria`	`FilterCriteria`	I criteri utilizzati dal filtro.

Invio

PivotFilter: il nuovo filtro.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addPivotValue(columnName)`

Aggiunge un nuovo valore pivot in base alla colonna dell'origine dati specificata senza alcuna funzione di aggregazione. Solo per le misure di Looker.

Il seguente codice mostra come aggiungere una misura di Looker come valore del pivot.

// TODO(developer): Replace with your spreadsheet ID which has a Looker data
// source.
const spreadsheet = SpreadsheetApp.openById('abcd1234');
const datasource = spreadsheet.getDataSources()[0];
const pivotTable = datasource.createDataSourcePivotTableOnNewSheet();

pivotTable.addPivotValue('columnName');

Questo metodo è disponibile solo per le origini dati Looker.

Parametri

Nome	Tipo	Descrizione
`columnName`	`String`	Il nome della colonna dell'origine dati su cui si basa il valore pivot.

Invio

PivotValue: il nuovo valore pivot.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addPivotValue(columnName, summarizeFunction)`

Aggiunge un nuovo valore pivot in base alla colonna dell'origine dati specificata con la funzione di aggregazione specificata.

Per aggiungere valori pivot per le misure di Looker, utilizza addPivotValue(columnName).

Parametri

Nome	Tipo	Descrizione
`columnName`	`String`	Il nome della colonna dell'origine dati su cui si basa il valore pivot.
`summarizeFunction`	`PivotTableSummarizeFunction`	La funzione di riepilogo utilizzata dal valore del pivot.

Invio

PivotValue: il nuovo valore pivot.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addRowGroup(columnName)`

Aggiunge un nuovo gruppo di righe pivot in base alla colonna dell'origine dati specificata.

Parametri

Nome	Tipo	Descrizione
`columnName`	`String`	Il nome della colonna dell'origine dati su cui si basa il gruppo pivot.

Invio

PivotGroup: il nuovo gruppo pivot.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`asPivotTable()`

Restituisce la tabella pivot dell'origine dati come oggetto tabella pivot normale.

Invio

PivotTable: la tabella pivot.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`cancelDataRefresh()`

Annullamento dell'aggiornamento dei dati associato a questo oggetto se è in esecuzione.

Questo esempio mostra come annullare l'aggiornamento di una formula.

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

Viene lanciata un'eccezione se il tipo di origine dati non è attivo. Utilizza i metodi SpreadsheetApp#enable...Execution() per attivare l'esecuzione dei dati per un tipo di origine dati specifico.

Invio

DataSourcePivotTable: l'oggetto dati.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`forceRefreshData()`

Aggiorna i dati di questo oggetto indipendentemente dallo stato corrente. Per maggiori dettagli, consulta refreshData(). Se vuoi annullare un aggiornamento di questo oggetto attualmente in esecuzione, consulta cancelDataRefresh().

Viene lanciata un'eccezione se il tipo di origine dati non è attivo. Utilizza i metodi SpreadsheetApp#enable...Execution() per attivare l'esecuzione dei dati per un tipo di origine dati specifico.

Invio

DataSourcePivotTable: l'oggetto dati.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSource()`

Recupera l'origine dati a cui è collegato l'oggetto.

Invio

DataSource: l'origine dati.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getStatus()`

Recupera lo stato di esecuzione dei dati dell'oggetto.

Invio

DataExecutionStatus: lo stato di esecuzione dei dati.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`refreshData()`

Aggiorna i dati dell'oggetto.

Genera un'eccezione se è attualmente nello stato error. Utilizza DataSource#updateSpec() per aggiornare la specifica. Il metodo è preferito a forceRefreshData() per evitare modifiche impreviste all'origine dati.

Viene lanciata un'eccezione se il tipo di origine dati non è attivo. Utilizza i metodi SpreadsheetApp#enable...Execution() per attivare l'esecuzione dei dati per un tipo di origine dati specifico.

Invio

DataSourcePivotTable: l'oggetto dati.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`waitForCompletion(timeoutInSeconds)`

Attende il completamento dell'esecuzione corrente e termina dopo il numero di secondi specificato. Genera un'eccezione se l'esecuzione non è completata al termine del timeout, ma non annulla l'esecuzione dei dati.

Parametri

Nome	Tipo	Descrizione
`timeoutInSeconds`	`Integer`	Il tempo di attesa per l'esecuzione dei dati, in secondi. Il valore massimo è 300 secondi.

Invio

DataExecutionStatus: lo stato di esecuzione dei dati.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets