Mevcut veri kaynağı pivot tablosuna erişin ve bu tabloda değişiklik yapın. Yeni bir veri kaynağı pivot tablosu oluşturmak için Range.createDataSourcePivotTable(dataSource)
değerini kullanın.
Bu sınıfı yalnızca bir veritabanına bağlı verilerle kullanın.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
addColumnGroup(columnName) | PivotGroup | Belirtilen veri kaynağı sütununa göre yeni bir pivot sütun grubu ekler. |
addFilter(columnName, filterCriteria) | PivotFilter | Belirtilen filtre ölçütleriyle belirtilen veri kaynağı sütununu temel alarak yeni bir filtre ekler. |
addPivotValue(columnName, summarizeFunction) | PivotValue | Belirtilen özetleme işleviyle, belirtilen veri kaynağı sütununu temel alarak yeni bir pivot değer ekler. |
addRowGroup(columnName) | PivotGroup | Belirtilen veri kaynağı sütununa göre yeni bir pivot satır grubu ekler. |
asPivotTable() | PivotTable | Veri kaynağı pivot tablosunu normal bir pivot tablo nesnesi olarak döndürür. |
cancelDataRefresh() | DataSourcePivotTable | Bu nesne çalışıyorsa bu nesneyle ilişkili veri yenilemesini iptal eder. |
forceRefreshData() | DataSourcePivotTable | Geçerli durumdan bağımsız olarak bu nesnenin verilerini yeniler. |
getDataSource() | DataSource | Nesnenin bağlı olduğu veri kaynağını alır. |
getStatus() | DataExecutionStatus | Nesnenin veri yürütme durumunu alır. |
refreshData() | DataSourcePivotTable | Nesnenin verilerini yeniler. |
waitForCompletion(timeoutInSeconds) | DataExecutionStatus | Geçerli yürütme tamamlanana kadar bekler ve sağlanan saniye sayısı dolduktan 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
Ad | Tür | Açıklama |
---|---|---|
columnName | String | Pivot grubunun temel aldığı veri kaynağı sütunu adı. |
Return
PivotGroup
: Yeni pivot grubu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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çütleriyle belirtilen veri kaynağı sütununu temel alarak yeni bir filtre ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnName | String | Filtrenin temel aldığı veri kaynağı sütunu adı. |
filterCriteria | FilterCriteria | Filtrenin kullandığı ölçütler. |
Return
PivotFilter
: Yeni filtre.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addPivotValue(columnName, summarizeFunction)
Belirtilen özetleme işleviyle, belirtilen veri kaynağı sütununu temel alarak yeni bir pivot değer ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnName | String | Pivot değerinin temel aldığı veri kaynağı sütunu adı. |
summarizeFunction | PivotTableSummarizeFunction | Pivot tablo değerinin kullandığı özetleme işlevi. |
Return
PivotValue
: Yeni pivot değeri.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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
Ad | Tür | Açıklama |
---|---|---|
columnName | String | Pivot grubunun temel aldığı veri kaynağı sütunu adı. |
Return
PivotGroup
: Yeni pivot grubu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 tablodur.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
cancelDataRefresh()
Bu nesne çalışıyorsa bu nesneyle ilişkili veri yenilemesini 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 bir istisna oluşturur. Belirli veri kaynağı türlerinde veri yürütmeyi etkinleştirmek için
SpreadsheetApp#enable...Execution()
yöntemlerini kullanın.
Return
DataSourcePivotTable
: Veri nesnesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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. Daha fazla bilgi için refreshData()
sayfasına bakın. Bu nesnenin şu anda devam eden yenilemesini iptal etmek istiyorsanız cancelDataRefresh()
adresine bakın.
Veri kaynağı türü etkin değilse bir istisna oluşturur. Belirli veri kaynağı türlerinde veri yürütmeyi etkinleştirmek için SpreadsheetApp#enable...Execution()
yöntemlerini kullanın.
Return
DataSourcePivotTable
: Veri nesnesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 biri 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 durumudur.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 oluşturur. Teknik özellikleri güncellemek için DataSource#updateSpec()
öğesini kullanın. Veri kaynağında beklenmeyen düzenlemeleri önlemek için yöntem forceRefreshData()
yerine tercih edilir.
Veri kaynağı türü etkin değilse bir istisna oluşturur. Belirli veri kaynağı türlerinde veri yürütmeyi etkinleştirmek için SpreadsheetApp#enable...Execution()
yöntemlerini kullanın.
Return
DataSourcePivotTable
: Veri nesnesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri 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 tamamlanana kadar bekler ve sağlanan saniye sayısı dolduktan sonra zaman aşımına uğrar. Zaman aşımına uğradığında yürütme tamamlanmazsa ancak veri yürütme işlemini iptal etmezse bir istisna oluşturur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
timeoutInSeconds | Integer | Saniye cinsinden veri yürütülmesi için beklenecek süre. Maksimum süre 300 saniyedir. |
Return
DataExecutionStatus
: Veri yürütme durumudur.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets