Class DataSourcePivotTable

DataSourcePivotTable

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 i dati connessi a un database.

Metodi

MetodoTipo restituitoBreve descrizione
addColumnGroup(columnName)PivotGroupAggiunge un nuovo gruppo di colonne pivot in base alla colonna dell'origine dati specificata.
addFilter(columnName, filterCriteria)PivotFilterAggiunge un nuovo filtro in base alla colonna dell'origine dati specificata con i criteri di filtro specificati.
addPivotValue(columnName)PivotValueAggiunge un nuovo valore pivot in base alla colonna dell'origine dati specificata senza alcuna funzione di riepilogo.
addPivotValue(columnName, summarizeFunction)PivotValueAggiunge un nuovo valore pivot in base alla colonna dell'origine dati specificata con la funzione di riepilogo specificata.
addRowGroup(columnName)PivotGroupAggiunge un nuovo gruppo di righe pivot in base alla colonna dell'origine dati specificata.
asPivotTable()PivotTableRestituisce la tabella pivot dell'origine dati come un normale oggetto tabella pivot.
cancelDataRefresh()DataSourcePivotTableAnnulla l'aggiornamento dei dati associato a questo oggetto, se è attualmente in esecuzione.
forceRefreshData()DataSourcePivotTableAggiorna i dati di questo oggetto indipendentemente dallo stato attuale.
getDataSource()DataSourceRecupera l'origine dati a cui è collegato l'oggetto.
getStatus()DataExecutionStatusRecupera lo stato di esecuzione dei dati dell'oggetto.
refreshData()DataSourcePivotTableAggiorna i dati dell'oggetto.
waitForCompletion(timeoutInSeconds)DataExecutionStatusAttende il completamento dell'esecuzione corrente, con timeout dopo il numero di secondi fornito.

Documentazione dettagliata

addColumnGroup(columnName)

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

Parametri

NomeTipoDescrizione
columnNameStringIl nome della colonna dell'origine dati su cui si basa il gruppo pivot.

Indietro

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

NomeTipoDescrizione
columnNameStringIl nome della colonna dell'origine dati su cui si basa il filtro.
filterCriteriaFilterCriteriaI criteri utilizzati dal filtro.

Indietro

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 riepilogo. Solo per le misure di Looker.

Il seguente codice mostra come aggiungere una misura di Looker come valore 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

NomeTipoDescrizione
columnNameStringIl nome della colonna dell'origine dati su cui si basa il valore pivot.

Indietro

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 riepilogo specificata.

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

Parametri

NomeTipoDescrizione
columnNameStringIl nome della colonna dell'origine dati su cui si basa il valore pivot.
summarizeFunctionPivotTableSummarizeFunctionLa funzione di riepilogo utilizzata dal valore pivot.

Indietro

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

NomeTipoDescrizione
columnNameStringIl nome della colonna dell'origine dati su cui si basa il gruppo pivot.

Indietro

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.

Indietro

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 a questo oggetto, se è attualmente 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();

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 specifico di origine dati.

Indietro

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 attuale. Per maggiori dettagli, consulta refreshData(). Se vuoi annullare un aggiornamento in corso 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 tipo specifico di origine dati.

Indietro

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.

Indietro

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.

Indietro

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 si trova nello stato error. Utilizza DataSource#updateSpec() per aggiornare la specifica. Questo metodo è preferibile 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 specifico di origine dati.

Indietro

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 fornito. Genera un'eccezione se l'esecuzione non viene completata al momento del timeout, ma non annulla l'esecuzione dei dati.

Parametri

NomeTipoDescrizione
timeoutInSecondsIntegerIl tempo di attesa per l'esecuzione dei dati, in secondi. Il valore massimo è 300 secondi.

Indietro

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