أداة إنشاء قواعد التحقّق من صحة البيانات
// Set the data validation for cell A1 to require a value from B1:B10. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var 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. var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')]; var newDates = [new Date('1/1/2014'), new Date('12/31/2014')]; var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns()); var rules = range.getDataValidations(); for (var i = 0; i < rules.length; i++) { for (var j = 0; j < rules[i].length; j++) { var rule = rules[i][j]; if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN && args[0].getTime() == oldDates[0].getTime() && args[1].getTime() == oldDates[1].getTime()) { // Create a builder from the existing rule, then change the dates. rules[i][j] = rule.copy().withCriteria(criteria, newDates).build(); } } } } range.setDataValidations(rules);
الإرجاع
DataValidationBuilder
- أداة إنشاء تستند إلى إعدادات هذه القاعدة
getAllowInvalid()
تعرض القاعدة true
إذا كانت القاعدة تعرض تحذيرًا عندما يتعذّر على الإدخال التحقُّق من صحة البيانات، أو تعرض false
إذا رفضت القاعدة المُدخلة تمامًا. الإعداد التلقائي لقواعد التحقّق من صحة البيانات الجديدة هو true
.
الإرجاع
Boolean
— true
إذا كانت القاعدة تسمح بالإدخال الذي يتعذّر التحقّق من صحة البيانات false
إن لم يكن
getCriteriaType()
يتم الحصول على نوع معايير القاعدة كما هو محدّد في التعداد DataValidationCriteria
. للحصول على
وسيطات للمعايير، استخدم getCriteriaValues()
. لاستخدام هذه القيم لإنشاء أو
لتعديل قاعدة التحقّق من صحة البيانات، يُرجى الاطّلاع على withCriteria(criteria, args)
.
// Log information about the data validation rule for cell A1. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = cell.getDataValidation(); if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); Logger.log('The data validation rule is %s %s', criteria, args); } else { Logger.log('The cell does not have a data validation rule.') }
الإرجاع
DataValidationCriteria
- نوع معايير التحقق من صحة البيانات
getCriteriaValues()
للحصول على مصفوفة من الوسيطات لمعايير القاعدة. للحصول على نوع المعايير، استخدِم getCriteriaType()
. لاستخدام هذه القيم لإنشاء قاعدة التحقّق من البيانات أو تعديلها، يُرجى الاطّلاع على withCriteria(criteria, args)
.
// Log information about the data validation rule for cell A1. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = cell.getDataValidation(); if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); Logger.log('The data validation rule is %s %s', criteria, args); } else { Logger.log('The cell does not have a data validation rule.') }
الإرجاع
Object[]
: مصفوفة من الوسيطات المناسبة لنوع معايير القاعدة. عدد الوسيطات
ويتطابق نوعها مع طريقة require...()
المقابلة لفئة DataValidationBuilder
.
getHelpText()
الحصول على نص مساعدة القاعدة، أو null
في حال عدم ضبط نص مساعدة.
الإرجاع
String
: نص مساعدة القاعدة أو null
في حال عدم ضبط نص مساعدة
requireCheckbox()
لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب أن يكون الإدخال قيمة منطقية؛ هذه القيمة هي المعروض كمربع اختيار.
// Set the data validation for cell A1 to require a boolean value; the value is rendered as a // checkbox. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireCheckbox().build(); cell.setDataValidation(rule);
الإرجاع
DataValidationBuilder
— أداة الإنشاء هذه، للسلاسل
requireCheckbox(checkedValue)
تحدِّد هذه السياسة قاعدة التحقّق من صحة البيانات بحيث تتطلب أن يكون الإدخال فارغًا أو قيمة محدَّدة. فعندما يتطابق الإدخال مع القيمة المحددة التي يتم عرض الخلية كمربع اختيار محدد. عندما المدخل فارغ، يتم عرض الخلية كمربع اختيار غير محدد.
// Set the data validation for cell A1 to require a custom checked value that is rendered as a // checkbox. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build(); cell.setDataValidation(rule);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
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. var cell = SpreadsheetApp.getActive().getRange('A1'); var 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. var cell = SpreadsheetApp.getActive().getRange('A1'); var 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. var cell = SpreadsheetApp.getActive().getRange('A1'); var 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. var cell = SpreadsheetApp.getActive().getRange('A1'); var 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. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013')).build(); cell.setDataValidation(rule);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
start | Date | أقرب تاريخ مقبول. |
end | Date | آخر تاريخ مقبول |
الإرجاع
DataValidationBuilder
— أداة الإنشاء هذه، للسلاسل
requireDateEqualTo(date)
لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب تاريخًا مساويًا للقيمة المحددة. حقول الوقت في
ويتم تجاهل الكائن Date
؛ استخدام حقول اليوم والشهر والسنة فقط.
// Set the data validation for cell A1 to require a date equal to January 1, 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireDateEqualTo(new Date('1/1/2013')) .build(); cell.setDataValidation(rule);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
date | Date | تمثّل هذه السمة التاريخ الوحيد المقبول. |
الإرجاع
DataValidationBuilder
— أداة الإنشاء هذه، للسلاسل
requireDateNotBetween(start, end)
لتعيين قاعدة التحقق من صحة البيانات بحيث تتطلب تاريخًا لا يقع بين - وليس تاريخًا
تاريخين محددين. يتم تجاهل الحقول الزمنية لعناصر Date
، فقط اليوم،
استخدام حقلي الشهر والسنة.
// Set the data validation for cell A1 to require a date not in 2013. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation() .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013')).build(); cell.setDataValidation(rule);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
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. var cell = SpreadsheetApp.getActive().getRange('A1'); var 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. var cell = SpreadsheetApp.getActive().getRange('A1'); var 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. var cell = SpreadsheetApp.getActive().getRange('A1'); var 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. var cell = SpreadsheetApp.getActive().getRange('A1'); var 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. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberEqualTo(3.1415926536).build(); cell.setDataValidation(rule);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
number | Number | تمثّل هذه السمة القيمة الوحيدة المقبولة. |
الإرجاع
DataValidationBuilder
— أداة الإنشاء هذه، للسلاسل
requireNumberGreaterThan(number)
لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب رقمًا أكبر من القيمة المحددة.
// Set the data validation for cell A1 to require a number greater than 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build(); cell.setDataValidation(rule);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
number | Number | أعلى قيمة غير مقبولة. |
الإرجاع
DataValidationBuilder
— أداة الإنشاء هذه، للسلاسل
requireNumberGreaterThanOrEqualTo(number)
لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب رقمًا أكبر من أو يساوي القيمة المحددة.
// Set the data validation for cell A1 to require a number greater than or equal to 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThanOrEqualTo(0).build(); cell.setDataValidation(rule);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
number | Number | تمثّل هذه السمة أدنى قيمة مقبولة. |
الإرجاع
DataValidationBuilder
— أداة الإنشاء هذه، للسلاسل
requireNumberLessThan(number)
لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب رقمًا أقل من القيمة المحددة.
// Set the data validation for cell A1 to require a number less than 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build(); cell.setDataValidation(rule);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
number | Number | أدنى قيمة غير مقبولة. |
الإرجاع
DataValidationBuilder
— أداة الإنشاء هذه، للسلاسل
requireNumberLessThanOrEqualTo(number)
لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب رقم أقل من أو يساوي القيمة المقدمة.
// Set the data validation for cell A1 to require a number less than or equal to 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberLessThanOrEqualTo(0).build(); cell.setDataValidation(rule);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
number | Number | تمثّل هذه السمة أعلى قيمة مقبولة. |
الإرجاع
DataValidationBuilder
— أداة الإنشاء هذه، للسلاسل
requireNumberNotBetween(start, end)
لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب رقمًا لا يقع بينه وبين رقم عددين محددين.
// Set the data validation for cell A1 to require a number not between 1 and 10. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberNotBetween(1, 10).build(); cell.setDataValidation(rule);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
start | Number | أدنى قيمة غير مقبولة. |
end | Number | أعلى قيمة غير مقبولة. |
الإرجاع
DataValidationBuilder
— أداة الإنشاء هذه، للسلاسل
requireNumberNotEqualTo(number)
لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب رقمًا لا يساوي القيمة المحددة.
// Set the data validation for cell A1 to require a number not equal to 0. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build(); cell.setDataValidation(rule);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
number | Number | القيمة الوحيدة غير المقبولة. |
الإرجاع
DataValidationBuilder
— أداة الإنشاء هذه، للسلاسل
requireTextContains(text)
تحدِّد هذه السياسة قاعدة التحقّق من صحة البيانات بحيث تتطلب أن يحتوي الإدخال على القيمة المحدَّدة.
// Set the data validation for cell A1 to require any value that includes "Google". var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextContains('Google').build(); cell.setDataValidation(rule);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
text | String | القيمة التي يجب أن يحتوي عليها الإدخال. |
الإرجاع
DataValidationBuilder
— أداة الإنشاء هذه، للسلاسل
requireTextDoesNotContain(text)
تضبط هذه السياسة قاعدة التحقّق من صحة البيانات بحيث تتطلب ألّا يحتوي الإدخال على القيمة المحدّدة.
// Set the data validation for cell A1 to require any value that does not include "@". var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build(); cell.setDataValidation(rule);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
text | String | القيمة التي يجب ألا يحتوي عليها الإدخال. |
الإرجاع
DataValidationBuilder
— أداة الإنشاء هذه، للسلاسل
requireTextEqualTo(text)
لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب أن يكون الإدخال مساويًا للقيمة المحددة.
// Set the data validation for cell A1 to require "Yes". var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build(); cell.setDataValidation(rule);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
text | String | تمثّل هذه السمة القيمة الوحيدة المقبولة. |
الإرجاع
DataValidationBuilder
— أداة الإنشاء هذه، للسلاسل
requireTextIsEmail()
لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب أن يكون الإدخال في شكل عنوان بريد إلكتروني.
// Set the data validation for cell A1 to require text in the form of an email address. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build(); cell.setDataValidation(rule);
الإرجاع
DataValidationBuilder
— أداة الإنشاء هذه، للسلاسل
requireTextIsUrl()
تضبط هذه السياسة قاعدة التحقّق من صحة البيانات بحيث تتطلب أن يكون الإدخال في شكل عنوان URL.
// Set the data validation for cell A1 to require text in the form of a URL. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireTextIsUrl().build(); cell.setDataValidation(rule);
الإرجاع
DataValidationBuilder
— أداة الإنشاء هذه، للسلاسل
requireValueInList(values)
لضبط قاعدة التحقق من صحة البيانات بحيث تتطلب أن يكون الإدخال مساويًا لإحدى القيم المحددة.
// Set the data validation for cell A1 to require "Yes" or "No", with a dropdown menu. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No']).build(); cell.setDataValidation(rule);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
values | String[] | مصفوفة من القيم المقبولة. |
الإرجاع
DataValidationBuilder
— أداة الإنشاء هذه، للسلاسل
requireValueInList(values, showDropdown)
لتعيين قاعدة التحقق من صحة البيانات بحيث تتطلب أن يكون المُدخل يساوي إحدى القيم المحددة، مع خيار إخفاء القائمة المنسدلة.
// Set the data validation for cell A1 to require "Yes" or "No", with no dropdown menu. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No'], false).build(); cell.setDataValidation(rule);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
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. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var 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. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var 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. var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')]; var newDates = [new Date('1/1/2014'), new Date('12/31/2014')]; var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns()); var rules = range.getDataValidations(); for (var i = 0; i < rules.length; i++) { for (var j = 0; j < rules[i].length; j++) { var rule = rules[i][j]; if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN && args[0].getTime() == oldDates[0].getTime() && args[1].getTime() == oldDates[1].getTime()) { // Create a builder from the existing rule, then change the dates. rules[i][j] = rule.copy().withCriteria(criteria, newDates).build(); } } } } range.setDataValidations(rules);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
criteria | DataValidationCriteria | نوع معايير التحقق من صحة البيانات. |
args | Object[] | يشير ذلك المصطلح إلى مصفوفة من الوسيطات المناسبة لنوع المعايير. عدد الوسيطات
يتطابق نوعها مع طريقة require...() المقابلة أعلاه. |
الإرجاع
DataValidationBuilder
— أداة الإنشاء هذه، للسلاسل