Accedere all'origine dati esistente e modificarla. Per creare una tabella dell'origine dati con una nuova origine dati, consulta
DataSourceTable
.
Utilizza questa classe solo con dati connessi a un database.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
createCalculatedColumn(name, formula) | DataSourceColumn | Crea una colonna calcolata. |
createDataSourcePivotTableOnNewSheet() | DataSourcePivotTable | Crea una tabella pivot dell'origine dati da questa origine dati nella prima cella di un nuovo foglio. |
createDataSourceTableOnNewSheet() | DataSourceTable | Crea una tabella di origine dati da questa origine dati nella prima cella di un nuovo foglio. |
getCalculatedColumnByName(columnName) | DataSourceColumn | Restituisce la colonna calcolata nell'origine dati che corrisponde al nome della colonna. |
getCalculatedColumns() | DataSourceColumn[] | Restituisce tutte le colonne calcolate nell'origine dati. |
getColumns() | DataSourceColumn[] | Restituisce tutte le colonne nell'origine dati. |
getDataSourceSheets() | DataSourceSheet[] | Restituisce i fogli dell'origine dati associati a questa origine dati. |
getSpec() | DataSourceSpec | Restituisce la specifica dell'origine dati. |
refreshAllLinkedDataSourceObjects() | void | Aggiorna tutti gli oggetti dell'origine dati collegati all'origine dati. |
updateSpec(spec) | DataSource | Aggiorna la specifica dell'origine dati e aggiorna gli oggetti dell'origine dati collegati a quest'ultima con la nuova specifica. |
updateSpec(spec, refreshAllLinkedObjects) | DataSource | Aggiorna la specifica dell'origine dati e aggiorna il valore data
source sheets collegato con la nuova specifica. |
waitForAllDataExecutionsCompletion(timeoutInSeconds) | void | Attende il completamento di tutte le esecuzioni correnti degli oggetti dell'origine dati collegati, con timeout dopo il numero di secondi specificato. |
Documentazione dettagliata
createCalculatedColumn(name, formula)
Crea una colonna calcolata.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | Il nome della colonna calcolata. |
formula | String | La formula della colonna calcolata. |
Ritorni
DataSourceColumn
: la colonna calcolata appena creata.
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
createDataSourcePivotTableOnNewSheet()
Crea una tabella pivot dell'origine dati da questa origine dati nella prima cella di un nuovo foglio. Come effetto collaterale, imposta il nuovo foglio come attivo.
Ritorni
DataSourcePivotTable
: la tabella pivot dell'origine dati appena creata.
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
createDataSourceTableOnNewSheet()
Crea una tabella di origine dati da questa origine dati nella prima cella di un nuovo foglio. Come effetto collaterale, imposta il nuovo foglio come foglio attivo.
Ritorni
DataSourceTable
: la tabella dell'origine dati appena creata.
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
getCalculatedColumnByName(columnName)
Restituisce la colonna calcolata nell'origine dati che corrisponde al nome della colonna.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnName | String | Il nome della colonna calcolata da ottenere. |
Ritorni
DataSourceColumn
: la colonna calcolata che corrisponde al nome della colonna oppure null
se non è presente.
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
getCalculatedColumns()
Restituisce tutte le colonne calcolate nell'origine dati.
Ritorni
DataSourceColumn[]
: un array di tutte le colonne calcolate nell'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
getColumns()
Restituisce tutte le colonne nell'origine dati.
Ritorni
DataSourceColumn[]
: un array di tutti i DataSourceColumn
nell'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
getDataSourceSheets()
Restituisce i fogli dell'origine dati associati a questa origine dati.
Ritorni
DataSourceSheet[]
: un array di fogli di origini 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
getSpec()
Restituisce la specifica dell'origine dati.
Ritorni
DataSourceSpec
: la specifica dell'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
refreshAllLinkedDataSourceObjects()
Aggiorna tutti gli oggetti dell'origine dati collegati 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 il tipo di origine dati specifico.
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
updateSpec(spec)
Aggiorna la specifica dell'origine dati e aggiorna gli oggetti dell'origine dati collegati a quest'ultima con la nuova specifica.
Genera un'eccezione se il tipo di origine dati non è abilitato. Utilizza i metodi SpreadsheetApp#enable...Execution()
per attivare l'esecuzione dei dati per il tipo di origine dati specifico.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
spec | DataSourceSpec | La specifica dell'origine dati da utilizzare per l'aggiornamento. |
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
updateSpec(spec, refreshAllLinkedObjects)
Aggiorna la specifica dell'origine dati e aggiorna il valore data
source sheets
collegato con la nuova specifica.
Genera un'eccezione se il tipo di origine dati non è abilitato. Utilizza i metodi SpreadsheetApp#enable...Execution()
per attivare l'esecuzione dei dati per il tipo di origine dati specifico.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
spec | DataSourceSpec | La specifica dell'origine dati da utilizzare per l'aggiornamento. |
refreshAllLinkedObjects | Boolean | Se true , vengono aggiornati anche tutti gli oggetti dell'origine dati collegati a questa origine dati. |
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
waitForAllDataExecutionsCompletion(timeoutInSeconds)
Attende il completamento di tutte le esecuzioni correnti degli oggetti dell'origine dati collegati, con timeout dopo il numero di secondi specificato. Genera un'eccezione se le esecuzioni non vengono completate quando si verifica il timeout, ma non le annulla.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
timeoutInSeconds | Integer | Il tempo di attesa per le esecuzioni dei dati, in secondi. Il massimo è 300 secondi. |
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