Class DataSourceFormula

DataSourceFormula

Accedi e modifica le formule delle origini dati esistenti. Per creare una nuova formula dell'origine dati, utilizza Range.setFormula(formula).

Utilizza questa classe solo con i dati connessi a un database BigQuery.

Metodi

MetodoTipo restituitoBreve descrizione
cancelDataRefresh()DataSourceFormulaAnnulla l'aggiornamento dei dati associato a questo oggetto, se è in esecuzione.
forceRefreshData()DataSourceFormulaAggiorna i dati di questo oggetto indipendentemente dallo stato attuale.
getAnchorCell()RangeRestituisce l'oggetto Range che rappresenta la cella in cui è ancorata questa formula dell'origine dati.
getDataSource()DataSourceRecupera l'origine dati a cui è collegato l'oggetto.
getDisplayValue()StringRestituisce il valore visualizzato della formula dell'origine dati.
getFormula()StringRestituisce la formula per questa formula dell'origine dati.
getStatus()DataExecutionStatusRecupera lo stato di esecuzione dei dati dell'oggetto.
refreshData()DataSourceFormulaAggiorna i dati dell'oggetto.
setFormula(formula)DataSourceFormulaAggiorna la formula.
waitForCompletion(timeoutInSeconds)DataExecutionStatusAttende il completamento dell'esecuzione corrente, con un timeout dopo il numero di secondi fornito.

Documentazione dettagliata

cancelDataRefresh()

Annulla l'aggiornamento dei dati associato a questo oggetto, se è 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 è attivo. Utilizza i metodi SpreadsheetApp#enable...Execution() per attivare l'esecuzione dei dati per un tipo di origine dati specifico.

Indietro

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

forceRefreshData()

Aggiorna i dati di questo oggetto indipendentemente dallo stato attuale. Per maggiori dettagli, consulta refreshData(). Se vuoi annullare un aggiornamento in esecuzione di questo oggetto, consulta cancelDataRefresh().

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

Indietro

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 l'oggetto Range che rappresenta la cella in cui è ancorata questa formula dell'origine dati.

Indietro

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

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

getDisplayValue()

Restituisce il valore visualizzato della formula dell'origine dati.

Indietro

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.

Indietro

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

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 lo stato attuale è error. Utilizza DataSource#updateSpec() per aggiornare la specifica. Il metodo è preferibile a forceRefreshData() per evitare modifiche impreviste all'origine dati.

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

Indietro

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

NomeTipoDescrizione
formulaStringLa nuova formula.

Indietro

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, con un 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