Class DataSourcePivotTable

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Tabela źródeł danych

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

MetodaZwracany typKrótki opis
addColumnGroup(columnName)PivotGroupDodaje nową grupę kolumn tabeli przestawnej na podstawie określonej kolumny źródła danych.
addFilter(columnName, filterCriteria)PivotFilterDodaje nowy filtr na podstawie podanej kolumny źródła danych z określonymi kryteriami filtrowania.
addPivotValue(columnName, summarizeFunction)PivotValueDodaje nową wartość tabeli przestawnej na podstawie określonej kolumny źródła danych z określoną funkcją podsumowania.
addRowGroup(columnName)PivotGroupDodaje nową grupę wierszy tabeli przestawnej na podstawie określonej kolumny źródła danych.
asPivotTable()PivotTableZwraca tabelę przestawną źródła danych jako zwykły obiekt tabeli przestawnej.
forceRefreshData()DataSourcePivotTableOdświeża dane tego obiektu niezależnie od bieżącego stanu.
getDataSource()DataSourcePobiera źródło danych, z którym obiekt jest połączony.
getStatus()DataExecutionStatusPobiera stan wykonania danych obiektu.
refreshData()DataSourcePivotTableOdświeża dane obiektu.
waitForCompletion(timeoutInSeconds)DataExecutionStatusPowoduje, ż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

NazwaTypOpis
columnNameStringNazwa 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

NazwaTypOpis
columnNameStringNazwa kolumny źródeł danych, na której podstawie opiera się filtr.
filterCriteriaFilterCriteriaKryteria 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

NazwaTypOpis
columnNameStringNazwa kolumny danych źródła, na której opiera się wartość przestawna.
summarizeFunctionPivotTableSummarizeFunctionFunkcja 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

NazwaTypOpis
columnNameStringNazwa 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

NazwaTypOpis
timeoutInSecondsIntegerCzas 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