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

Metoda	Zwracany typ	Krótki opis
addColumnGroup(columnName)	PivotGroup	Dodaje nową grupę kolumn przestawnych na podstawie wybranej 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)	PivotValue	Dodaje nową wartość tabeli przestawnej na podstawie wybranej kolumny źródła danych bez funkcji podsumowującej.
addPivotValue(columnName, summarizeFunction)	PivotValue	Dodaje nową wartość tabeli przestawnej na podstawie wybranej kolumny źródła danych za pomocą określonej funkcji podsumowującej.
addRowGroup(columnName)	PivotGroup	Dodaje nową grupę wierszy tabeli przestawnej na podstawie wybranej 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 obecnie uruchomione.
forceRefreshData()	DataSourcePivotTable	Odświeża dane tego obiektu niezależnie od jego bieżącego stanu.
getDataSource()	DataSource	Pobiera źródło danych, z którym jest powiązany 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, 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

Nazwa	Typ	Opis
columnName	String	Nazwa 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

Nazwa	Typ	Opis
columnName	String	Nazwa kolumny źródła danych, na której podstawie działa filtr.
filterCriteria	FilterCriteria	Kryteria 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

Nazwa	Typ	Opis
columnName	String	Nazwa 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

Nazwa	Typ	Opis
columnName	String	Nazwa kolumny źródła danych, na której podstawie obliczana jest wartość w tabeli przestawnej.
summarizeFunction	PivotTableSummarizeFunction	Funkcja 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

Nazwa	Typ	Opis
columnName	String	Nazwa 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

Nazwa	Typ	Opis
timeoutInSeconds	Integer	Czas 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