Class PivotGroup

PivotGroup

Pivot-Tabellen-Breakout-Gruppen aufrufen und bearbeiten

Methoden

MethodeRückgabetypKurzbeschreibung
addManualGroupingRule(groupName, groupMembers)PivotGroupFügt dieser Pivot-Gruppe eine manuelle Gruppierungsregel hinzu.
areLabelsRepeated()BooleanGibt an, ob Labels als wiederholt angezeigt werden.
clearGroupingRule()PivotGroupEntfernt alle Gruppierungsregeln aus dieser Pivot-Gruppe.
clearSort()PivotGroupAlle auf diese Gruppe angewendeten Sortierungen werden entfernt.
getDateTimeGroupingRule()DateTimeGroupingRuleGibt die Gruppierungsregel für Datum und Uhrzeit für die Pivot-Gruppe oder null zurück, wenn keine Gruppierungsregel für Datum und Uhrzeit festgelegt ist.
getDimension()DimensionGibt zurück, ob es sich um eine Zeilen- oder Spaltengruppe handelt.
getGroupLimit()PivotGroupLimitGibt das Pivot-Gruppenlimit für die Pivot-Gruppe zurück.
getIndex()IntegerGibt den Index dieser Pivot-Gruppe in der aktuellen Gruppenreihenfolge zurück
getPivotTable()PivotTableGibt das PivotTable zurück, zu dem diese Gruppe gehört.
getSourceDataColumn()IntegerGibt die Nummer der Quelldatenspalte zurück, die in dieser Gruppe zusammengefasst wird.
getSourceDataSourceColumn()DataSourceColumnGibt die Datenquellenspalte zurück, mit der die Pivot-Gruppe arbeitet.
hideRepeatedLabels()PivotGroupBlendet wiederholte Labels für diese Gruppierung aus.
isSortAscending()BooleanGibt true zurück, wenn die Sortierung aufsteigend ist, und false, wenn die Sortierfolge absteigend ist.
moveToIndex(index)PivotGroupVerschiebt diese Gruppe an die angegebene Position in der aktuellen Liste von Zeilen- oder Spaltengruppen.
remove()voidEntfernt diese Pivot-Gruppe aus der Tabelle.
removeManualGroupingRule(groupName)PivotGroupEntfernt die manuelle Gruppierungsregel mit dem angegebenen groupName.
resetDisplayName()PivotGroupSetzt den Anzeigenamen dieser Gruppe in der Pivot-Tabelle auf den Standardwert zurück.
setDateTimeGroupingRule(dateTimeGroupingRuleType)PivotGroupLegt die Datum-Uhrzeit-Gruppierungsregel für die Pivot-Gruppe fest.
setDisplayName(name)PivotGroupLegt den Anzeigenamen dieser Gruppe in der Pivot-Tabelle fest.
setGroupLimit(countLimit)PivotGroupLegt das Pivot-Gruppenlimit für die Pivot-Gruppe fest.
setHistogramGroupingRule(minValue, maxValue, intervalSize)PivotGroupLegt eine Histogramm-Gruppierungsregel für diese Pivot-Gruppe fest.
showRepeatedLabels()PivotGroupWenn mehr als eine Zeilen- oder Spaltengruppierung vorhanden ist, zeigt diese Methode das Label dieser Gruppierung für jeden Eintrag der nachfolgenden Gruppierung an.
showTotals(showTotals)PivotGroupLegt fest, ob Gesamtwerte für diese Pivot-Gruppe in der Tabelle angezeigt werden sollen.
sortAscending()PivotGroupLegt die Sortierreihenfolge auf aufsteigend fest.
sortBy(value, oppositeGroupValues)PivotGroupSortiert diese Gruppe nach dem angegebenen PivotValue für die Werte aus oppositeGroupValues.
sortDescending()PivotGroupLegt die absteigende Sortierreihenfolge fest.
totalsAreShown()BooleanGibt an, ob derzeit Gesamtwerte für diese Pivot-Gruppe angezeigt werden.

Detaillierte Dokumentation

addManualGroupingRule(groupName, groupMembers)

Fügt dieser Pivot-Gruppe eine manuelle Gruppierungsregel hinzu.

Parameter

NameTypBeschreibung
groupNameStringDer Name dieser Gruppierungsregel.
groupMembersObject[]Die Werte, die in dieser Gruppierungsregel enthalten sind.

