Dostęp do grup podgrup tabel przestawnych i ich modyfikowanie.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
addManualGroupingRule(groupName, groupMembers) | PivotGroup | Dodaje ręczną regułę grupowania dla tej grupy przestawnej. |
areLabelsRepeated() | Boolean | Wskazuje, czy etykiety są wyświetlane jako powtarzające się. |
clearGroupingRule() | PivotGroup | Usuwa wszystkie reguły grupowania z tej grupy przestawnej. |
clearSort() | PivotGroup | Usuwa sortowanie zastosowane do tej grupy. |
getDateTimeGroupingRule() | DateTimeGroupingRule | Zwraca regułę grupowania data i godzina w grupie przestawnej lub null , jeśli nie ustawiono reguły grupowania data-godzina. |
getDimension() | Dimension | Zwraca, czy jest to grupa wierszy czy kolumn. |
getGroupLimit() | PivotGroupLimit | Zwraca limit grupy przestawnej w grupie elementów tabeli przestawnej. |
getIndex() | Integer | Zwraca indeks tej grupy przestawnej w bieżącej kolejności grupowania. |
getPivotTable() | PivotTable | Zwraca grupę PivotTable , do której należy dane grupowanie. |
getSourceDataColumn() | Integer | Zwraca liczbę kolumny danych źródłowych podsumowujących tę grupę. |
getSourceDataSourceColumn() | DataSourceColumn | Zwraca kolumnę źródła danych, na której działa grupa przestawna. |
hideRepeatedLabels() | PivotGroup | Ukrywa powtarzające się etykiety dla tej grupy. |
isSortAscending() | Boolean | Zwraca wartość true , jeśli sortowanie jest rosnąco, lub zwraca wartość false , jeśli kolejność sortowania jest malejąca. |
moveToIndex(index) | PivotGroup | Przenosi tę grupę na określoną pozycję na bieżącej liście grup wierszy lub kolumn. |
remove() | void | Usuwa tę grupę przestawną z tabeli. |
removeManualGroupingRule(groupName) | PivotGroup | Usuwa regułę ręcznego grupowania z określonym atrybutem groupName . |
resetDisplayName() | PivotGroup | Resetuje wyświetlaną nazwę tej grupy w tabeli przestawnej do wartości domyślnej. |
setDateTimeGroupingRule(dateTimeGroupingRuleType) | PivotGroup | Ustawia regułę grupowania data i godzina w grupie przestawnej. |
setDisplayName(name) | PivotGroup | Ustawia wyświetlaną nazwę tej grupy w tabeli przestawnej. |
setGroupLimit(countLimit) | PivotGroup | Określa limit grupy przestawnej dla tej grupy. |
setHistogramGroupingRule(minValue, maxValue, intervalSize) | PivotGroup | Ustawia regułę grupowania histogramu dla tej grupy przestawnej. |
showRepeatedLabels() | PivotGroup | Jeśli istnieje więcej niż 1 grupa wierszy lub kolumn, ta metoda wyświetla etykietę tego grupowania dla każdego wpisu kolejnego grupowania. |
showTotals(showTotals) | PivotGroup | Określa, czy w tabeli mają być wyświetlane łączne wartości dla tej grupy przestawnej. |
sortAscending() | PivotGroup | Ustawia kolejność sortowania rosnącą. |
sortBy(value, oppositeGroupValues) | PivotGroup | Sortuje tę grupę według określonego argumentu PivotValue dla wartości z oppositeGroupValues . |
sortDescending() | PivotGroup | Ustawia kolejność sortowania malejącą. |
totalsAreShown() | Boolean | Wskazuje, czy dla tej grupy przestawnej są obecnie wyświetlane łączne wartości. |
Szczegółowa dokumentacja
addManualGroupingRule(groupName, groupMembers)
Dodaje ręczną regułę grupowania dla tej grupy przestawnej.
Parametry
Nazwa | Typ | Opis |
---|---|---|
groupName | String | Nazwa tej reguły grupowania. |
groupMembers | Object[] | Wartości uwzględnione w tej regule grupowania. |
Powroty
PivotGroup
– grupa przestawna na potrzeby łańcuchów.
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
areLabelsRepeated()
Wskazuje, czy etykiety są wyświetlane jako powtarzające się.
Powroty
Boolean
– true
, jeśli etykiety się powtarzają. W przeciwnym razie zwraca false
.
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
clearGroupingRule()
Usuwa wszystkie reguły grupowania z tej grupy przestawnej.
Powroty
PivotGroup
– grupa przestawna na potrzeby łańcuchów.
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
clearSort()
Usuwa sortowanie zastosowane do tej grupy.
Powroty
PivotGroup
– grupa przestawna na potrzeby łańcuchów.
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
getDateTimeGroupingRule()
Zwraca regułę grupowania data i godzina w grupie przestawnej lub null
, jeśli nie ustawiono reguły grupowania data-godzina.
Powroty
DateTimeGroupingRule
– reguła grupowania daty i godziny.
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
getDimension()
Zwraca, czy jest to grupa wierszy czy kolumn.
Powroty
Dimension
– wymiar reprezentujący typ grupy,
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
getGroupLimit()
Zwraca limit grupy przestawnej w grupie elementów tabeli przestawnej. Zwraca wartość null
, jeśli nie ustawiono limitu grup przestawnych.
Powroty
PivotGroupLimit
– limit grup przestawnych.
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
getIndex()
Zwraca indeks tej grupy przestawnej w bieżącej kolejności grupowania.
Powroty
Integer
– indeks grupy przestawnej;
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
getPivotTable()
Zwraca grupę PivotTable
, do której należy dane grupowanie.
Powroty
PivotTable
– tabela przestawna, do której należy ta grupa.
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
getSourceDataColumn()
Zwraca liczbę kolumny danych źródłowych podsumowujących tę grupę. Wartość indeksu jest uzależniona od liczby 1. Jeśli ta grupa podsumowuje dane źródłowe w kolumnie „A” arkusza kalkulacyjnego, ta metoda zwraca wartość 1
.
Powroty
Integer
– numer kolumny danych źródłowych,
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
getSourceDataSourceColumn()
Zwraca kolumnę źródła danych, na której działa grupa przestawna. Zwraca wartość null
, jeśli tabela przestawna nie jest typu {DataSourcePivotTableApi}.
Powroty
DataSourceColumn
– kolumna źródła danych, na której działa 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
hideRepeatedLabels()
Ukrywa powtarzające się etykiety dla tej grupy. Jeśli etykiety są już ukryte, użytkownik nie będzie mógł ich wyświetlić. Jeśli ta metoda zostanie wywołana, zanim istnieje kilka grupowań wierszy lub kolumn, po dodaniu dodatkowego grupowania powtarzające się etykiety są ukryte.
Powroty
PivotGroup
– grupa przestawna na potrzeby łańcuchów.
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
isSortAscending()
Zwraca wartość true
, jeśli sortowanie jest rosnąco, lub zwraca wartość false
, jeśli kolejność sortowania jest malejąca.
Powroty
Boolean
– true
, jeśli kolejność sortowania jest rosnąca.
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
moveToIndex(index)
Przenosi tę grupę na określoną pozycję na bieżącej liście grup wierszy lub kolumn. Te indeksy są liczone od 0. Jeśli np. grupę należy przenieść na pierwszą pozycję, metodę należy wywołać za pomocą polecenia 0
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
index | Integer | Indeks, do którego chcesz przenieść tę grupę. |
Powroty
PivotGroup
– grupa przestawna na potrzeby łańcuchów.
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
remove()
Usuwa tę grupę przestawną z tabeli.
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
removeManualGroupingRule(groupName)
Usuwa regułę ręcznego grupowania z określonym atrybutem groupName
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
groupName | String | Nazwa reguły grupowania do usunięcia. |
Powroty
PivotGroup
– grupa przestawna na potrzeby łańcuchów.
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
resetDisplayName()
Resetuje wyświetlaną nazwę tej grupy w tabeli przestawnej do wartości domyślnej.
Powroty
PivotGroup
– grupa przestawna na potrzeby łańcuchów.
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
setDateTimeGroupingRule(dateTimeGroupingRuleType)
Ustawia regułę grupowania data i godzina w grupie przestawnej.
Aby usunąć regułę, użyj clearGroupingRule()
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
dateTimeGroupingRuleType | DateTimeGroupingRuleType | Typ reguły do ustawienia. |
Powroty
PivotGroup
– grupa przestawna służąca do tworzenia łańcuchów.
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
setDisplayName(name)
Ustawia wyświetlaną nazwę tej grupy w tabeli przestawnej.
Parametry
Nazwa | Typ | Opis |
---|---|---|
name | String | Wyświetlana nazwa do ustawienia. |
Powroty
PivotGroup
– grupa przestawna przeznaczona do łańcuchów
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
setGroupLimit(countLimit)
Określa limit grupy przestawnej dla tej grupy. Ta operacja jest obsługiwana tylko w przypadku elementu DataSourcePivotTable
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
countLimit | Integer | Limit wierszy lub kolumn do ustawienia. Musi być liczbą dodatnią. |
Powroty
PivotGroup
– grupa przestawna umożliwiająca tworzenie łańcuchów.
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
setHistogramGroupingRule(minValue, maxValue, intervalSize)
Ustawia regułę grupowania histogramu dla tej grupy przestawnej. Reguła histogramu porządkuje wartości w kolumnie danych źródłowych w zasobniki o stałym rozmiarze. Wszystkie wartości od minValue
do maxValue
są umieszczane w grupach o rozmiarze interval
. Wszystkie wartości poniżej minValue
zostaną umieszczone w jednym zasobniku, tak samo jak wszystkie wartości większe niż maxValue
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
minValue | Integer | Minimalna wartość, która umożliwia umieszczenie elementów w zasobnikach. Niższe wartości są łączone w jeden zasobnik. |
maxValue | Integer | Maksymalna wartość elementów, które można umieścić w zasobnikach. Większe wartości są łączone w jeden zasobnik. |
intervalSize | Integer |
Powroty
PivotGroup
– grupa przestawna na potrzeby łańcuchów.
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
showRepeatedLabels()
Jeśli istnieje więcej niż 1 grupa wierszy lub kolumn, ta metoda wyświetla etykietę tego grupowania dla każdego wpisu kolejnego grupowania. Jeśli etykiety są już powtórzone, skutkuje to brakiem operacji. Jeśli ta metoda zostanie wywołana, zanim istnieje kilka grupowań wierszy lub kolumn, po dodaniu kolejnych grupowań wyświetlane są powtarzające się etykiety.
Powroty
PivotGroup
– grupa przestawna na potrzeby łańcuchów.
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
showTotals(showTotals)
Określa, czy w tabeli mają być wyświetlane łączne wartości dla tej grupy przestawnej.
Parametry
Nazwa | Typ | Opis |
---|---|---|
showTotals | Boolean | Określa, czy wyświetlać sumy. |
Powroty
PivotGroup
– grupa przestawna na potrzeby łańcuchów.
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
sortAscending()
Ustawia kolejność sortowania rosnącą.
Powroty
PivotGroup
– grupa przestawna na potrzeby łańcuchów.
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
sortBy(value, oppositeGroupValues)
Sortuje tę grupę według określonego argumentu PivotValue
dla wartości z oppositeGroupValues
.
// Sorts the item group by the "SUM of Quantity" pivot value for the specified salespersons. var sheet = SpreadsheetApp.getActiveSheet(); var pivotTable = sheet.getPivotTables()[0]; var itemGroup = pivotTable.getRowGroups()[0]; var sumQuantityValue = pivotTable.getPivotValues()[0]; itemGroup.sortBy(sumQuantityValue, ['Beth', 'Amir', 'Devyn']);
Parametry
Nazwa | Typ | Opis |
---|---|---|
value | PivotValue | Wartość w tabeli przestawnej, według której chcesz posortować listę. |
oppositeGroupValues | Object[] | Wartości przeciwnej grupy przestawnej (grupy kolumn przy sortowaniu grupy wierszy lub grupy wierszy w przypadku sortowania grupy kolumn), które służą do sortowania. Kolejność tych wartości określa pierwszeństwo przy łamaniu remisów. |
Powroty
PivotGroup
– grupa przestawna na potrzeby łańcuchów.
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
sortDescending()
Ustawia kolejność sortowania malejącą.
Powroty
PivotGroup
– grupa przestawna na potrzeby łańcuchów.
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
totalsAreShown()
Wskazuje, czy dla tej grupy przestawnej są obecnie wyświetlane łączne wartości.
Powroty
Boolean
– true
, jeśli wyświetlane są całkowite wartości dla tej grupy przestawnej. W przeciwnym razie zwraca false
.
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