سازنده قوانین اعتبارسنجی داده ها.
// 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 Validation | یک قانون اعتبارسنجی داده را از تنظیمات اعمال شده برای سازنده می سازد. |
copy() | Data Validation Builder | بر اساس تنظیمات این قانون یک سازنده برای یک قانون اعتبارسنجی داده ایجاد می کند. |
get Allow Invalid() | Boolean | در صورتی که این قانون یک هشدار را در زمانی که ورودی اعتبارسنجی داده را با شکست مواجه میکند، نشان میدهد، یا اگر ورودی را به طور کامل رد کند، true false . |
get Criteria Type() | Data ValidationCriteria | نوع معیار قانون را همانطور که در فهرست Data ValidationCriteria تعریف شده است دریافت می کند. |
get Criteria Values() | Object[] | آرایه ای از آرگومان ها را برای معیارهای قاعده دریافت می کند. |
get Help Text() | String | متن راهنمای قانون را دریافت می کند، یا اگر متن راهنما تنظیم نشده باشد، null . |
require Checkbox() | Data Validation Builder | قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی یک مقدار بولی باشد. این مقدار به عنوان یک چک باکس ارائه می شود. |
require Checkbox(checkedValue) | Data Validation Builder | قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی مقدار مشخص شده یا خالی باشد. |
require Checkbox(checkedValue, uncheckedValue) | Data Validation Builder | قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی یکی از مقادیر مشخص شده باشد. |
require Date() | Data Validation Builder | قانون اعتبارسنجی داده ها را به گونه ای تنظیم می کند که به تاریخ نیاز دارد. |
require DateAfter(date) | Data Validation Builder | قانون اعتبارسنجی داده را طوری تنظیم می کند که تاریخ بعد از مقدار داده شده را بخواهد. |
require DateBefore(date) | Data Validation Builder | قانون اعتبارسنجی داده را طوری تنظیم می کند که تاریخ قبل از مقدار داده شده را بخواهد. |
require DateBetween(start, end) | Data Validation Builder | قانون اعتبارسنجی داده ها را به گونه ای تنظیم می کند که تاریخی بین دو تاریخ مشخص شده یا یکی از آنها باشد. |
require DateEqualTo(date) | Data Validation Builder | قانون اعتبارسنجی داده ها را طوری تنظیم می کند که به تاریخی برابر با مقدار داده شده نیاز دارد. |
require DateNotBetween(start, end) | Data Validation Builder | قانون اعتبارسنجی داده ها را به گونه ای تنظیم می کند که به تاریخی نیاز دارد که بین دو تاریخ مشخص قرار نگیرد و هیچ کدام از آنها نباشد. |
require DateOnOrAfter(date) | Data Validation Builder | قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که تاریخ روی یا بعد از مقدار داده شده را بخواهد. |
require DateOnOrBefore(date) | Data Validation Builder | قانون اعتبارسنجی داده ها را طوری تنظیم می کند که تاریخ را روی مقدار داده شده یا قبل از آن نیاز دارد. |
require Formula Satisfied(formula) | Data Validation Builder | قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که فرمول داده شده را به true ارزیابی کند. |
require Number Between(start, end) | Data Validation Builder | قانون اعتبارسنجی داده ها را به گونه ای تنظیم می کند که به عددی نیاز دارد که بین دو عدد مشخص قرار می گیرد یا یکی از آنها باشد. |
require Number Equal To(number) | Data Validation Builder | قانون اعتبارسنجی داده را طوری تنظیم می کند که به عددی برابر با مقدار داده شده نیاز داشته باشد. |
require Number Greater Than(number) | Data Validation Builder | قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که به عددی بیشتر از مقدار داده شده نیاز دارد. |
require Number Greater ThanOrEqualTo(number) | Data Validation Builder | قانون اعتبارسنجی داده را طوری تنظیم می کند که به عددی بزرگتر یا مساوی با مقدار داده شده نیاز داشته باشد. |
require Number Less Than(number) | Data Validation Builder | قانون اعتبارسنجی داده را طوری تنظیم می کند که به عددی کمتر از مقدار داده شده نیاز داشته باشد. |
require Number Less ThanOrEqualTo(number) | Data Validation Builder | قانون اعتبارسنجی داده را طوری تنظیم می کند که به عددی کمتر یا مساوی با مقدار داده شده نیاز داشته باشد. |
require Number Not Between(start, end) | Data Validation Builder | قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که به عددی نیاز داشته باشد که بین دو عدد مشخص قرار نگیرد و هیچ کدام از آن ها نباشد. |
require Number Not Equal To(number) | Data Validation Builder | قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که به عددی نیاز داشته باشد که با مقدار داده شده برابر نباشد. |
require Text Contains(text) | Data Validation Builder | قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی حاوی مقدار داده شده باشد. |
require Text Does Not Contain(text) | Data Validation Builder | قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی حاوی مقدار داده شده نباشد. |
require Text Equal To(text) | Data Validation Builder | قانون اعتبارسنجی داده ها را به گونه ای تنظیم می کند که ورودی برابر با مقدار داده شده باشد. |
require Text Is Email() | Data Validation Builder | قانون اعتبارسنجی داده ها را به گونه ای تنظیم می کند که ورودی به شکل آدرس ایمیل باشد. |
require Text Is Url() | Data Validation Builder | قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی به شکل URL باشد. |
require Value In List(values) | Data Validation Builder | قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی برابر با یکی از مقادیر داده شده باشد. |
require Value In List(values, showDropdown) | Data Validation Builder | قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی برابر با یکی از مقادیر داده شده باشد، با گزینه ای برای پنهان کردن منوی کشویی. |
require Value In Range(range) | Data Validation Builder | قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی برابر با مقداری در محدوده داده شده باشد. |
require Value In Range(range, showDropdown) | Data Validation Builder | قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی با یک مقدار در محدوده داده شده برابر باشد، با گزینه ای برای پنهان کردن منوی کشویی. |
set Allow Invalid(allowInvalidData) | Data Validation Builder | تنظیم می کند که آیا در صورت عدم موفقیت ورودی اعتبارسنجی داده ها، هشدار نشان داده شود یا اینکه ورودی به طور کامل رد شود. |
set Help Text(helpText) | Data Validation Builder | متن راهنما را تنظیم می کند که وقتی کاربر روی سلولی که اعتبار داده روی آن تنظیم شده است نشان داده می شود. |
with Criteria(criteria, args) | Data Validation Builder | قانون اعتبار سنجی داده ها را بر روی معیارهای تعریف شده توسط مقادیر Data ValidationCriteria تنظیم می کند که معمولاً از criteria و arguments یک قانون موجود گرفته می شود. |
مستندات دقیق
build()
یک قانون اعتبارسنجی داده را از تنظیمات اعمال شده برای سازنده می سازد.
بازگشت
Data Validation
- نمایشی از قانون اعتبارسنجی داده ها
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 Validation Builder
- سازنده ای بر اساس تنظیمات این قانون
get Allow Invalid()
در صورتی که این قانون یک هشدار را در زمانی که ورودی اعتبارسنجی داده را با شکست مواجه میکند، نشان میدهد، یا اگر ورودی را به طور کامل رد کند، true
false
. پیشفرض قوانین اعتبارسنجی داده جدید true
است.
بازگشت
Boolean
- true
اگر قانون اجازه ورودیهایی را بدهد که اعتبارسنجی دادهها ناموفق باشد. false
اگر نه
get Criteria Type()
نوع معیار قانون را همانطور که در فهرست Data ValidationCriteria
تعریف شده است دریافت می کند. برای بدست آوردن آرگومان های معیارها، get Criteria Values()
استفاده کنید. برای استفاده از این مقادیر برای ایجاد یا اصلاح یک قانون اعتبارسنجی داده، with Criteria(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.'); }
بازگشت
Data ValidationCriteria
- نوع معیارهای اعتبارسنجی داده ها
get Criteria Values()
آرایه ای از آرگومان ها را برای معیارهای قاعده دریافت می کند. برای دریافت نوع معیار، get Criteria Type()
استفاده کنید. برای استفاده از این مقادیر برای ایجاد یا اصلاح یک قانون اعتبارسنجی داده، with Criteria(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...()
کلاس Data Validation Builder
مطابقت دارد
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 Validation Builder
- این سازنده، برای زنجیره زدن
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 Value | Object | مقدار اختصاص داده شده به یک کادر علامت دار. |
بازگشت
Data Validation Builder
- این سازنده، برای زنجیره زدن
require Checkbox(checkedValue, uncheckedValue)
قانون اعتبارسنجی داده را به گونه ای تنظیم می کند که ورودی یکی از مقادیر مشخص شده باشد. وقتی checked Value
سلول بهعنوان یک چک باکس علامتدار نمایش داده میشود. وقتی علامت ورودی unchecked Value
سلول به عنوان یک چک باکس بدون علامت نمایش داده می شود.
// 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 Value | Object | مقدار اختصاص داده شده به یک کادر علامت دار. |
unchecked Value | Object | مقدار اختصاص داده شده به یک کادر بدون علامت. |
بازگشت
Data Validation Builder
- این سازنده، برای زنجیره زدن
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 Validation Builder
- این سازنده، برای زنجیره زدن
require DateAfter(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 Validation Builder
- این سازنده، برای زنجیره زدن
require DateBefore(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 Validation Builder
- این سازنده، برای زنجیره زدن
require DateBetween(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 Validation Builder
- این سازنده، برای زنجیره زدن
require DateEqualTo(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 Validation Builder
- این سازنده، برای زنجیره زدن
require DateNotBetween(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 Validation Builder
- این سازنده، برای زنجیره زدن
require DateOnOrAfter(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 Validation Builder
- این سازنده، برای زنجیره زدن
require DateOnOrBefore(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 Validation Builder
- این سازنده، برای زنجیره زدن
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 Validation Builder
- این سازنده، برای زنجیره زدن
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 Validation Builder
- این سازنده، برای زنجیره زدن
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 Validation Builder
- این سازنده، برای زنجیره زدن
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 Validation Builder
- این سازنده، برای زنجیره زدن
require Number Greater ThanOrEqualTo(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 Validation Builder
- این سازنده، برای زنجیره زدن
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 Validation Builder
- این سازنده، برای زنجیره زدن
require Number Less ThanOrEqualTo(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 Validation Builder
- این سازنده، برای زنجیره زدن
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 Validation Builder
- این سازنده، برای زنجیره زدن
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 Validation Builder
- این سازنده، برای زنجیره زدن
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 Validation Builder
- این سازنده، برای زنجیره زدن
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 Validation Builder
- این سازنده، برای زنجیره زدن
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 Validation Builder
- این سازنده، برای زنجیره زدن
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 Validation Builder
- این سازنده، برای زنجیره زدن
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 Validation Builder
- این سازنده، برای زنجیره زدن
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 Validation Builder
- این سازنده، برای زنجیره زدن
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 Dropdown | Boolean | true اگر صفحه گسترده باید یک منوی کشویی برای مقادیر نشان دهد. false اگر نه |
بازگشت
Data Validation Builder
- این سازنده، برای زنجیره زدن
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 Validation Builder
- این سازنده، برای زنجیره زدن
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 Dropdown | Boolean | true اگر صفحه گسترده باید یک منوی کشویی برای مقادیر نشان دهد. false اگر نه |
بازگشت
Data Validation Builder
- این سازنده، برای زنجیره زدن
set Allow Invalid(allowInvalidData)
تنظیم می کند که آیا در صورت عدم موفقیت ورودی اعتبارسنجی داده ها، هشدار نشان داده شود یا اینکه ورودی به طور کامل رد شود. پیشفرض قوانین اعتبارسنجی داده جدید true
است.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
allow Invalid Data | Boolean | true اگر قانون باید ورودی هایی را مجاز کند که اعتبار سنجی داده ها را با شکست مواجه می کند. false اگر نه |
بازگشت
Data Validation Builder
- این سازنده، برای زنجیره زدن
set Help Text(helpText)
متن راهنما را تنظیم می کند که وقتی کاربر روی سلولی که اعتبار داده روی آن تنظیم شده است نشان داده می شود.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
help Text | String | متن راهنما برای تنظیم. |
بازگشت
Data Validation Builder
- این سازنده، برای زنجیره زدن
with Criteria(criteria, args)
قانون اعتبار سنجی داده ها را بر روی معیارهای تعریف شده توسط مقادیر Data ValidationCriteria
تنظیم می کند که معمولاً از 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 ValidationCriteria | نوع معیار اعتبار سنجی داده ها. |
args | Object[] | آرایه ای از آرگومان های متناسب با نوع معیار؛ تعداد آرگومانها و نوع آنها با متد require...() بالا مطابقت دارد. |
بازگشت
Data Validation Builder
- این سازنده، برای زنجیره زدن