uzyskiwać dostęp do istniejących formuł źródeł danych i modyfikować je; Aby utworzyć nową formułę źródła danych, użyj funkcji Range.setFormula(formula)
.
Używaj tej klasy tylko w przypadku danych połączonych z bazą danych.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
cancelDataRefresh() | DataSourceFormula | Anuluje odświeżanie danych powiązane z tym obiektem, jeśli jest on uruchomiony. |
forceRefreshData() | DataSourceFormula | Odświeża dane tego obiektu niezależnie od bieżącego stanu. |
getAnchorCell() | Range | Zwraca Range reprezentujący komórkę, w której zakotwiczona jest ta formuła źródła danych. |
getDataSource() | DataSource | Pobiera źródło danych, z którym połączony jest obiekt. |
getDisplayValue() | String | Zwraca wartość wyświetlaną formuły źródła danych. |
getFormula() | String | Zwraca formułę tej formuły źródła danych. |
getStatus() | DataExecutionStatus | Pobiera stan wykonania danych obiektu. |
refreshData() | DataSourceFormula | Odświeża dane obiektu. |
setFormula(formula) | DataSourceFormula | Aktualizuje formułę. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | Czekam na zakończenie bieżącego wykonania, przekracza limit czasu po podanej liczbie sekund. |
Szczegółowa dokumentacja
cancelDataRefresh()
Anuluje odświeżanie danych powiązane z tym obiektem, jeśli jest on uruchomiony.
Ten przykład pokazuje, jak anulować odświeżenie formuły.
const spreadsheet = SpreadsheetApp.getActive(); const formula = spreadsheet.getDataSourceFormulas()[0]; // Cancel the ongoing refresh on the formula. formula.cancelDataRefresh();
Zgłasza wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod
SpreadsheetApp#enable...Execution()
, aby włączyć wykonywanie kodu dla określonego źródła danych
typu.
Powrót
DataSourceFormula
– obiekt danych.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
forceRefreshData()
Odświeża dane tego obiektu niezależnie od bieżącego stanu. Zobacz refreshData()
:
. Jeśli chcesz anulować aktualnie uruchomione odświeżanie tego obiektu, zobacz cancelDataRefresh()
.
Zgłasza wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution()
, aby włączyć wykonywanie kodu dla określonego źródła danych
typu.
Powrót
DataSourceFormula
– obiekt danych.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAnchorCell()
Zwraca Range
reprezentujący komórkę, w której zakotwiczona jest ta formuła źródła danych.
Powrót
Range
– komórka kotwicy.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSource()
Pobiera źródło danych, z którym połączony jest obiekt.
Powrót
DataSource
– źródło danych.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValue()
Zwraca wartość wyświetlaną formuły źródła danych.
Powrót
String
– wyświetlana wartość.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormula()
Zwraca formułę tej formuły źródła danych.
Powrót
String
– formuła.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getStatus()
Pobiera stan wykonania danych obiektu.
Powrót
DataExecutionStatus
– stan wykonania kodu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refreshData()
Odświeża dane obiektu.
Zgłasza wyjątek, jeśli obecnie jest w stanie error
. Aby zaktualizować specyfikację, użyj polecenia DataSource#updateSpec()
. Metoda
preferowana niż forceRefreshData()
, aby zapobiec nieoczekiwanym edytowaniu źródła danych.
Zgłasza wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution()
, aby włączyć wykonywanie kodu dla określonego źródła danych
typu.
Powrót
DataSourceFormula
– obiekt danych.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormula(formula)
Aktualizuje formułę.
Parametry
Nazwa | Typ | Opis |
---|---|---|
formula | String | Nowa formuła. |
Powrót
DataSourceFormula
– formuła źródła danych służąca do tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForCompletion(timeoutInSeconds)
Czekam na zakończenie bieżącego wykonania, przekracza limit czasu po podanej liczbie sekund. Zgłasza wyjątek, jeśli wykonanie nie zostanie ukończone po przekroczeniu limitu czasu, ale nie anuluje i generowanie danych.
Parametry
Nazwa | Typ | Opis |
---|---|---|
timeoutInSeconds | Integer | Czas oczekiwania na wykonanie bazy danych (w sekundach). Maksymalna liczba to 300 sek. |
Powrót
DataExecutionStatus
– stan wykonania kodu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets