Veri doğrulama kuralları için 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 dayanarak veri doğrulama kuralı için bir oluşturucu oluşturur. |
getAllowInvalid() | Boolean | Kural, giriş veri doğrulamasında başarısız olduğunda true , girişi tamamen reddederse false döndürür. |
getCriteriaType() | DataValidationCriteria | DataValidationCriteria sıralamasında tanımlandığı şekliyle kuralın ölçüt türünü alır. |
getCriteriaValues() | Object[] | Kuralın ölçütleri için bir dizi bağımsız değişken alır. |
getHelpText() | String | Kuralın yardım metnini veya herhangi bir yardım metni ayarlanmamışsa null mesajını alır. |
requireCheckbox() | DataValidationBuilder | Veri doğrulama kuralını, girişin bir boole değeri olmasını gerektirecek şekilde ayarlar. Bu değer, onay kutusu olarak oluşturulur. |
requireCheckbox(checkedValue) | DataValidationBuilder | Veri doğrulama kuralını, girişin belirtilen değerde veya boş olmasını gerektirecek şekilde ayarlar. |
requireCheckbox(checkedValue, uncheckedValue) | DataValidationBuilder | Veri doğrulama kuralını, girişin belirtilen değerlerden biri olmasını gerektirecek şekilde ayarlar. |
requireDate() | DataValidationBuilder | Veri doğrulama kuralını tarih gerektirecek şekilde ayarlar. |
requireDateAfter(date) | DataValidationBuilder | Veri doğrulama kuralını, verilen değerden sonra bir tarih gerektirecek şekilde ayarlar. |
requireDateBefore(date) | DataValidationBuilder | Veri doğrulama kuralını, verilen değerden önce bir tarihi zorunlu kılacak şekilde ayarlar. |
requireDateBetween(start, end) | DataValidationBuilder | Veri doğrulama kuralını, belirtilen iki tarih arasına veya bu tarihlerden birine denk gelen bir tarihi zorunlu kılacak şekilde ayarlar. |
requireDateEqualTo(date) | DataValidationBuilder | Veri doğrulama kuralını, verilen değere eşit bir tarihi zorunlu kılacak şekilde ayarlar. |
requireDateNotBetween(start, end) | DataValidationBuilder | Veri doğrulama kuralını, belirtilen iki tarih arasında olmayan ve bu iki tarih arasında da yer almayan bir tarihi zorunlu kılacak şekilde ayarlar. |
requireDateOnOrAfter(date) | DataValidationBuilder | Veri doğrulama kuralını, verilen değer ile aynı veya sonraki bir tarihi zorunlu kılacak şekilde ayarlar. |
requireDateOnOrBefore(date) | DataValidationBuilder | Veri doğrulama kuralını, belirtilen değerde veya bu değerden önce bir tarihi zorunlu kılacak şekilde ayarlar. |
requireFormulaSatisfied(formula) | DataValidationBuilder | Veri doğrulama kuralını, belirtilen formülün true olarak değerlendirilmesini gerektirecek şekilde ayarlar. |
requireNumberBetween(start, end) | DataValidationBuilder | Veri doğrulama kuralını, belirtilen iki sayının arasına veya bu iki sayının arasına denk gelen bir sayıyı zorunlu kılacak şekilde ayarlar. |
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ı, belirtilen iki sayı arasında yer almayan ve bu iki sayının ikisi de olmayan bir sayı gerektirecek şekilde ayarlar. |
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 gerektirecek şekilde ayarlar. |
requireTextEqualTo(text) | DataValidationBuilder | Veri doğrulama kuralını, girişin verilen değere eşit olmasını gerektirecek şekilde ayarlar. |
requireTextIsEmail() | DataValidationBuilder | Veri doğrulama kuralını, girişin 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 verilen değerlerden birine eşit olmasını gerektirecek şekilde ayarlar. |
requireValueInList(values, showDropdown) | DataValidationBuilder | Veri doğrulama kuralını, girişin verilen değerlerden birine eşit olmasını gerektirecek şekilde ayarlar ve 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 belirli aralıktaki bir değere eşit olmasını gerektirecek şekilde ayarlar ve açılır menüyü gizleme seçeneği sunar. |
setAllowInvalid(allowInvalidData) | DataValidationBuilder | Giriş, veri doğrulaması başarısız olduğunda bir uyarı gösterilip gösterilmeyeceğini veya girişin tamamen reddedilip reddedilmeyeceğini belirler. |
setHelpText(helpText) | DataValidationBuilder | Kullanıcı, veri doğrulamasının ayarlandığı hücrenin üzerine geldiğinde görünen yardım metnini ayarlar. |
withCriteria(criteria, args) | DataValidationBuilder | Veri doğrulama kuralını, genellikle mevcut bir kuralın criteria ve arguments değerlerinden alınan DataValidationCriteria değerleriyle tanımlanan ölçütlere ayarlar. |
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 dayanarak veri doğrulama kuralı için bir 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ına dayalı bir oluşturucu
getAllowInvalid()
Kural, giriş veri doğrulamasında başarısız olduğunda true
, girişi tamamen reddederse false
döndürür. Yeni veri doğrulama kuralları için varsayılan değer: true
.
Return
Boolean
: Kural, veri doğrulamasında başarısız olan girişe izin veriyorsa true
; izin verilmiyorsa false
getCriteriaType()
DataValidationCriteria
sıralamasında tanımlandığı şekliyle kuralın ölçüt türünü alır. Ölçütlerle ilgili bağımsız değişkenleri almak için getCriteriaValues()
işlevini kullanın. Bir veri doğrulama kuralı oluşturmak veya değiştirmek için bu değerleri kullanmak üzere withCriteria(criteria, args)
bölümüne 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 ölçütlerinin türü
getCriteriaValues()
Kuralın ölçütleri için bir dizi bağımsız değişken alır. Ölçüt türünü öğrenmek için getCriteriaType()
işlevini kullanın. Bir veri doğrulama kuralı oluşturmak veya mevcut bir kuralı değiştirmek üzere bu değerleri kullanmak için withCriteria(criteria, args)
politikası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 olan bağımsız değişken dizisi; bağımsız değişken sayısı ve türü, DataValidationBuilder
sınıfının karşılık gelen require...()
yöntemiyle eşleşir
getHelpText()
Kuralın yardım metnini veya herhangi bir yardım metni ayarlanmamışsa null
mesajını alır.
Return
String
— kuralın yardım metni veya 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, onay kutusu olarak 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 bağlantı için bu derleyici
requireCheckbox(checkedValue)
Veri doğrulama kuralını, girişin belirtilen değerde veya boş olmasını gerektirecek şekilde ayarlar. Giriş belirtilen değerle eşleştiğinde hücre işaretli onay kutusu olarak oluşturulur. Giriş boş olduğunda 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 bir kutuya atanan değer. |
Return
DataValidationBuilder
— zincirleme bağlantı için bu derleyici
requireCheckbox(checkedValue, uncheckedValue)
Veri doğrulama kuralını, girişin belirtilen değerlerden biri olmasını gerektirecek şekilde ayarlar. Giriş checkedValue
olduğunda hücre işaretli onay kutusu olarak oluşturulur. Giriş uncheckedValue
olduğunda 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 bir kutuya atanan değer. |
uncheckedValue | Object | İşaretlenmemiş bir kutuya atanan değer. |
Return
DataValidationBuilder
— zincirleme bağlantı için bu derleyici
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 bağlantı için bu derleyici
requireDateAfter(date)
Veri doğrulama kuralını, verilen değerden sonra bir tarih gerektirecek şekilde ayarlar. Date
nesnesinin 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 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 en son tarih. |
Return
DataValidationBuilder
— zincirleme bağlantı için bu derleyici
requireDateBefore(date)
Veri doğrulama kuralını, verilen değerden önce bir tarihi zorunlu kılacak şekilde ayarlar. Date
nesnesinin 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 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 edilemeyen en erken tarih. |
Return
DataValidationBuilder
— zincirleme bağlantı için bu derleyici
requireDateBetween(start, end)
Veri doğrulama kuralını, belirtilen iki tarih arasına veya bu tarihlerden birine denk gelen bir tarihi zorunlu kılacak şekilde ayarlar. 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 bağlantı için bu derleyici
requireDateEqualTo(date)
Veri doğrulama kuralını, verilen değere eşit bir tarihi zorunlu kılacak şekilde ayarlar. Date
nesnesinin 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 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 bağlantı için bu derleyici
requireDateNotBetween(start, end)
Veri doğrulama kuralını, belirtilen iki tarih arasında olmayan ve bu iki tarih arasında da yer almayan bir tarihi zorunlu kılacak şekilde ayarlar. 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 edilemeyen en erken tarih. |
end | Date | Kabul edilemez en son tarih. |
Return
DataValidationBuilder
— zincirleme bağlantı için bu derleyici
requireDateOnOrAfter(date)
Veri doğrulama kuralını, verilen değer ile aynı veya sonraki bir tarihi zorunlu kılacak şekilde ayarlar. Date
nesnesinin 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 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 bağlantı için bu derleyici
requireDateOnOrBefore(date)
Veri doğrulama kuralını, belirtilen değerde veya bu değerden önce bir tarihi zorunlu kılacak şekilde ayarlar. Date
nesnesinin 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 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 bağlantı için bu derleyici
requireFormulaSatisfied(formula)
Veri doğrulama kuralını, belirtilen formülün true
olarak değerlendirilmesini gerektirecek ş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 bir formül. |
Return
DataValidationBuilder
— zincirleme bağlantı için bu derleyici
requireNumberBetween(start, end)
Veri doğrulama kuralını, belirtilen iki sayının arasına veya bu iki sayının arasına denk gelen bir sayıyı zorunlu kılacak şekilde ayarlar.
// 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 bağlantı için bu derleyici
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 bağlantı için bu derleyici
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 bağlantı için bu derleyici
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 bağlantı için bu derleyici
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 bağlantı için bu derleyici
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 bağlantı için bu derleyici
requireNumberNotBetween(start, end)
Veri doğrulama kuralını, belirtilen iki sayı arasında yer almayan ve bu iki sayının ikisi de olmayan bir sayı gerektirecek şekilde ayarlar.
// 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 bağlantı için bu derleyici
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 bağlantı için bu derleyici
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 bağlantı için bu derleyici
requireTextDoesNotContain(text)
Veri doğrulama kuralını, girişin verilen değeri içermemesini gerektirecek ş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 bağlantı için bu derleyici
requireTextEqualTo(text)
Veri doğrulama kuralını, girişin verilen değere eşit olmasını gerektirecek ş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 bağlantı için bu derleyici
requireTextIsEmail()
Veri doğrulama kuralını, girişin 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 bağlantı için bu derleyici
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 bağlantı için bu derleyici
requireValueInList(values)
Veri doğrulama kuralını, girişin verilen 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 bağlantı için bu derleyici
requireValueInList(values, showDropdown)
Veri doğrulama kuralını, girişin verilen değerlerden birine eşit olmasını gerektirecek şekilde ayarlar ve 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 açılır menü gösterilmesi gerekiyorsa true , görünmüyorsa false . |
Return
DataValidationBuilder
— zincirleme bağlantı için bu derleyici
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 bağlantı için bu derleyici
requireValueInRange(range, showDropdown)
Veri doğrulama kuralını, girişin belirli aralıktaki bir değere eşit olmasını gerektirecek şekilde ayarlar ve 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 açılır menü gösterilmesi gerekiyorsa true , görünmüyorsa false . |
Return
DataValidationBuilder
— zincirleme bağlantı için bu derleyici
setAllowInvalid(allowInvalidData)
Giriş, veri doğrulaması başarısız olduğunda bir uyarı gösterilip gösterilmeyeceğini veya girişin tamamen reddedilip reddedilmeyeceğini belirler. Yeni veri doğrulama kuralları için varsayılan değer: true
.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
allowInvalidData | Boolean | Kuralın veri doğrulamasında başarısız olan girişe izin vermesi gerekiyorsa true ; izin vermiyorsa false . |
Return
DataValidationBuilder
— zincirleme bağlantı için bu derleyici
setHelpText(helpText)
Kullanıcı, veri doğrulamasının ayarlandığı hücrenin üzerine geldiğinde görünen yardım metnini ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
helpText | String | Ayarlanacak yardım metni. |
Return
DataValidationBuilder
— zincirleme bağlantı için bu derleyici
withCriteria(criteria, args)
Veri doğrulama kuralını, genellikle mevcut bir kuralın criteria
ve arguments
değerlerinden alınan DataValidationCriteria
değerleriyle tanımlanan ölçütlere ayarlar.
// 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 bağımsız değişken dizisi. Bağımsız değişken sayısı ve türü, yukarıdaki ilgili require...() yöntemiyle eşleşir. |
Return
DataValidationBuilder
— zincirleme bağlantı için bu derleyici