Strumento per la creazione di regole di convalida dei dati.
// 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);
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
build() | DataValidation | Crea una regola di convalida dei dati dalle impostazioni applicate al generatore. |
copy() | DataValidationBuilder | Crea un builder per una regola di convalida dei dati basata sulle impostazioni di questa regola. |
getAllowInvalid() | Boolean | Restituisce true se la regola mostra un avviso quando l'input non riesce a convalidare i dati o false se rifiuta completamente l'input. |
getCriteriaType() | DataValidationCriteria | Restituisce il tipo di criteri della regola come definito nell'enumerazione DataValidationCriteria . |
getCriteriaValues() | Object[] | Restituisce un array di argomenti per i criteri della regola. |
getHelpText() | String | Recupera il testo della guida della regola o null se non è impostato alcun testo della guida. |
requireCheckbox() | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che l'input sia un valore booleano. questo valore è visualizzato come una casella di controllo. |
requireCheckbox(checkedValue) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che l'input corrisponda al valore specificato o sia vuoto. |
requireCheckbox(checkedValue, uncheckedValue) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che l'input corrisponda a uno dei valori specificati. |
requireDate() | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che richieda una data. |
requireDateAfter(date) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che richieda una data successiva al valore specificato. |
requireDateBefore(date) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che richieda una data prima del valore specificato. |
requireDateBetween(start, end) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che richieda una data compresa tra due o due intervalli date specificate. |
requireDateEqualTo(date) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che richieda una data uguale al valore specificato. |
requireDateNotBetween(start, end) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che richieda una data che non rientri tra e nessuna data due date specificate. |
requireDateOnOrAfter(date) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che richieda una data corrispondente o successiva al valore specificato. |
requireDateOnOrBefore(date) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che venga richiesta una data corrispondente o precedente al valore specificato. |
requireFormulaSatisfied(formula) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che la formula specificata restituisca true . |
requireNumberBetween(start, end) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che richieda un numero compreso tra due o due numeri specificati. |
requireNumberEqualTo(number) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che richieda un numero uguale al valore specificato. |
requireNumberGreaterThan(number) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che richieda un numero maggiore rispetto al valore specificato. |
requireNumberGreaterThanOrEqualTo(number) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che richieda un numero maggiore o uguale al valore specificato. |
requireNumberLessThan(number) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che richieda un numero inferiore al valore specificato. |
requireNumberLessThanOrEqualTo(number) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che richieda un numero inferiore o uguale al valore specificato. |
requireNumberNotBetween(start, end) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che richieda un numero che non rientri tra e che non rientri tra l'uno e l'altro due numeri specificati. |
requireNumberNotEqualTo(number) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che richieda un numero diverso da quello specificato. |
requireTextContains(text) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che l'input contenga il valore specificato. |
requireTextDoesNotContain(text) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che l'input non contenga il valore specificato. |
requireTextEqualTo(text) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che l'input sia uguale al valore specificato. |
requireTextIsEmail() | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che l'input sia sotto forma di indirizzo email. |
requireTextIsUrl() | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che l'input sia sotto forma di URL. |
requireValueInList(values) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che l'input sia uguale a uno dei valori specificati. |
requireValueInList(values, showDropdown) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che l'input sia uguale a uno dei valori specificati. con un'opzione per nascondere il menu a discesa. |
requireValueInRange(range) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che l'input sia uguale a un valore compreso nell'intervallo specificato. |
requireValueInRange(range, showDropdown) | DataValidationBuilder | Imposta la regola di convalida dei dati in modo che l'input sia uguale a un valore compreso nell'intervallo specificato con un'opzione per nascondere il menu a discesa. |
setAllowInvalid(allowInvalidData) | DataValidationBuilder | Consente di impostare se mostrare un avviso quando l'input non supera la convalida dei dati o se rifiutare l'input completamente. |
setHelpText(helpText) | DataValidationBuilder | Imposta il testo della guida che viene visualizzato quando l'utente passa il mouse sopra la cella su cui è attiva la convalida dei dati. per iniziare. |
withCriteria(criteria, args) | DataValidationBuilder | Imposta la regola di convalida dei dati sui criteri definiti dai valori DataValidationCriteria ,
generalmente ricavato dai criteria e dai arguments di una regola esistente. |
Documentazione dettagliata
build()
Crea una regola di convalida dei dati dalle impostazioni applicate al generatore.
Invio
DataValidation
: una rappresentazione della regola di convalida dei dati.
copy()
Crea un builder per una regola di convalida dei dati basata sulle impostazioni di questa regola.
// 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);
Invio
DataValidationBuilder
: uno strumento per la creazione basato sulle impostazioni di questa regola
getAllowInvalid()
Restituisce true
se la regola mostra un avviso quando l'input non riesce a convalidare i dati o false
se rifiuta completamente l'input. Il valore predefinito per le nuove regole di convalida dei dati è true
.
Invio
Boolean
- true
se la regola consente input che non superano la convalida dei dati; false
in caso contrario
getCriteriaType()
Restituisce il tipo di criteri della regola come definito nell'enumerazione DataValidationCriteria
. Per ottenere
per i criteri, utilizza getCriteriaValues()
. Per utilizzare questi valori per creare
modificare una regola di convalida dei dati, 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.') }
Invio
DataValidationCriteria
: il tipo di criteri di convalida dei dati.
getCriteriaValues()
Restituisce un array di argomenti per i criteri della regola. Per ottenere il tipo di criteri, utilizza getCriteriaType()
. Per utilizzare questi valori per creare o modificare una regola di convalida dei dati, 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.') }
Invio
Object[]
: un array di argomenti appropriati al tipo di criteri della regola; il numero di argomenti
e il loro tipo corrisponde al metodo require...()
corrispondente della classe DataValidationBuilder
getHelpText()
Recupera il testo della guida della regola o null
se non è impostato alcun testo della guida.
Invio
String
: il testo della guida della regola o null
se non è impostato alcun testo della guida
requireCheckbox()
Imposta la regola di convalida dei dati in modo che l'input sia un valore booleano. questo valore è visualizzato come una casella di controllo.
// 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);
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireCheckbox(checkedValue)
Imposta la regola di convalida dei dati in modo che l'input corrisponda al valore specificato o sia vuoto. Quando Se l'input corrisponde al valore specificato, la cella viene visualizzata come casella di controllo selezionata. Quando se l'input è vuoto, la cella viene visualizzata come una casella di controllo non selezionata.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
checkedValue | Object | Il valore assegnato a una casella di controllo. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireCheckbox(checkedValue, uncheckedValue)
Imposta la regola di convalida dei dati in modo che l'input corrisponda a uno dei valori specificati. Quando
l'input è checkedValue
; la cella viene visualizzata come una casella di controllo selezionata. Quando
l'input è uncheckedValue
, la cella viene visualizzata come una casella di controllo non selezionata.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
checkedValue | Object | Il valore assegnato a una casella di controllo. |
uncheckedValue | Object | Il valore assegnato a una casella deselezionata. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireDate()
Imposta la regola di convalida dei dati in modo che richieda una data.
// 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);
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireDateAfter(date)
Imposta la regola di convalida dei dati in modo che richieda una data successiva al valore specificato. I campi temporali del
Gli oggetti Date
vengono ignorati. vengono utilizzati solo i campi giorno, mese e anno.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | Date | L'ultima data non accettabile. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireDateBefore(date)
Imposta la regola di convalida dei dati in modo che richieda una data prima del valore specificato. I campi temporali del
Gli oggetti Date
vengono ignorati. vengono utilizzati solo i campi giorno, mese e anno.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | Date | La prima data non accettabile. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireDateBetween(start, end)
Imposta la regola di convalida dei dati in modo che richieda una data compresa tra due o due intervalli
date specificate. I campi temporali degli oggetti Date
vengono ignorati. solo il giorno, il mese
e anno.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Date | La prima data accettabile. |
end | Date | L'ultima data accettabile. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireDateEqualTo(date)
Imposta la regola di convalida dei dati in modo che richieda una data uguale al valore specificato. I campi temporali di
l'oggetto Date
viene ignorato; vengono utilizzati solo i campi giorno, mese e anno.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | Date | L'unica data accettabile. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireDateNotBetween(start, end)
Imposta la regola di convalida dei dati in modo che richieda una data che non rientri tra e nessuna data
due date specificate. I campi temporali degli oggetti Date
vengono ignorati. solo il giorno,
mese e anno.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Date | La prima data non accettabile. |
end | Date | L'ultima data non accettabile. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireDateOnOrAfter(date)
Imposta la regola di convalida dei dati in modo che venga richiesta una data corrispondente o successiva al valore specificato. I campi temporali di
l'oggetto Date
viene ignorato; vengono utilizzati solo i campi giorno, mese e anno.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | Date | La prima data accettabile. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireDateOnOrBefore(date)
Imposta la regola di convalida dei dati in modo che venga richiesta una data corrispondente o precedente al valore specificato. I campi temporali
dell'oggetto Date
vengono ignorati; vengono utilizzati solo i campi giorno, mese e anno.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | Date | L'ultima data accettabile. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireFormulaSatisfied(formula)
Imposta la regola di convalida dei dati in modo che la formula specificata restituisca 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
formula | String | Una formula personalizzata che restituisce true se l'input è valido. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireNumberBetween(start, end)
Imposta la regola di convalida dei dati in modo che richieda un numero compreso tra due o due numeri specificati.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Number | Il valore accettabile più basso. |
end | Number | Il valore accettabile più alto. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireNumberEqualTo(number)
Imposta la regola di convalida dei dati in modo che richieda un numero uguale al valore specificato.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Number | L'unico valore accettabile. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireNumberGreaterThan(number)
Imposta la regola di convalida dei dati in modo che richieda un numero maggiore rispetto al valore specificato.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Number | Il valore non accettabile più alto. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireNumberGreaterThanOrEqualTo(number)
Imposta la regola di convalida dei dati in modo che richieda un numero maggiore o uguale al valore specificato.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Number | Il valore accettabile più basso. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireNumberLessThan(number)
Imposta la regola di convalida dei dati in modo che richieda un numero inferiore al valore specificato.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Number | Il valore non accettabile più basso. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireNumberLessThanOrEqualTo(number)
Imposta la regola di convalida dei dati in modo che richieda un numero inferiore o uguale al valore specificato.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Number | Il valore accettabile più alto. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireNumberNotBetween(start, end)
Imposta la regola di convalida dei dati in modo che richieda un numero che non rientri tra e che non rientri tra l'uno e l'altro due numeri specificati.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Number | Il valore non accettabile più basso. |
end | Number | Il valore non accettabile più alto. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireNumberNotEqualTo(number)
Imposta la regola di convalida dei dati in modo che richieda un numero diverso da quello specificato.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Number | L'unico valore inaccettabile. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireTextContains(text)
Imposta la regola di convalida dei dati in modo che l'input contenga il valore specificato.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | Il valore che deve contenere l'input. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireTextDoesNotContain(text)
Imposta la regola di convalida dei dati in modo che l'input non contenga il valore specificato.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | Il valore che l'input non deve contenere. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireTextEqualTo(text)
Imposta la regola di convalida dei dati in modo che l'input sia uguale al valore specificato.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | L'unico valore accettabile. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireTextIsEmail()
Imposta la regola di convalida dei dati in modo che l'input sia sotto forma di indirizzo email.
// 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);
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireTextIsUrl()
Imposta la regola di convalida dei dati in modo che l'input sia sotto forma di 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);
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireValueInList(values)
Imposta la regola di convalida dei dati in modo che l'input sia uguale a uno dei valori specificati.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
values | String[] | Un array di valori accettabili. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireValueInList(values, showDropdown)
Imposta la regola di convalida dei dati in modo che l'input sia uguale a uno dei valori specificati. con un'opzione per nascondere il menu a discesa.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
values | String[] | Un array di valori accettabili. |
showDropdown | Boolean | true se il foglio di lavoro deve mostrare un menu a discesa per i valori;
false in caso contrario. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireValueInRange(range)
Imposta la regola di convalida dei dati in modo che l'input sia uguale a un valore compreso nell'intervallo specificato.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
range | Range | Un intervallo che contiene i valori accettabili. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
requireValueInRange(range, showDropdown)
Imposta la regola di convalida dei dati in modo che l'input sia uguale a un valore compreso nell'intervallo specificato con un'opzione per nascondere il menu a discesa.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
range | Range | Un intervallo che contiene i valori accettabili. |
showDropdown | Boolean | true se il foglio di lavoro deve mostrare un menu a discesa per i valori;
false in caso contrario. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
setAllowInvalid(allowInvalidData)
Consente di impostare se mostrare un avviso quando l'input non supera la convalida dei dati o se rifiutare l'input
completamente. Il valore predefinito per le nuove regole di convalida dei dati è true
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
allowInvalidData | Boolean | true se la regola deve consentire input che non superano la convalida dei dati;
false in caso contrario. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
setHelpText(helpText)
Imposta il testo della guida che viene visualizzato quando l'utente passa il mouse sopra la cella su cui è attiva la convalida dei dati. per iniziare.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
helpText | String | Il testo della guida da impostare. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento
withCriteria(criteria, args)
Imposta la regola di convalida dei dati sui criteri definiti dai valori DataValidationCriteria
,
in genere ricavato dai criteria
e dai arguments
di una regola esistente.
// 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);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
criteria | DataValidationCriteria | Il tipo di criteri di convalida dei dati. |
args | Object[] | Un array di argomenti appropriati al tipo di criteri; il numero di argomenti e
il loro tipo corrisponde al metodo require...() corrispondente sopra indicato. |
Invio
DataValidationBuilder
: questo builder, per il concatenamento