Class DataValidationBuilder

VeriDoğrulamaOluşturucu

Veri doğrulama kuralları için oluşturucu. 

// Set the data validation for cell A1 to require a value from B1:B10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Yöntemler

YöntemDönüş türüKısa açıklama
build()DataValidationOluşturucuya uygulanan ayarlardan veri doğrulama kuralı oluşturur.
copy()DataValidationBuilderBu kuralın ayarlarına göre veri doğrulama kuralı oluşturucu oluşturur.
getAllowInvalid()BooleanGiriş veri doğrulamasında başarısız olduğunda kural uyarı gösteriyorsa true, girişi tamamen reddediyorsa false döndürür.
getCriteriaType()DataValidationCriteriaKuralın ölçüt türünü DataValidationCriteria enum'unda tanımlandığı şekilde alır.
getCriteriaValues()Object[]Kuralın ölçütleri için bir bağımsız değişken dizisi alır.
getHelpText()StringKuralın yardım metnini veya yardım metni ayarlanmamışsa null değerini döndürür.
requireCheckbox()DataValidationBuilderVeri doğrulama kuralını, girişin bir boole değeri olmasını zorunlu kılacak şekilde ayarlar. Bu değer, onay kutusu olarak oluşturulur.
requireCheckbox(checkedValue)DataValidationBuilderVeri doğrulama kuralını, girişin belirtilen değer veya boş olmasını gerektirecek şekilde ayarlar.
requireCheckbox(checkedValue, uncheckedValue)DataValidationBuilderVeri doğrulama kuralını, girişin belirtilen değerlerden birini gerektirecek şekilde ayarlar.
requireDate()DataValidationBuilderVeri doğrulama kuralını tarih gerektirecek şekilde ayarlar.
requireDateAfter(date)DataValidationBuilderVeri doğrulama kuralını, belirtilen değerden sonraki bir tarih gerektirecek şekilde ayarlar.
requireDateBefore(date)DataValidationBuilderVeri doğrulama kuralını, belirtilen değerden önceki bir tarih gerektirecek şekilde ayarlar.
requireDateBetween(start, end)DataValidationBuilderVeri doğrulama kuralını, belirtilen iki tarih arasında veya bu tarihlerden biri olan bir tarih gerektirecek şekilde ayarlar.
requireDateEqualTo(date)DataValidationBuilderVeri doğrulama kuralını, belirtilen değere eşit bir tarih gerektirecek şekilde ayarlar.
requireDateNotBetween(start, end)DataValidationBuilderVeri doğrulama kuralını, belirtilen iki tarih arasında olmayan ve bu tarihlerden biri olmayan bir tarih gerektirecek şekilde ayarlar.
requireDateOnOrAfter(date)DataValidationBuilderVeri doğrulama kuralını, belirtilen değerdeki veya sonrasındaki bir tarih gerektirecek şekilde ayarlar.
requireDateOnOrBefore(date)DataValidationBuilderVeri doğrulama kuralını, belirtilen değere eşit veya bu tarihten önce bir tarih gerektirecek şekilde ayarlar.
requireFormulaSatisfied(formula)DataValidationBuilderVeri doğrulama kuralını, verilen formülün true değerini döndürmesini gerektirecek şekilde ayarlar.
requireNumberBetween(start, end)DataValidationBuilderVeri doğrulama kuralını, belirtilen iki sayı arasında veya bu sayılardan biri olan bir sayı gerektirecek şekilde ayarlar.
requireNumberEqualTo(number)DataValidationBuilderVeri doğrulama kuralını, belirtilen değere eşit bir sayı gerektirecek şekilde ayarlar.
requireNumberGreaterThan(number)DataValidationBuilderVeri doğrulama kuralını, belirtilen değerden büyük bir sayı gerektirecek şekilde ayarlar.
requireNumberGreaterThanOrEqualTo(number)DataValidationBuilderVeri doğrulama kuralını, verilen değerden büyük veya bu değere eşit bir sayı gerektirecek şekilde ayarlar.
requireNumberLessThan(number)DataValidationBuilderVeri doğrulama kuralını, belirtilen değerden daha düşük bir sayı gerektirecek şekilde ayarlar.
requireNumberLessThanOrEqualTo(number)DataValidationBuilderVeri doğrulama kuralını, belirtilen değerden az veya bu değere eşit bir sayı gerektirecek şekilde ayarlar.
requireNumberNotBetween(start, end)DataValidationBuilderVeri doğrulama kuralını, belirtilen iki sayı arasında olmayan ve bu sayılardan biri olmayan bir sayı gerektirecek şekilde ayarlar.
requireNumberNotEqualTo(number)DataValidationBuilderVeri doğrulama kuralını, belirtilen değere eşit olmayan bir sayı gerektirecek şekilde ayarlar.
requireTextContains(text)DataValidationBuilderVeri doğrulama kuralını, girişin belirli bir değeri içermesini zorunlu kılacak şekilde ayarlar.
requireTextDoesNotContain(text)DataValidationBuilderVeri doğrulama kuralını, girişin belirli bir değeri içermemesini gerektirecek şekilde ayarlar.
requireTextEqualTo(text)DataValidationBuilderVeri doğrulama kuralını, girişin belirtilen değere eşit olmasını gerektirecek şekilde ayarlar.
requireTextIsEmail()DataValidationBuilderVeri doğrulama kuralını, girişin e-posta adresi biçiminde olmasını zorunlu kılacak şekilde ayarlar.
requireTextIsUrl()DataValidationBuilderVeri doğrulama kuralını, girişin URL biçiminde olmasını zorunlu kılacak şekilde ayarlar.
requireValueInList(values)DataValidationBuilderVeri doğrulama kuralını, girişin belirtilen değerlerden birine eşit olmasını gerektirecek şekilde ayarlar.
requireValueInList(values, showDropdown)DataValidationBuilderVeri doğrulama kuralını, girişin belirli değerlerden birine eşit olmasını gerektirecek şekilde ayarlar. Bu kuralda açılır menüyü gizleme seçeneği de bulunur.
requireValueInRange(range)DataValidationBuilderVeri doğrulama kuralını, girişin belirli aralıktaki bir değere eşit olmasını zorunlu kılacak şekilde ayarlar.
requireValueInRange(range, showDropdown)DataValidationBuilderVeri doğrulama kuralını, girişin belirli bir aralıktaki bir değere eşit olmasını zorunlu kılacak şekilde ayarlar. Bu kuralda, açılır menüyü gizleme seçeneği de bulunur.
setAllowInvalid(allowInvalidData)DataValidationBuilderGiriş veri doğrulamasını geçemediğinde uyarı gösterilip gösterilmeyeceğini veya girişin tamamen reddedilip reddedilmeyeceğini belirler.
setHelpText(helpText)DataValidationBuilderKullanıcı fare imlecini veri doğrulamasının ayarlandığı hücrenin üzerine getirdiğinde görünen yardım metnini ayarlar.
withCriteria(criteria, args)DataValidationBuilderVeri doğrulama kuralını, genellikle mevcut bir kuralın criteria ve arguments öğesinden alınan DataValidationCriteria değerleriyle tanımlanan ölçütlere ayarlar.

