Class DataValidationBuilder

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

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

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(). ولاستخدام هذه القيم لإنشاء قاعدة للتحقق من صحة البيانات أو تعديلها، راجع 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(). ولاستخدام هذه القيم لإنشاء قاعدة للتحقّق من صحة البيانات أو تعديلها، اطّلِع على 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 في حال عدم ضبط نص مساعدة

لتعيين قاعدة التحقق من صحة البيانات بحيث تتطلب أن يكون الإدخال قيمة منطقية، ويتم عرض هذه القيمة كمربع اختيار.

// Set the data validation for cell A1 to require a boolean value; the value is rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox().build();
cell.setDataValidation(rule);

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

DataValidationBuilder: أداة إنشاء السلاسل

لتعيين قاعدة التحقق من صحة البيانات بحيث تتطلب أن يكون الإدخال هو القيمة المحددة أو فارغًا. عندما يتطابق الإدخال مع القيمة المحددة، يتم عرض الخلية كمربع اختيار محدد. عندما يكون الإدخال فارغًا، يتم عرض الخلية كمربع اختيار غير محدد.

// Set the data validation for cell A1 to require a custom checked value that is rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لتعيين قاعدة التحقق من صحة البيانات بحيث تتطلب أن يكون المدخل أحد القيم المحددة. عندما يكون المُدخل checkedValue، يتم عرض الخلية كمربّع اختيار محدَّد. عندما يكون الإدخال uncheckedValue، يتم عرض الخلية كمربّع اختيار غير محدَّد.

// Set the data validation for cell A1 to require custom checked values that are rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED', 'PENDING').build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لضبط قاعدة التحقّق من صحة البيانات بحيث تتطلب تاريخًا.

// Set the data validation for cell A1 to require a date.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDate().build();
cell.setDataValidation(rule);

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

DataValidationBuilder: أداة إنشاء السلاسل

لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب تاريخًا بعد القيمة المقدمة. ويتم تجاهل الحقول الزمنية للعنصر Date، ويتم استخدام حقول اليوم والشهر والسنة فقط.

// Set the data validation for cell A1 to require a date after January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateAfter(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب تاريخًا قبل القيمة المقدمة. ويتم تجاهل الحقول الزمنية للعنصر Date، ويتم استخدام حقول اليوم والشهر والسنة فقط.

// Set the data validation for cell A1 to require a date before January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateBefore(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لتعيين قاعدة التحقق من صحة البيانات لطلب تاريخ يقع بين أو يكون إما تاريخين محددين. يتم تجاهل الحقول الزمنية للكائنات Date، ويتم استخدام حقول اليوم والشهر والسنة فقط.

// Set the data validation for cell A1 to require a date in 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013')).build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب تاريخًا مساويًا للقيمة المحددة. ويتم تجاهل الحقول الزمنية للكائن Date، ويتم استخدام حقول اليوم والشهر والسنة فقط.

// Set the data validation for cell A1 to require a date equal to January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateEqualTo(new Date('1/1/2013'))
    .build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لتعيين قاعدة التحقق من صحة البيانات بحيث تتطلب تاريخًا لا يقع بين تاريخين محددين وليسا أي منهما. ويتم تجاهل الحقول الزمنية للكائنات Date، ويتم استخدام حقول اليوم والشهر والسنة فقط.

// Set the data validation for cell A1 to require a date not in 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013')).build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب تاريخًا يقع في القيمة المحددة أو بعدها. ويتم تجاهل الحقول الزمنية للكائن Date، ويتم استخدام حقول اليوم والشهر والسنة فقط.

// Set the data validation for cell A1 to require a date on or after January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateOnOrAfter(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب تاريخًا يقع في القيمة المحددة أو قبلها. ويتم تجاهل الحقول الزمنية للكائن Date، ويتم استخدام حقول اليوم والشهر والسنة فقط.

// Set the data validation for cell A1 to require a date on or before January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateOnOrBefore(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

تعمل هذه السياسة على ضبط قاعدة التحقّق من صحة البيانات بحيث تتطلب تقييم الصيغة المحددة إلى true.

// Set the data validation for cell A1 to equal B1 with a custom formula.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireFormulaSatisfied('=EQ(A1,B1)').build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لتعيين قاعدة التحقق من صحة البيانات بحيث تتطلب رقمًا يقع بين رقمين محددين أو يكون إما أحدهما.

// Set the data validation for cell A1 to require a number between 1 and 10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberBetween(1, 10).build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب رقمًا يساوي القيمة المحددة.

// Set the data validation for cell A1 to require a number equal to 3.1415926536.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberEqualTo(3.1415926536).build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب رقمًا أكبر من القيمة المقدمة.

// Set the data validation for cell A1 to require a number greater than 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب رقمًا أكبر من أو يساوي القيمة المحددة.

// Set the data validation for cell A1 to require a number greater than or equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThanOrEqualTo(0).build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب رقمًا أقل من القيمة المقدمة.

// Set the data validation for cell A1 to require a number less than 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب رقمًا أقل من أو يساوي القيمة المحددة.

// Set the data validation for cell A1 to require a number less than or equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThanOrEqualTo(0).build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لتعيين قاعدة التحقق من صحة البيانات لطلب رقم لا يقع بين رقمين محددين وليس أيهما كان أيًا منهما.

// Set the data validation for cell A1 to require a number not between 1 and 10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberNotBetween(1, 10).build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب رقمًا لا يساوي القيمة المحددة.

// Set the data validation for cell A1 to require a number not equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لتعيين قاعدة التحقق من صحة البيانات بحيث تتطلب أن يحتوي الإدخال على القيمة المحددة.

// Set the data validation for cell A1 to require any value that includes "Google".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextContains('Google').build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب ألا يحتوي الإدخال على القيمة المحددة.

// Set the data validation for cell A1 to require any value that does not include "@".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لتعيين قاعدة التحقق من صحة البيانات بحيث تتطلب أن يكون المدخل مساويًا للقيمة المحددة.

// Set the data validation for cell A1 to require "Yes".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب أن يكون الإدخال في شكل عنوان بريد إلكتروني.

// Set the data validation for cell A1 to require text in the form of an email address.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build();
cell.setDataValidation(rule);

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

DataValidationBuilder: أداة إنشاء السلاسل

لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب أن يكون الإدخال في شكل عنوان URL.

// Set the data validation for cell A1 to require text in the form of a URL.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextIsUrl().build();
cell.setDataValidation(rule);

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

DataValidationBuilder: أداة إنشاء السلاسل

لتعيين قاعدة التحقق من صحة البيانات بحيث تتطلب أن يكون المدخل مساويًا لإحدى القيم المحددة.

// Set the data validation for cell A1 to require "Yes" or "No", with a dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No']).build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لتعيين قاعدة التحقق من صحة البيانات بحيث تتطلب أن يكون الإدخال مساويًا لإحدى القيم المحددة، مع وجود خيار لإخفاء القائمة المنسدلة.

// Set the data validation for cell A1 to require "Yes" or "No", with no dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No'], false).build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب أن يكون المدخل مساويًا لقيمة ما في نطاق معين.

// Set the data validation for cell A1 to require a value from B1:B10, with a dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لتعيين قاعدة التحقق من صحة البيانات بحيث تتطلب أن يكون الإدخال مساويًا لقيمة في نطاق معين، مع توفر خيار لإخفاء القائمة المنسدلة.

// Set the data validation for cell A1 to require value from B1:B10, with no dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range, false).build();
cell.setDataValidation(rule);

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

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

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لتعيين نص المساعدة الذي يظهر عندما يمرر المستخدم فوق الخلية التي تم تعيين التحقق من صحة البيانات عليها.

المَعلمات

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

DataValidationBuilder: أداة إنشاء السلاسل

لضبط قاعدة التحقق من صحة البيانات على معايير تحدّدها قيم DataValidationCriteria، والتي تكون عادةً مأخوذة من criteria وarguments لقاعدة حالية.

// 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: أداة إنشاء السلاسل