Class PivotGroup

PivotGruppe

Auf Aufschlüsselungsgruppen von Pivot-Tabellen zugreifen und diese bearbeiten.

Methoden

MethodeRückgabetypKurzbeschreibung
addManualGroupingRule(groupName, groupMembers)PivotGroupHiermit wird eine manuelle Gruppierungsregel für diese Pivot-Gruppe hinzugefügt.
areLabelsRepeated()BooleanGibt zurück, ob Labels als wiederholt angezeigt werden.
clearGroupingRule()PivotGroupEntfernt alle Gruppierungsregeln aus dieser Pivot-Gruppe.
clearSort()PivotGroupEntfernt die Sortierung, die auf diese Gruppe angewendet wurde.
getDateTimeGroupingRule()DateTimeGroupingRuleGibt die Datums-/Uhrzeit-Gruppierungsregel für die Pivot-Gruppe zurück oder null, wenn keine Datums-/Uhrzeit-Gruppierungsregel festgelegt ist.
getDimension()DimensionGibt zurück, ob es sich um eine Zeilen- oder Spaltengruppe handelt.
getGroupLimit()PivotGroupLimitGibt das Limit für die Pivot-Gruppe zurück.
getIndex()IntegerGibt den Index dieser Pivot-Gruppe in der aktuellen Gruppenreihenfolge zurück.
getPivotTable()PivotTableGibt die PivotTable zurück, zu der diese Gruppierung gehört.
getSourceDataColumn()IntegerGibt die Nummer der Quelldatenspalte zurück, die in dieser Gruppe zusammengefasst wird.
getSourceDataSourceColumn()DataSourceColumnGibt die Datenquellenspalte zurück, auf die sich die Pivot-Gruppe bezieht.
hideRepeatedLabels()PivotGroupWiederholte Labels für diese Gruppierung werden ausgeblendet.
isSortAscending()BooleanGibt true zurück, wenn die Sortierung aufsteigend ist, und false, wenn sie absteigend ist.
moveToIndex(index)PivotGroupVerschiebt diese Gruppe an die angegebene Position in der aktuellen Liste der Zeilen- oder Spaltengruppen.
remove()voidDiese Pivot-Gruppe wird aus der Tabelle entfernt.
removeManualGroupingRule(groupName)PivotGroupEntfernt die manuelle Gruppierungsregel mit der angegebenen groupName.
resetDisplayName()PivotGroupDer Anzeigename dieser Gruppe in der Pivot-Tabelle wird auf den Standardwert zurückgesetzt.
setDateTimeGroupingRule(dateTimeGroupingRuleType)PivotGroupHiermit wird die Datums-/Uhrzeit-Gruppierungsregel für die Pivot-Gruppe festgelegt.
setDisplayName(name)PivotGroupLegt den Anzeigenamen dieser Gruppe in der Pivot-Tabelle fest.
setGroupLimit(countLimit)PivotGroupHier legen Sie das Limit für die Pivot-Gruppe fest.
setHistogramGroupingRule(minValue, maxValue, intervalSize)PivotGroupHiermit wird eine Histogrammgruppierungsregel für diese Pivot-Gruppe festgelegt.
showRepeatedLabels()PivotGroupWenn es mehr als eine Zeilen- oder Spaltengruppierung gibt, wird bei dieser Methode das Label dieser Gruppierung für jeden Eintrag der nachfolgenden Gruppierung angezeigt.
showTotals(showTotals)PivotGroupHier legen Sie fest, ob in der Tabelle Gesamtwerte für diese Pivot-Gruppe angezeigt werden sollen.
sortAscending()PivotGroupDie Sortierreihenfolge wird aufsteigend festgelegt.
sortBy(value, oppositeGroupValues)PivotGroupDiese Gruppe wird für die Werte aus dem oppositeGroupValues nach dem angegebenen PivotValue sortiert.
sortDescending()PivotGroupDie Sortierreihenfolge wird auf „absteigend“ gesetzt.
totalsAreShown()BooleanGibt an, ob für diese Pivot-Gruppe derzeit Gesamtwerte angezeigt werden.

Detaillierte Dokumentation

addManualGroupingRule(groupName, groupMembers)

Hiermit wird eine manuelle Gruppierungsregel für diese Pivot-Gruppe hinzugefügt.

Parameter

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

Rückflug

PivotGroup: Die Pivot-Gruppe für die Verknüpfung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

areLabelsRepeated()

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

Rückflug

Boolean – true, wenn Labels wiederholt werden, andernfalls false.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

clearGroupingRule()

Entfernt alle Gruppierungsregeln aus dieser Pivot-Gruppe.

Rückflug

PivotGroup: Die Pivot-Gruppe für die Verknüpfung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

clearSort()

Entfernt die Sortierung, die auf diese Gruppe angewendet wurde.

Rückflug

PivotGroup: Die Pivot-Gruppe für die Verknüpfung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getDateTimeGroupingRule()

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

Rückflug

DateTimeGroupingRule: Die Gruppierungsregel vom Typ „Datum/Uhrzeit“.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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.

Rückflug

Dimension: Die Dimension, die den Typ dieser Gruppe darstellt

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getGroupLimit()

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

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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.

Rückflug

Integer: Index der Pivot-Gruppe

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getPivotTable()

Gibt die PivotTable zurück, zu der diese Gruppierung gehört.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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 beginnt bei 1. Wenn diese Gruppe die Quelldaten in Spalte A der Tabelle zusammenfasst, gibt diese Methode 1 zurück.