Ayrıntılı dokümanlar

build()

Oluşturucuya uygulanan ayarlardan veri doğrulama kuralı oluşturur.

Return

DataValidation: Veri doğrulama kuralının gösterimi

copy()

Bu kuralın ayarlarına göre veri doğrulama kuralı oluşturucu oluşturur. 

// Change existing data validation rules that require a date in 2013 to require
// a date in 2014.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    const rule = rules[i][j];

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const 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()

Giriş veri doğrulamasında başarısız olduğunda kural uyarı gösteriyorsa true, girişi tamamen reddediyorsa false döndürür. Yeni veri doğrulama kurallarının varsayılan değeri true'tür.

Return

Boolean: Kural, veri doğrulamasını geçemeyen girişlere izin veriyorsa true, aksi takdirde false

getCriteriaType()

Kuralın ölçüt türünü DataValidationCriteria enum'unda tanımlandığı şekilde alır. Ölçütlerin bağımsız değişkenlerini almak için getCriteriaValues() değerini kullanın. Veri doğrulama kuralı oluşturmak veya mevcut bir kuralı değiştirmek için bu değerleri kullanmak istiyorsanız withCriteria(criteria, args) bölümüne bakın. 

// Log information about the data validation rule for cell A1.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const 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 bağımsız değişken dizisi alır. Ölçüt türünü almak için getCriteriaType() değerini kullanın. Veri doğrulama kuralı oluşturmak veya mevcut bir kuralı değiştirmek için bu değerleri kullanmak istiyorsanız withCriteria(criteria, args) bölümüne bakın. 

