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()
.
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
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.
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
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