Class DataSourcePivotTable

DataSourcePivotTable

Mevcut veri kaynağı pivot tablosuna erişme ve değişiklik yapma. Yeni bir veri kaynağı pivot tablosu oluşturmak için Range.createDataSourcePivotTable(dataSource)

Bu sınıfı yalnızca bir veritabanına bağlı verilerle kullanın.

Yöntemler

YöntemDönüş türüKısa açıklama
addColumnGroup(columnName)PivotGroupBelirtilen veri kaynağı sütununa göre yeni bir pivot sütun grubu ekler.
addFilter(columnName, filterCriteria)PivotFilterBelirtilen filtre ölçütlerine sahip belirtilen veri kaynağı sütununa göre yeni bir filtre ekler.
addPivotValue(columnName, summarizeFunction)PivotValueBelirtilen özetle, belirtilen veri kaynağı sütununa göre yeni bir pivot değeri ekler işlevini kullanın.
addRowGroup(columnName)PivotGroupBelirtilen veri kaynağı sütununa göre yeni bir pivot satır grubu ekler.
asPivotTable()PivotTableVeri kaynağı pivot tablosunu normal bir pivot tablo nesnesi olarak döndürür.
cancelDataRefresh()DataSourcePivotTableBu nesne şu anda çalışıyorsa, nesneyle ilişkili veri yenileme işlemini iptal eder.
forceRefreshData()DataSourcePivotTableGeçerli durumdan bağımsız olarak bu nesnenin verilerini yeniler.
getDataSource()DataSourceNesnenin bağlı olduğu veri kaynağını alır.
getStatus()DataExecutionStatusNesnenin veri yürütme durumunu alır.
refreshData()DataSourcePivotTableNesnenin verilerini yeniler.
waitForCompletion(timeoutInSeconds)DataExecutionStatusGeçerli yürütme işlemi tamamlanana kadar bekler. Belirtilen sayıda saniye geçtikten sonra zaman aşımına uğrar.

Ayrıntılı belgeler

addColumnGroup(columnName)

Belirtilen veri kaynağı sütununa göre yeni bir pivot sütun grubu ekler.

Parametreler

AdTürAçıklama
columnNameStringPivot grubunun temel aldığı veri kaynağı sütununun adı.

Return

PivotGroup — Yeni pivot grubu.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

addFilter(columnName, filterCriteria)

Belirtilen filtre ölçütlerine sahip belirtilen veri kaynağı sütununa göre yeni bir filtre ekler.

Parametreler

AdTürAçıklama
columnNameStringFiltrenin temel aldığı veri kaynağı sütununun adı.
filterCriteriaFilterCriteriaFiltrenin kullandığı ölçütler.

Return

PivotFilter — Yeni filtre.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

addPivotValue(columnName, summarizeFunction)

Belirtilen özetle, belirtilen veri kaynağı sütununa göre yeni bir pivot değeri ekler işlevini kullanın.

Parametreler

AdTürAçıklama
columnNameStringPivot değerinin temel aldığı veri kaynağı sütununun adı.
summarizeFunctionPivotTableSummarizeFunctionPivot değerinin kullandığı özetleme işlevi.

Return

PivotValue — Yeni pivot değeri.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

addRowGroup(columnName)

Belirtilen veri kaynağı sütununa göre yeni bir pivot satır grubu ekler.

Parametreler

AdTürAçıklama
columnNameStringPivot grubunun temel aldığı veri kaynağı sütununun adı.

Return

PivotGroup — Yeni pivot grubu.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

asPivotTable()

Veri kaynağı pivot tablosunu normal bir pivot tablo nesnesi olarak döndürür.

Return

PivotTable: Pivot tablo.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

cancelDataRefresh()

Bu nesne şu anda çalışıyorsa, nesneyle ilişkili veri yenileme işlemini iptal eder.

Bu örnekte, formül yenilemesinin nasıl iptal edileceği gösterilmektedir.

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

Veri kaynağı türü etkin değilse istisna atar. Belirli bir veri kaynağına yönelik veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanma türü.

Return

DataSourcePivotTable: Veri nesnesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

forceRefreshData()

Geçerli durumdan bağımsız olarak bu nesnenin verilerini yeniler. refreshData() ürününü inceleyin inceleyebilirsiniz. Bu nesnenin şu anda devam eden yenileme işlemini iptal etmek istiyorsanız cancelDataRefresh() bölümüne bakın.

Veri kaynağı türü etkin değilse istisna atar. Belirli bir veri kaynağına yönelik veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanma türü.

Return

DataSourcePivotTable: Veri nesnesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getDataSource()

Nesnenin bağlı olduğu veri kaynağını alır.

Return

DataSource — Veri kaynağı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getStatus()

Nesnenin veri yürütme durumunu alır.

Return

DataExecutionStatus — Veri yürütme durumu.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

refreshData()

Nesnenin verilerini yeniler.

Şu anda error durumundaysa istisna atar. Spesifikasyonu güncellemek için DataSource#updateSpec() öğesini kullanın. Yöntem veri kaynağında beklenmeyen düzenlemeleri önlemek için forceRefreshData() yerine tercih edilir.

Veri kaynağı türü etkin değilse istisna atar. Belirli bir veri kaynağına yönelik veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanma türü.

Return

DataSourcePivotTable: Veri nesnesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

waitForCompletion(timeoutInSeconds)

Geçerli yürütme işlemi tamamlanana kadar bekler. Belirtilen sayıda saniye geçtikten sonra zaman aşımına uğrar. Zaman aşımına uğradığında yürütme tamamlanmazsa bir istisna atar ancak veri yürütme sürecidir.

Parametreler

AdTürAçıklama
timeoutInSecondsIntegerVerilerin yürütülmesi için beklenecek saniye cinsinden süre. Maksimum değer 300'dür. saniye.

Return

DataExecutionStatus — Veri yürütme durumu.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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