Class DataValidationBuilder

DataValidationBuilder

أداة إنشاء قواعد التحقّق من صحة البيانات 

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

الطُرق

الطريقةنوع القيمة التي تم إرجاعهاوصف قصير
build()DataValidationتنشئ هذه الدالة قاعدة للتحقّق من صحة البيانات من الإعدادات التي تم تطبيقها على أداة الإنشاء.
copy()DataValidationBuilderتُنشئ هذه الدالة أداة إنشاء لقاعدة التحقّق من صحة البيانات استنادًا إلى إعدادات هذه القاعدة.
getAllowInvalid()Booleanتعرِض هذه السمة القيمة true إذا كانت القاعدة تعرض تحذيرًا عند تعذُّر التحقّق من صحة البيانات، أو القيمة false إذا كانت القاعدة ترفض البيانات بالكامل.
getCriteriaType()DataValidationCriteriaتعرض هذه السمة نوع معايير القاعدة كما هو محدّد في التعداد DataValidationCriteria.
getCriteriaValues()Object[]تعرض هذه الدالة مصفوفة من وسيطات معايير القاعدة.
getHelpText()Stringتعرض هذه السمة نص المساعدة الخاص بالقاعدة، أو null إذا لم يتم ضبط أي نص مساعدة.
requireCheckbox()DataValidationBuilderتضبط قاعدة التحقّق من صحة البيانات على أن يكون الإدخال قيمة منطقية، ويتم عرض هذه القيمة كمربّع اختيار.
requireCheckbox(checkedValue)DataValidationBuilderتضبط قاعدة التحقّق من صحة البيانات على أن يكون الإدخال هو القيمة المحدّدة أو فارغًا.
requireCheckbox(checkedValue, uncheckedValue)DataValidationBuilderتضبط هذه السمة قاعدة التحقّق من صحة البيانات لتتطلّب أن تكون القيمة المُدخَلة إحدى القيم المحدّدة.
requireDate()DataValidationBuilderتضبط هذه السمة قاعدة التحقّق من صحة البيانات لتتطلّب إدخال تاريخ.
requireDateAfter(date)DataValidationBuilderتضبط قاعدة التحقّق من صحة البيانات لتتطلّب تاريخًا بعد القيمة المحدّدة.
requireDateBefore(date)DataValidationBuilderتضبط هذه السمة قاعدة التحقّق من صحة البيانات لتتطلّب إدخال تاريخ قبل القيمة المحدّدة.
requireDateBetween(start, end)DataValidationBuilderتضبط هذه السمة قاعدة التحقّق من صحة البيانات لتتطلّب إدخال تاريخ يقع بين تاريخَين محدَّدَين أو يكون أحد هذين التاريخَين.
requireDateEqualTo(date)DataValidationBuilderتضبط هذه السمة قاعدة التحقّق من صحة البيانات لتتطلّب تاريخًا يساوي القيمة المحدّدة.
requireDateNotBetween(start, end)DataValidationBuilderتضبط قاعدة التحقّق من صحة البيانات على طلب تاريخ لا يقع بين تاريخَين محدّدين ولا يساوي أيًا منهما.
requireDateOnOrAfter(date)DataValidationBuilderتضبط قاعدة التحقّق من صحة البيانات على طلب تاريخ في اليوم المحدد أو بعده.
requireDateOnOrBefore(date)DataValidationBuilderتضبط هذه السمة قاعدة التحقّق من صحة البيانات لتتطلّب تاريخًا في القيمة المحدّدة أو قبلها.
requireFormulaSatisfied(formula)DataValidationBuilderتضبط هذه السمة قاعدة التحقّق من صحة البيانات لتتطلّب أن يتم تقييم الصيغة المحدّدة إلى true.
requireNumberBetween(start, end)DataValidationBuilderتضبط هذه السمة قاعدة التحقّق من صحة البيانات على طلب رقم يقع بين رقمين محدّدين أو يكون أحد هذين الرقمين.
requireNumberEqualTo(number)DataValidationBuilderتضبط قاعدة التحقّق من صحة البيانات على طلب رقم يساوي القيمة المحدّدة.
requireNumberGreaterThan(number)DataValidationBuilderتضبط قاعدة التحقّق من صحة البيانات على طلب رقم أكبر من القيمة المحدّدة.
requireNumberGreaterThanOrEqualTo(number)DataValidationBuilderيضبط قاعدة التحقّق من صحة البيانات على طلب رقم أكبر من القيمة المحدّدة أو يساويها.
requireNumberLessThan(number)DataValidationBuilderتضبط هذه السمة قاعدة التحقّق من صحة البيانات لتتطلّب إدخال رقم أقل من القيمة المحدّدة.
requireNumberLessThanOrEqualTo(number)DataValidationBuilderتضبط هذه السمة قاعدة التحقّق من صحة البيانات على طلب إدخال رقم أقل من القيمة المحدّدة أو يساويها.
requireNumberNotBetween(start, end)DataValidationBuilderتضبط هذه السمة قاعدة التحقّق من صحة البيانات على طلب إدخال رقم لا يقع بين رقمَين محدَّدَين ولا يساوي أيًا منهما.
requireNumberNotEqualTo(number)DataValidationBuilderتضبط قاعدة التحقّق من صحة البيانات على أن تتطلّب رقمًا لا يساوي القيمة المحدّدة.
requireTextContains(text)DataValidationBuilderتضبط قاعدة التحقّق من صحة البيانات على أن يتضمّن الإدخال القيمة المحدّدة.
requireTextDoesNotContain(text)DataValidationBuilderتضبط قاعدة التحقّق من صحة البيانات على أن تتطلّب ألا يحتوي الإدخال على القيمة المحدّدة.
requireTextEqualTo(text)DataValidationBuilderتضبط قاعدة التحقّق من صحة البيانات على أن يكون الإدخال مساويًا للقيمة المحدّدة.
requireTextIsEmail()DataValidationBuilderتضبط قاعدة التحقّق من صحة البيانات على أن يكون الإدخال في شكل عنوان بريد إلكتروني.
requireTextIsUrl()DataValidationBuilderتضبط قاعدة التحقّق من صحة البيانات على أن يكون الإدخال في شكل عنوان URL.
requireValueInList(values)DataValidationBuilderتضبط قاعدة التحقّق من صحة البيانات على أن يكون الإدخال مساويًا لإحدى القيم المحدّدة.
requireValueInList(values, showDropdown)DataValidationBuilderتضبط قاعدة التحقّق من صحة البيانات على أن يكون الإدخال مساويًا لإحدى القيم المحدّدة، مع خيار إخفاء القائمة المنسدلة.
requireValueInRange(range)DataValidationBuilderتضبط قاعدة التحقّق من صحة البيانات على أن يكون الإدخال مساويًا لقيمة في النطاق المحدّد.
requireValueInRange(range, showDropdown)DataValidationBuilderتضبط هذه السمة قاعدة التحقّق من صحة البيانات على أن يكون الإدخال مساويًا لقيمة في النطاق المحدّد، مع خيار إخفاء القائمة المنسدلة.
setAllowInvalid(allowInvalidData)DataValidationBuilderتحديد ما إذا كان سيتم عرض تحذير عند فشل التحقّق من صحة البيانات المدخلة أو ما إذا كان سيتم رفض الإدخال بالكامل.
setHelpText(helpText)DataValidationBuilderتضبط هذه السمة نص المساعدة الذي يظهر عندما يمرّر المستخدم مؤشر الماوس فوق الخلية التي تم ضبط ميزة "التحقّق من صحة البيانات" عليها.
withCriteria(criteria, args)DataValidationBuilderتضبط هذه السمة قاعدة التحقّق من صحة البيانات على المعايير المحدّدة بقيم DataValidationCriteria، والتي يتم عادةً أخذها من criteria وarguments لقاعدة حالية.

مستندات تفصيلية

build()

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

الإرجاع

DataValidation: تمثيل لقاعدة التحقّق من صحة البيانات

copy()

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

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

الإرجاع

‫DataValidationBuilder: أداة إنشاء تستند إلى إعدادات هذه القاعدة

getAllowInvalid()

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

الإرجاع

Boolean: true إذا كانت القاعدة تسمح بإدخال بيانات يتعذّر التحقّق من صحتها، false إذا لم تكن تسمح بذلك

getCriteriaType()

تعرض هذه السمة نوع معايير القاعدة كما هو محدّد في التعداد DataValidationCriteria. للحصول على وسيطات المعايير، استخدِم getCriteriaValues(). لاستخدام هذه القيم لإنشاء قاعدة التحقّق من صحة البيانات أو تعديلها، راجِع withCriteria(criteria, args). 

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

الإرجاع

DataValidationCriteria: نوع معايير التحقّق من صحة البيانات

getCriteriaValues()

تعرض هذه الدالة مصفوفة من وسيطات معايير القاعدة. للحصول على نوع المعايير، استخدِم getCriteriaType(). لاستخدام هذه القيم لإنشاء قاعدة التحقّق من صحة البيانات أو تعديلها، اطّلِع على withCriteria(criteria, args). 

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

الإرجاع

‫Object[]: مصفوفة من الوسيطات المناسبة لنوع معايير القاعدة، ويتطابق عدد الوسيطات ونوعها مع طريقة require...() المقابلة لفئة DataValidationBuilder

getHelpText()

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

الإرجاع

‫String: نص المساعدة الخاص بالقاعدة، أو null إذا لم يتم ضبط أي نص مساعدة

requireCheckbox()

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

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

الإرجاع

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

requireCheckbox(checkedValue)

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

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

المَعلمات

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

الإرجاع

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

requireCheckbox(checkedValue, uncheckedValue)

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

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

المَعلمات

الاسمالنوعالوصف
checkedValueObjectالقيمة المحدّدة لمربّع الاختيار الذي تم وضع علامة فيه
uncheckedValueObjectالقيمة المحدّدة لمربّع غير محدّد

الإرجاع

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

requireDate()

تضبط هذه السمة قاعدة التحقّق من صحة البيانات لتتطلّب إدخال تاريخ. 

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

الإرجاع

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

requireDateAfter(date)

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

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

المَعلمات

الاسمالنوعالوصف
dateDateأحدث تاريخ غير مقبول.

الإرجاع

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

requireDateBefore(date)

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

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

المَعلمات

الاسمالنوعالوصف
dateDateأقرب تاريخ غير مقبول.

الإرجاع

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

requireDateBetween(start, end)

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

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

المَعلمات

الاسمالنوعالوصف
startDateأقرب تاريخ مقبول.
endDateأبعد تاريخ مقبول.

الإرجاع

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

requireDateEqualTo(date)

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

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

المَعلمات

الاسمالنوعالوصف
dateDateالتاريخ المقبول الوحيد

الإرجاع

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

requireDateNotBetween(start, end)

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

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

المَعلمات

الاسمالنوعالوصف
startDateأقرب تاريخ غير مقبول.
endDateأحدث تاريخ غير مقبول.

الإرجاع

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

requireDateOnOrAfter(date)

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

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

المَعلمات

الاسمالنوعالوصف
dateDateأقرب تاريخ مقبول.

الإرجاع

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

requireDateOnOrBefore(date)

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

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

المَعلمات

الاسمالنوعالوصف
dateDateأبعد تاريخ مقبول.

الإرجاع

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

requireFormulaSatisfied(formula)

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

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

المَعلمات

الاسمالنوعالوصف
formulaStringصيغة مخصّصة يتم تقييمها على أنّها true إذا كانت البيانات المدخلة صالحة.

الإرجاع

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

requireNumberBetween(start, end)

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

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

المَعلمات

الاسمالنوعالوصف
startNumberتمثّل هذه السمة أدنى قيمة مقبولة.
endNumberتمثّل هذه السمة أعلى قيمة مقبولة.

الإرجاع

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

requireNumberEqualTo(number)

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

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

المَعلمات

الاسمالنوعالوصف
numberNumberالقيمة المقبولة الوحيدة

الإرجاع

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

requireNumberGreaterThan(number)

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

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

المَعلمات

الاسمالنوعالوصف
numberNumberتمثّل هذه السمة أعلى قيمة غير مقبولة.

الإرجاع

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

requireNumberGreaterThanOrEqualTo(number)

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

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

المَعلمات

الاسمالنوعالوصف
numberNumberتمثّل هذه السمة أدنى قيمة مقبولة.

