Class DataSourcePivotTable

DataSourcePivotTable

Auf vorhandene Datenquellen-Pivot-Tabellen zugreifen und diese bearbeiten Wenn Sie eine neue Pivot-Tabelle für eine Datenquelle erstellen möchten, verwenden Sie Range.createDataSourcePivotTable(dataSource).

Verwenden Sie diese Klasse nur mit Daten, die mit einer Datenbank verbunden sind.

Methoden

MethodeRückgabetypKurzbeschreibung
addColumnGroup(columnName)PivotGroupFügt eine neue Pivot-Spaltengruppe basierend auf der angegebenen Datenquellen-Spalte hinzu.
addFilter(columnName, filterCriteria)PivotFilterFügt einen neuen Filter basierend auf der angegebenen Datenquellenspalte mit den angegebenen Filterkriterien hinzu.
addPivotValue(columnName)PivotValueFügt einen neuen Pivot-Tabellenwert basierend auf der angegebenen Datenquellenspalte ohne Zusammenfassungsfunktion hinzu.
addPivotValue(columnName, summarizeFunction)PivotValueFügt einen neuen Pivot-Wert basierend auf der angegebenen Datenquellenspalte mit der angegebenen Funktion „summarize“ hinzu.
addRowGroup(columnName)PivotGroupFügt eine neue Pivot-Zeilengruppe basierend auf der angegebenen Datenquellenspalte hinzu.
asPivotTable()PivotTableGibt die Datenquellen-Pivot-Tabelle als reguläres Pivot-Tabellenobjekt zurück.
cancelDataRefresh()DataSourcePivotTableBricht die Datenaktualisierung ab, die mit diesem Objekt verknüpft ist, falls sie gerade ausgeführt wird.
forceRefreshData()DataSourcePivotTableAktualisiert die Daten dieses Objekts unabhängig vom aktuellen Status.
getDataSource()DataSourceRuft die Datenquelle ab, mit der das Objekt verknüpft ist.
getStatus()DataExecutionStatusRuft den Status der Datenausführung des Objekts ab.
refreshData()DataSourcePivotTableAktualisiert die Daten des Objekts.
waitForCompletion(timeoutInSeconds)DataExecutionStatusWartet, bis die aktuelle Ausführung abgeschlossen ist. Es kommt nach der angegebenen Anzahl von Sekunden zu einer Zeitüberschreitung.

Detaillierte Dokumentation

addColumnGroup(columnName)

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

Parameter

NameTypBeschreibung
columnNameStringDer Name der Datenquellen-Spalte, auf der die Pivot-Gruppe basiert.

Rückflug

PivotGroup: Die neue Pivot-Gruppe.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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

NameTypBeschreibung
columnNameStringDer Name der Datenquellenspalte, auf der der Filter basiert.
filterCriteriaFilterCriteriaDie Kriterien, die der Filter verwendet.

Rückflug

PivotFilter: Der neue Filter.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

addPivotValue(columnName)

Fügt einen neuen Pivot-Tabellenwert basierend auf der angegebenen Datenquellenspalte ohne Zusammenfassungsfunktion hinzu. Nur für Looker-Messwerte.

Im folgenden Code sehen Sie, wie Sie eine Looker-Messung als Pivot-Wert hinzufügen können. 

// TODO(developer): Replace with your spreadsheet ID which has a Looker data
// source.
const spreadsheet = SpreadsheetApp.openById('abcd1234');
const datasource = spreadsheet.getDataSources()[0];
const pivotTable = datasource.createDataSourcePivotTableOnNewSheet();

pivotTable.addPivotValue('columnName');

Diese Methode ist nur für Looker-Datenquellen verfügbar.

Parameter

NameTypBeschreibung
columnNameStringDer Name der Datenquellenspalte, auf der der Pivot-Wert basiert.

Rückflug

PivotValue: Der neue Pivot-Wert.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 Funktion „summarize“ hinzu.

Wenn Sie Pivot-Werte für Looker-Messwerte hinzufügen möchten, verwenden Sie addPivotValue(columnName).

Parameter

NameTypBeschreibung
columnNameStringDer Name der Datenquellenspalte, auf der der Pivot-Wert basiert.
summarizeFunctionPivotTableSummarizeFunctionDie Zusammenfassungsfunktion, die für den Pivot-Wert verwendet wird.

Rückflug

PivotValue: Der neue Pivot-Wert.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

addRowGroup(columnName)

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

Parameter

NameTypBeschreibung
columnNameStringDer Name der Datenquellen-Spalte, auf der die Pivot-Gruppe basiert.

Rückflug

PivotGroup: Die neue Pivot-Gruppe.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

asPivotTable()

Gibt die Datenquellen-Pivot-Tabelle als reguläres Pivot-Tabellenobjekt zurück.

Rückflug

PivotTable – Die Pivot-Tabelle.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

cancelDataRefresh()

Bricht die Datenaktualisierung ab, die mit diesem Objekt verknüpft ist, falls sie gerade ausgeführt wird.

In diesem Beispiel wird gezeigt, wie Sie das Aktualisieren einer Formel 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 können Sie die Datenabfrage für einen bestimmten Datenquelltyp aktivieren.

Rückflug

DataSourcePivotTable: Das Datenobjekt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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(). Wenn Sie eine aktuell laufende Aktualisierung dieses Objekts abbrechen möchten, lesen Sie cancelDataRefresh().

Löst eine Ausnahme aus, wenn der Datenquellentyp nicht aktiviert ist. Mit SpreadsheetApp#enable...Execution()-Methoden können Sie die Datenabfrage für einen bestimmten Datenquelltyp aktivieren.

Rückflug

DataSourcePivotTable: Das Datenobjekt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

getStatus()

Ruft den Status der Datenausführung des Objekts ab.

Rückflug

DataExecutionStatus: Der Status der Datenausführung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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 sich die Instanz derzeit im Status error befindet. 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 Datenquellentyp nicht aktiviert ist. Mit SpreadsheetApp#enable...Execution()-Methoden können Sie die Datenabfrage für einen bestimmten Datenquelltyp aktivieren.

Rückflug

DataSourcePivotTable: Das Datenobjekt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

waitForCompletion(timeoutInSeconds)

Wartet, bis die aktuelle Ausführung abgeschlossen ist. Es kommt nach der angegebenen Anzahl von Sekunden zu einer Zeitüberschreitung. Löst eine Ausnahme aus, wenn die Ausführung bei Zeitüberschreitung nicht abgeschlossen ist, bricht die Datenausführung jedoch nicht ab.

Parameter

NameTypBeschreibung
timeoutInSecondsIntegerDie Zeit in Sekunden, die auf die Ausführung von Daten gewartet werden soll. Das Maximum beträgt 300 Sekunden.

Rückflug

DataExecutionStatus: Der Status der Datenausführung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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