Class DataValidation

DataValidation

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