Accede a las reglas de validación de datos. Para crear una regla nueva, usa SpreadsheetApp.newDataValidation()
y DataValidationBuilder
. Puedes usar Range.setDataValidation(rule)
a fin de establecer la regla de validación para un rango.
// 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.') }
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
copy() | DataValidationBuilder | Crea un compilador para una regla de validación de datos según la configuración de esta regla. |
getAllowInvalid() | Boolean | Muestra true si la regla muestra una advertencia cuando falla la entrada de datos o false si rechaza la entrada por completo. |
getCriteriaType() | DataValidationCriteria | Obtiene el tipo de criterios de la regla como se define en la enumeración DataValidationCriteria . |
getCriteriaValues() | Object[] | Obtiene un arreglo de argumentos para los criterios de la regla. |
getHelpText() | String | Obtiene el texto de ayuda de la regla o null si no se establece ningún texto de ayuda. |
Documentación detallada
copy()
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
getAllowInvalid()
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
getCriteriaType()
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.
getCriteriaValues()
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
.
getHelpText()
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