Class DataValidation

VeriDoğrulama

Veri doğrulama kurallarına erişme Yeni kural oluşturmak için SpreadsheetApp.newDataValidation() ve DataValidationBuilder simgesini kullanın. Bir aralık için doğrulama kuralını ayarlamak üzere Range.setDataValidation(rule) kullanabilirsiniz. 

// 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.');
}

Yöntemler

YöntemDönüş türüKısa açıklama
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.

Ayrıntılı dokümanlar

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 DataValidationBuilder.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 DataValidationBuilder.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