Class DataValidation

Crea un compilador para una regla de validación de datos según la configuración de esta regla.

// 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);

Volver

DataValidationBuilder: un compilador basado en la configuración de esta regla

Muestra true si la regla muestra una advertencia cuando falla la entrada de datos o false si rechaza la entrada por completo. El valor predeterminado de las nuevas reglas de validación de datos es true.

Volver

Boolean: true si la regla permite la entrada que falla en la validación de datos; false si no

Obtiene el tipo de criterios de la regla como se define en la enumeración DataValidationCriteria. Para obtener los argumentos de los criterios, usa getCriteriaValues(). Si deseas usar estos valores para crear o modificar una regla de validación de datos, consulta DataValidationBuilder.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.')
}

Volver

DataValidationCriteria: Es el tipo de criterios de validación de datos.

Obtiene un arreglo de argumentos para los criterios de la regla. Para obtener el tipo de criterios, usa getCriteriaType(). Si deseas usar estos valores para crear o modificar una regla de validación de datos, consulta DataValidationBuilder.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.')
}

Volver

Object[]: Es un array de argumentos apropiados para el tipo de criterios de la regla. El número de argumentos y su tipo coinciden con el método require...() correspondiente de la clase DataValidationBuilder.

Obtiene el texto de ayuda de la regla o null si no se establece ningún texto de ayuda.

Volver

String: El texto de ayuda de la regla o null si no se establece ningún texto de ayuda