Class DataSourcePivotTable

DataSourcePivotTable

Dostęp do istniejącej tabeli przestawnej źródła danych i jej modyfikowanie. Aby utworzyć tabelę przestawną nowego źródła danych, użyj kodu Range.createDataSourcePivotTable(dataSource).

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

Metody

MetodaZwracany typKrótki opis
addColumnGroup(columnName)PivotGroupDodaje nową grupę kolumn przestawnych na podstawie określonej kolumny źródła danych.
addFilter(columnName, filterCriteria)PivotFilterDodaje nowy filtr na podstawie określonej kolumny źródła danych z określonymi kryteriami filtrowania.
addPivotValue(columnName)PivotValueDodaje nową wartość w tabeli przestawnej na podstawie określonej kolumny źródła danych bez funkcji podsumowania.
addPivotValue(columnName, summarizeFunction)PivotValueDodaje nową wartość przestawną 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.
cancelDataRefresh()DataSourcePivotTableAnuluje odświeżanie danych powiązane z tym obiektem, jeśli jest ono obecnie w toku.
forceRefreshData()DataSourcePivotTableOdświeża dane tego obiektu niezależnie od jego bieżącego stanu.
getDataSource()DataSourcePobiera źródło danych, z którym połączony jest obiekt.
getStatus()DataExecutionStatusPobiera stan wykonania danych obiektu.
refreshData()DataSourcePivotTableOdświeża dane obiektu.
waitForCompletion(timeoutInSeconds)DataExecutionStatusCzeka na zakończenie bieżącego działania. Po upływie podanej liczby sekund następuje przekroczenie limitu czasu.

Szczegółowa dokumentacja

addColumnGroup(columnName)

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

Parametry

NazwaTypOpis
columnNameStringNazwa kolumny źródła danych, na której opiera się grupa przestawna.

Powrót

PivotGroup – nowa grupa przestawna.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 określonej kolumny źródła danych z określonymi kryteriami filtrowania.

Parametry

NazwaTypOpis
columnNameStringNazwa kolumny źródła danych, na której podstawie jest tworzony filtr.
filterCriteriaFilterCriteriaKryteria używane przez filtr.

Powrót

PivotFilter – nowy filtr.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

addPivotValue(columnName)

Dodaje nową wartość w tabeli przestawnej na podstawie określonej kolumny źródła danych bez funkcji podsumowania. Dotyczy tylko miar Lookera.

Poniższy kod pokazuje, jak dodać miarę Lookera jako wartość przestawną. 

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

pivotTable.addPivotValue('columnName');

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

Parametry

NazwaTypOpis
columnNameStringNazwa kolumny źródła danych, na której opiera się wartość w tabeli przestawnej.

Powrót

PivotValue – nowa wartość przestawna.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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ść przestawną na podstawie określonej kolumny źródła danych z określoną funkcją podsumowania.

Aby dodać wartości przestawne do miar Lookera, użyj znaku addPivotValue(columnName).

Parametry

NazwaTypOpis
columnNameStringNazwa kolumny źródła danych, na której opiera się wartość w tabeli przestawnej.
summarizeFunctionPivotTableSummarizeFunctionFunkcja podsumowująca, której używa wartość przestawna.

Powrót

PivotValue – nowa wartość przestawna.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 źródła danych, na której opiera się grupa przestawna.

Powrót

PivotGroup – nowa grupa przestawna.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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.

Powrót

PivotTable – tabela przestawna.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 ono obecnie w toku.

Ten przykład pokazuje, jak anulować odświeżanie 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 umożliwić wykonywanie zapytań do bazy danych w przypadku określonego typu źródła danych.

Powrót

DataSourcePivotTable – obiekt danych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 jego bieżącego stanu. Więcej informacji znajdziesz w artykule refreshData(). Jeśli chcesz anulować aktualnie trwające odświeżanie tego obiektu, zapoznaj się z sekcją cancelDataRefresh().

Zgłasza wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution(), aby umożliwić wykonywanie zapytań do bazy danych w przypadku określonego typu źródła danych.

Powrót

DataSourcePivotTable – obiekt danych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 połączony jest obiekt.

Powrót

DataSource – źródło danych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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.

Powrót

DataExecutionStatus – stan wykonania danych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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.

Zgłasza wyjątek, jeśli obecnie jest w stanie error. Użyj DataSource#updateSpec(), aby zaktualizować specyfikację. Ta metoda jest preferowana w stosunku do forceRefreshData(), ponieważ zapobiega nieoczekiwanym zmianom w źródle danych.

Zgłasza wyjątek, jeśli typ źródła danych nie jest włączony. Użyj metod SpreadsheetApp#enable...Execution(), aby umożliwić wykonywanie zapytań do bazy danych w przypadku określonego typu źródła danych.

Powrót

DataSourcePivotTable – obiekt danych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 działania. Po upływie podanej liczby sekund następuje przekroczenie limitu czasu. Zwraca wyjątek, jeśli wykonanie nie zostanie ukończone przed upływem limitu czasu, ale nie anuluje wykonania danych.

Parametry

NazwaTypOpis
timeoutInSecondsIntegerCzas oczekiwania na wykonanie zapytania do bazy danych w sekundach. Maksymalny czas to 300 sekund.

Powrót

DataExecutionStatus – stan wykonania danych.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets