Uzyskuj dostęp do tabeli przestawnej źródła danych i modyfikuj ją. Aby utworzyć nową tabelę przestawną źródeł danych, użyj Range.createDataSourcePivotTable(dataSource)
.
tej klasy używaj 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 podanej kolumny źródła danych z określonymi kryteriami filtrowania. |
addPivotValue(columnName, summarizeFunction) | PivotValue | Dodaje nową wartość tabeli przestawnej 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. |
forceRefreshData() | DataSourcePivotTable | Odświeża dane tego obiektu niezależnie od bieżącego stanu. |
getDataSource() | DataSource | Pobiera źródło danych, z którym obiekt jest połączony. |
getStatus() | DataExecutionStatus | Pobiera stan wykonania danych obiektu. |
refreshData() | DataSourcePivotTable | Odświeża dane obiektu. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | Powoduje, że bieżące wykonanie zostanie zakończone po upływie określonej liczby 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 danych zbioru danych, na której opiera się grupa przestawna. |
Zwróć
PivotGroup
– nowa grupa elementów tabeli przestawnej.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 podanej kolumny źródła danych z określonymi kryteriami filtrowania.
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnName | String | Nazwa kolumny źródeł danych, na której podstawie opiera się filtr. |
filterCriteria | FilterCriteria | Kryteria używane przez filtr. |
Zwróć
PivotFilter
– nowy filtr.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addPivotValue(columnName, summarizeFunction)
Dodaje nową wartość tabeli przestawnej na podstawie określonej kolumny źródła danych z określoną funkcją podsumowania.
Parametry
Nazwa | Typ | Opis |
---|---|---|
columnName | String | Nazwa kolumny danych źródła, na której opiera się wartość przestawna. |
summarizeFunction | PivotTableSummarizeFunction | Funkcja podsumowania, której używa wartość w tabeli przestawnej. |
Zwróć
PivotValue
– nowa wartość tabeli przestawnej.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 danych zbioru danych, na której opiera się grupa przestawna. |
Zwróć
PivotGroup
– nowa grupa elementów tabeli przestawnej.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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.
Zwróć
PivotTable
– tabela przestawna,
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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. Więcej informacji: refreshData()
.
Zwraca wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution()
, aby włączyć wykonywanie danych dla określonego typu źródła danych.
Zwróć
DataSourcePivotTable
– obiekt danych;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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 obiekt jest połączony.
Zwróć
DataSource
– źródło danych,
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getStatus()
Pobiera stan wykonania danych obiektu.
Zwróć
DataExecutionStatus
– stan wykonania danych.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refreshData()
Odświeża dane obiektu.
Zwraca wyjątek, jeśli obecnie jest w stanie error
. Użyj DataSource#updateSpec()
, aby zaktualizować specyfikację. Ta metoda jest preferowana zamiast forceRefreshData()
, aby zapobiec nieoczekiwanym zmianom w źródle danych.
Zwraca wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution()
, aby włączyć wykonywanie danych dla określonego typu źródła danych.
Zwróć
DataSourcePivotTable
– obiekt danych;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForCompletion(timeoutInSeconds)
Powoduje, że bieżące wykonanie zostanie zakończone po upływie określonej liczby sekund. Zwraca wyjątek, jeśli wykonanie zadania nie zostanie zakończone, ale nie anuluje jego wykonania.
Parametry
Nazwa | Typ | Opis |
---|---|---|
timeoutInSeconds | Integer | Czas oczekiwania na wykonanie danych (w sekundach). Maksymalna długość to 300 sekund. |
Zwróć
DataExecutionStatus
– stan wykonania danych.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets