Class DataValidation

اعتبار سنجی داده ها

دسترسی به قوانین اعتبارسنجی داده ها برای ایجاد یک قانون جدید، از SpreadsheetApp.newDataValidation() و DataValidationBuilder استفاده کنید. می‌توانید از Range.setDataValidation(rule) برای تنظیم قانون اعتبارسنجی برای یک محدوده استفاده کنید.

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

مواد و روش ها

روش	نوع برگشت	توضیح مختصر
copy()	DataValidationBuilder	بر اساس تنظیمات این قانون یک سازنده برای یک قانون اعتبارسنجی داده ایجاد می کند.
getAllowInvalid()	Boolean	در صورتی که این قانون یک هشدار true در زمانی که ورودی اعتبارسنجی داده را با شکست مواجه می‌کند، نشان می‌دهد، یا اگر ورودی را به طور کامل رد کند، false .
getCriteriaType()	DataValidationCriteria	نوع معیار قانون را همانطور که در فهرست DataValidationCriteria تعریف شده است دریافت می کند.
getCriteriaValues()	Object[]	آرایه ای از آرگومان ها را برای معیارهای قاعده دریافت می کند.
getHelpText()	String	متن راهنمای قانون را دریافت می کند، یا اگر متن راهنما تنظیم نشده باشد null .

مستندات دقیق

copy()

بر اساس تنظیمات این قانون یک سازنده برای یک قانون اعتبارسنجی داده ایجاد می کند.

// 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);

برگشت

DataValidationBuilder - سازنده بر اساس تنظیمات این قانون

---

getAllowInvalid()

در صورتی که این قانون یک هشدار true در زمانی که ورودی اعتبارسنجی داده را با شکست مواجه می‌کند، نشان می‌دهد، یا اگر ورودی را به طور کامل رد کند، false . پیش‌فرض قوانین اعتبارسنجی داده جدید true است.

برگشت

Boolean - true اگر قانون اجازه ورودی‌هایی را بدهد که اعتبارسنجی داده‌ها ناموفق باشد. false اگر نه

---

getCriteriaType()

نوع معیار قانون را همانطور که در فهرست DataValidationCriteria تعریف شده است دریافت می کند. برای بدست آوردن آرگومان های معیارها، از getCriteriaValues() استفاده کنید. برای استفاده از این مقادیر برای ایجاد یا اصلاح یک قانون اعتبارسنجی داده، به DataValidationBuilder.withCriteria(criteria, args) مراجعه کنید.

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

برگشت

DataValidationCriteria - نوع معیارهای اعتبارسنجی داده ها

---

getCriteriaValues()

آرایه ای از آرگومان ها را برای معیارهای قاعده دریافت می کند. برای دریافت نوع معیار، از getCriteriaType() استفاده کنید. برای استفاده از این مقادیر برای ایجاد یا اصلاح یک قانون اعتبارسنجی داده، به DataValidationBuilder.withCriteria(criteria, args) مراجعه کنید.

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

برگشت

Object[] - آرایه ای از آرگومان های مناسب با نوع معیار قاعده. تعداد آرگومان‌ها و نوع آن‌ها با متد require...() کلاس DataValidationBuilder مطابقت دارد

---

getHelpText()

متن راهنمای قانون را دریافت می کند، یا اگر متن راهنما تنظیم نشده باشد null .

برگشت

String - متن راهنمای قانون، یا اگر متن راهنما تنظیم نشده باشد، null