Return

PivotGroup: Die Pivot-Gruppe für die Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

areLabelsRepeated()

Gibt an, ob Labels als wiederholt angezeigt werden.

Return

Boolean: true, wenn Labels wiederholt werden. Andernfalls wird false zurückgegeben.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

clearGroupingRule()

Entfernt alle Gruppierungsregeln aus dieser Pivot-Gruppe.

Return

PivotGroup: Die Pivot-Gruppe für die Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

clearSort()

Alle auf diese Gruppe angewendeten Sortierungen werden entfernt.

Return

PivotGroup: Die Pivot-Gruppe für die Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDateTimeGroupingRule()

Gibt die Gruppierungsregel für Datum und Uhrzeit für die Pivot-Gruppe oder null zurück, wenn keine Gruppierungsregel für Datum und Uhrzeit festgelegt ist.

Return

DateTimeGroupingRule: Die Gruppierungsregel für Datum und Uhrzeit.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDimension()

Gibt zurück, ob es sich um eine Zeilen- oder Spaltengruppe handelt.

Return

Dimension: die Dimension, die den Typ dieser Gruppe darstellt

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getGroupLimit()

Gibt das Pivot-Gruppenlimit für die Pivot-Gruppe zurück. Gibt null zurück, wenn kein Pivot-Gruppenlimit festgelegt ist.

Return

PivotGroupLimit: Das Limit für Pivot-Gruppen.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getIndex()

Gibt den Index dieser Pivot-Gruppe in der aktuellen Gruppenreihenfolge zurück

Return

Integer: Index der Pivot-Gruppe

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getPivotTable()

Gibt das PivotTable zurück, zu dem diese Gruppe gehört.

Return

PivotTable: die Pivot-Tabelle, zu der diese Gruppe gehört.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSourceDataColumn()

Gibt die Nummer der Quelldatenspalte zurück, die in dieser Gruppe zusammengefasst wird. Dieser Index ist 1-basiert, wenn diese Gruppe Quelldaten in Spalte "A" der Tabelle zusammenfasst, gibt diese Methode 1 zurück.

Return

Integer: die Nummer der Quelldatenspalte

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSourceDataSourceColumn()

Gibt die Datenquellenspalte zurück, mit der die Pivot-Gruppe arbeitet. Gibt null zurück, wenn die Pivot-Tabelle keine {DataSourcePivotTableApi} ist.

Return

DataSourceColumn: Die Datenquellenspalte, auf der die Pivot-Gruppe angewendet wird.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

hideRepeatedLabels()

Blendet wiederholte Labels für diese Gruppierung aus. Wenn Labels bereits ausgeblendet sind, führt dies zu einem Leerbefehl. Wenn diese Methode aufgerufen wird, bevor mehrere Zeilen- oder Spaltengruppierungen vorhanden sind, werden wiederholte Labels ausgeblendet, wenn eine zusätzliche Gruppierung hinzugefügt wird.

Return

PivotGroup: Die Pivot-Gruppe für die Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

isSortAscending()

Gibt true zurück, wenn die Sortierung aufsteigend ist, und false, wenn die Sortierfolge absteigend ist.

Return

Boolean: true, wenn die Sortierfolge aufsteigend ist.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

moveToIndex(index)

Verschiebt diese Gruppe an die angegebene Position in der aktuellen Liste von Zeilen- oder Spaltengruppen. Diese Indizes basieren auf 0. Wenn diese Gruppe beispielsweise an die erste Position verschoben werden soll, sollte diese Methode mit 0 aufgerufen werden.

Parameter

NameTypBeschreibung
indexIntegerIndex, in den diese Gruppe verschoben werden soll.

Return

PivotGroup: Die Pivot-Gruppe für die Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

remove()

Entfernt diese Pivot-Gruppe aus der Tabelle.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

removeManualGroupingRule(groupName)

Entfernt die manuelle Gruppierungsregel mit dem angegebenen groupName.

Parameter

NameTypBeschreibung
groupNameStringDer Name der Gruppierungsregel, die entfernt werden soll.

Return

PivotGroup: Die Pivot-Gruppe für die Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

resetDisplayName()

Setzt den Anzeigenamen dieser Gruppe in der Pivot-Tabelle auf den Standardwert zurück.

Return

