Accedi alla tabella pivot dell'origine dati esistente e modificala. Per creare una nuova tabella pivot dell'origine dati, utilizza
Range.createDataSourcePivotTable(dataSource).
Utilizza questa classe solo con dati connessi a un database.
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
addColumnGroup(columnName) | PivotGroup | Aggiunge un nuovo gruppo di colonne pivot in base alla colonna di 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, summarizeFunction) | PivotValue | Aggiunge un nuovo valore pivot in base alla colonna di origine dati specificata con la funzione di riepilogo specificata. |
addRowGroup(columnName) | PivotGroup | Aggiunge un nuovo gruppo di righe pivot in base alla colonna di origine dati specificata. |
asPivotTable() | PivotTable | Restituisce la tabella pivot dell'origine dati come un normale oggetto tabella pivot. |
forceRefreshData() | DataSourcePivotTable | Aggiorna i dati dell'oggetto indipendentemente dallo stato attuale. |
getDataSource() | DataSource | Restituisce 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, scade dopo il numero di secondi specificato. |
Documentazione dettagliata
addColumnGroup(columnName)
Aggiunge un nuovo gruppo di colonne pivot in base alla colonna di origine dati specificata.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
columnName | String | Il nome della colonna della fonte di dati su cui si basa il gruppo pivot. |
Ritorni
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 di origine dei dati su cui si basa il filtro. |
filterCriteria | FilterCriteria | I criteri utilizzati dal filtro. |
Ritorni
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 in base alla colonna di origine dati specificata con la funzione di riepilogo specificata.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
columnName | String | Il nome della colonna della fonte di dati su cui si basa il valore pivot. |
summarizeFunction | PivotTableSummarizeFunction | La funzione di riepilogo utilizzata dal valore pivot. |
Ritorni
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 di origine dati specificata.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
columnName | String | Il nome della colonna della fonte di dati su cui si basa il gruppo pivot. |
Ritorni
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.
Ritorni
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
forceRefreshData()
Aggiorna i dati dell'oggetto indipendentemente dallo stato attuale. Per ulteriori dettagli, visita la pagina refreshData().
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 tipo di origine dati specifico.
Ritorni
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()
Restituisce l'origine dati a cui è collegato l'oggetto.
Ritorni
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.
Ritorni
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 lo stato attuale è 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 tipo di origine dati specifico.
Ritorni
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, scade dopo il numero di secondi specificato. Genera un'eccezione se l'esecuzione non viene completata al momento 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 massimo è 300 secondi. |
Ritorni
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