Veri doğrulama kurallarına erişim. Yeni kural oluşturmak için SpreadsheetApp.newDataValidation()
ve DataValidationBuilder
kurallarını kullanın. Bir aralık için doğrulama kuralı ayarlamak üzere Range.setDataValidation(rule)
kullanabilirsiniz.
// 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.') }
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
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. |
Ayrıntılı belgeler
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 DataValidationBuilder.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 DataValidationBuilder.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