Class DataValidationBuilder

اعتبار سنجی داده ها

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

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