Class PivotGroup

PrzestawGrupuj

Dostęp do grup podziału tabeli przestawnej i ich modyfikowanie.

Metody

MetodaZwracany typKrótki opis
addManualGroupingRule(groupName, groupMembers)PivotGroupDodaje regułę grupowania ręcznego dla tej grupy elementów tabeli przestawnej.
areLabelsRepeated()BooleanZwraca informację, czy etykiety są wyświetlane jako powtarzające się.
clearGroupingRule()PivotGroupUsuwa z tej grupy przestawnej wszystkie reguły grupowania.
clearSort()PivotGroupUsuwa wszelkie sortowanie zastosowane do tej grupy.
getDateTimeGroupingRule()DateTimeGroupingRule|nullZwraca regułę grupowania „data i godzina” w grupie elementów tabeli przestawnej lub null, jeśli nie ustawiono reguły grupowania „data i godzina”.
getDimension()DimensionZwraca informację, czy jest to grupa wierszy czy kolumn.
getGroupLimit()PivotGroupLimit|nullZwraca limit grupowania elementów tabeli przestawnej w grupie elementów tabeli przestawnej.
getIndex()IntegerZwraca indeks tej grupy elementów tabeli przestawnej w bieżącej kolejności grup.
getPivotTable()PivotTableZwraca PivotTable, do którego należy to grupowanie.
getSourceDataColumn()IntegerZwraca liczbę kolumn danych źródłowych, które podsumowuje ta grupa.
getSourceDataSourceColumn()DataSourceColumn|nullZwraca kolumnę źródła danych, na której działa grupa przestawna.
hideRepeatedLabels()PivotGroupUkrywa powtarzające się etykiety w tym grupowaniu.
isSortAscending()BooleanZwraca true, jeśli sortowanie jest rosnące, a false, jeśli jest malejące.
moveToIndex(index)PivotGroupPrzenosi tę grupę na określone miejsce na bieżącej liście grup wierszy lub kolumn.
remove()voidUsuwa tę grupę przestawną z tabeli.
removeManualGroupingRule(groupName)PivotGroupUsuwa regułę grupowania ręcznego o określonym identyfikatorze groupName.
resetDisplayName()PivotGroupPrzywraca wyświetlaną nazwę tej grupy w tabeli przestawnej do wartości domyślnej.
setDateTimeGroupingRule(dateTimeGroupingRuleType)PivotGroupUstawia regułę grupowania „data i godzina” w grupie elementów tabeli przestawnej.
setDisplayName(name)PivotGroupUstawia wyświetlaną nazwę tej grupy w tabeli przestawnej.
setGroupLimit(countLimit)PivotGroupUstawia limit grupowania elementów tabeli przestawnej w grupie elementów tabeli przestawnej.
setHistogramGroupingRule(minValue, maxValue, intervalSize)PivotGroupUstawia regułę grupowania histogramu dla tej grupy przestawnej.
showRepeatedLabels()PivotGroupJeśli istnieje więcej niż 1 grupowanie wierszy lub kolumn, ta metoda wyświetla etykietę tego grupowania dla każdego wpisu w kolejnym grupowaniu.
showTotals(showTotals)PivotGroupOkreśla, czy w tabeli mają być wyświetlane wartości łączne dla tej grupy w tabeli przestawnej.
sortAscending()PivotGroupUstawia kolejność sortowania na rosnącą.
sortBy(value, oppositeGroupValues)PivotGroupSortuje tę grupę według określonego PivotValue dla wartości z oppositeGroupValues.
sortDescending()PivotGroupUstawia kolejność sortowania na malejącą.
totalsAreShown()BooleanZwraca informację, czy dla tej grupy przestawnej są obecnie wyświetlane wartości łączne.

Szczegółowa dokumentacja

addManualGroupingRule(groupName, groupMembers)

Dodaje regułę grupowania ręcznego dla tej grupy elementów tabeli przestawnej.

Parametry

NazwaTypOpis
groupNameStringNazwa tej reguły grupowania.
groupMembersObject[]Wartości uwzględnione w tej regule grupowania.

Powrót

PivotGroup – grupa bazowa do łączenia.

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

areLabelsRepeated()

Zwraca informację, czy etykiety są wyświetlane jako powtarzające się.

