Class DataSourcePivotTable

DatenQuellePivotTabelle

Auf vorhandene Datenquellen-Pivot-Tabelle zugreifen und diese ändern 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

MethodeRückgabetypKurzbeschreibung
addColumnGroup(columnName)PivotGroupHiermit wird eine neue Pivot-Spaltengruppe basierend auf der angegebenen Datenquellenspalte hinzugefügt.
addFilter(columnName, filterCriteria)PivotFilterHiermit wird ein neuer Filter basierend auf der angegebenen Datenquellenspalte mit den angegebenen Filterkriterien hinzugefügt.
addPivotValue(columnName)PivotValueHiermit wird ein neuer Pivot-Tabellenwert basierend auf der angegebenen Datenquellenspalte ohne Zusammenfassungsfunktion hinzugefügt.
addPivotValue(columnName, summarizeFunction)PivotValueHiermit wird ein neuer Pivot-Wert basierend auf der angegebenen Datenquellenspalte mit der angegebenen Zusammenfassungsfunktion hinzugefügt.
addRowGroup(columnName)PivotGroupHiermit wird eine neue Pivot-Zeilengruppe basierend auf der angegebenen Datenquellenspalte hinzugefügt.
asPivotTable()PivotTableDie Datenquellen-Pivot-Tabelle wird als reguläres Pivot-Tabellenobjekt zurückgegeben.
cancelDataRefresh()DataSourcePivotTableBricht die Datenaktualisierung für dieses Objekt ab, falls sie gerade ausgeführt wird.
forceRefreshData()DataSourcePivotTableDie Daten dieses Objekts werden unabhängig vom aktuellen Status aktualisiert.
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)DataExecutionStatusEs wird gewartet, bis die aktuelle Ausführung abgeschlossen ist. Nach der angegebenen Anzahl von Sekunden kommt es zu einer Zeitüberschreitung.

Detaillierte Dokumentation

addColumnGroup(columnName)

Hiermit wird eine neue Pivot-Spaltengruppe basierend auf der angegebenen Datenquellenspalte hinzugefügt.

Parameter

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

Rückflug

PivotGroup: Die neue 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

addFilter(columnName, filterCriteria)

Hiermit wird ein neuer Filter basierend auf der angegebenen Datenquellenspalte mit den angegebenen Filterkriterien hinzugefügt.

Parameter

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

Rückflug

PivotFilter – der neue Filter.

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

addPivotValue(columnName)

Hiermit wird ein neuer Pivot-Tabellenwert basierend auf der angegebenen Datenquellenspalte ohne Zusammenfassungsfunktion hinzugefügt. Nur für Looker-Messwerte.

Im folgenden Code wird gezeigt, wie Sie ein Looker-Maß als Pivot-Wert hinzufügen. 

// 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, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

addPivotValue(columnName, summarizeFunction)

Hiermit wird ein neuer Pivot-Wert basierend auf der angegebenen Datenquellenspalte mit der angegebenen Zusammenfassungsfunktion hinzugefügt.

Verwenden Sie addPivotValue(columnName), um Pivot-Werte für Looker-Messwerte hinzuzufügen.

Parameter

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

Rückflug

PivotValue: Der neue Pivot-Wert.

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

addRowGroup(columnName)

Hiermit wird eine neue Pivot-Zeilengruppe basierend auf der angegebenen Datenquellenspalte hinzugefügt.

Parameter

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

Rückflug

PivotGroup: Die neue 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

asPivotTable()

Die Datenquellen-Pivot-Tabelle wird als reguläres Pivot-Tabellenobjekt zurückgegeben.

Rückflug

PivotTable: Die Pivot-Tabelle.

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

cancelDataRefresh()

Bricht die Datenaktualisierung für dieses Objekt ab, falls sie gerade ausgeführt wird.

In diesem Beispiel wird gezeigt, wie Sie die Aktualisierung 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 Datenausführung für einen bestimmten Datenquellentyp aktivieren.

Rückflug

DataSourcePivotTable: Das Datenobjekt.

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

forceRefreshData()

Die Daten dieses Objekts werden unabhängig vom aktuellen Status aktualisiert. Weitere Informationen finden Sie unter refreshData(). 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 können Sie die Datenausführung für einen bestimmten Datenquellentyp aktivieren.

Rückflug

DataSourcePivotTable: Das Datenobjekt.

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

getDataSource()

Ruft die Datenquelle ab, mit der das Objekt verknüpft ist.

Rückflug

DataSource: Datenquelle

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

getStatus()

Ruft den Status der Datenausführung des Objekts ab.

Rückflug

DataExecutionStatus: Der Status der Datenausführung.

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

refreshData()

Aktualisiert die Daten des Objekts.

Eine Ausnahme wird geworfen, wenn der aktuelle Status error ist. Verwenden Sie DataSource#updateSpec(), um die Spezifikation zu aktualisieren. Diese 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 Datenausführung für einen bestimmten Datenquellentyp aktivieren.

Rückflug

DataSourcePivotTable: Das Datenobjekt.

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

waitForCompletion(timeoutInSeconds)

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

Parameter

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

Rückflug

DataExecutionStatus: Der Status der Datenausführung.

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