Class DataValidation

تنشئ أداة إنشاء لقاعدة التحقّق من صحة البيانات استنادًا إلى إعدادات هذه القاعدة.

// 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: أداة إنشاء استنادًا إلى إعدادات هذه القاعدة

يتم عرض true إذا كانت القاعدة تعرض تحذيرًا عند تعذُّر عملية التحقق من صحة البيانات، أو يتم عرض false في حال رفض الإدخال بالكامل. الإعداد التلقائي لقواعد التحقق من صحة البيانات الجديدة هو true.

استرجاع الكرة

Boolean: true إذا كانت القاعدة تسمح بإدخال البيانات التي لا تنجح، وfalse إذا لم يكن الأمر كذلك

للحصول على نوع معايير القاعدة كما هو محدّد في التعداد 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 — نوع معايير التحقق من صحة البيانات

للحصول على صفيف من الوسيطات لمعايير القاعدة. للحصول على نوع المعيار، استخدِم 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.

الحصول على نص مساعدة القاعدة أو null في حال عدم ضبط نص مساعدة

استرجاع الكرة

String: نص مساعدة القاعدة أو null في حال عدم ضبط نص مساعدة