Powrót

Boolean – true, jeśli etykiety się powtarzają; w przeciwnym razie zwraca false.

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

clearGroupingRule()

Usuwa z tej grupy przestawnej wszystkie reguły grupowania.

Powrót

PivotGroup – grupa bazowa do łączenia.

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

clearSort()

Usuwa wszelkie sortowanie zastosowane do tej grupy.

Powrót

PivotGroup – grupa bazowa do łączenia.

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

getDateTimeGroupingRule()

Zwraca regułę grupowania „data i godzina” w grupie elementów tabeli przestawnej lub null, jeśli nie ustawiono reguły grupowania „data i godzina”.

Powrót

DateTimeGroupingRule|null – reguła grupowania „data i godzina”.

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

getDimension()

Zwraca informację, czy jest to grupa wierszy czy kolumn.

Powrót

Dimension – wymiar reprezentujący typ tej grupy.

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

getGroupLimit()

Zwraca limit grupowania elementów tabeli przestawnej w grupie elementów tabeli przestawnej. Zwraca wartość null, jeśli nie ustawiono limitu grupowania elementów tabeli przestawnej.

Powrót

PivotGroupLimit|null – limit grupowania elementów tabeli przestawnej.

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

getIndex()

Zwraca indeks tej grupy elementów tabeli przestawnej w bieżącej kolejności grup.

Powrót

Integer – indeks grupy elementów tabeli przestawnej.

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

getPivotTable()

Zwraca PivotTable, do którego należy to grupowanie.

Powrót

PivotTable – tabela przestawna, do której należy ta grupa.

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

getSourceDataColumn()

Zwraca liczbę kolumn danych źródłowych, które podsumowuje ta grupa. Ten indeks jest liczony od 1. Jeśli ta grupa podsumowuje dane źródłowe w kolumnie „A” arkusza kalkulacyjnego, ta metoda zwraca 1.

Powrót

Integer – numer kolumny danych źródłowych.

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

getSourceDataSourceColumn()

Zwraca kolumnę źródła danych, na której działa grupa przestawna. Zwraca wartość null, jeśli tabela przestawna nie jest obiektem {DataSourcePivotTableApi}.

Powrót

DataSourceColumn|null – kolumna źródła danych, na której działa 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

hideRepeatedLabels()

Ukrywa powtarzające się etykiety w tym grupowaniu. Jeśli etykiety są już ukryte, ta metoda nie ma żadnego efektu. Jeśli ta metoda zostanie wywołana przed utworzeniem wielu grupowań wierszy lub kolumn, po dodaniu kolejnego grupowania powtarzające się etykiety zostaną ukryte.

Powrót

PivotGroup – grupa bazowa do łączenia.

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

isSortAscending()

Zwraca true, jeśli sortowanie jest rosnące, a false, jeśli jest malejące.

Powrót

Boolean – true, jeśli kolejność sortowania jest rosnąca.

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

moveToIndex(index)

Przenosi tę grupę na określone miejsce na bieżącej liście grup wierszy lub kolumn. Te indeksy są oparte na numeracji od zera. Jeśli na przykład ta grupa ma zostać przeniesiona na pierwszą pozycję, należy wywołać tę metodę z wartością 0.

Parametry

NazwaTypOpis
indexIntegerIndeks, do którego ma zostać przeniesiona ta grupa.

Powrót

PivotGroup – grupa bazowa do łączenia.

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

remove()

Usuwa tę grupę przestawną z tabeli.

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

removeManualGroupingRule(groupName)

Usuwa regułę grupowania ręcznego o określonym identyfikatorze groupName.

Parametry

NazwaTypOpis
groupNameStringNazwa reguły grupowania do usunięcia.

Powrót

PivotGroup – grupa bazowa do łączenia.

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

resetDisplayName()

Przywraca wyświetlaną nazwę tej grupy w tabeli przestawnej do wartości domyślnej.

Powrót

PivotGroup – grupa bazowa do łączenia.

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

setDateTimeGroupingRule(dateTimeGroupingRuleType)

Ustawia regułę grupowania „data i godzina” w grupie elementów tabeli przestawnej.

Aby usunąć regułę, użyj clearGroupingRule().