// Log information about the data validation rule for cell A1.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const 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 dizisidir. Bağımsız değişkenlerin sayısı ve türleri, DataValidationBuilder sınıfının ilgili require...() yöntemiyle eşleşir.

getHelpText()

Kuralın yardım metnini veya yardım metni ayarlanmamışsa null değerini döndürü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ı zorunlu kılacak ş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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const 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 veya boş olmasını gerektirecek şekilde ayarlar. Giriş belirtilen değerle eşleştiğinde hücre, işaretli bir onay kutusu olarak oluşturulur. Giriş boş olduğunda hücre, işareti kaldırılmış 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
checkedValueObjectİşaretli bir 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 birini gerektirecek şekilde ayarlar. Giriş checkedValue olduğunda hücre, işaretli bir 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireCheckbox('APPROVED', 'PENDING')
                 .build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
checkedValueObjectİşaretli bir kutuya atanan değer.
uncheckedValueObjectİş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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const 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 sonraki 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateAfter(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
dateDateKabul edilemeyen en son tarih.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireDateBefore(date)

Veri doğrulama kuralını, belirtilen değerden önceki 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 before January 1, 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateBefore(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
dateDateKabul edilebilecek en erken tarih.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireDateBetween(start, end)

Veri doğrulama kuralını, belirtilen iki tarih arasında veya bu tarihlerden biri olan bir tarih gerektirecek ş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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation()
        .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013'))
        .build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
startDateKabul edilebilir en erken tarih.
endDateKabul edilebilir en son tarih.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireDateEqualTo(date)

Veri doğrulama kuralını, belirtilen değere eşit 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 equal to January 1,
// 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateEqualTo(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
dateDateTek kabul edilen tarih.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireDateNotBetween(start, end)

Veri doğrulama kuralını, belirtilen iki tarih arasında olmayan ve bu tarihlerden biri olmayan bir tarih gerektirecek ş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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation()
        .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013'))
        .build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
startDateKabul edilebilecek en erken tarih.
endDateKabul edilemeyen en son tarih.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireDateOnOrAfter(date)

Veri doğrulama kuralını, belirtilen değerdeki veya sonrasındaki 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 on or after January 1,
// 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateOnOrAfter(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
dateDateKabul edilebilir en erken tarih.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireDateOnOrBefore(date)

Veri doğrulama kuralını, belirtilen değere eşit veya bu tarihten önce 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 on or before January 1,
// 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateOnOrBefore(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
dateDateKabul edilebilir en son tarih.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireFormulaSatisfied(formula)

Veri doğrulama kuralını, verilen formülün true değerini döndürmesini gerektirecek şekilde ayarlar. 

// Set the data validation for cell A1 to equal B1 with a custom formula.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireFormulaSatisfied('=EQ(A1,B1)')
                 .build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
formulaStringGiriş geçerliyse true olarak değerlendirilen özel formül.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireNumberBetween(start, end)

Veri doğrulama kuralını, belirtilen iki sayı arasında veya bu sayılardan biri olan bir sayı gerektirecek şekilde ayarlar. 

// Set the data validation for cell A1 to require a number between 1 and 10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberBetween(1, 10).build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
startNumberKabul edilebilir en düşük değer.
endNumberKabul edilebilir en yüksek değer.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireNumberEqualTo(number)

Veri doğrulama kuralını, belirtilen değere eşit bir sayı gerektirecek şekilde ayarlar. 

// Set the data validation for cell A1 to require a number equal
// to 3.1415926536.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberEqualTo(Math.PI).build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
numberNumberKabul edilen tek değerdir.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireNumberGreaterThan(number)

Veri doğrulama kuralını, belirtilen değerden büyük bir sayı gerektirecek şekilde ayarlar. 

// Set the data validation for cell A1 to require a number greater than 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
numberNumberKabul edilemeyecek 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireNumberGreaterThanOrEqualTo(0)
                 .build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
numberNumberKabul edilebilir en düşük değer.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireNumberLessThan(number)

Veri doğrulama kuralını, belirtilen değerden daha düşük bir sayı gerektirecek şekilde ayarlar. 

// Set the data validation for cell A1 to require a number less than 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
numberNumberKabul edilemeyecek en düşük değer.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireNumberLessThanOrEqualTo(number)

Veri doğrulama kuralını, belirtilen değerden az 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireNumberLessThanOrEqualTo(0)
                 .build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
numberNumberKabul edilebilir en yüksek değer.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireNumberNotBetween(start, end)

Veri doğrulama kuralını, belirtilen iki sayı arasında olmayan ve bu sayılardan biri olmayan bir sayı gerektirecek şekilde ayarlar. 

// Set the data validation for cell A1 to require a number not between 1 and 10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberNotBetween(1, 10).build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
startNumberKabul edilemeyecek en düşük değer.
endNumberKabul edilemeyecek en yüksek değer.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireNumberNotEqualTo(number)

Veri doğrulama kuralını, belirtilen 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
numberNumberYalnızca kabul edilmeyen değer.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireTextContains(text)

Veri doğrulama kuralını, girişin belirli bir değeri içermesini zorunlu kılacak şekilde ayarlar. 

// Set the data validation for cell A1 to require any value that includes
// "Google".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextContains('Google').build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
textStringGirişin içermesi gereken değer.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireTextDoesNotContain(text)

Veri doğrulama kuralını, girişin belirli bir değeri içermemesini gerektirecek şekilde ayarlar. 

// Set the data validation for cell A1 to require any value that does not
// include "@".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
textStringGirişin içermemesi gereken değer.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireTextEqualTo(text)

Veri doğrulama kuralını, girişin belirtilen değere eşit olmasını gerektirecek şekilde ayarlar. 

// Set the data validation for cell A1 to require "Yes".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
textStringKabul edilen tek değerdir.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireValueInList(['Yes', 'No'])
                 .build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
valuesString[]Kabul edilen değerler dizisi.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireValueInList(values, showDropdown)

Veri doğrulama kuralını, girişin belirli değerlerden birine eşit olmasını gerektirecek şekilde ayarlar. Bu kuralda açılır menüyü gizleme seçeneği de bulunur. 

// Set the data validation for cell A1 to require "Yes" or "No", with no
// dropdown menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireValueInList(['Yes', 'No'], false)
                 .build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
valuesString[]Kabul edilen değerler dizisi.
showDropdownBooleanE-tabloda değerler için açılır menü gösterilecekse true, aksi takdirde false.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

requireValueInRange(range)

Veri doğrulama kuralını, girişin belirli aralıktaki bir değere eşit olmasını zorunlu kılacak şekilde ayarlar. 

// Set the data validation for cell A1 to require a value from B1:B10, with a
// dropdown menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
rangeRangeKabul edilen 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 belirli bir aralıktaki bir değere eşit olmasını zorunlu kılacak şekilde ayarlar. Bu kuralda, açılır menüyü gizleme seçeneği de bulunur. 

// Set the data validation for cell A1 to require value from B1:B10, with no
// dropdown menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule = SpreadsheetApp.newDataValidation()
                 .requireValueInRange(range, false)
                 .build();
cell.setDataValidation(rule);

Parametreler

AdTürAçıklama
rangeRangeKabul edilen değerleri içeren bir aralık.
showDropdownBooleanE-tabloda değerler için açılır menü gösterilecekse true, aksi takdirde false.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

setAllowInvalid(allowInvalidData)

Giriş veri doğrulamasını geçemediğinde uyarı gösterilip gösterilmeyeceğini veya girişin tamamen reddedilip reddedilmeyeceğini belirler. Yeni veri doğrulama kurallarının varsayılan değeri true'tür.

Parametreler

AdTürAçıklama
allowInvalidDataBooleanKural, veri doğrulamasını geçemeyen girişlere izin veriyorsa true; aksi takdirde false.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

setHelpText(helpText)

Kullanıcı fare imlecini veri doğrulamasının ayarlandığı hücrenin üzerine getirdiğinde görünen yardım metnini ayarlar.

Parametreler

AdTürAçıklama
helpTextStringAyarlanacak yardım metni.

Return

DataValidationBuilder: zincirleme için bu oluşturucu

withCriteria(criteria, args)

Veri doğrulama kuralını, genellikle mevcut bir kuralın criteria ve arguments öğesinden 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.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    const rule = rules[i][j];

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const 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

AdTürAçıklama
criteriaDataValidationCriteriaVeri doğrulama ölçütlerinin türü.
argsObject[]Ölçüt türüne uygun bir bağımsız değişken dizisi; bağımsız değişkenlerin sayısı ve türleri, yukarıdaki ilgili require...() yöntemiyle eşleşir.

Return

DataValidationBuilder: zincirleme için bu oluşturucu