Es un compilador para reglas de validación de datos.
// 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);
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
build() | DataValidation | Construye una regla de validación de datos a partir de la configuración aplicada al compilador. |
copy() | DataValidationBuilder | Crea un compilador para una regla de validación de datos basada en la configuración de esta regla. |
getAllowInvalid() | Boolean | Muestra true si la regla muestra una advertencia cuando la entrada falla en la validación 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 array de argumentos para los criterios de la regla. |
getHelpText() | String | Obtiene el texto de ayuda de la regla o null si no se configuró un texto de ayuda. |
requireCheckbox() | DataValidationBuilder | Establece la regla de validación de datos de modo que exija que la entrada sea un valor booleano. este valor es se renderizan como una casilla de verificación. |
requireCheckbox(checkedValue) | DataValidationBuilder | Establece la regla de validación de datos de modo que la entrada sea el valor especificado o el espacio en blanco. |
requireCheckbox(checkedValue, uncheckedValue) | DataValidationBuilder | Establece la regla de validación de datos de modo que la entrada sea uno de los valores especificados. |
requireDate() | DataValidationBuilder | Establece la regla de validación de datos para que requiera una fecha. |
requireDateAfter(date) | DataValidationBuilder | Establece la regla de validación de datos para que requiera una fecha posterior al valor determinado. |
requireDateBefore(date) | DataValidationBuilder | Establece la regla de validación de datos para que requiera una fecha anterior al valor especificado. |
requireDateBetween(start, end) | DataValidationBuilder | Establece la regla de validación de datos para que requiera una fecha que se encuentre entre dos fechas específicas. |
requireDateEqualTo(date) | DataValidationBuilder | Configura la regla de validación de datos para que requiera una fecha igual al valor especificado. |
requireDateNotBetween(start, end) | DataValidationBuilder | Establece la regla de validación de datos para que requiera una fecha que no se encuentre en el intervalo intermedio o que no sea igual a dos fechas especificadas. |
requireDateOnOrAfter(date) | DataValidationBuilder | Establece la regla de validación de datos para que requiera una fecha igual o posterior al valor especificado. |
requireDateOnOrBefore(date) | DataValidationBuilder | Establece la regla de validación de datos para que requiera una fecha igual o anterior al valor dado. |
requireFormulaSatisfied(formula) | DataValidationBuilder | Establece la regla de validación de datos de modo que la fórmula dada se evalúe como true . |
requireNumberBetween(start, end) | DataValidationBuilder | Establece la regla de validación de datos para que requiera un número que se encuentre entre dos o uno de dos un número específico. |
requireNumberEqualTo(number) | DataValidationBuilder | Configura la regla de validación de datos de modo que requiera un número igual al valor determinado. |
requireNumberGreaterThan(number) | DataValidationBuilder | Establece la regla de validación de datos de modo que requiera un número mayor que el valor especificado. |
requireNumberGreaterThanOrEqualTo(number) | DataValidationBuilder | Configura la regla de validación de datos de modo que requiera un número mayor o igual que el valor especificado. |
requireNumberLessThan(number) | DataValidationBuilder | Establece la regla de validación de datos de modo que requiera un número menor que el valor especificado. |
requireNumberLessThanOrEqualTo(number) | DataValidationBuilder | Establece la regla de validación de datos de modo que requiera un número menor o igual que el valor especificado. |
requireNumberNotBetween(start, end) | DataValidationBuilder | Establece la regla de validación de datos de modo que requiera un número que no se encuentre entre los dos siguientes: de dos números especificados. |
requireNumberNotEqualTo(number) | DataValidationBuilder | Configura la regla de validación de datos para que requiera un número que no sea igual al valor especificado. |
requireTextContains(text) | DataValidationBuilder | Establece la regla de validación de datos de modo que la entrada contenga el valor dado. |
requireTextDoesNotContain(text) | DataValidationBuilder | Establece la regla de validación de datos de modo que la entrada no contenga el valor dado. |
requireTextEqualTo(text) | DataValidationBuilder | Establece la regla de validación de datos de modo que la entrada sea igual al valor dado. |
requireTextIsEmail() | DataValidationBuilder | Establece la regla de validación de datos de modo que se requiera que la entrada tenga el formato de una dirección de correo electrónico. |
requireTextIsUrl() | DataValidationBuilder | Establece la regla de validación de datos de modo que la entrada tenga el formato de una URL. |
requireValueInList(values) | DataValidationBuilder | Establece la regla de validación de datos de modo que se requiera que la entrada sea igual a uno de los valores especificados. |
requireValueInList(values, showDropdown) | DataValidationBuilder | Establece la regla de validación de datos para que la entrada sea igual a uno de los valores especificados. con una opción para ocultar el menú desplegable. |
requireValueInRange(range) | DataValidationBuilder | Establece la regla de validación de datos de modo que se requiera que la entrada sea igual a un valor en el rango especificado. |
requireValueInRange(range, showDropdown) | DataValidationBuilder | Establece la regla de validación de datos de modo que se requiera que la entrada sea igual a un valor en el rango dado. con una opción para ocultar el menú desplegable. |
setAllowInvalid(allowInvalidData) | DataValidationBuilder | Establece si se debe mostrar una advertencia cuando se produce un error en la validación de datos o si se debe rechazar la entrada. por completo. |
setHelpText(helpText) | DataValidationBuilder | Establece el texto de ayuda que aparece cuando el usuario coloca el cursor sobre la celda en la que se realiza la validación de datos automático. |
withCriteria(criteria, args) | DataValidationBuilder | Establece la regla de validación de datos en los criterios definidos por los valores de DataValidationCriteria .
por lo general, se toma de los criteria y arguments de una regla existente. |
Documentación detallada
build()
Construye una regla de validación de datos a partir de la configuración aplicada al compilador.
Volver
DataValidation
: Es una representación de la regla de validación de datos.
copy()
Crea un compilador para una regla de validación de datos basada en 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
: Es un compilador basado en la configuración de esta regla.
getAllowInvalid()
Muestra true
si la regla muestra una advertencia cuando la entrada falla en la validación de datos o false
si rechaza la entrada por completo. El valor predeterminado para las reglas de validación de datos nuevas es true
.
Volver
Boolean
: true
si la regla permite una entrada que falla en la validación de datos false
si no es así
getCriteriaType()
Obtiene el tipo de criterios de la regla como se define en la enumeración DataValidationCriteria
. Para obtener la
los argumentos de los criterios, usa getCriteriaValues()
. Utilizar estos valores para crear o
modificar una regla de validación de datos, consulta 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 array 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 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. la cantidad 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 configuró un texto de ayuda.
Volver
String
: Es el texto de ayuda de la regla o null
si no se estableció un texto de ayuda.
requireCheckbox()
Establece la regla de validación de datos de modo que exija que la entrada sea un valor booleano. este valor es se renderizan como una casilla de verificación.
// 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);
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireCheckbox(checkedValue)
Establece la regla de validación de datos de modo que la entrada sea el valor especificado o el espacio en blanco. Cuándo Si la entrada coincide con el valor especificado, la celda se renderiza como una casilla de verificación marcada. Cuando la entrada esté en blanco, la celda se renderizará como una casilla de verificación desmarcada.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
checkedValue | Object | Es el valor asignado a una casilla marcada. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireCheckbox(checkedValue, uncheckedValue)
Establece la regla de validación de datos de modo que la entrada sea uno de los valores especificados. Cuándo
el valor de entrada es checkedValue
y la celda se renderiza como una casilla de verificación marcada. Cuando
entrada es uncheckedValue
; la celda se renderiza como una casilla de verificación desmarcada.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
checkedValue | Object | Es el valor asignado a una casilla marcada. |
uncheckedValue | Object | El valor asignado a una casilla desmarcada. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireDate()
Establece la regla de validación de datos para que requiera una fecha.
// 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);
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireDateAfter(date)
Establece la regla de validación de datos para que requiera una fecha posterior al valor determinado. Los campos temporales de la
Se ignora el objeto Date
. solo se usan los campos día, mes y año.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
date | Date | La fecha inaceptable más reciente. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireDateBefore(date)
Establece la regla de validación de datos para que requiera una fecha anterior al valor especificado. Los campos temporales de la
Se ignora el objeto Date
. solo se usan los campos día, mes y año.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
date | Date | La fecha más antigua inaceptable |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireDateBetween(start, end)
Establece la regla de validación de datos para que requiera una fecha que se encuentre entre dos
fechas específicas. Se ignoran los campos de hora de los objetos Date
. solo el día, el mes
y Año.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
start | Date | La fecha aceptable más antigua. |
end | Date | La fecha aceptable más reciente. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireDateEqualTo(date)
Configura la regla de validación de datos para que requiera una fecha igual al valor especificado. Los campos temporales de
se ignoran el objeto Date
. solo se usan los campos día, mes y año.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
date | Date | La única fecha aceptable |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireDateNotBetween(start, end)
Establece la regla de validación de datos para que requiera una fecha que no se encuentre en el intervalo intermedio o que no sea igual a
dos fechas especificadas. Se ignoran los campos de hora de los objetos Date
. solo el día,
mes y año.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
start | Date | La fecha más antigua inaceptable |
end | Date | La fecha inaceptable más reciente. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireDateOnOrAfter(date)
Establece la regla de validación de datos para que requiera una fecha igual o posterior al valor especificado. Los campos temporales de
se ignoran el objeto Date
. solo se usan los campos día, mes y año.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
date | Date | La fecha aceptable más antigua. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireDateOnOrBefore(date)
Establece la regla de validación de datos para que requiera una fecha igual o anterior al valor dado. Los campos de hora
del objeto Date
se ignoran. solo se usan los campos día, mes y año.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
date | Date | La fecha aceptable más reciente. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireFormulaSatisfied(formula)
Establece la regla de validación de datos de modo que la fórmula dada se evalúe como 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
formula | String | Es una fórmula personalizada que se evalúa como true si la entrada es válida. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireNumberBetween(start, end)
Establece la regla de validación de datos para que requiera un número que se encuentre entre dos o uno de dos un número específico.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
start | Number | Es el valor aceptable más bajo. |
end | Number | Es el valor aceptable más alto. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireNumberEqualTo(number)
Configura la regla de validación de datos de modo que requiera un número igual al valor determinado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
number | Number | Es el único valor aceptable. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireNumberGreaterThan(number)
Establece la regla de validación de datos de modo que requiera un número mayor que el valor especificado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
number | Number | Es el valor inaceptable más alto. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireNumberGreaterThanOrEqualTo(number)
Configura la regla de validación de datos de modo que requiera un número mayor o igual que el valor especificado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
number | Number | Es el valor aceptable más bajo. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireNumberLessThan(number)
Establece la regla de validación de datos de modo que requiera un número menor que el valor especificado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
number | Number | Es el valor inaceptable más bajo. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireNumberLessThanOrEqualTo(number)
Establece la regla de validación de datos de modo que requiera un número menor o igual que el valor especificado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
number | Number | Es el valor aceptable más alto. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireNumberNotBetween(start, end)
Establece la regla de validación de datos de modo que requiera un número que no se encuentre entre los dos siguientes: de dos números especificados.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
start | Number | Es el valor inaceptable más bajo. |
end | Number | Es el valor inaceptable más alto. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireNumberNotEqualTo(number)
Configura la regla de validación de datos para que requiera un número que no sea igual al valor especificado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
number | Number | El único valor inaceptable. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireTextContains(text)
Establece la regla de validación de datos de modo que la entrada contenga el valor dado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
text | String | Es el valor que debe contener la entrada. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireTextDoesNotContain(text)
Establece la regla de validación de datos de modo que la entrada no contenga el valor dado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
text | String | Es el valor que no debe contener la entrada. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireTextEqualTo(text)
Establece la regla de validación de datos de modo que la entrada sea igual al valor dado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
text | String | Es el único valor aceptable. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireTextIsEmail()
Establece la regla de validación de datos de modo que se requiera que la entrada tenga el formato de una dirección de correo electrónico.
// 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);
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireTextIsUrl()
Establece la regla de validación de datos de modo que la entrada tenga el formato de una 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);
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireValueInList(values)
Establece la regla de validación de datos de modo que se requiera que la entrada sea igual a uno de los valores especificados.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
values | String[] | Es un array de valores aceptables. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireValueInList(values, showDropdown)
Establece la regla de validación de datos para que la entrada sea igual a uno de los valores especificados. con una opción para ocultar el menú desplegable.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
values | String[] | Es un array de valores aceptables. |
showDropdown | Boolean | true si la hoja de cálculo debe mostrar un menú desplegable para los valores;
false si no es así. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireValueInRange(range)
Establece la regla de validación de datos de modo que se requiera que la entrada sea igual a un valor en el rango especificado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
range | Range | Un rango que contiene los valores aceptables. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
requireValueInRange(range, showDropdown)
Establece la regla de validación de datos de modo que se requiera que la entrada sea igual a un valor en el rango dado. con una opción para ocultar el menú desplegable.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
range | Range | Un rango que contiene los valores aceptables. |
showDropdown | Boolean | true si la hoja de cálculo debe mostrar un menú desplegable para los valores;
false si no es así. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
setAllowInvalid(allowInvalidData)
Establece si se debe mostrar una advertencia cuando se produce un error en la validación de datos o si se debe rechazar la entrada.
por completo. El valor predeterminado para las reglas de validación de datos nuevas es true
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
allowInvalidData | Boolean | Es true si la regla debe permitir entradas que fallen en la validación de datos.
false si no es así. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
setHelpText(helpText)
Establece el texto de ayuda que aparece cuando el usuario coloca el cursor sobre la celda en la que se realiza la validación de datos automático.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
helpText | String | Texto de ayuda que se configurará. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.
withCriteria(criteria, args)
Establece la regla de validación de datos en los criterios definidos por los valores de DataValidationCriteria
.
por lo general, se toma de los criteria
y arguments
de una regla existente.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
criteria | DataValidationCriteria | El tipo de criterio de validación de datos. |
args | Object[] | Un array de argumentos apropiados para el tipo de criterios. la cantidad de argumentos y
su tipo coincide con el método require...() correspondiente anterior. |
Volver
DataValidationBuilder
: Este compilador se usa para encadenamiento.