Diese Seite wurde von der Cloud Translation API übersetzt.

Class DataSourcePivotTable

Vorhandene Datenquellen-Pivot-Tabelle aufrufen und bearbeiten Um eine neue Pivot-Tabelle für die Datenquelle zu erstellen, verwenden Sie Range.createDataSourcePivotTable(dataSource)

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 basierend auf der angegebenen Datenquellenspalte hinzu.
`addFilter(columnName, filterCriteria)`	`PivotFilter`	Fügt einen neuen Filter basierend auf der angegebenen Datenquellenspalte mit den angegebenen Filterkriterien hinzu.
`addPivotValue(columnName, summarizeFunction)`	`PivotValue`	Fügt einen neuen Pivot-Wert basierend auf der angegebenen Datenquellenspalte mit der angegebenen Zusammenfassung hinzu .
`addRowGroup(columnName)`	`PivotGroup`	Fügt basierend auf der angegebenen Datenquellenspalte eine neue Pivot-Zeilengruppe hinzu.
`asPivotTable()`	`PivotTable`	Gibt die Pivot-Tabelle der Datenquelle als reguläres Pivot-Tabellenobjekt zurück.
`cancelDataRefresh()`	`DataSourcePivotTable`	Bricht die mit diesem Objekt verknüpfte Datenaktualisierung ab, wenn es gerade ausgeführt wird.
`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, wobei nach der angegebenen Anzahl von Sekunden eine Zeitüberschreitung auftritt.

Detaillierte Dokumentation

`addColumnGroup(columnName)`

Fügt eine neue Pivot-Spaltengruppe basierend auf der angegebenen Datenquellenspalte hinzu.

Parameter

Name	Typ	Beschreibung
`columnName`	`String`	Der Name der Datenquellenspalte, auf der die Pivot-Gruppe basiert.

Rückflug

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 einen neuen Filter basierend auf der angegebenen Datenquellenspalte mit den angegebenen Filterkriterien hinzu.

Parameter

Name	Typ	Beschreibung
`columnName`	`String`	Der Name der Datenquellenspalte, auf der der Filter basiert.
`filterCriteria`	`FilterCriteria`	Die Kriterien, die vom Filter verwendet werden.

Rückflug

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 einen neuen Pivot-Wert basierend auf der angegebenen Datenquellenspalte mit der angegebenen Zusammenfassung hinzu .

Parameter

Name	Typ	Beschreibung
`columnName`	`String`	Der Name der Datenquellenspalte, auf der der Pivot-Wert basiert.
`summarizeFunction`	`PivotTableSummarizeFunction`	Die summarize-Funktion, die der Pivot-Wert verwendet.

Rückflug

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 basierend auf der angegebenen Datenquellenspalte eine neue Pivot-Zeilengruppe hinzu.

Parameter

Name	Typ	Beschreibung
`columnName`	`String`	Der Name der Datenquellenspalte, auf der die Pivot-Gruppe basiert.

Rückflug

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.

Rückflug

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

`cancelDataRefresh()`

Bricht die mit diesem Objekt verknüpfte Datenaktualisierung ab, wenn es gerade ausgeführt wird.

In diesem Beispiel wird gezeigt, wie Sie eine Formelaktualisierung abbrechen.

const spreadsheet = SpreadsheetApp.getActive();
const formula = spreadsheet.getDataSourceFormulas()[0];
// Cancel the ongoing refresh on the formula.
formula.cancelDataRefresh();

Löst eine Ausnahme aus, wenn der Datenquellentyp nicht aktiviert ist. Mit SpreadsheetApp#enable...Execution()-Methoden die Datenausführung für eine bestimmte Datenquelle aktivieren Typ.

Rückflug

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

`forceRefreshData()`

Aktualisiert die Daten dieses Objekts unabhängig vom aktuellen Status. refreshData() ansehen für erhalten Sie weitere Informationen. Informationen zum Abbrechen einer aktuell laufenden Aktualisierung dieses Objekts finden Sie unter cancelDataRefresh().

Löst eine Ausnahme aus, wenn der Datenquellentyp nicht aktiviert ist. Mit SpreadsheetApp#enable...Execution()-Methoden die Datenausführung für eine bestimmte Datenquelle aktivieren Typ.

Rückflug

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.

Rückflug

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.

Rückflug

DataExecutionStatus: Der 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 sie sich derzeit im Status error befindet. Verwenden Sie DataSource#updateSpec(), um die Spezifikation zu aktualisieren. Die Methode ist gegenüber forceRefreshData() bevorzugt, um unerwartete Änderungen an der Datenquelle zu vermeiden.

Löst eine Ausnahme aus, wenn der Datenquellentyp nicht aktiviert ist. Mit SpreadsheetApp#enable...Execution()-Methoden die Datenausführung für eine bestimmte Datenquelle aktivieren Typ.

Rückflug

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, wobei nach der angegebenen Anzahl von Sekunden eine Zeitüberschreitung auftritt. Löst eine Ausnahme aus, wenn die Ausführung bei einer Zeitüberschreitung nicht abgeschlossen ist, aber bricht den Datenausführung.

Parameter

Name	Typ	Beschreibung
`timeoutInSeconds`	`Integer`	Die Zeit in Sekunden, die auf die Datenausführung gewartet werden soll. Maximal sind 300 zulässig Sekunden.

Rückflug

DataExecutionStatus: Der 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