Ta strona została przetłumaczona przez Cloud Translation API.

Class DataSourceFormula

Dostęp do formuł istniejących źródeł danych i ich modyfikowanie. Aby utworzyć nową formułę źródła danych, użyj funkcji Range.setFormula(formula).

Używaj tej klasy tylko z danymi połączonymi z bazą danych.

Metody

Metoda	Zwracany typ	Krótki opis
`forceRefreshData()`	`DataSourceFormula`	Odświeża dane tego obiektu niezależnie od bieżącego stanu.
`getAnchorCell()`	`Range`	Zwraca wartość `Range` reprezentującą komórkę, w której zakotwiczona jest ta formuła źródła danych.
`getDataSource()`	`DataSource`	Pobiera źródło danych, z którym jest połączony obiekt.
`getDisplayValue()`	`String`	Zwraca wyświetlaną wartość formuły źródła danych.
`getFormula()`	`String`	Zwraca formułę dla 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`	Czeka na zakończenie bieżącego wykonania. Limit czasu zostaje przekroczony po podanej liczbie sekund.

Szczegółowa dokumentacja

`forceRefreshData()`

Odświeża dane tego obiektu niezależnie od bieżącego stanu. Aby dowiedzieć się więcej, wejdź na refreshData().

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 danych w przypadku określonego typu źródła danych.

Powroty

DataSourceFormula – obiekt danych,

Upoważnienie

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 wartość Range reprezentującą komórkę, w której zakotwiczona jest ta formuła źródła danych.

Powroty

Range – komórka zakotwiczenia.

Upoważnienie

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 jest połączony obiekt.

Powroty

DataSource – źródło danych.

Upoważnienie

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 wyświetlaną wartość formuły źródła danych.

Powroty

String – wartość wyświetlana.

Upoważnienie

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łę dla tej formuły źródła danych.

Powroty

String – formuła.

Upoważnienie

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.

Powroty

DataExecutionStatus – stan wykonania danych.

Upoważnienie

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 znajduje się w stanie error. Użyj DataSource#updateSpec(), aby zaktualizować specyfikację. Ta metoda jest preferowana zamiast metody forceRefreshData(), aby zapobiegać nieoczekiwanym zmianom w źródle danych.

Powroty

DataSourceFormula – obiekt danych,

Upoważnienie

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.

Powroty

DataSourceFormula – formuła źródła danych służąca do tworzenia łańcuchów.

Upoważnienie

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

Czeka na zakończenie bieżącego wykonania. Limit czasu zostaje przekroczony po podanej liczbie sekund. Zgłasza wyjątek, jeśli wykonanie nie zostało ukończone po przekroczeniu limitu czasu, ale nie anuluje wykonywania danych.

Parametry

Nazwa	Typ	Opis
`timeoutInSeconds`	`Integer`	Czas oczekiwania na wykonanie danych (w sekundach). Maksymalna długość to 300 sekund.

Powroty

DataExecutionStatus – stan wykonania danych.

Upoważnienie

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