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

Class DataSourcePivotTable

Dostęp do tabeli przestawnej źródła danych i jej modyfikowanie. Aby utworzyć nową tabelę przestawną źródła danych, użyj Range.createDataSourcePivotTable(dataSource).

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

Metody

Metoda	Zwracany typ	Krótki opis
`addColumnGroup(columnName)`	`PivotGroup`	Dodaje nową grupę kolumn tabeli przestawnej na podstawie określonej kolumny źródła danych.
`addFilter(columnName, filterCriteria)`	`PivotFilter`	Dodaje nowy filtr na podstawie kolumny źródła danych z określonymi kryteriami filtra.
`addPivotValue(columnName, summarizeFunction)`	`PivotValue`	Dodaje nową wartość przestawną na podstawie określonej kolumny źródła danych z określoną funkcją sumowania.
`addRowGroup(columnName)`	`PivotGroup`	Dodaje nową grupę wierszy tabeli przestawnej na podstawie określonej kolumny źródła danych.
`asPivotTable()`	`PivotTable`	Zwraca tabelę przestawną źródła danych jako zwykły obiekt tabeli przestawnej.
`forceRefreshData()`	`DataSourcePivotTable`	Odświeża dane tego obiektu niezależnie od bieżącego stanu.
`getDataSource()`	`DataSource`	Pobiera źródło danych, z którym jest połączony obiekt.
`getStatus()`	`DataExecutionStatus`	Pobiera stan wykonania danych obiektu.
`refreshData()`	`DataSourcePivotTable`	Odświeża dane obiektu.
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	Czeka na zakończenie bieżącego wykonania. Limit czasu zostaje przekroczony po podanej liczbie sekund.

Szczegółowa dokumentacja

`addColumnGroup(columnName)`

Dodaje nową grupę kolumn tabeli przestawnej na podstawie określonej kolumny źródła danych.

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa kolumny źródła danych, na której bazuje grupa przestawna.

Powroty

PivotGroup – nowa grupa przestawna.

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

`addFilter(columnName, filterCriteria)`

Dodaje nowy filtr na podstawie kolumny źródła danych z określonymi kryteriami filtra.

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa kolumny źródła danych, na podstawie której działa filtr.
`filterCriteria`	`FilterCriteria`	Kryteria używane przez filtr.

Powroty

PivotFilter – nowy filtr.

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

`addPivotValue(columnName, summarizeFunction)`

Dodaje nową wartość przestawną na podstawie określonej kolumny źródła danych z określoną funkcją sumowania.

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa kolumny źródła danych, na której bazuje wartość w tabeli przestawnej.
`summarizeFunction`	`PivotTableSummarizeFunction`	Funkcja dodawania, której używa wartość w tabeli przestawnej.

Powroty

PivotValue – nowa wartość w tabeli przestawnej.

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

`addRowGroup(columnName)`

Dodaje nową grupę wierszy tabeli przestawnej na podstawie określonej kolumny źródła danych.

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa kolumny źródła danych, na której bazuje grupa przestawna.

Powroty

PivotGroup – nowa grupa przestawna.

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

`asPivotTable()`

Zwraca tabelę przestawną źródła danych jako zwykły obiekt tabeli przestawnej.

Powroty

PivotTable – tabela przestawna.

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

`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

DataSourcePivotTable – 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

`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

`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

DataSourcePivotTable – 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

`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