Bu sayfa, Cloud Translation API ile çevrilmiştir.

Class DataSourceFormula

Mevcut veri kaynağı formüllerine erişme ve bu formülleri değiştirme Yeni bir veri kaynağı formülü oluşturmak için Range.setFormula(formula) simgesini kullanın.

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

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`cancelDataRefresh()`	`DataSourceFormula`	Şu anda çalışıyorsa bu nesneyle ilişkili veri yenilemeyi iptal eder.
`forceRefreshData()`	`DataSourceFormula`	Mevcut durumdan bağımsız olarak bu nesnenin verilerini yeniler.
`getAnchorCell()`	`Range`	Bu veri kaynağı formülünün sabitlendiği hücreyi temsil eden `Range` değerini döndürür.
`getDataSource()`	`DataSource`	Nesnenin bağlı olduğu veri kaynağını alır.
`getDisplayValue()`	`String`	Veri kaynağı formülünün görüntüleme değerini döndürür.
`getFormula()`	`String`	Bu veri kaynağı formülünün formülünü döndürür.
`getStatus()`	`DataExecutionStatus`	Nesnenin veri yürütme durumunu alır.
`refreshData()`	`DataSourceFormula`	Nesnenin verilerini yeniler.
`setFormula(formula)`	`DataSourceFormula`	Formülü günceller.
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	Mevcut yürütme işlemi tamamlanana kadar bekler ve belirtilen saniye sayısı dolduktan sonra zaman aşımına uğrar.

Ayrıntılı dokümanlar

`cancelDataRefresh()`

Şu anda çalışıyorsa bu nesneyle ilişkili veri yenilemeyi iptal eder.

Bu örnekte, formül yenilemenin 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ü etkinleştirilmemişse istisna atar. Belirli bir veri kaynağı türü için veri yürütme işlemini etkinleştirmek üzere SpreadsheetApp#enable...Execution() yöntemlerini kullanın.

Return

DataSourceFormula: Veri nesnesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`forceRefreshData()`

Mevcut durumdan bağımsız olarak bu nesnenin verilerini yeniler. Daha fazla bilgi için refreshData() bölümüne bakın. Bu nesnenin şu anda çalışan yenileme işlemini iptal etmek istiyorsanız cancelDataRefresh() bölümüne bakın.

Return

DataSourceFormula: Veri nesnesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getAnchorCell()`

Bu veri kaynağı formülünün sabitlendiği hücreyi temsil eden Range değerini döndürür.

Return

Range: Sabit hücre.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getDisplayValue()`

Veri kaynağı formülünün görüntüleme değerini döndürür.

Return

String: Görüntülenen değer.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getFormula()`

Bu veri kaynağı formülünün formülünü döndürür.

Return

String: Formül.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`refreshData()`

Nesnenin verilerini yeniler.

Şu anda error durumundaysa istisna oluşturur. Spesifikasyonu güncellemek için DataSource#updateSpec() simgesini kullanın. Veri kaynağında beklenmedik düzenlemeleri önlemek için bu yöntem, forceRefreshData() yerine tercih edilir.

Return

DataSourceFormula: Veri nesnesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`setFormula(formula)`

Formülü günceller.

Parametreler

Ad	Tür	Açıklama
`formula`	`String`	Yeni formül.

Return

DataSourceFormula: Zincirleme için veri kaynağı formülü.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`waitForCompletion(timeoutInSeconds)`

Mevcut yürütme işlemi tamamlanana kadar bekler ve belirtilen saniye sayısı dolduktan sonra zaman aşımına uğrar. Zaman aşımı olduğunda yürütme tamamlanmazsa bir istisna oluşturur ancak veri yürütme işlemini iptal etmez.

Parametreler

Ad	Tür	Açıklama
`timeoutInSeconds`	`Integer`	Veri yürütme işlemi için bekleme süresi (saniye cinsinden). Maksimum süre 300 saniyedir.

Return

DataExecutionStatus: Veri yürütme durumu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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