Accedere alle formule dell'origine dati e modificarle. Per creare una nuova formula dell'origine dati, utilizza Range.setFormula(formula).
Utilizza questa classe solo con dati connessi a un database.
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
forceRefreshData() | DataSourceFormula | Aggiorna i dati dell'oggetto indipendentemente dallo stato attuale. |
getAnchorCell() | Range | Restituisce Range che rappresenta la cella in cui è ancorata questa formula dell'origine dati. |
getDataSource() | DataSource | Restituisce l'origine dati a cui è collegato l'oggetto. |
getDisplayValue() | String | Restituisce il valore visualizzato della formula dell'origine dati. |
getFormula() | String | Restituisce la formula per questa formula dell'origine dati. |
getStatus() | DataExecutionStatus | Restituisce lo stato di esecuzione dei dati dell'oggetto. |
refreshData() | DataSourceFormula | Aggiorna i dati dell'oggetto. |
setFormula(formula) | DataSourceFormula | Aggiorna la formula. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | Attende il completamento dell'esecuzione corrente, scade dopo il numero di secondi specificato. |
Documentazione dettagliata
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
DataSourceFormula: 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
getAnchorCell()
Restituisce Range che rappresenta la cella in cui è ancorata questa formula dell'origine dati.
Ritorni
Range: la cella di ancoraggio.
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
getDisplayValue()
Restituisce il valore visualizzato della formula dell'origine dati.
Ritorni
String: il valore visualizzato.
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
getFormula()
Restituisce la formula per questa formula dell'origine dati.
Ritorni
String: la formula.
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
DataSourceFormula: 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
setFormula(formula)
Aggiorna la formula.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
formula | String | La nuova formula. |
Ritorni
DataSourceFormula: la formula dell'origine dati per il concatenamento.
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