Parametry

NazwaTypOpis
dateTimeGroupingRuleTypeDateTimeGroupingRuleTypeTyp reguły do ustawienia.

Powrót

PivotGroup – grupa przestawna do łączenia.

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

setDisplayName(name)

Ustawia wyświetlaną nazwę tej grupy w tabeli przestawnej.

Parametry

NazwaTypOpis
nameStringWyświetlana nazwa do ustawienia.

Powrót

PivotGroup – grupa przestawna do łączenia;

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

setGroupLimit(countLimit)

Ustawia limit grupowania elementów tabeli przestawnej w grupie elementów tabeli przestawnej. Ta operacja jest obsługiwana tylko w przypadku DataSourcePivotTable.

Parametry

NazwaTypOpis
countLimitIntegerLimit liczby wierszy lub kolumn do ustawienia. Musi być dodatnia.

Powrót

PivotGroup – grupa bazowa do łączenia.

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

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 zasobnikach o stałym rozmiarze. Wszystkie wartości od minValue do maxValue są umieszczane w grupach o rozmiarze interval. Wszystkie wartości poniżej minValue są umieszczane w jednym zasobniku, podobnie jak wszystkie wartości większe niż maxValue.

Parametry

NazwaTypOpis
minValueIntegerMinimalna wartość elementów, które mają być umieszczane w przedziałach. Wartości mniejsze od tej wartości są łączone w jeden zasobnik.
maxValueIntegerMaksymalna wartość elementów, które mają zostać umieszczone w przedziałach. Wartości większe niż ta są łączone w jednym przedziale.
intervalSizeInteger

Powrót

PivotGroup – grupa bazowa do łączenia.

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

showRepeatedLabels()

Jeśli istnieje więcej niż 1 grupowanie wierszy lub kolumn, ta metoda wyświetla etykietę tego grupowania dla każdego wpisu w kolejnym grupowaniu. Jeśli etykiety są już powtórzone, ta metoda nie ma wpływu na działanie. Jeśli ta metoda zostanie wywołana przed utworzeniem wielu grup wierszy lub kolumn, po dodaniu dodatkowej grupy zostaną wyświetlone powtórzone etykiety.

Powrót

PivotGroup – grupa bazowa do łączenia.

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

showTotals(showTotals)

Określa, czy w tabeli mają być wyświetlane wartości łączne dla tej grupy w tabeli przestawnej.

Parametry

NazwaTypOpis
showTotalsBooleanOkreśla, czy wyświetlać sumy.

Powrót

PivotGroup – grupa bazowa do łączenia.

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

sortAscending()

Ustawia kolejność sortowania na rosnącą.

Powrót

PivotGroup – grupa bazowa do łączenia.

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

sortBy(value, oppositeGroupValues)

Sortuje tę grupę według określonego PivotValue dla wartości z oppositeGroupValues. 

// Sorts the item group by the "SUM of Quantity" pivot value for the specified
// salespersons.
const sheet = SpreadsheetApp.getActiveSheet();
const pivotTable = sheet.getPivotTables()[0];
const itemGroup = pivotTable.getRowGroups()[0];
const sumQuantityValue = pivotTable.getPivotValues()[0];
itemGroup.sortBy(sumQuantityValue, ['Beth', 'Amir', 'Devyn']);

Parametry

NazwaTypOpis
valuePivotValueWartość w tabeli przestawnej, według której ma nastąpić sortowanie.
oppositeGroupValuesObject[]Wartości przeciwnej grupy przestawnej (grupy kolumn, jeśli sortujesz grupę wierszy, lub grupy wierszy, jeśli sortujesz grupę kolumn), które są używane do sortowania. Kolejność tych wartości określa priorytet w przypadku remisu.

Powrót

PivotGroup – grupa bazowa do łączenia.

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

sortDescending()

Ustawia kolejność sortowania na malejącą.

Powrót

PivotGroup – grupa bazowa do łączenia.

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

totalsAreShown()

Zwraca informację, czy dla tej grupy przestawnej są obecnie wyświetlane wartości łączne.

Powrót

Boolean – true, jeśli dla tej grupy w tabeli przestawnej wyświetlane są wartości łączne; w przeciwnym razie zwraca false.

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