Veri doğrulama kuralları oluşturucu.
// Set the data validation for cell A1 to require a value from B1:B10. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build(); cell.setDataValidation(rule);
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
build() | DataValidation | Oluşturucuya uygulanan ayarlardan bir veri doğrulama kuralı oluşturur. |
copy() | DataValidationBuilder | Bu kuralın ayarlarına göre bir veri doğrulama kuralı için oluşturucu oluşturur. |
getAllowInvalid() | Boolean | Kural, giriş veri doğrulamasında başarısız olduğunda uyarı gösteriyorsa true değerini veya girişi tamamen reddetmesi durumunda false değerini döndürür. |
getCriteriaType() | DataValidationCriteria | Kuralın DataValidationCriteria sıralamasında tanımlanan ölçüt türünü alır. |
getCriteriaValues() | Object[] | Kuralın ölçütleri için bir bağımsız değişken dizisi alır. |
getHelpText() | String | Kuralın yardım metnini veya yardım metni ayarlanmadıysa null değerini alır. |
requireCheckbox() | DataValidationBuilder | Veri doğrulama kuralını, girişin bir boole değeri olmasını gerektirecek şekilde ayarlar; bu değer oluşturulur. |
requireCheckbox(checkedValue) | DataValidationBuilder | Veri doğrulama kuralını, girişin belirtilen değer olarak veya boş olmasını gerektirecek şekilde ayarlar. |
requireCheckbox(checkedValue, uncheckedValue) | DataValidationBuilder | Veri doğrulama kuralını, girişin belirtilen değerlerden biri olmasını zorunlu kılacak şekilde ayarlar. |
requireDate() | DataValidationBuilder | Veri doğrulama kuralını tarih gerektirecek şekilde ayarlar. |
requireDateAfter(date) | DataValidationBuilder | Veri doğrulama kuralını, belirtilen değerden sonra bir tarih girilmesini zorunlu kılacak şekilde ayarlar. |
requireDateBefore(date) | DataValidationBuilder | Veri doğrulama kuralını, belirtilen değerden önceki bir tarihi gerektirecek şekilde ayarlar. |
requireDateBetween(start, end) | DataValidationBuilder | Veri doğrulama kuralını, iki tarih arasına denk gelen veya ikiden biri arasında olan bir tarih gerektirecek şekilde ayarlar belirtilen tarihlerde |
requireDateEqualTo(date) | DataValidationBuilder | Veri doğrulama kuralını, verilen değere eşit bir tarih gerektirecek şekilde ayarlar. |
requireDateNotBetween(start, end) | DataValidationBuilder | Veri doğrulama kuralını, dahil edilir. |
requireDateOnOrAfter(date) | DataValidationBuilder | Veri doğrulama kuralını, belirtilen değerde veya bu değerden sonraki bir tarihi gerektirecek şekilde ayarlar. |
requireDateOnOrBefore(date) | DataValidationBuilder | Veri doğrulama kuralını, belirtilen değerde veya öncesinde bir tarih girilmesini zorunlu kılacak şekilde ayarlar. |
requireFormulaSatisfied(formula) | DataValidationBuilder | Veri doğrulama kuralını, belirtilen formülün true olarak değerlendirilmesini zorunlu kılacak şekilde ayarlar. |
requireNumberBetween(start, end) | DataValidationBuilder | Veri doğrulama kuralını, iki sayı arasına denk gelen veya ikiden biri arasında bir sayı gerektirecek şekilde ayarlar belirtir. |
requireNumberEqualTo(number) | DataValidationBuilder | Veri doğrulama kuralını, verilen değere eşit bir sayı gerektirecek şekilde ayarlar. |
requireNumberGreaterThan(number) | DataValidationBuilder | Veri doğrulama kuralını, verilen değerden büyük bir sayı gerektirecek şekilde ayarlar. |
requireNumberGreaterThanOrEqualTo(number) | DataValidationBuilder | Veri doğrulama kuralını, verilen değerden büyük veya bu değere eşit bir sayı gerektirecek şekilde ayarlar. |
requireNumberLessThan(number) | DataValidationBuilder | Veri doğrulama kuralını, verilen değerden küçük bir sayı gerektirecek şekilde ayarlar. |
requireNumberLessThanOrEqualTo(number) | DataValidationBuilder | Veri doğrulama kuralını, verilen değerden küçük veya bu değere eşit bir sayı gerektirecek şekilde ayarlar. |
requireNumberNotBetween(start, end) | DataValidationBuilder | Veri doğrulama kuralını sayısını gösterir. |
requireNumberNotEqualTo(number) | DataValidationBuilder | Veri doğrulama kuralını, verilen değere eşit olmayan bir sayı gerektirecek şekilde ayarlar. |
requireTextContains(text) | DataValidationBuilder | Veri doğrulama kuralını, girişin verilen değeri içermesini zorunlu kılacak şekilde ayarlar. |
requireTextDoesNotContain(text) | DataValidationBuilder | Veri doğrulama kuralını, girişin verilen değeri içermemesini zorunlu kılacak şekilde ayarlar. |
requireTextEqualTo(text) | DataValidationBuilder | Veri doğrulama kuralını, girişin verilen değere eşit olmasını zorunlu kılacak şekilde ayarlar. |
requireTextIsEmail() | DataValidationBuilder | Veri doğrulama kuralını, girişin bir e-posta adresi biçiminde olmasını zorunlu kılacak şekilde ayarlar. |
requireTextIsUrl() | DataValidationBuilder | Veri doğrulama kuralını, girişin URL biçiminde olmasını zorunlu kılacak şekilde ayarlar. |
requireValueInList(values) | DataValidationBuilder | Veri doğrulama kuralını, girişin belirtilen değerlerden birine eşit olmasını gerektirecek şekilde ayarlar. |
requireValueInList(values, showDropdown) | DataValidationBuilder | Veri doğrulama kuralını, girişin belirtilen değerlerden birine eşit olmasını gerektirecek şekilde ayarlar. seçeneği ile açılır menüyü gizleme seçeneği sunar. |
requireValueInRange(range) | DataValidationBuilder | Veri doğrulama kuralını, girişin belirtilen aralıktaki bir değere eşit olmasını gerektirecek şekilde ayarlar. |
requireValueInRange(range, showDropdown) | DataValidationBuilder | Veri doğrulama kuralını, girişin belirtilen aralıktaki bir değere eşit olmasını gerektirecek şekilde ayarlar. seçeneği ile açılır menüyü gizleme seçeneği sunar. |
setAllowInvalid(allowInvalidData) | DataValidationBuilder | Giriş, veri doğrulamasında başarısız olduğunda uyarı gösterilmesini veya girişin reddedilip reddedilmeyeceğini belirler kullanabiliyoruz. |
setHelpText(helpText) | DataValidationBuilder | Kullanıcı veri doğrulamasının yapılacağı hücrenin üzerine geldiğinde görünen yardım metnini belirler ayarlandı. |
withCriteria(criteria, args) | DataValidationBuilder | Veri doğrulama kuralını DataValidationCriteria değerleriyle tanımlanan ölçütlere ayarlar,
genellikle mevcut bir kuralın criteria ve arguments öğelerinden alınır. |
Ayrıntılı belgeler
build()
Oluşturucuya uygulanan ayarlardan bir veri doğrulama kuralı oluşturur.
Return
DataValidation
— veri doğrulama kuralının temsili
copy()
Bu kuralın ayarlarına göre bir veri doğrulama kuralı için oluşturucu oluşturur.
// Change existing data validation rules that require a date in 2013 to require a date in 2014. var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')]; var newDates = [new Date('1/1/2014'), new Date('12/31/2014')]; var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns()); var rules = range.getDataValidations(); for (var i = 0; i < rules.length; i++) { for (var j = 0; j < rules[i].length; j++) { var rule = rules[i][j]; if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN && args[0].getTime() == oldDates[0].getTime() && args[1].getTime() == oldDates[1].getTime()) { // Create a builder from the existing rule, then change the dates. rules[i][j] = rule.copy().withCriteria(criteria, newDates).build(); } } } } range.setDataValidations(rules);
Return
DataValidationBuilder
- bu kuralın ayarlarını temel alan bir oluşturucu
getAllowInvalid()
Kural, giriş veri doğrulamasında başarısız olduğunda uyarı gösteriyorsa true
değerini veya girişi tamamen reddetmesi durumunda false
değerini döndürür. Yeni veri doğrulama kuralları için varsayılan değer true
şeklindedir.
Return
Boolean
— Kural, veri doğrulamasında başarısız olan girişe izin veriyorsa true
; Değilse false
getCriteriaType()
Kuralın DataValidationCriteria
sıralamasında tanımlanan ölçüt türünü alır. To almak için
bağımsız değişkenlerin olması için getCriteriaValues()
kullanın. Bu değerleri kullanarak veya
değiştirme hakkında daha fazla bilgi için withCriteria(criteria, args)
sayfasına bakın.
// Log information about the data validation rule for cell A1. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = cell.getDataValidation(); if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); Logger.log('The data validation rule is %s %s', criteria, args); } else { Logger.log('The cell does not have a data validation rule.') }
Return
DataValidationCriteria
— veri doğrulama kriterlerinin türü
getCriteriaValues()
Kuralın ölçütleri için bir bağımsız değişken dizisi alır. Ölçüt türünü almak için getCriteriaType()
işlevini kullanın. Veri doğrulama kuralı oluşturmak veya değiştirmek amacıyla bu değerleri kullanmak için withCriteria(criteria, args)
sayfasına bakın.
// Log information about the data validation rule for cell A1. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = cell.getDataValidation(); if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); Logger.log('The data validation rule is %s %s', criteria, args); } else { Logger.log('The cell does not have a data validation rule.') }
Return
Object[]
— Kuralın ölçüt türüne uygun bir bağımsız değişken dizisi; bağımsız değişken sayısı
ve türü, DataValidationBuilder
sınıfının ilgili require...()
yöntemiyle eşleşiyor
getHelpText()
Kuralın yardım metnini veya yardım metni ayarlanmadıysa null
değerini alır.
Return
String
— kuralın yardım metni. Yardım metni ayarlanmamışsa null
requireCheckbox()
Veri doğrulama kuralını, girişin bir boole değeri olmasını gerektirecek şekilde ayarlar; bu değer oluşturulur.
// Set the data validation for cell A1 to require a boolean value; the value is rendered as a // checkbox. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireCheckbox().build(); cell.setDataValidation(rule);
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireCheckbox(checkedValue)
Veri doğrulama kuralını, girişin belirtilen değer olarak veya boş olmasını gerektirecek şekilde ayarlar. Zaman giriş, belirtilen değerle eşleşir ve hücrenin işaretli onay kutusu olarak oluşturulur. giriş boşsa hücre, işaretlenmemiş bir onay kutusu olarak oluşturulur.
// Set the data validation for cell A1 to require a custom checked value that is rendered as a // checkbox. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
checkedValue | Object | İşaretli kutuya atanan değer. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireCheckbox(checkedValue, uncheckedValue)
Veri doğrulama kuralını, girişin belirtilen değerlerden biri olmasını zorunlu kılacak şekilde ayarlar. Zaman
giriş checkedValue
ise hücre, işaretli onay kutusu olarak oluşturulur.
giriş uncheckedValue
ise hücre, işaretlenmemiş bir onay kutusu olarak oluşturulur.
// Set the data validation for cell A1 to require custom checked values that are rendered as a // checkbox. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED', 'PENDING').build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
checkedValue | Object | İşaretli kutuya atanan değer. |
uncheckedValue | Object | İşaretlenmemiş bir kutuya atanan değer. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireDate()
Veri doğrulama kuralını tarih gerektirecek şekilde ayarlar.
// Set the data validation for cell A1 to require a date. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireDate().build(); cell.setDataValidation(rule);
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireDateAfter(date)
Veri doğrulama kuralını, belirtilen değerden sonra bir tarih girilmesini zorunlu kılacak şekilde ayarlar. Çalışmanın zaman alanları
Date
nesne yoksayılır; yalnızca gün, ay ve yıl alanları kullanılır.
// Set the data validation for cell A1 to require a date after January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireDateAfter(new Date('1/1/2013')).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | Date | Kabul edilemez son tarih. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireDateBefore(date)
Veri doğrulama kuralını, belirtilen değerden önceki bir tarihi gerektirecek şekilde ayarlar. Çalışmanın zaman alanları
Date
nesne yoksayılır; yalnızca gün, ay ve yıl alanları kullanılır.
// Set the data validation for cell A1 to require a date before January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireDateBefore(new Date('1/1/2013')).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | Date | Kabul edilemez en erken tarih. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireDateBetween(start, end)
Veri doğrulama kuralını, iki tarih arasına denk gelen veya ikiden biri arasında olan bir tarih gerektirecek şekilde ayarlar
belirtilen tarihlerde Date
nesnelerinin zaman alanları yoksayılır; yalnızca gün, ay,
ve yıl alanları kullanılır.
// Set the data validation for cell A1 to require a date in 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013')).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
start | Date | Kabul edilebilir en erken tarih. |
end | Date | Kabul edilebilir en son tarih. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireDateEqualTo(date)
Veri doğrulama kuralını, verilen değere eşit bir tarih gerektirecek şekilde ayarlar. Zaman alanları
Date
nesnesi yoksayılır; yalnızca gün, ay ve yıl alanları kullanılır.
// Set the data validation for cell A1 to require a date equal to January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireDateEqualTo(new Date('1/1/2013')) .build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | Date | Kabul edilebilir tek tarih. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireDateNotBetween(start, end)
Veri doğrulama kuralını,
dahil edilir. Date
nesnelerinin zaman alanları yoksayılır; yalnızca gün,
ay ve yıl alanları kullanılır.
// Set the data validation for cell A1 to require a date not in 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013')).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
start | Date | Kabul edilemez en erken tarih. |
end | Date | Kabul edilemez son tarih. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireDateOnOrAfter(date)
Veri doğrulama kuralını, belirtilen değerde veya bu değerden sonraki bir tarihi gerektirecek şekilde ayarlar. Zaman alanları
Date
nesnesi yoksayılır; yalnızca gün, ay ve yıl alanları kullanılır.
// Set the data validation for cell A1 to require a date on or after January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireDateOnOrAfter(new Date('1/1/2013')).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | Date | Kabul edilebilir en erken tarih. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireDateOnOrBefore(date)
Veri doğrulama kuralını, belirtilen değerde veya öncesinde bir tarih girilmesini zorunlu kılacak şekilde ayarlar. Zaman alanları
of Date
nesnesi yok sayılıyor; yalnızca gün, ay ve yıl alanları kullanılır.
// Set the data validation for cell A1 to require a date on or before January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireDateOnOrBefore(new Date('1/1/2013')).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | Date | Kabul edilebilir en son tarih. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireFormulaSatisfied(formula)
Veri doğrulama kuralını, belirtilen formülün true
olarak değerlendirilmesini zorunlu kılacak şekilde ayarlar.
// Set the data validation for cell A1 to equal B1 with a custom formula. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireFormulaSatisfied('=EQ(A1,B1)').build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
formula | String | Giriş geçerliyse true sonucunu veren özel formül. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireNumberBetween(start, end)
Veri doğrulama kuralını, iki sayı arasına denk gelen veya ikiden biri arasında bir sayı gerektirecek şekilde ayarlar belirtir.
// Set the data validation for cell A1 to require a number between 1 and 10. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberBetween(1, 10).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
start | Number | Kabul edilebilir en düşük değer. |
end | Number | Kabul edilebilir en yüksek değer. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireNumberEqualTo(number)
Veri doğrulama kuralını, verilen değere eşit bir sayı gerektirecek şekilde ayarlar.
// Set the data validation for cell A1 to require a number equal to 3.1415926536. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberEqualTo(3.1415926536).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Number | Kabul edilebilir tek değer. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireNumberGreaterThan(number)
Veri doğrulama kuralını, verilen değerden büyük bir sayı gerektirecek şekilde ayarlar.
// Set the data validation for cell A1 to require a number greater than 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Number | Kabul edilemez en yüksek değer. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireNumberGreaterThanOrEqualTo(number)
Veri doğrulama kuralını, verilen değerden büyük veya bu değere eşit bir sayı gerektirecek şekilde ayarlar.
// Set the data validation for cell A1 to require a number greater than or equal to 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThanOrEqualTo(0).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Number | Kabul edilebilir en düşük değer. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireNumberLessThan(number)
Veri doğrulama kuralını, verilen değerden küçük bir sayı gerektirecek şekilde ayarlar.
// Set the data validation for cell A1 to require a number less than 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Number | Kabul edilemez en düşük değer. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireNumberLessThanOrEqualTo(number)
Veri doğrulama kuralını, verilen değerden küçük veya bu değere eşit bir sayı gerektirecek şekilde ayarlar.
// Set the data validation for cell A1 to require a number less than or equal to 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberLessThanOrEqualTo(0).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Number | Kabul edilebilir en yüksek değer. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireNumberNotBetween(start, end)
Veri doğrulama kuralını sayısını gösterir.
// Set the data validation for cell A1 to require a number not between 1 and 10. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberNotBetween(1, 10).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
start | Number | Kabul edilemez en düşük değer. |
end | Number | Kabul edilemez en yüksek değer. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireNumberNotEqualTo(number)
Veri doğrulama kuralını, verilen değere eşit olmayan bir sayı gerektirecek şekilde ayarlar.
// Set the data validation for cell A1 to require a number not equal to 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Number | Kabul edilemez tek değer. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireTextContains(text)
Veri doğrulama kuralını, girişin verilen değeri içermesini zorunlu kılacak şekilde ayarlar.
// Set the data validation for cell A1 to require any value that includes "Google". var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextContains('Google').build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | Girişin içermesi gereken değer. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireTextDoesNotContain(text)
Veri doğrulama kuralını, girişin verilen değeri içermemesini zorunlu kılacak şekilde ayarlar.
// Set the data validation for cell A1 to require any value that does not include "@". var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | Girişin içermemesi gereken değer. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireTextEqualTo(text)
Veri doğrulama kuralını, girişin verilen değere eşit olmasını zorunlu kılacak şekilde ayarlar.
// Set the data validation for cell A1 to require "Yes". var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
text | String | Kabul edilebilir tek değer. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireTextIsEmail()
Veri doğrulama kuralını, girişin bir e-posta adresi biçiminde olmasını zorunlu kılacak şekilde ayarlar.
// Set the data validation for cell A1 to require text in the form of an email address. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build(); cell.setDataValidation(rule);
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireTextIsUrl()
Veri doğrulama kuralını, girişin URL biçiminde olmasını zorunlu kılacak şekilde ayarlar.
// Set the data validation for cell A1 to require text in the form of a URL. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextIsUrl().build(); cell.setDataValidation(rule);
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireValueInList(values)
Veri doğrulama kuralını, girişin belirtilen değerlerden birine eşit olmasını gerektirecek şekilde ayarlar.
// Set the data validation for cell A1 to require "Yes" or "No", with a dropdown menu. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No']).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
values | String[] | Kabul edilebilir değerler dizisi. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireValueInList(values, showDropdown)
Veri doğrulama kuralını, girişin belirtilen değerlerden birine eşit olmasını gerektirecek şekilde ayarlar. seçeneği ile açılır menüyü gizleme seçeneği sunar.
// Set the data validation for cell A1 to require "Yes" or "No", with no dropdown menu. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No'], false).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
values | String[] | Kabul edilebilir değerler dizisi. |
showDropdown | Boolean | E-tabloda değerler için bir açılır menü gösterilmesi gerekiyorsa true ;
Değilse false . |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireValueInRange(range)
Veri doğrulama kuralını, girişin belirtilen aralıktaki bir değere eşit olmasını gerektirecek şekilde ayarlar.
// Set the data validation for cell A1 to require a value from B1:B10, with a dropdown menu. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
range | Range | Kabul edilebilir değerleri içeren bir aralık. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
requireValueInRange(range, showDropdown)
Veri doğrulama kuralını, girişin belirtilen aralıktaki bir değere eşit olmasını gerektirecek şekilde ayarlar. seçeneği ile açılır menüyü gizleme seçeneği sunar.
// Set the data validation for cell A1 to require value from B1:B10, with no dropdown menu. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range, false).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
range | Range | Kabul edilebilir değerleri içeren bir aralık. |
showDropdown | Boolean | E-tabloda değerler için bir açılır menü gösterilmesi gerekiyorsa true ;
Değilse false . |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
setAllowInvalid(allowInvalidData)
Giriş, veri doğrulamasında başarısız olduğunda uyarı gösterilmesini veya girişin reddedilip reddedilmeyeceğini belirler
kullanabiliyoruz. Yeni veri doğrulama kuralları için varsayılan değer true
şeklindedir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
allowInvalidData | Boolean | Kuralın veri doğrulamasında başarısız olan girişlere izin vermesi gerekiyorsa true ;
Değilse false . |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
setHelpText(helpText)
Kullanıcı veri doğrulamasının yapılacağı hücrenin üzerine geldiğinde görünen yardım metnini belirler ayarlandı.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
helpText | String | Ayarlanacak yardım metni. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu
withCriteria(criteria, args)
Veri doğrulama kuralını DataValidationCriteria
değerleriyle tanımlanan ölçütlere ayarlar,
genellikle mevcut bir kuralın criteria
ve arguments
öğelerinden alınır.
// Change existing data validation rules that require a date in 2013 to require a date in 2014. var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')]; var newDates = [new Date('1/1/2014'), new Date('12/31/2014')]; var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns()); var rules = range.getDataValidations(); for (var i = 0; i < rules.length; i++) { for (var j = 0; j < rules[i].length; j++) { var rule = rules[i][j]; if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN && args[0].getTime() == oldDates[0].getTime() && args[1].getTime() == oldDates[1].getTime()) { // Create a builder from the existing rule, then change the dates. rules[i][j] = rule.copy().withCriteria(criteria, newDates).build(); } } } } range.setDataValidations(rules);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
criteria | DataValidationCriteria | Veri doğrulama ölçütünün türü. |
args | Object[] | Ölçüt türüne uygun bir bağımsız değişken dizisi; bağımsız değişken sayısını
bunların türü yukarıdaki karşılık gelen require...() yöntemiyle eşleşir. |
Return
DataValidationBuilder
— zincirleme için bu oluşturucu