Class PivotGroup

Pivot-Gruppe

Auf Pivot-Tabellen-Breakouts zugreifen und sie ändern

Methoden

MethodeRückgabetypKurzbeschreibung
addManualGroupingRule(groupName, groupMembers)PivotGroupFügt eine manuelle Gruppierungsregel für diese Pivot-Gruppe hinzu.
areLabelsRepeated()BooleanGibt zurück, ob Labels als wiederholt angezeigt werden.
clearGroupingRule()PivotGroupEntfernt alle Gruppierungsregeln aus dieser Pivot-Gruppe.
clearSort()PivotGroupEntfernt alle auf diese Gruppe angewendeten Sortierungen.
getDateTimeGroupingRule()DateTimeGroupingRuleGibt die Gruppierungsregel „Datum/Uhrzeit“ für die Pivot-Gruppe zurück oder null, wenn keine Gruppierungsregel für das Datum und die Uhrzeit festgelegt ist.
getDimension()DimensionGibt zurück, ob es sich um eine Zeilen- oder Spaltengruppe handelt.
getGroupLimit()PivotGroupLimitGibt das 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 Gruppierung gehört.
getSourceDataColumn()IntegerGibt die Anzahl der Quelldaten zurück, die diese Gruppe zusammenfasst.
getSourceDataSourceColumn()DataSourceColumnGibt die Datenquelle zurück, in der die Pivot-Gruppe aktiv ist.
hideRepeatedLabels()PivotGroupWiederholte Labels für diese Gruppierung werden ausgeblendet.
isSortAscending()BooleanGibt true zurück, wenn die Sortierung aufsteigend ist, und gibt false zurück, wenn die Sortierreihenfolge 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 der angegebenen groupName.
resetDisplayName()PivotGroupSetzt den Anzeigenamen dieser Gruppe in der Pivot-Tabelle auf den Standardwert zurück.
setDateTimeGroupingRule(dateTimeGroupingRuleType)PivotGroupLegt die Gruppierungsregel „Datum/Uhrzeit“ für die Pivot-Gruppe fest.
setDisplayName(name)PivotGroupLegt den Anzeigenamen dieser Gruppe in der Pivot-Tabelle fest.
setGroupLimit(countLimit)PivotGroupLegt das Limit der Pivot-Gruppe für die Gruppe fest.
setHistogramGroupingRule(minValue, maxValue, intervalSize)PivotGroupLegt eine Regel für die Histogrammgruppierung für diese Pivot-Gruppe fest.
showRepeatedLabels()PivotGroupWenn es mehr als eine Zeilen- oder Spaltengruppierung gibt, wird bei dieser Methode für jeden Eintrag der nachfolgenden Gruppierung das Label dieser Gruppierung angezeigt.
showTotals(showTotals)PivotGroupLegt fest, ob die Gesamtwerte für diese Pivot-Gruppe in der Tabelle angezeigt werden.
sortAscending()PivotGroupLegt die Sortierreihenfolge fest, die aufsteigend sein soll.
sortBy(value, oppositeGroupValues)PivotGroupSortiert diese Gruppe nach dem angegebenen PivotValue für die Werte aus oppositeGroupValues.
sortDescending()PivotGroupLegt die absteigende Sortierreihenfolge fest.
totalsAreShown()BooleanGibt zurück, ob aktuell Gesamtwerte für diese Pivot-Gruppe angezeigt werden.

Detaillierte Dokumentation

addManualGroupingRule(groupName, groupMembers)

Fügt eine manuelle Gruppierungsregel für diese Pivot-Gruppe hinzu.

Parameter

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

Zurücksenden

PivotGroup: Die Pivot-Gruppe für Verkettungen.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

areLabelsRepeated()

Gibt zurück, ob Labels als wiederholt angezeigt werden.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

clearGroupingRule()

Entfernt alle Gruppierungsregeln aus dieser Pivot-Gruppe.

Zurücksenden

PivotGroup: Die Pivot-Gruppe für Verkettungen.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

clearSort()

Entfernt alle auf diese Gruppe angewendeten Sortierungen.

Zurücksenden

PivotGroup: Die Pivot-Gruppe für Verkettungen.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getDateTimeGroupingRule()

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

Zurücksenden

DateTimeGroupingRule: Die Gruppierungsregel „Datum/Uhrzeit“.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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.

Zurücksenden

Dimension: Die Dimension, die den Typ dieser Gruppe darstellt

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getGroupLimit()

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

Zurücksenden

PivotGroupLimit: Das Limit für die Pivot-Gruppe.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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.

Zurücksenden

Integer: Index der Pivot-Gruppe

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getPivotTable()

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

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getSourceDataColumn()

Gibt die Anzahl der Quelldaten zurück, die diese Gruppe zusammenfasst. Dieser Index basiert auf 1, wenn die Gruppe Quelldaten in der Spalte „A“ der Tabelle zusammenfasst und diese Methode 1 zurückgibt.

Zurücksenden

Integer: die Spaltennummer der Quelldaten

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

getSourceDataSourceColumn()

