Mengakses aturan validasi data. Untuk membuat aturan baru, gunakan SpreadsheetApp.newDataValidation()
dan DataValidationBuilder
. Anda dapat menggunakan Range.setDataValidation(rule)
untuk menetapkan aturan validasi untuk suatu rentang.
// 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.') }
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
copy() | DataValidationBuilder | Membuat builder untuk aturan validasi data berdasarkan setelan aturan ini. |
getAllowInvalid() | Boolean | Menampilkan true jika aturan menampilkan peringatan saat input gagal dalam validasi data, atau false jika aturan menolak input sepenuhnya. |
getCriteriaType() | DataValidationCriteria | Mendapatkan jenis kriteria aturan seperti yang ditentukan dalam enum DataValidationCriteria . |
getCriteriaValues() | Object[] | Mengambil array argumen untuk kriteria aturan. |
getHelpText() | String | Mendapatkan teks bantuan aturan, atau null jika tidak ada teks bantuan yang ditetapkan. |
Dokumentasi mendetail
copy()
Membuat builder untuk aturan validasi data berdasarkan setelan aturan ini.
// 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
— builder berdasarkan setelan aturan ini
getAllowInvalid()
Menampilkan true
jika aturan menampilkan peringatan saat input gagal dalam validasi data, atau false
jika aturan menolak input sepenuhnya. Default untuk aturan validasi data baru adalah true
.
Return
Boolean
— true
jika aturan mengizinkan input yang gagal dalam validasi data; false
jika tidak
getCriteriaType()
Mendapatkan jenis kriteria aturan seperti yang ditentukan dalam enum DataValidationCriteria
. Untuk mendapatkan
argumen bagi kriteria, gunakan getCriteriaValues()
. Untuk menggunakan nilai ini untuk membuat atau mengubah aturan validasi data, lihat DataValidationBuilder.withCriteria(criteria, args)
.
// 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
— jenis kriteria validasi data
getCriteriaValues()
Mengambil array argumen untuk kriteria aturan. Untuk mendapatkan jenis kriteria, gunakan getCriteriaType()
. Untuk menggunakan nilai ini guna membuat atau mengubah aturan validasi data, lihat DataValidationBuilder.withCriteria(criteria, args)
.
// 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[]
— array argumen yang sesuai dengan jenis kriteria aturan; jumlah argumen dan jenisnya cocok dengan metode require...()
yang sesuai dari class DataValidationBuilder
getHelpText()
Mendapatkan teks bantuan aturan, atau null
jika tidak ada teks bantuan yang ditetapkan.
Return
String
— teks bantuan aturan, atau null
jika tidak ada teks bantuan yang ditetapkan