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

Class DataSourceFormula

Mevcut veri kaynağı formüllerine erişin ve bunları değiştirin. Yeni bir veri kaynağı formülü oluşturmak için Range.setFormula(formula) politikasını 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
`cancelDataRefresh()`	`DataSourceFormula`	Bu nesne çalışıyorsa bu nesneyle ilişkili veri yenilemesini iptal eder.
`forceRefreshData()`	`DataSourceFormula`	Geçerli 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ülenen 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 tamamlanana kadar bekler ve sağlanan saniye sayısı dolduktan sonra zaman aşımına uğrar.

Ayrıntılı belgeler

`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

DataSourceFormula: 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

DataSourceFormula: 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

`getAnchorCell()`

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

Return

Range — Bağlantı hücresi.

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

`getDisplayValue()`

Veri kaynağı formülünün görüntülenen 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 biri 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 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

DataSourceFormula: 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

`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 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