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

Class DataSourcePivotTable

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

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

Metody

Metoda	Zwracany typ	Krótki opis
`addColumnGroup(columnName)`	`PivotGroup`	Dodaje nową grupę kolumn przestawnych 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 filtrowania.
`addPivotValue(columnName, summarizeFunction)`	`PivotValue`	Dodaje nową wartość w tabeli przestawnej na podstawie określonej kolumny źródła danych z określonym podsumowaniem .
`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 on 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 połączony jest obiekt.
`getStatus()`	`DataExecutionStatus`	Pobiera stan wykonania danych obiektu.
`refreshData()`	`DataSourcePivotTable`	Odświeża dane obiektu.
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	Czekam na zakończenie bieżącego wykonania, przekracza limit czasu po podanej liczbie sekund.

Szczegółowa dokumentacja

`addColumnGroup(columnName)`

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

Parametry

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

Powrót

PivotGroup – nowa grupa elementów tabeli przestawnej.

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

`addFilter(columnName, filterCriteria)`

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

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa kolumny źródła danych, na której opiera się filtr.
`filterCriteria`	`FilterCriteria`	Kryteria stosowane przez filtr.

Powrót

PivotFilter – nowy filtr.

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

`addPivotValue(columnName, summarizeFunction)`

Dodaje nową wartość w tabeli przestawnej na podstawie określonej kolumny źródła danych z określonym podsumowaniem .

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa kolumny źródła danych, na której jest oparta wartość w tabeli przestawnej.
`summarizeFunction`	`PivotTableSummarizeFunction`	Funkcja podsumowania używana przez wartość w tabeli przestawnej.

Powrót

PivotValue – nowa wartość tabeli przestawnej.

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

`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 jest oparta grupa przestawna.

Powrót

PivotGroup – nowa grupa elementów tabeli przestawnej.

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

`asPivotTable()`

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

Powrót

PivotTable – tabela przestawna.

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

`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

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

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

`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

`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

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

`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