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

Class DataSourceFormula

Mevcut veri kaynağı formüllerine erişme ve bunları değiştirme Yeni bir veri kaynağı formülü oluşturmak için Range.setFormula(formula) işlevini 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`	Bu nesne şu anda çalışıyorsa, nesneyle ilişkili veri yenileme işlemini iptal eder.
`forceRefreshData()`	`DataSourceFormula`	Geçerli durumdan bağımsız olarak bu nesnenin verilerini yeniler.
`getAnchorCell()`	`Range`	Bu veri kaynağı formülünün bağlı olduğu 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üne ilişkin formülü 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`	Geç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

`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ğına yönelik veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution() yöntemlerini kullanma türü.

Return

DataSourceFormula: 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. Şunun için refreshData() sayfasına bakın: 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

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 bağlı olduğu hücreyi temsil eden Range değerini döndürür.

Return

Range — Sabit hücre.

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

`getDisplayValue()`

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

Return

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

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

`getFormula()`

Bu veri kaynağı formülüne ilişkin formülü döndürür.

Return

String: Formül.

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. 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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ı, 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ı 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`	Verilerin yürütülmesi için beklenecek saniye cinsinden süre. Maksimum süre 300 saniyedir.

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