Rückflug

Integer – die Nummer der Spalte mit den Quelldaten

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getSourceDataSourceColumn()

Gibt die Datenquellenspalte zurück, auf die sich die Pivot-Gruppe bezieht. Gibt null zurück, wenn die Pivot-Tabelle keine {DataSourcePivotTableApi} ist.

Rückflug

DataSourceColumn: Die Datenquellenspalte, auf die sich die Pivot-Gruppe bezieht.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • 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, geschieht nichts. Wird diese Methode aufgerufen, bevor mehrere Zeilen- oder Spaltengruppierungen vorhanden sind, werden wiederholte Labels ausgeblendet, wenn eine zusätzliche Gruppierung hinzugefügt wird.

Rückflug

PivotGroup: Die Pivot-Gruppe für die Verknüpfung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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 sie absteigend ist.

Rückflug

Boolean bis true, wenn die Sortierreihenfolge aufsteigend ist.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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 der Zeilen- oder Spaltengruppen. Diese Indizes beginnen bei 0. 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.

Rückflug

PivotGroup: Die Pivot-Gruppe für die Verknüpfung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

remove()

Diese Pivot-Gruppe wird aus der Tabelle entfernt.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

Rückflug

PivotGroup: Die Pivot-Gruppe für die Verknüpfung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

resetDisplayName()

Der Anzeigename dieser Gruppe in der Pivot-Tabelle wird auf den Standardwert zurückgesetzt.

Rückflug

PivotGroup: Die Pivot-Gruppe für die Verknüpfung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setDateTimeGroupingRule(dateTimeGroupingRuleType)

Hiermit wird die Datums-/Uhrzeit-Gruppierungsregel für die Pivot-Gruppe festgelegt.

Wenn Sie die Regel entfernen möchten, verwenden Sie clearGroupingRule().

Parameter

NameTypBeschreibung
dateTimeGroupingRuleTypeDateTimeGroupingRuleTypeDer zu festzulegende Regeltyp.

Rückflug

PivotGroup: Die Pivot-Gruppe für die Verknüpfung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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.

Rückflug

PivotGroup – die Pivot-Gruppe für die Verknüpfung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setGroupLimit(countLimit)

Hier legen Sie das Limit 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 soll. Muss positiv sein.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setHistogramGroupingRule(minValue, maxValue, intervalSize)

Hiermit wird eine Histogrammgruppierungsregel für diese Pivot-Gruppe festgelegt. Mit einer Histogrammregel werden Werte in einer Quelldatenspalte in Buckets mit konstanter Größe organisiert. Alle Werte von minValue bis maxValue werden in Gruppen mit der Größe interval eingeteilt. Alle Werte unter minValue werden in einen Bucket eingeordnet, ebenso wie alle Werte über maxValue.

Parameter

NameTypBeschreibung
minValueIntegerDer Mindestwert für Elemente, die in Bucket eingeordnet werden sollen. Werte, die unter diesem Wert liegen, werden in einem einzelnen Bucket zusammengefasst.
maxValueIntegerDer maximale Wert für Elemente, die in Bucket eingeordnet werden sollen. Größere Werte werden in einem einzigen Bucket zusammengefasst.
intervalSizeInteger

Rückflug

PivotGroup: Die Pivot-Gruppe für die Verknüpfung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • 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 das Label dieser Gruppierung für jeden Eintrag der nachfolgenden Gruppierung angezeigt. Wenn Labels bereits wiederholt werden, geschieht nichts. Wenn diese Methode aufgerufen wird, bevor es mehrere Zeilen- oder Spaltengruppierungen gibt, werden bei einer zusätzlichen Gruppierung wiederholte Labels angezeigt.

Rückflug

PivotGroup: Die Pivot-Gruppe für die Verknüpfung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

showTotals(showTotals)

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

Parameter

NameTypBeschreibung
showTotalsBooleanOb Gesamtwerte angezeigt werden sollen.

Rückflug

PivotGroup: Die Pivot-Gruppe für die Verknüpfung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

sortAscending()

Die Sortierreihenfolge wird aufsteigend festgelegt.

Rückflug

PivotGroup: Die Pivot-Gruppe für die Verknüpfung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

sortBy(value, oppositeGroupValues)

Diese Gruppe wird für die Werte aus dem oppositeGroupValues nach dem angegebenen PivotValue sortiert. 

// 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']);

Parameter

NameTypBeschreibung
valuePivotValueDer Pivot-Wert, nach dem sortiert werden soll.
oppositeGroupValuesObject[]Die Werte einer gegenüberliegenden Pivot-Gruppe (eine Spaltengruppe, wenn eine Zeilengruppe sortiert wird, oder eine Zeilengruppe, wenn eine Spaltengruppe sortiert wird), die für die Sortierung verwendet werden. Die Reihenfolge dieser Werte bestimmt die Priorität bei Gleichstand.

Rückflug

PivotGroup: Die Pivot-Gruppe für die Verknüpfung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

sortDescending()

Die Sortierreihenfolge wird auf „absteigend“ gesetzt.

Rückflug

PivotGroup: Die Pivot-Gruppe für die Verknüpfung.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

totalsAreShown()

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

Rückflug

Boolean – true, wenn für diese Pivot-Gruppe Gesamtwerte angezeigt werden; andernfalls wird false zurückgegeben.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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