أداة إنشاء لقواعد التحقّق من صحة البيانات
// 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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
range | Range | نطاق يحتوي على قيم مقبولة. |
showDropdown | Boolean | true إذا كان جدول البيانات يجب أن يعرض قائمة منسدلة للقيم، أو false إذا لم يكن الأمر كذلك. |
استرجاع الكرة
DataValidationBuilder
: أداة إنشاء السلاسل
setAllowInvalid(allowInvalidData)
تحدد ما إذا كان سيتم عرض تحذير عندما يفشل الإدخال في التحقق من صحة البيانات أو ما إذا كان سيتم رفض الإدخال
تمامًا. الإعداد التلقائي لقواعد التحقق من صحة البيانات الجديدة هو true
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
allowInvalidData | Boolean | true إذا كان يجب أن تسمح القاعدة بإدخال يؤدي إلى تعذُّر التحقق من صحة البيانات، وfalse إذا لم يكن كذلك. |
استرجاع الكرة
DataValidationBuilder
: أداة إنشاء السلاسل
setHelpText(helpText)
لتعيين نص المساعدة الذي يظهر عندما يمرر المستخدم فوق الخلية التي تم تعيين التحقق من صحة البيانات عليها.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
criteria | DataValidationCriteria | يشير ذلك المصطلح إلى نوع معايير التحقّق من صحة البيانات. |
args | Object[] | تمثّل هذه السمة مصفوفة من الوسيطات المناسبة لنوع المعايير ويتطابق عدد الوسيطات ونوعها مع طريقة require...() المقابلة أعلاه. |
استرجاع الكرة
DataValidationBuilder
: أداة إنشاء السلاسل