الإرجاع

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

requireNumberLessThan(number)

تضبط هذه السمة قاعدة التحقّق من صحة البيانات لتتطلّب إدخال رقم أقل من القيمة المحدّدة. 

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

المَعلمات

الاسمالنوعالوصف
numberNumberتمثّل هذه السمة أدنى قيمة غير مقبولة.

الإرجاع

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

requireNumberLessThanOrEqualTo(number)

تضبط هذه السمة قاعدة التحقّق من صحة البيانات على طلب إدخال رقم أقل من القيمة المحدّدة أو يساويها. 

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

المَعلمات

الاسمالنوعالوصف
numberNumberتمثّل هذه السمة أعلى قيمة مقبولة.

الإرجاع

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

requireNumberNotBetween(start, end)

تضبط هذه السمة قاعدة التحقّق من صحة البيانات على طلب إدخال رقم لا يقع بين رقمَين محدَّدَين ولا يساوي أيًا منهما. 

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

المَعلمات

الاسمالنوعالوصف
startNumberتمثّل هذه السمة أدنى قيمة غير مقبولة.
endNumberتمثّل هذه السمة أعلى قيمة غير مقبولة.

الإرجاع

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

requireNumberNotEqualTo(number)

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

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

المَعلمات

الاسمالنوعالوصف
numberNumberالقيمة الوحيدة غير المقبولة

الإرجاع

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

requireTextContains(text)

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

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

المَعلمات

الاسمالنوعالوصف
textStringالقيمة التي يجب أن يحتوي عليها الإدخال

الإرجاع

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

requireTextDoesNotContain(text)

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

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

المَعلمات

الاسمالنوعالوصف
textStringالقيمة التي يجب ألا يحتوي عليها الإدخال

الإرجاع

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

requireTextEqualTo(text)

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

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

المَعلمات

الاسمالنوعالوصف
textStringالقيمة المقبولة الوحيدة

الإرجاع

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

requireTextIsEmail()

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

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

الإرجاع

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

requireTextIsUrl()

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

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

الإرجاع

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

requireValueInList(values)

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

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

المَعلمات

الاسمالنوعالوصف
valuesString[]مجموعة من القيم المقبولة

الإرجاع

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

requireValueInList(values, showDropdown)

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

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

المَعلمات

الاسمالنوعالوصف
valuesString[]مجموعة من القيم المقبولة
showDropdownBoolean‫true إذا كان جدول البيانات سيعرض قائمة منسدلة للقيم، وfalse إذا لم يكن سيعرضها.

الإرجاع

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

requireValueInRange(range)

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

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

المَعلمات

الاسمالنوعالوصف
rangeRangeنطاق يحتوي على القيم المقبولة

الإرجاع

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

requireValueInRange(range, showDropdown)

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

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

المَعلمات

الاسمالنوعالوصف
rangeRangeنطاق يحتوي على القيم المقبولة
showDropdownBoolean‫true إذا كان جدول البيانات سيعرض قائمة منسدلة للقيم، وfalse إذا لم يكن سيعرضها.

الإرجاع

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

setAllowInvalid(allowInvalidData)

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

المَعلمات

الاسمالنوعالوصف
allowInvalidDataBoolean‫true إذا كان من المفترض أن تسمح القاعدة بإدخال بيانات لا تجتاز عملية التحقّق من صحة البيانات، false إذا لم يكن الأمر كذلك.

الإرجاع

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

setHelpText(helpText)

تضبط هذه السمة نص المساعدة الذي يظهر عندما يمرّر المستخدم مؤشر الماوس فوق الخلية التي تم ضبط ميزة &quot;التحقّق من صحة البيانات&quot; عليها.

المَعلمات

الاسمالنوعالوصف
helpTextStringنص المساعدة المطلوب ضبطه.

الإرجاع

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

withCriteria(criteria, args)

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

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

المَعلمات

الاسمالنوعالوصف
criteriaDataValidationCriteriaنوع معايير التحقّق من صحة البيانات
argsObject[]صفيف من الوسيطات المناسبة لنوع المعايير، ويتطابق عدد الوسيطات ونوعها مع طريقة require...() المقابلة أعلاه.

الإرجاع

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