Gibt die Datenquelle zurück, in der die Pivot-Gruppe aktiv ist. Gibt null zurück, wenn die Pivot-Tabelle keine {DataSourcePivotTableApi} ist.

Zurücksenden

DataSourceColumn: Die Datenquellenspalte, in der die Pivot-Gruppe ausgeführt wird.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

hideRepeatedLabels()

Wiederholte Labels für diese Gruppierung werden ausgeblendet. Wenn Labels bereits ausgeblendet sind, führt dies zu einer No-Op. Wenn diese Methode aufgerufen wird, bevor mehrere Zeilen- oder Spaltengruppierungen vorhanden sind, und eine weitere Gruppierung hinzugefügt wird, werden wiederholte Labels ausgeblendet.

Zurücksenden

PivotGroup: Die Pivot-Gruppe für Verkettungen.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

isSortAscending()

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

Zurücksenden

Boolean: true, wenn die Sortierreihenfolge aufsteigend ist.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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 Indexe sind 0-basiert. Wenn diese Gruppe beispielsweise an die erste Position verschoben werden soll, sollte diese Methode mit 0 aufgerufen werden.

Parameter

NameTypBeschreibung
indexIntegerDer Index, in den diese Gruppierung verschoben werden soll.

Zurücksenden

PivotGroup: Die Pivot-Gruppe für Verkettungen.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

remove()

Entfernt diese Pivot-Gruppe aus der Tabelle.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

removeManualGroupingRule(groupName)

Entfernt die manuelle Gruppierungsregel mit der angegebenen groupName.

Parameter

NameTypBeschreibung
groupNameStringDer Name der zu entfernenden Gruppierungsregel.

Zurücksenden

PivotGroup: Die Pivot-Gruppe für Verkettungen.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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.

Zurücksenden

PivotGroup: Die Pivot-Gruppe für Verkettungen.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

setDateTimeGroupingRule(dateTimeGroupingRuleType)

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

Mit clearGroupingRule() können Sie die Regel entfernen.

Parameter

NameTypBeschreibung
dateTimeGroupingRuleTypeDateTimeGroupingRuleTypeDer festzulegende Regeltyp.

Zurücksenden

PivotGroup: Die Pivot-Gruppe zum Verketten.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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.

Zurücksenden

PivotGroup: Die Pivot-Gruppe für Verkettungen.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

setGroupLimit(countLimit)

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

Parameter

NameTypBeschreibung
countLimitIntegerDas Limit für die Anzahl der festzulegenden Zeilen oder Spalten. Muss positiv sein.

Zurücksenden

PivotGroup: Die Pivot-Gruppe für Verkettungen.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

setHistogramGroupingRule(minValue, maxValue, intervalSize)

Legt eine Regel für die Histogrammgruppierung für diese Pivot-Gruppe fest. Mit einer Histogrammregel werden Werte in einer Quelldatenspalte in Buckets konstanter Größe organisiert. Alle Werte von minValue bis maxValue werden in Gruppen der Größe interval platziert. Alle Werte unter minValue sowie alle Werte größer als maxValue werden in einem Bucket platziert.

Parameter

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

Zurücksenden

PivotGroup: Die Pivot-Gruppe für Verkettungen.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

showRepeatedLabels()

Wenn es mehr als eine Zeilen- oder Spaltengruppierung gibt, wird bei dieser Methode für jeden Eintrag der nachfolgenden Gruppierung das Label dieser Gruppierung angezeigt. Wenn Labels bereits wiederholt wurden, führt dies zu einer No-Op. Wenn diese Methode aufgerufen wird, bevor mehrere Zeilen- oder Spaltengruppierungen vorhanden sind, werden weitere Labels hinzugefügt, wenn eine weitere Gruppierung hinzugefügt wird.

Zurücksenden

PivotGroup: Die Pivot-Gruppe für Verkettungen.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

showTotals(showTotals)

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

Parameter

NameTypBeschreibung
showTotalsBooleanGibt an, ob Gesamtwerte angezeigt werden sollen oder nicht.

Zurücksenden

PivotGroup: Die Pivot-Gruppe für Verkettungen.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

sortAscending()

Legt die Sortierreihenfolge fest, die aufsteigend sein soll.

Zurücksenden

PivotGroup: Die Pivot-Gruppe für Verkettungen.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

  • 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
valuePivotValueDer Pivot-Wert, nach dem sortiert werden soll.
oppositeGroupValuesObject[]Die Werte einer entgegengesetzten Pivot-Gruppe (eine Spaltengruppe, wenn eine Zeilengruppe sortiert wird, oder eine Zeilengruppe, wenn eine Spaltengruppe sortiert wird), die zum Sortieren verwendet werden. Die Reihenfolge dieser Werte bestimmt den Vorrang beim Unentschieden.

Zurücksenden

PivotGroup: Die Pivot-Gruppe für Verkettungen.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

sortDescending()

Legt die absteigende Sortierreihenfolge fest.

Zurücksenden

PivotGroup: Die Pivot-Gruppe für Verkettungen.

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

totalsAreShown()

Gibt zurück, ob aktuell Gesamtwerte für diese Pivot-Gruppe angezeigt werden.

Zurücksenden

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

Autorisierung

Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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