Class DataValidation

DataValidation

Veri doğrulama kurallarına erişme. Yeni bir kural oluşturmak için SpreadsheetApp.newDataValidation() ve DataValidationBuilder kurallarını kullanın. Tekliflerinizi otomatikleştirmek ve optimize etmek için Range.setDataValidation(rule) ile bir aralık için doğrulama kuralını ayarlayı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.')
}

Yöntemler

YöntemDönüş türüKısa açıklama
copy()DataValidationBuilderBu kuralın ayarlarına göre bir veri doğrulama kuralı için oluşturucu oluşturur.
getAllowInvalid()BooleanKural, giriş veri doğrulamasında başarısız olduğunda uyarı gösteriyorsa true değerini veya girişi tamamen reddetmesi durumunda false değerini döndürür.
getCriteriaType()DataValidationCriteriaKuralın DataValidationCriteria sıralamasında tanımlanan ölçüt türünü 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 ayarlanmadıysa null değerini alır.

Ayrıntılı belgeler

copy()

Bu kuralın ayarlarına göre bir veri doğrulama kuralı için 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ını temel alan bir oluşturucu

getAllowInvalid()

Kural, giriş veri doğrulamasında başarısız olduğunda uyarı gösteriyorsa true değerini veya girişi tamamen reddetmesi durumunda false değerini döndürür. Yeni veri doğrulama kuralları için varsayılan değer true şeklindedir.

Return

Boolean — Kural, veri doğrulamasında başarısız olan girişe izin veriyorsa true; Değilse false

getCriteriaType()

Kuralın DataValidationCriteria sıralamasında tanımlanan ölçüt türünü alır. To almak için bağımsız değişkenlerin olması için getCriteriaValues() kullanın. Bu değerleri kullanarak veya değiştirme hakkında daha fazla bilgi için DataValidationBuilder.withCriteria(criteria, args) sayfası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

DataValidationCriteria — veri doğrulama kriterlerinin 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() işlevini kullanın. Veri doğrulama kuralı oluşturmak veya değiştirmek amacıyla bu değerleri kullanmak için DataValidationBuilder.withCriteria(criteria, args) sayfası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 bir bağımsız değişken dizisi; bağımsız değişken sayısı ve türü, DataValidationBuilder sınıfının ilgili require...() yöntemiyle eşleşiyor

getHelpText()

Kuralın yardım metnini veya yardım metni ayarlanmadıysa null değerini alır.

Return

String — kuralın yardım metni. Yardım metni ayarlanmamışsa null