Class DataValidationBuilder

DataValidationBuilder

سازنده قوانین اعتبارسنجی داده ها.

// 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 - این سازنده، برای زنجیره زدن