Class DataValidation

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.

الإرجاع

Booleantrue إذا كانت القاعدة تسمح بالإدخال الذي يتعذّر التحقّق من صحة البيانات 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 في حال عدم ضبط نص مساعدة