Auf vorhandene Pivot-Tabellen der Datenquelle zugreifen und diese bearbeiten Verwenden Sie Range.createDataSourcePivotTable(dataSource)
, um eine neue Pivot-Tabelle für die Datenquelle zu erstellen.
Verwenden Sie diese Klasse nur mit Daten, die mit einer Datenbank verbunden sind.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
addColumnGroup(columnName) | PivotGroup | Fügt eine neue Pivot-Spaltengruppe auf Grundlage der angegebenen Datenquellenspalte hinzu. |
addFilter(columnName, filterCriteria) | PivotFilter | Fügt auf der Grundlage der angegebenen Datenquellenspalte mit den angegebenen Filterkriterien einen neuen Filter hinzu. |
addPivotValue(columnName, summarizeFunction) | PivotValue | Fügt auf der Grundlage der angegebenen Datenquellenspalte mit der angegebenen Zusammenfassungsfunktion einen neuen Pivot-Wert hinzu. |
addRowGroup(columnName) | PivotGroup | Fügt eine neue Pivot-Zeilengruppe auf Basis der angegebenen Datenquellenspalte hinzu. |
asPivotTable() | PivotTable | Gibt die Pivot-Tabelle der Datenquelle als reguläres Pivot-Tabellenobjekt zurück |
forceRefreshData() | DataSourcePivotTable | Aktualisiert die Daten dieses Objekts unabhängig vom aktuellen Status. |
getDataSource() | DataSource | Ruft die Datenquelle ab, mit der das Objekt verknüpft ist. |
getStatus() | DataExecutionStatus | Ruft den Datenausführungsstatus des Objekts ab. |
refreshData() | DataSourcePivotTable | Aktualisiert die Daten des Objekts. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | Wartet, bis die aktuelle Ausführung abgeschlossen ist, mit einer Zeitüberschreitung nach der angegebenen Anzahl von Sekunden. |
Detaillierte Dokumentation
addColumnGroup(columnName)
Fügt eine neue Pivot-Spaltengruppe auf Grundlage der angegebenen Datenquellenspalte hinzu.
Parameter
Name | Typ | Beschreibung |
---|---|---|
columnName | String | Der Name der Datenquelle, auf dem die Pivot-Gruppe basiert. |
Return
PivotGroup
: Die neue 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
addFilter(columnName, filterCriteria)
Fügt auf der Grundlage der angegebenen Datenquellenspalte mit den angegebenen Filterkriterien einen neuen Filter hinzu.
Parameter
Name | Typ | Beschreibung |
---|---|---|
columnName | String | Der Name der Datenquelle, auf der der Filter basiert. |
filterCriteria | FilterCriteria | Die vom Filter verwendeten Kriterien. |
Return
PivotFilter
: Der neue Filter.
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
addPivotValue(columnName, summarizeFunction)
Fügt auf der Grundlage der angegebenen Datenquellenspalte mit der angegebenen Zusammenfassungsfunktion einen neuen Pivot-Wert hinzu.
Parameter
Name | Typ | Beschreibung |
---|---|---|
columnName | String | Der Name der Datenquelle-Spalte, auf der der Pivot-Wert basiert. |
summarizeFunction | PivotTableSummarizeFunction | Die summarize-Funktion, die der Pivot-Wert verwendet. |
Return
PivotValue
: Der neue Pivot-Wert.
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
addRowGroup(columnName)
Fügt eine neue Pivot-Zeilengruppe auf Basis der angegebenen Datenquellenspalte hinzu.
Parameter
Name | Typ | Beschreibung |
---|---|---|
columnName | String | Der Name der Datenquelle, auf dem die Pivot-Gruppe basiert. |
Return
PivotGroup
: Die neue 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
asPivotTable()
Gibt die Pivot-Tabelle der Datenquelle als reguläres Pivot-Tabellenobjekt zurück
Return
PivotTable
: die Pivot-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
forceRefreshData()
Aktualisiert die Daten dieses Objekts unabhängig vom aktuellen Status. Weitere Informationen finden Sie unter refreshData()
.
Löst eine Ausnahme aus, wenn der Typ der Datenquelle nicht aktiviert ist. Verwenden Sie SpreadsheetApp#enable...Execution()
-Methoden, um die Datenausführung für einen bestimmten Datenquellentyp zu ermöglichen.
Return
DataSourcePivotTable
: Das Datenobjekt.
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
getDataSource()
Ruft die Datenquelle ab, mit der das Objekt verknüpft ist.
Return
DataSource
: Die Datenquelle.
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
getStatus()
Ruft den Datenausführungsstatus des Objekts ab.
Return
DataExecutionStatus
: Status der Datenausführung.
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
refreshData()
Aktualisiert die Daten des Objekts.
Löst eine Ausnahme aus, wenn der Status derzeit error
ist. Verwenden Sie DataSource#updateSpec()
, um die Spezifikation zu aktualisieren. Die Methode wird gegenüber forceRefreshData()
bevorzugt, um unerwartete Änderungen an der Datenquelle zu verhindern.
Löst eine Ausnahme aus, wenn der Typ der Datenquelle nicht aktiviert ist. Verwenden Sie SpreadsheetApp#enable...Execution()
-Methoden, um die Datenausführung für einen bestimmten Datenquellentyp zu ermöglichen.
Return
DataSourcePivotTable
: Das Datenobjekt.
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
waitForCompletion(timeoutInSeconds)
Wartet, bis die aktuelle Ausführung abgeschlossen ist, mit einer Zeitüberschreitung nach der angegebenen Anzahl von Sekunden. Löst eine Ausnahme aus, wenn die Ausführung nach Ablauf des Zeitlimits nicht abgeschlossen ist, bricht jedoch die Datenausführung nicht ab.
Parameter
Name | Typ | Beschreibung |
---|---|---|
timeoutInSeconds | Integer | Die Zeit in Sekunden, die auf die Ausführung der Daten gewartet werden soll. Das Maximum beträgt 300 Sekunden. |
Return
DataExecutionStatus
: Status der Datenausführung.
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