Class DataSourcePivotTable

Źródłodanychtabeliprzejścia

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

Używaj tej klasy tylko z danymi połączonymi z bazą danych.

Metody

MetodaZwracany typKrótki opis
addColumnGroup(columnName)PivotGroupDodaje nową grupę kolumn przestawnych na podstawie wybranej kolumny źródła danych.
addFilter(columnName, filterCriteria)PivotFilterDodaje nowy filtr na podstawie określonej kolumny źródła danych z określonymi kryteriami filtra.
addPivotValue(columnName)PivotValueDodaje nową wartość tabeli przestawnej na podstawie wybranej kolumny źródła danych bez funkcji podsumowującej.
addPivotValue(columnName, summarizeFunction)PivotValueDodaje nową wartość tabeli przestawnej na podstawie wybranej kolumny źródła danych za pomocą określonej funkcji podsumowującej.
addRowGroup(columnName)PivotGroupDodaje nową grupę wierszy tabeli przestawnej na podstawie wybranej 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 obecnie uruchomione.
forceRefreshData()DataSourcePivotTableOdświeża dane tego obiektu niezależnie od jego bieżącego stanu.
getDataSource()DataSourcePobiera źródło danych, z którym jest powiązany obiekt.
getStatus()DataExecutionStatusPobiera stan wykonania danych obiektu.
refreshData()DataSourcePivotTableOdświeża dane obiektu.
waitForCompletion(timeoutInSeconds)DataExecutionStatusCzeka na zakończenie bieżącego wykonania, po czym po upływie podanej liczby sekund kończy działanie.

Szczegółowa dokumentacja

addColumnGroup(columnName)

Dodaje nową grupę kolumn przestawnych na podstawie wybranej 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, 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

addFilter(columnName, filterCriteria)

Dodaje nowy filtr na podstawie określonej kolumny źródła danych z określonymi kryteriami filtra.

Parametry

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

Powrót

PivotFilter – nowy filtr.

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

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.
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 podstawie obliczana jest wartość w tabeli przestawnej.

Powrót

PivotValue – nowa wartość przestawna.

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

addPivotValue(columnName, summarizeFunction)

Dodaje nową wartość tabeli przestawnej na podstawie wybranej kolumny źródła danych za pomocą określonej funkcji podsumowującej.

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

Parametry

NazwaTypOpis
columnNameStringNazwa kolumny źródła danych, na której podstawie obliczana jest wartość w tabeli przestawnej.
summarizeFunctionPivotTableSummarizeFunctionFunkcja podsumowywania używana przez wartość wymiaru.

Powrót

PivotValue – nowa wartość przestawna.

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

addRowGroup(columnName)

Dodaje nową grupę wierszy tabeli przestawnej na podstawie wybranej 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, 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, 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

cancelDataRefresh()

anuluje odświeżanie danych powiązane z tym obiektem, jeśli jest obecnie uruchomione.

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

Wyjątek jest zgłaszany, 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, 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

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 wykonywane odświeżanie tego obiektu, zapoznaj się z artykułem cancelDataRefresh().

Wyjątek jest zgłaszany, 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, 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

getDataSource()

Pobiera źródło danych, z którym jest powiązany 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 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

refreshData()

Odświeża dane obiektu.

Wyjątek jest rzucany, jeśli aktualny stan to error. Aby zaktualizować specyfikację, użyj DataSource#updateSpec(). Ta metoda jest preferowana w stosunku do forceRefreshData(), ponieważ zapobiega nieoczekiwanym zmianom w źródle danych.

Wyjątek jest zgłaszany, 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, 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

waitForCompletion(timeoutInSeconds)

Czeka na zakończenie bieżącego wykonania, po czym po upływie podanej liczby sekund kończy działanie. Wyjątek jest zwracany, jeśli wykonanie nie zostało ukończone, gdy upłynął limit czasu, ale nie anuluje wykonania danych.

Parametry

NazwaTypOpis
timeoutInSecondsIntegerCzas oczekiwania na wykonanie danych (w sekundach). Maksymalny czas trwania to 300 sekund.

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