Class 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.

الإرجاع

Booleantrue إذا كانت القاعدة تسمح بإدخال بيانات لا تجتاز عملية التحقّق من صحتها، 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[]صفيف من القيم المقبولة
showDropdownBooleantrue إذا كان يجب أن يعرض جدول البيانات قائمة منسدلة للقيم 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نطاق يحتوي على القيم المقبولة
showDropdownBooleantrue إذا كان يجب أن يعرض جدول البيانات قائمة منسدلة للقيم false إذا لم يكن الأمر كذلك

الإرجاع

DataValidationBuilder — هذا المُنشئ، لتسلسل العناصر


setAllowInvalid(allowInvalidData)

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

المعلمات

الاسمالنوعالوصف
allowInvalidDataBooleantrue إذا كان يجب أن تسمح القاعدة بإدخال بيانات لا تجتاز عملية التحقّق من البيانات false إذا لم يكن الأمر كذلك

الإرجاع

DataValidationBuilder — هذا المُنشئ، لتسلسل العناصر


setHelpText(helpText)

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

المعلمات

الاسمالنوعالوصف
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 — هذا المُنشئ، لتسلسل العناصر