Builder untuk aturan validasi data.
// 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);
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
build() | DataValidation | Membuat aturan validasi data dari setelan yang diterapkan pada builder. |
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. |
requireCheckbox() | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan input adalah nilai boolean; nilai ini dirender sebagai kotak centang. |
requireCheckbox(checkedValue) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan input adalah nilai yang ditentukan atau kosong. |
requireCheckbox(checkedValue, uncheckedValue) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan input adalah salah satu dari nilai yang ditentukan. |
requireDate() | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan tanggal. |
requireDateAfter(date) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan tanggal setelah nilai yang diberikan. |
requireDateBefore(date) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan tanggal sebelum nilai yang diberikan. |
requireDateBetween(start, end) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan tanggal yang berada di antara, atau salah satu dari, dua tanggal yang ditentukan. |
requireDateEqualTo(date) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan tanggal yang sama dengan nilai yang diberikan. |
requireDateNotBetween(start, end) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan tanggal yang tidak berada di antara, dan bukan salah satu dari, dua tanggal yang ditentukan. |
requireDateOnOrAfter(date) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan tanggal pada atau setelah nilai yang diberikan. |
requireDateOnOrBefore(date) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan tanggal pada atau sebelum nilai yang diberikan. |
requireFormulaSatisfied(formula) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan formula yang ditentukan bernilai true . |
requireNumberBetween(start, end) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan angka yang berada di antara, atau salah satu dari, dua angka yang ditentukan. |
requireNumberEqualTo(number) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan angka yang sama dengan nilai yang diberikan. |
requireNumberGreaterThan(number) | DataValidationBuilder | Menyetel aturan validasi data untuk mewajibkan angka yang lebih besar dari nilai yang diberikan. |
requireNumberGreaterThanOrEqualTo(number) | DataValidationBuilder | Menyetel aturan validasi data untuk mewajibkan angka yang lebih besar dari atau sama dengan nilai yang diberikan. |
requireNumberLessThan(number) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan angka yang lebih kecil dari nilai yang diberikan. |
requireNumberLessThanOrEqualTo(number) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan angka yang kurang dari atau sama dengan nilai yang diberikan. |
requireNumberNotBetween(start, end) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan angka yang tidak berada di antara, dan bukan dari, dua angka yang ditentukan. |
requireNumberNotEqualTo(number) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan angka yang tidak sama dengan nilai yang diberikan. |
requireTextContains(text) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan input berisi nilai yang diberikan. |
requireTextDoesNotContain(text) | DataValidationBuilder | Menetapkan aturan validasi data untuk mengharuskan input tidak berisi nilai yang diberikan. |
requireTextEqualTo(text) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan input sama dengan nilai yang diberikan. |
requireTextIsEmail() | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan input berupa alamat email. |
requireTextIsUrl() | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan input berupa URL. |
requireValueInList(values) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan input sama dengan salah satu nilai yang diberikan. |
requireValueInList(values, showDropdown) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan input sama dengan salah satu nilai yang diberikan, dengan opsi untuk menyembunyikan menu dropdown. |
requireValueInRange(range) | DataValidationBuilder | Menetapkan aturan validasi data untuk mengharuskan input sama dengan nilai dalam rentang yang diberikan. |
requireValueInRange(range, showDropdown) | DataValidationBuilder | Menetapkan aturan validasi data untuk mewajibkan input sama dengan nilai dalam rentang yang ditentukan, dengan opsi untuk menyembunyikan menu dropdown. |
setAllowInvalid(allowInvalidData) | DataValidationBuilder | Menetapkan apakah akan menampilkan peringatan saat input gagal dalam validasi data, atau apakah akan menolak input sepenuhnya. |
setHelpText(helpText) | DataValidationBuilder | Menetapkan teks bantuan yang muncul saat pengguna mengarahkan kursor ke sel tempat validasi data ditetapkan. |
withCriteria(criteria, args) | DataValidationBuilder | Menetapkan aturan validasi data ke kriteria yang ditentukan oleh nilai DataValidationCriteria ,
biasanya diambil dari criteria dan arguments aturan yang ada. |
Dokumentasi mendetail
build()
Membuat aturan validasi data dari setelan yang diterapkan pada builder.
Return
DataValidation
— representasi aturan validasi data
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 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 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
requireCheckbox()
Menetapkan aturan validasi data untuk mewajibkan input adalah nilai boolean; nilai ini dirender sebagai kotak centang.
// 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
— builder ini, untuk membuat rantai
requireCheckbox(checkedValue)
Menetapkan aturan validasi data untuk mewajibkan input adalah nilai yang ditentukan atau kosong. Jika input cocok dengan nilai yang ditentukan, sel dirender sebagai kotak centang yang dicentang. Jika input kosong, sel dirender sebagai kotak centang yang tidak dicentang.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
checkedValue | Object | Nilai yang ditetapkan ke kotak yang dicentang. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireCheckbox(checkedValue, uncheckedValue)
Menetapkan aturan validasi data untuk mewajibkan input adalah salah satu dari nilai yang ditentukan. Jika
inputnya adalah checkedValue
, sel dirender sebagai kotak centang yang dicentang. Jika
inputnya adalah uncheckedValue
, sel dirender sebagai kotak centang yang tidak dicentang.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
checkedValue | Object | Nilai yang ditetapkan ke kotak yang dicentang. |
uncheckedValue | Object | Nilai yang ditetapkan ke kotak yang tidak dicentang. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireDate()
Menetapkan aturan validasi data untuk mewajibkan tanggal.
// 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
— builder ini, untuk membuat rantai
requireDateAfter(date)
Menetapkan aturan validasi data untuk mewajibkan tanggal setelah nilai yang diberikan. Kolom waktu objek
Date
diabaikan; hanya kolom hari, bulan, dan tahun yang digunakan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
date | Date | Tanggal terakhir yang tidak dapat diterima. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireDateBefore(date)
Menetapkan aturan validasi data untuk mewajibkan tanggal sebelum nilai yang diberikan. Kolom waktu objek
Date
diabaikan; hanya kolom hari, bulan, dan tahun yang digunakan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
date | Date | Tanggal paling awal yang tidak dapat diterima. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireDateBetween(start, end)
Menetapkan aturan validasi data untuk mewajibkan tanggal yang berada di antara, atau salah satu dari, dua tanggal yang ditentukan. Kolom waktu objek Date
diabaikan; hanya kolom hari, bulan,
dan tahun yang digunakan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
start | Date | Tanggal paling awal yang dapat diterima. |
end | Date | Tanggal terakhir yang dapat diterima. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireDateEqualTo(date)
Menetapkan aturan validasi data untuk mewajibkan tanggal yang sama dengan nilai yang diberikan. Kolom waktu
objek Date
diabaikan; hanya kolom hari, bulan, dan tahun yang digunakan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
date | Date | Satu-satunya tanggal yang dapat diterima. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireDateNotBetween(start, end)
Menetapkan aturan validasi data untuk mewajibkan tanggal yang tidak berada di antara, dan bukan salah satu dari, dua tanggal yang ditentukan. Kolom waktu objek Date
diabaikan; hanya kolom hari,
bulan, dan tahun yang digunakan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
start | Date | Tanggal paling awal yang tidak dapat diterima. |
end | Date | Tanggal terakhir yang tidak dapat diterima. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireDateOnOrAfter(date)
Menetapkan aturan validasi data untuk mewajibkan tanggal pada atau setelah nilai yang diberikan. Kolom waktu
objek Date
diabaikan; hanya kolom hari, bulan, dan tahun yang digunakan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
date | Date | Tanggal paling awal yang dapat diterima. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireDateOnOrBefore(date)
Menetapkan aturan validasi data untuk mewajibkan tanggal pada atau sebelum nilai yang diberikan. Kolom waktu
objek Date
diabaikan; hanya kolom hari, bulan, dan tahun yang digunakan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
date | Date | Tanggal terakhir yang dapat diterima. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireFormulaSatisfied(formula)
Menetapkan aturan validasi data untuk mewajibkan formula yang ditentukan bernilai true
.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
formula | String | Formula kustom yang bernilai true jika inputnya valid. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireNumberBetween(start, end)
Menetapkan aturan validasi data untuk mewajibkan angka yang berada di antara, atau salah satu dari, dua angka yang ditentukan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
start | Number | Nilai terendah yang dapat diterima. |
end | Number | Nilai tertinggi yang dapat diterima. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireNumberEqualTo(number)
Menetapkan aturan validasi data untuk mewajibkan angka yang sama dengan nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
number | Number | Satu-satunya nilai yang dapat diterima. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireNumberGreaterThan(number)
Menyetel aturan validasi data untuk mewajibkan angka yang lebih besar dari nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
number | Number | Nilai tertinggi yang tidak dapat diterima. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireNumberGreaterThanOrEqualTo(number)
Menyetel aturan validasi data untuk mewajibkan angka yang lebih besar dari atau sama dengan nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
number | Number | Nilai terendah yang dapat diterima. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireNumberLessThan(number)
Menetapkan aturan validasi data untuk mewajibkan angka yang lebih kecil dari nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
number | Number | Nilai terendah yang tidak dapat diterima. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireNumberLessThanOrEqualTo(number)
Menetapkan aturan validasi data untuk mewajibkan angka yang kurang dari atau sama dengan nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
number | Number | Nilai tertinggi yang dapat diterima. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireNumberNotBetween(start, end)
Menetapkan aturan validasi data untuk mewajibkan angka yang tidak berada di antara, dan bukan dari, dua angka yang ditentukan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
start | Number | Nilai terendah yang tidak dapat diterima. |
end | Number | Nilai tertinggi yang tidak dapat diterima. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireNumberNotEqualTo(number)
Menetapkan aturan validasi data untuk mewajibkan angka yang tidak sama dengan nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
number | Number | Satu-satunya nilai yang tidak dapat diterima. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireTextContains(text)
Menetapkan aturan validasi data untuk mewajibkan input berisi nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
text | String | Nilai yang harus dimuat oleh input. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireTextDoesNotContain(text)
Menetapkan aturan validasi data untuk mengharuskan input tidak berisi nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
text | String | Nilai yang tidak boleh diisi oleh input. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireTextEqualTo(text)
Menetapkan aturan validasi data untuk mewajibkan input sama dengan nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
text | String | Satu-satunya nilai yang dapat diterima. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireTextIsEmail()
Menetapkan aturan validasi data untuk mewajibkan input berupa alamat email.
// 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
— builder ini, untuk membuat rantai
requireTextIsUrl()
Menetapkan aturan validasi data untuk mewajibkan input berupa URL.
// 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
— builder ini, untuk membuat rantai
requireValueInList(values)
Menetapkan aturan validasi data untuk mewajibkan input sama dengan salah satu nilai yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
values | String[] | Array nilai yang dapat diterima. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireValueInList(values, showDropdown)
Menetapkan aturan validasi data untuk mewajibkan input sama dengan salah satu nilai yang diberikan, dengan opsi untuk menyembunyikan menu dropdown.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
values | String[] | Array nilai yang dapat diterima. |
showDropdown | Boolean | true jika spreadsheet seharusnya menampilkan menu dropdown untuk nilai;
false jika tidak. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireValueInRange(range)
Menetapkan aturan validasi data untuk mengharuskan input sama dengan nilai dalam rentang yang diberikan.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
range | Range | Rentang yang berisi nilai yang dapat diterima. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
requireValueInRange(range, showDropdown)
Menetapkan aturan validasi data untuk mewajibkan input sama dengan nilai dalam rentang yang ditentukan, dengan opsi untuk menyembunyikan menu dropdown.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
range | Range | Rentang yang berisi nilai yang dapat diterima. |
showDropdown | Boolean | true jika spreadsheet seharusnya menampilkan menu dropdown untuk nilai;
false jika tidak. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
setAllowInvalid(allowInvalidData)
Menetapkan apakah akan menampilkan peringatan saat input gagal dalam validasi data, atau apakah akan menolak input
sepenuhnya. Default untuk aturan validasi data baru adalah true
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
allowInvalidData | Boolean | true jika aturan harus mengizinkan input yang gagal dalam validasi data;
false jika tidak. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
setHelpText(helpText)
Menetapkan teks bantuan yang muncul saat pengguna mengarahkan kursor ke sel tempat validasi data ditetapkan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
helpText | String | Teks bantuan yang akan ditetapkan. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai
withCriteria(criteria, args)
Menetapkan aturan validasi data ke kriteria yang ditentukan oleh nilai DataValidationCriteria
,
biasanya diambil dari criteria
dan arguments
aturan yang ada.
// 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
criteria | DataValidationCriteria | Jenis kriteria validasi data. |
args | Object[] | Array argumen yang sesuai dengan jenis kriteria tersebut; jumlah argumen dan
jenisnya cocok dengan metode require...() yang sesuai di atas. |
Return
DataValidationBuilder
— builder ini, untuk membuat rantai