Class DataValidation

DataValidation

Veri doğrulama kurallarına erişin. Yeni bir kural oluşturmak için SpreadsheetApp.newDataValidation() ve DataValidationBuilder simgelerini 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öntem	Dönüş türü	Kısa açıklama
copy()	DataValidationBuilder	Bu kuralın ayarlarına göre bir veri doğrulama kuralı için oluşturucu oluşturur.
getAllowInvalid()	Boolean	Kural, giriş verileri doğrulaması başarısız olduğunda uyarı gösteriyorsa true, girişi tamamen reddediyorsa false değerini döndürür.
getCriteriaType()	DataValidationCriteria	Kuralı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()	String	Kuralın yardım metnini veya yardım metni ayarlanmamışsa 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.
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()

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

Return

Kural, veri doğrulama hatası veren girişlere izin veriyorsa Boolean, aksi takdirde truefalse

---

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() kullanın. Veri doğrulama kuralı oluşturmak veya 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() kullanın. Veri doğrulama kuralı oluşturmak veya değiştirmek için bu değerleri kullanmak istiyorsanız DataValidationBuilder.withCriteria(criteria, args) başlıklı makaleyi inceleyin.

// 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 dizisi. Bağımsız değişkenlerin sayısı ve türü, 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 alır.

Return

String: Kuralın yardım metni veya yardım metni ayarlanmamışsa null