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 bir 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ünen 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()
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
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. 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
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
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. 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
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ına uğradığında yürütme tamamlanmazsa bir istisna atar ancak veri yürütme sürecidir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
timeoutInSeconds | Integer | Verilerin 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