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

Class DataSourcePivotTable

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

Używaj tej klasy tylko w przypadku danych połączonych z bazą danych.

Metody

Metoda	Typ zwracanej wartości	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 określonej 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ą podsumowania.
`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.
`cancelDataRefresh()`	`DataSourcePivotTable`	Anuluje odświeżanie danych powiązane z tym obiektem, jeśli jest aktualnie uruchomiony.
`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, a limit czasu oczekiwania po określonej liczbie sekund zostanie przekroczony.

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 podstawie której powstała 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 określonej kolumny źródła danych z określonymi kryteriami filtra.

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa kolumny źródła danych, na której podstawie jest 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ą podsumowania.

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ść przestawna.

Powroty

PivotValue – nowa wartość 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

`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 podstawie której powstała 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

`cancelDataRefresh()`

Anuluje odświeżanie danych powiązane z tym obiektem, jeśli jest aktualnie 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();

Jeśli typ źródła danych nie jest włączony, zgłasza wyjątek. 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

`forceRefreshData()`

Odświeża dane tego obiektu niezależnie od bieżącego stanu. Aby dowiedzieć się więcej, wejdź na refreshData(). Jeśli chcesz anulować uruchomione odświeżanie tego obiektu, zobacz cancelDataRefresh().

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 użytkownik jest w stanie error. Użyj narzędzia 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, a limit czasu oczekiwania po określonej liczbie sekund zostanie przekroczony. Zgłasza wyjątek, jeśli wykonanie nie zostało ukończone w momencie przekroczenia limitu czasu, ale nie anuluje wykonania 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