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.

الإرجاع

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

المعلَمات

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

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
checkedValue	Object	القيمة المحدّدة لمربّع اختيار تم وضع علامة فيه.
uncheckedValue	Object	القيمة المحدّدة لمربّع غير محدَّد

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
date	Date	آخر تاريخ غير مقبول.

الإرجاع

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

المعلَمات

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

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
start	Date	أقرب تاريخ مقبول.
end	Date	آخر تاريخ مقبول.

الإرجاع

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

المعلَمات

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

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
start	Date	أقرب تاريخ غير مقبول.
end	Date	آخر تاريخ غير مقبول.

الإرجاع

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

المعلَمات

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

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
date	Date	آخر تاريخ مقبول.

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
formula	String	صيغة مخصّصة يتم تقييمها على أنّها 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);

المعلَمات

الاسم	النوع	الوصف
start	Number	أدنى قيمة مقبولة.
end	Number	أعلى قيمة مقبولة.

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
number	Number	القيمة الوحيدة المقبولة.

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
number	Number	أعلى قيمة غير مقبولة.

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
number	Number	أدنى قيمة مقبولة.

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
number	Number	أدنى قيمة غير مقبولة.

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
number	Number	أعلى قيمة مقبولة.

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
start	Number	أدنى قيمة غير مقبولة.
end	Number	أعلى قيمة غير مقبولة.

الإرجاع

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

المعلَمات

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

الإرجاع

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

المعلَمات

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

الإرجاع

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

المعلَمات

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

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
text	String	القيمة الوحيدة المقبولة.

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
values	String[]	صفيف من القيم المقبولة

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
values	String[]	صفيف من القيم المقبولة
showDropdown	Boolean	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);

المعلَمات

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

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
range	Range	نطاق يحتوي على القيم المقبولة
showDropdown	Boolean	true إذا كان يجب أن يعرض جدول البيانات قائمة منسدلة للقيم false إذا لم يكن الأمر كذلك

الإرجاع

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

---

setAllowInvalid(allowInvalidData)

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

المعلَمات

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

الإرجاع

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

---

setHelpText(helpText)

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

المعلَمات

الاسم	النوع	الوصف
helpText	String	نص المساعدة المطلوب ضبطه

الإرجاع

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

المعلَمات

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

الإرجاع

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