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 z danymi połączonymi 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)`	`PivotValue`	Dodaje nową wartość tabeli przestawnej na podstawie wybranej kolumny źródła danych bez funkcji podsumowującej.
`addPivotValue(columnName, summarizeFunction)`	`PivotValue`	Dodaje nową wartość tabeli przestawnej na podstawie wybranej kolumny źródła danych za pomocą określonej funkcji podsumowującej.
`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 obecnie uruchomione.
`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`	Zwraca 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)`

Dodaje nową wartość tabeli przestawnej na podstawie wybranej kolumny źródła danych bez funkcji podsumowującej. Dotyczy tylko wskaźników Lookera.

Poniższy kod pokazuje, jak dodać miarę Looker jako wartość osi.

// TODO(developer): Replace with your spreadsheet ID which has a Looker data source.
var spreadsheet = SpreadsheetApp.openById("abcd1234")
var datasource = spreadsheet.getDataSources()[0];
var pivotTable = datasource.createDataSourcePivotTableOnNewSheet();

pivotTable.addPivotValue("columnName");

Ta metoda jest dostępna tylko w przypadku źródeł danych Lookera.

Parametry

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

`addPivotValue(columnName, summarizeFunction)`

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

Aby dodać wartości przestawne wskaźników Lookera, użyj funkcji addPivotValue(columnName).

Parametry

Nazwa	Typ	Opis
`columnName`	`String`	Nazwa kolumny źródła danych, na podstawie której jest tworzona 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 wybranej 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, które korzystają 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. Aby umożliwić wykonywanie zapytań do bazy danych w przypadku konkretnego typu źródła danych, użyj metody SpreadsheetApp#enable...Execution().

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 wykonywane odświeżanie tego obiektu, zapoznaj się z artykułem 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, które korzystają 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.

Wyjątek jest rzucany, jeśli aktualny stan to error. Aby zaktualizować specyfikację, użyj 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 danych.

Autoryzacja

Skrypty, które korzystają 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