Class PivotGroup

PivotGroup

Dostęp do grup podgrup tabel przestawnych i ich modyfikowanie.

Metody

MetodaZwracany typKrótki opis
addManualGroupingRule(groupName, groupMembers)PivotGroupDodaje ręczną regułę grupowania dla tej grupy przestawnej.
areLabelsRepeated()BooleanWskazuje, czy etykiety są wyświetlane jako powtarzające się.
clearGroupingRule()PivotGroupUsuwa wszystkie reguły grupowania z tej grupy przestawnej.
clearSort()PivotGroupUsuwa sortowanie zastosowane do tej grupy.
getDateTimeGroupingRule()DateTimeGroupingRuleZwraca regułę grupowania data i godzina w grupie przestawnej lub null, jeśli nie ustawiono reguły grupowania data-godzina.
getDimension()DimensionZwraca, czy jest to grupa wierszy czy kolumn.
getGroupLimit()PivotGroupLimitZwraca limit grupy przestawnej w grupie elementów tabeli przestawnej.
getIndex()IntegerZwraca indeks tej grupy przestawnej w bieżącej kolejności grupowania.
getPivotTable()PivotTableZwraca grupę PivotTable, do której należy dane grupowanie.
getSourceDataColumn()IntegerZwraca liczbę kolumny danych źródłowych podsumowujących tę grupę.
getSourceDataSourceColumn()DataSourceColumnZwraca kolumnę źródła danych, na której działa grupa przestawna.
hideRepeatedLabels()PivotGroupUkrywa powtarzające się etykiety dla tej grupy.
isSortAscending()BooleanZwraca wartość true, jeśli sortowanie jest rosnąco, lub zwraca wartość false, jeśli kolejność sortowania jest malejąca.
moveToIndex(index)PivotGroupPrzenosi tę grupę na określoną pozycję na bieżącej liście grup wierszy lub kolumn.
remove()voidUsuwa tę grupę przestawną z tabeli.
removeManualGroupingRule(groupName)PivotGroupUsuwa regułę ręcznego grupowania z określonym atrybutem groupName.
resetDisplayName()PivotGroupResetuje wyświetlaną nazwę tej grupy w tabeli przestawnej do wartości domyślnej.
setDateTimeGroupingRule(dateTimeGroupingRuleType)PivotGroupUstawia regułę grupowania data i godzina w grupie przestawnej.
setDisplayName(name)PivotGroupUstawia wyświetlaną nazwę tej grupy w tabeli przestawnej.
setGroupLimit(countLimit)PivotGroupOkreśla limit grupy przestawnej dla tej grupy.
setHistogramGroupingRule(minValue, maxValue, intervalSize)PivotGroupUstawia regułę grupowania histogramu dla tej grupy przestawnej.
showRepeatedLabels()PivotGroupJeś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)PivotGroupOkreśla, czy w tabeli mają być wyświetlane łączne wartości dla tej grupy przestawnej.
sortAscending()PivotGroupUstawia kolejność sortowania rosnącą.
sortBy(value, oppositeGroupValues)PivotGroupSortuje tę grupę według określonego argumentu PivotValue dla wartości z oppositeGroupValues.
sortDescending()PivotGroupUstawia kolejność sortowania malejącą.
totalsAreShown()BooleanWskazuje, 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

NazwaTypOpis
groupNameStringNazwa tej reguły grupowania.
groupMembersObject[]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

Booleantrue, 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

Booleantrue, 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

NazwaTypOpis
indexIntegerIndeks, 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

NazwaTypOpis
groupNameStringNazwa 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

NazwaTypOpis
dateTimeGroupingRuleTypeDateTimeGroupingRuleTypeTyp 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

NazwaTypOpis
nameStringWyś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

NazwaTypOpis
countLimitIntegerLimit 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

NazwaTypOpis
minValueIntegerMinimalna wartość, która umożliwia umieszczenie elementów w zasobnikach. Niższe wartości są łączone w jeden zasobnik.
maxValueIntegerMaksymalna wartość elementów, które można umieścić w zasobnikach. Większe wartości są łączone w jeden zasobnik.
intervalSizeInteger

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

NazwaTypOpis
showTotalsBooleanOkreś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

NazwaTypOpis
valuePivotValueWartość w tabeli przestawnej, według której chcesz posortować listę.
oppositeGroupValuesObject[]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

Booleantrue, 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