PivotGroup: Die Pivot-Gruppe für die Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setDateTimeGroupingRule(dateTimeGroupingRuleType)

Legt die Datum-Uhrzeit-Gruppierungsregel für die Pivot-Gruppe fest.

Verwenden Sie clearGroupingRule(), um die Regel zu entfernen.

Parameter

NameTypBeschreibung
dateTimeGroupingRuleTypeDateTimeGroupingRuleTypeDer festzulegende Regeltyp.

Return

PivotGroup: Die Pivot-Gruppe für die Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setDisplayName(name)

Legt den Anzeigenamen dieser Gruppe in der Pivot-Tabelle fest.

Parameter

NameTypBeschreibung
nameStringDer festzulegende Anzeigename.

Return

PivotGroup: die Pivot-Gruppe für die Verkettung

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setGroupLimit(countLimit)

Legt das Pivot-Gruppenlimit für die Pivot-Gruppe fest. Der Vorgang wird nur für DataSourcePivotTable unterstützt.

Parameter

NameTypBeschreibung
countLimitIntegerDie maximale Anzahl der Zeilen oder Spalten, die festgelegt werden sollen. Muss positiv sein.

Return

PivotGroup: Die Pivot-Gruppe für die Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setHistogramGroupingRule(minValue, maxValue, intervalSize)

Legt eine Histogramm-Gruppierungsregel für diese Pivot-Gruppe fest. Eine Histogrammregel organisiert Werte in einer Quelldatenspalte in Buckets konstanter Größe. Alle Werte von minValue bis maxValue werden in Gruppen der Größe interval platziert. Alle Werte unter minValue und größer als maxValue werden in einem Bucket zusammengefasst.

Parameter

NameTypBeschreibung
minValueIntegerDer Mindestwert für Elemente, die in Buckets platziert werden sollen. Werte unter diesem Wert werden in einem einzigen Bucket zusammengefasst.
maxValueIntegerDer Maximalwert für Elemente, die in Buckets platziert werden sollen. Größere Werte werden in einem einzigen Bucket zusammengefasst.
intervalSizeInteger

Return

PivotGroup: Die Pivot-Gruppe für die Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

showRepeatedLabels()

Wenn mehr als eine Zeilen- oder Spaltengruppierung vorhanden ist, zeigt diese Methode das Label dieser Gruppierung für jeden Eintrag der nachfolgenden Gruppierung an. Wenn Labels bereits wiederholt werden, führt dies zu einem Leerbefehl. Wenn diese Methode aufgerufen wird, bevor mehrere Zeilen- oder Spaltengruppierungen vorhanden sind, werden wiederholte Labels angezeigt, wenn eine zusätzliche Gruppierung hinzugefügt wird.

Return

PivotGroup: Die Pivot-Gruppe für die Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

showTotals(showTotals)

Legt fest, ob Gesamtwerte für diese Pivot-Gruppe in der Tabelle angezeigt werden sollen.

Parameter

NameTypBeschreibung
showTotalsBooleanGibt an, ob Summen angezeigt werden sollen.

Return

PivotGroup: Die Pivot-Gruppe für die Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

sortAscending()

Legt die Sortierreihenfolge auf aufsteigend fest.

Return

PivotGroup: Die Pivot-Gruppe für die Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

sortBy(value, oppositeGroupValues)

Sortiert diese Gruppe nach dem angegebenen PivotValue für die Werte aus 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']);

Parameter

NameTypBeschreibung
valuePivotValuePivot-Wert, nach dem sortiert werden soll
oppositeGroupValuesObject[]Die Werte einer gegenüberliegenden Pivot-Gruppe (eine Spaltengruppe beim Sortieren einer Zeilengruppe oder eine Zeilengruppe beim Sortieren einer Spaltengruppe), die zum Sortieren verwendet werden. Die Reihenfolge dieser Werte bestimmt den Vorrang beim Aufheben von Gleichstand.

Return

PivotGroup: Die Pivot-Gruppe für die Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

sortDescending()

Legt die absteigende Sortierreihenfolge fest.

Return

PivotGroup: Die Pivot-Gruppe für die Verkettung.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

totalsAreShown()

Gibt an, ob derzeit Gesamtwerte für diese Pivot-Gruppe angezeigt werden.

Return

Boolean: true, wenn Gesamtwerte für diese Pivot-Gruppe angezeigt werden. Andernfalls wird false zurückgegeben.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets