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 — этот построитель для цепочки