Questa pagina è stata tradotta dall'API Cloud Translation.

Class DataSourcePivotTable

Accedere alla tabella pivot dell'origine dati esistente e modificarla. Per creare una nuova tabella pivot dell'origine dati, utilizza 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 basato sulla colonna dell'origine dati specificata.
`addFilter(columnName, filterCriteria)`	`PivotFilter`	Aggiunge un nuovo filtro basato sulla colonna dell'origine dati specificata con i criteri di filtro specificati.
`addPivotValue(columnName, summarizeFunction)`	`PivotValue`	Aggiunge un nuovo valore pivot basato sulla colonna dell'origine dati specificata con il riepilogo specificato personalizzata.
`addRowGroup(columnName)`	`PivotGroup`	Aggiunge un nuovo gruppo di righe pivot basato sulla colonna dell'origine dati specificata.
`asPivotTable()`	`PivotTable`	Restituisce la tabella pivot dell'origine dati come un normale oggetto tabella pivot.
`cancelDataRefresh()`	`DataSourcePivotTable`	Annulla l'aggiornamento dei dati associato all'oggetto se è attualmente in esecuzione.
`forceRefreshData()`	`DataSourcePivotTable`	Aggiorna i dati dell'oggetto indipendentemente dallo stato attuale.
`getDataSource()`	`DataSource`	Recupera l'origine dati a cui è collegato l'oggetto.
`getStatus()`	`DataExecutionStatus`	Restituisce lo stato di esecuzione dei dati dell'oggetto.
`refreshData()`	`DataSourcePivotTable`	Aggiorna i dati dell'oggetto.
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	Attende il completamento dell'esecuzione corrente, con timeout dopo il numero di secondi specificato.

Documentazione dettagliata

`addColumnGroup(columnName)`

Aggiunge un nuovo gruppo di colonne pivot basato sulla colonna dell'origine dati specificata.

Parametri

Nome	Tipo	Descrizione
`columnName`	`String`	Il nome della colonna di 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 basato sulla colonna dell'origine dati specificata con i criteri di filtro specificati.

Parametri

Nome	Tipo	Descrizione
`columnName`	`String`	Il nome della colonna di 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, summarizeFunction)`

Aggiunge un nuovo valore pivot basato sulla colonna dell'origine dati specificata con il riepilogo specificato personalizzata.

Parametri

Nome	Tipo	Descrizione
`columnName`	`String`	Il nome della colonna di origine dati su cui si basa il valore pivot.
`summarizeFunction`	`PivotTableSummarizeFunction`	La funzione di riepilogo utilizzata dal 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

`addRowGroup(columnName)`

Aggiunge un nuovo gruppo di righe pivot basato sulla colonna dell'origine dati specificata.

Parametri

Nome	Tipo	Descrizione
`columnName`	`String`	Il nome della colonna di 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 un normale oggetto tabella pivot.

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()`

Annulla l'aggiornamento dei dati associato all'oggetto se è attualmente in esecuzione.

Questo esempio mostra come annullare un aggiornamento della formula.

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

Genera un'eccezione se il tipo di origine dati non è abilitato. Utilizza i metodi SpreadsheetApp#enable...Execution() per attivare l'esecuzione dei dati per un'origine dati specifica di testo.

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 dell'oggetto indipendentemente dallo stato attuale. Vedi refreshData() per ulteriori dettagli. Se vuoi annullare un aggiornamento attualmente in esecuzione di questo oggetto, consulta cancelDataRefresh().

Genera un'eccezione se il tipo di origine dati non è abilitato. Utilizza i metodi SpreadsheetApp#enable...Execution() per attivare l'esecuzione dei dati per un'origine dati specifica di testo.

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()`

Restituisce 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 rispetto a forceRefreshData() per evitare modifiche impreviste all'origine dati.

Genera un'eccezione se il tipo di origine dati non è abilitato. Utilizza i metodi SpreadsheetApp#enable...Execution() per attivare l'esecuzione dei dati per un'origine dati specifica di testo.

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, con timeout dopo il numero di secondi specificato. Genera un'eccezione se l'esecuzione non viene completata in caso di timeout, ma non annulla l'evento nell'esecuzione dei dati.

Parametri

Nome	Tipo	Descrizione
`timeoutInSeconds`	`Integer`	Il tempo di attesa dell'esecuzione dei dati, in secondi. Il numero 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