أداة إنشاء قواعد التحقّق من صحة البيانات
// 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() | Data | تُنشئ قاعدة للتحقّق من صحة البيانات من الإعدادات المطبَّقة على أداة الإنشاء. |
copy() | Data | تُنشئ أداة لإنشاء قاعدة للتحقّق من صحة البيانات استنادًا إلى إعدادات هذه القاعدة. |
get | Boolean | تعرِض القيمة true إذا كانت القاعدة تعرِض تحذيرًا عندما يتعذّر إكمال عملية التحقّق من البيانات، أو false إذا كانت ترفض الإدخال بالكامل. |
get | Data | تحصل على نوع معايير القاعدة كما هو محدّد في التعداد Data . |
get | Object[] | تحصل على صفيف من الوسيطات لمعايير القاعدة. |
get | String | تحصل على نص مساعدة القاعدة، أو null في حال عدم ضبط نص مساعدة. |
require | Data | تضبط قاعدة التحقّق من صحة البيانات لتطلب أن يكون الإدخال قيمة منطقية، ويتم عرض هذه القيمة كمربّع اختيار. |
require | Data | تضبط قاعدة التحقّق من البيانات لتطلب أن يكون الإدخال هو القيمة المحدّدة أو فارغًا. |
require | Data | تضبط قاعدة التحقّق من صحة البيانات لتطلب أن تكون الإدخال إحدى القيم المحدّدة. |
require | Data | ضبط قاعدة التحقّق من صحة البيانات لطلب إدخال تاريخ |
require | Data | تضبط قاعدة التحقّق من صحة البيانات لطلب تاريخ بعد القيمة المحدّدة. |
require | Data | تضبط قاعدة التحقّق من صحة البيانات لطلب تاريخ قبل القيمة المحدّدة. |
require | Data | تضبط قاعدة التحقّق من صحة البيانات لطلب تاريخ يقع بين تاريخين محدّدين أو يكون أحدهما. |
require | Data | تضبط قاعدة التحقّق من صحة البيانات لتطلب تاريخًا يساوي القيمة المحدّدة. |
require | Data | ضبط قاعدة التحقّق من البيانات لطلب تاريخ لا يقع بين تاريخَين محدّدَين ولا يمثّل أيًا منهما |
require | Data | ضبط قاعدة التحقّق من صحة البيانات لطلب تاريخ في التاريخ المحدّد أو بعده |
require | Data | تضبط قاعدة التحقّق من صحة البيانات لطلب تاريخ في أو قبل القيمة المحدّدة. |
require | Data | تضبط قاعدة التحقّق من صحة البيانات لتطلب تقييم الصيغة المحدّدة على true . |
require | Data | تضبط قاعدة التحقّق من صحة البيانات لطلب رقم يقع بين رقمَين محدّدَين أو يكون أحدهما. |
require | Data | لضبط قاعدة التحقّق من صحة البيانات لطلب رقم يساوي القيمة المحدّدة. |
require | Data | ضبط قاعدة التحقّق من صحة البيانات لطلب رقم أكبر من القيمة المحدّدة |
require | Data | تضبط قاعدة التحقّق من صحة البيانات لطلب رقم أكبر من القيمة المحدّدة أو يساويها. |
require | Data | ضبط قاعدة التحقّق من صحة البيانات لطلب رقم أقل من القيمة المحدّدة |
require | Data | تضبط قاعدة التحقّق من صحة البيانات لتطلب رقمًا أقل من القيمة المحدّدة أو يساويها. |
require | Data | تضبط قاعدة التحقّق من البيانات لطلب رقم لا يقع بين رقمَين محدّدَين ولا يمثّل أحدهما. |
require | Data | لضبط قاعدة التحقّق من البيانات على أن تطلب رقمًا غير مساوي للقيمة المحدّدة. |
require | Data | تضبط قاعدة التحقّق من صحة البيانات لتطلب أن يحتوي الإدخال على القيمة المحدّدة. |
require | Data | تضبط قاعدة التحقّق من البيانات لتطلب عدم احتواء الإدخال على القيمة المحدّدة. |
require | Data | تضبط قاعدة التحقّق من صحة البيانات لتطلب أن تكون الإدخال مساوية للقيمة المحدّدة. |
require | Data | تضبط قاعدة التحقّق من صحة البيانات لتطلب أن يكون الإدخال في شكل عنوان بريد إلكتروني. |
require | Data | تضبط قاعدة التحقّق من البيانات لتطلب أن يكون الإدخال في شكل عنوان URL. |
require | Data | تضبط قاعدة التحقّق من صحة البيانات لتطلب أن تكون الإدخال مساوية لأحد القيم المحدّدة. |
require | Data | تضبط قاعدة التحقّق من صحة البيانات لتطلب أن تكون الإدخال مساوية لأحد القيم المحدّدة، مع خيار لإخفاء القائمة المنسدلة. |
require | Data | تضبط قاعدة التحقّق من صحة البيانات لتطلب أن تكون الإدخال مساوية لقيمة في النطاق المحدّد. |
require | Data | تضبط قاعدة التحقّق من صحة البيانات لتطلب أن تكون الإدخال مساوية لقيمة في النطاق المحدّد، مع خيار لإخفاء القائمة المنسدلة. |
set | Data | لتحديد ما إذا كان سيتم عرض تحذير عندما يتعذّر إثبات صحة الإدخال أو رفض الإدخال تمامًا. |
set | Data | لضبط نص المساعدة الذي يظهر عندما يمرِّر المستخدم مؤشّر الماوس فوق الخلية التي تم ضبط ميزة التحقّق من البيانات عليها |
with | Data | تضبط قاعدة التحقّق من صحة البيانات على معايير محدّدة بواسطة قيم Data ،
يتم عادةً أخذها من criteria وarguments لقاعدة حالية. |
مستندات تفصيلية
build()
تُنشئ قاعدة للتحقّق من صحة البيانات من الإعدادات المطبَّقة على أداة الإنشاء.
الإرجاع
Data
- تمثيل لقاعدة التحقّق من صحة البيانات
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);
الإرجاع
Data
: أداة إنشاء مستندة إلى إعدادات هذه القاعدة
get Allow Invalid()
تعرِض القيمة true
إذا كانت القاعدة تعرِض تحذيرًا عندما يتعذّر إكمال عملية التحقّق من البيانات، أو false
إذا كانت ترفض الإدخال بالكامل. الإعداد التلقائي لقواعد التحقّق من صحة البيانات الجديدة هو true
.
الإرجاع
Boolean
— true
إذا كانت القاعدة تسمح بإدخال بيانات لا تجتاز عملية التحقّق من صحتها، false
إذا لم تكن كذلك
get Criteria Type()
تحصل على نوع معايير القاعدة كما هو محدّد في التعداد Data
. للحصول على
المَعلمات للمعايير، استخدِم get
. لاستخدام هذه القيم لإنشاء قاعدة التحقّق من صحة البيانات أو
تعديلها، اطّلِع على with
.
// 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.'); }
الإرجاع
Data
: نوع معايير التحقّق من صحة البيانات
get Criteria Values()
تحصل على صفيف من الوسيطات لمعايير القاعدة. للحصول على نوع المعايير، استخدِم get
. لاستخدام هذه القيم لإنشاء قاعدة التحقّق من صحة البيانات أو تعديلها، يُرجى الاطّلاع على with
.
// 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...()
المقابلة لفئة Data
get Help Text()
تحصل على نص مساعدة القاعدة، أو null
في حال عدم ضبط نص مساعدة.
الإرجاع
String
: نص مساعدة القاعدة، أو null
في حال عدم ضبط نص مساعدة
require Checkbox()
تضبط قاعدة التحقّق من صحة البيانات لتطلب أن يكون الإدخال قيمة منطقية، ويتم عرض هذه القيمة كمربّع اختيار.
// 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);
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Checkbox(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);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
checked | Object | القيمة المحدّدة لمربّع اختيار تم وضع علامة فيه. |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Checkbox(checkedValue, uncheckedValue)
تضبط قاعدة التحقّق من صحة البيانات لتطلب أن تكون الإدخال إحدى القيم المحدّدة. عندما يكون
الإدخال هو checked
، يتم عرض الخلية على أنّها مربّع اختيار تم وضع علامة فيه. عندما يكون
الإدخال هو unchecked
، يتم عرض الخلية على أنّها مربّع اختيار لم تتم إزالة علامته.
// 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);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
checked | Object | القيمة المحدّدة لمربّع اختيار تم وضع علامة فيه. |
unchecked | Object | القيمة المحدّدة لمربّع غير محدَّد |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Date()
ضبط قاعدة التحقّق من صحة البيانات لطلب إدخال تاريخ
// 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);
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Date After(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 | آخر تاريخ غير مقبول. |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Date Before(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 | أقرب تاريخ غير مقبول. |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Date Between(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 | آخر تاريخ مقبول. |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Date Equal To(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 | التاريخ الوحيد المقبول |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Date Not Between(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 | آخر تاريخ غير مقبول. |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Date On Or After(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 | أقرب تاريخ مقبول. |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Date On Or Before(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 | آخر تاريخ مقبول. |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Formula Satisfied(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 إذا كان الإدخال صالحًا. |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Number Between(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 | أعلى قيمة مقبولة. |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Number Equal To(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 | القيمة الوحيدة المقبولة. |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Number Greater Than(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 | أعلى قيمة غير مقبولة. |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Number Greater Than Or Equal To(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 | أدنى قيمة مقبولة. |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Number Less Than(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 | أدنى قيمة غير مقبولة. |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Number Less Than Or Equal To(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 | أعلى قيمة مقبولة. |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Number Not Between(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 | أعلى قيمة غير مقبولة. |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Number Not Equal To(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 | القيمة الوحيدة غير المقبولة. |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Text Contains(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 | القيمة التي يجب أن يحتوي عليها الإدخال |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Text Does Not Contain(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 | القيمة التي يجب ألا يحتوي عليها الإدخال |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Text Equal To(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 | القيمة الوحيدة المقبولة. |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Text Is Email()
تضبط قاعدة التحقّق من صحة البيانات لتطلب أن يكون الإدخال في شكل عنوان بريد إلكتروني.
// 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);
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Text Is Url()
تضبط قاعدة التحقّق من البيانات لتطلب أن يكون الإدخال في شكل عنوان 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);
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Value In List(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[] | صفيف من القيم المقبولة |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Value In List(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[] | صفيف من القيم المقبولة |
show | Boolean | true إذا كان يجب أن يعرض جدول البيانات قائمة منسدلة للقيم
false إذا لم يكن الأمر كذلك |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Value In Range(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 | نطاق يحتوي على القيم المقبولة |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
require Value In Range(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 | نطاق يحتوي على القيم المقبولة |
show | Boolean | true إذا كان يجب أن يعرض جدول البيانات قائمة منسدلة للقيم
false إذا لم يكن الأمر كذلك |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
set Allow Invalid(allowInvalidData)
لتحديد ما إذا كان سيتم عرض تحذير عندما يتعذّر إثبات صحة الإدخال أو رفض الإدخال
تمامًا. الإعداد التلقائي لقواعد التحقّق من صحة البيانات الجديدة هو true
.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
allow | Boolean | true إذا كان يجب أن تسمح القاعدة بإدخال بيانات لا تجتاز عملية التحقّق من البيانات
false إذا لم يكن الأمر كذلك |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
set Help Text(helpText)
لضبط نص المساعدة الذي يظهر عندما يمرِّر المستخدم مؤشّر الماوس فوق الخلية التي تم ضبط ميزة التحقّق من البيانات عليها
المعلمات
الاسم | النوع | الوصف |
---|---|---|
help | String | نص المساعدة المطلوب ضبطه |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر
with Criteria(criteria, args)
تضبط قاعدة التحقّق من صحة البيانات على معايير محدّدة بواسطة قيم Data
،
يتم عادةً أخذها من 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 | Data | نوع معايير التحقّق من صحة البيانات. |
args | Object[] | صفيف من الوسائط المناسبة لنوع المعايير، وعدد الوسائط
ونوعها يتطابقان مع طريقة require...() المقابلة أعلاه. |
الإرجاع
Data
— هذا المُنشئ، لتسلسل العناصر