Class DataValidationBuilder

DataValidationBuilder

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

MetodoTipo restituitoBreve descrizione
build()DataValidationCrea una regola di convalida dei dati dalle impostazioni applicate al generatore.
copy()DataValidationBuilderCrea un builder per una regola di convalida dei dati basata sulle impostazioni di questa regola.
getAllowInvalid()BooleanRestituisce true se la regola mostra un avviso quando l'input non riesce a convalidare i dati o false se rifiuta completamente l'input.
getCriteriaType()DataValidationCriteriaRestituisce il tipo di criteri della regola come definito nell'enumerazione DataValidationCriteria.
getCriteriaValues()Object[]Restituisce un array di argomenti per i criteri della regola.
getHelpText()StringRecupera il testo della guida della regola o null se non è impostato alcun testo della guida.
requireCheckbox()DataValidationBuilderImposta 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)DataValidationBuilderImposta la regola di convalida dei dati in modo che l'input corrisponda al valore specificato o sia vuoto.
requireCheckbox(checkedValue, uncheckedValue)DataValidationBuilderImposta la regola di convalida dei dati in modo che l'input corrisponda a uno dei valori specificati.
requireDate()DataValidationBuilderImposta la regola di convalida dei dati in modo che richieda una data.
requireDateAfter(date)DataValidationBuilderImposta la regola di convalida dei dati in modo che richieda una data successiva al valore specificato.
requireDateBefore(date)DataValidationBuilderImposta la regola di convalida dei dati in modo che richieda una data prima del valore specificato.
requireDateBetween(start, end)DataValidationBuilderImposta la regola di convalida dei dati in modo che richieda una data compresa tra due o due intervalli date specificate.
requireDateEqualTo(date)DataValidationBuilderImposta la regola di convalida dei dati in modo che richieda una data uguale al valore specificato.
requireDateNotBetween(start, end)DataValidationBuilderImposta la regola di convalida dei dati in modo che richieda una data che non rientri tra e nessuna data due date specificate.
requireDateOnOrAfter(date)DataValidationBuilderImposta la regola di convalida dei dati in modo che richieda una data corrispondente o successiva al valore specificato.
requireDateOnOrBefore(date)DataValidationBuilderImposta la regola di convalida dei dati in modo che venga richiesta una data corrispondente o precedente al valore specificato.
requireFormulaSatisfied(formula)DataValidationBuilderImposta la regola di convalida dei dati in modo che la formula specificata restituisca true.
requireNumberBetween(start, end)DataValidationBuilderImposta la regola di convalida dei dati in modo che richieda un numero compreso tra due o due numeri specificati.
requireNumberEqualTo(number)DataValidationBuilderImposta la regola di convalida dei dati in modo che richieda un numero uguale al valore specificato.
requireNumberGreaterThan(number)DataValidationBuilderImposta la regola di convalida dei dati in modo che richieda un numero maggiore rispetto al valore specificato.
requireNumberGreaterThanOrEqualTo(number)DataValidationBuilderImposta la regola di convalida dei dati in modo che richieda un numero maggiore o uguale al valore specificato.
requireNumberLessThan(number)DataValidationBuilderImposta la regola di convalida dei dati in modo che richieda un numero inferiore al valore specificato.
requireNumberLessThanOrEqualTo(number)DataValidationBuilderImposta la regola di convalida dei dati in modo che richieda un numero inferiore o uguale al valore specificato.
requireNumberNotBetween(start, end)DataValidationBuilderImposta 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)DataValidationBuilderImposta la regola di convalida dei dati in modo che richieda un numero diverso da quello specificato.
requireTextContains(text)DataValidationBuilderImposta la regola di convalida dei dati in modo che l'input contenga il valore specificato.
requireTextDoesNotContain(text)DataValidationBuilderImposta la regola di convalida dei dati in modo che l'input non contenga il valore specificato.
requireTextEqualTo(text)DataValidationBuilderImposta la regola di convalida dei dati in modo che l'input sia uguale al valore specificato.
requireTextIsEmail()DataValidationBuilderImposta la regola di convalida dei dati in modo che l'input sia sotto forma di indirizzo email.
requireTextIsUrl()DataValidationBuilderImposta la regola di convalida dei dati in modo che l'input sia sotto forma di URL.
requireValueInList(values)DataValidationBuilderImposta la regola di convalida dei dati in modo che l'input sia uguale a uno dei valori specificati.
requireValueInList(values, showDropdown)DataValidationBuilderImposta 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)DataValidationBuilderImposta la regola di convalida dei dati in modo che l'input sia uguale a un valore compreso nell'intervallo specificato.
requireValueInRange(range, showDropdown)DataValidationBuilderImposta 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)DataValidationBuilderConsente di impostare se mostrare un avviso quando l'input non supera la convalida dei dati o se rifiutare l'input completamente.
setHelpText(helpText)DataValidationBuilderImposta 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)DataValidationBuilderImposta 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

NomeTipoDescrizione
checkedValueObjectIl 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

NomeTipoDescrizione
checkedValueObjectIl valore assegnato a una casella di controllo.
uncheckedValueObjectIl 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

NomeTipoDescrizione
dateDateL'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

NomeTipoDescrizione
dateDateLa 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

NomeTipoDescrizione
startDateLa prima data accettabile.
endDateL'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

NomeTipoDescrizione
dateDateL'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

NomeTipoDescrizione
startDateLa prima data non accettabile.
endDateL'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

NomeTipoDescrizione
dateDateLa 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

NomeTipoDescrizione
dateDateL'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

NomeTipoDescrizione
formulaStringUna 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

NomeTipoDescrizione
startNumberIl valore accettabile più basso.
endNumberIl 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

NomeTipoDescrizione
numberNumberL'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

NomeTipoDescrizione
numberNumberIl 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

NomeTipoDescrizione
numberNumberIl 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

NomeTipoDescrizione
numberNumberIl 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

NomeTipoDescrizione
numberNumberIl 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

NomeTipoDescrizione
startNumberIl valore non accettabile più basso.
endNumberIl 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

NomeTipoDescrizione
numberNumberL'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

NomeTipoDescrizione
textStringIl 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

NomeTipoDescrizione
textStringIl 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

NomeTipoDescrizione
textStringL'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

NomeTipoDescrizione
valuesString[]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

NomeTipoDescrizione
valuesString[]Un array di valori accettabili.
showDropdownBooleantrue 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

NomeTipoDescrizione
rangeRangeUn 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

NomeTipoDescrizione
rangeRangeUn intervallo che contiene i valori accettabili.
showDropdownBooleantrue 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

NomeTipoDescrizione
allowInvalidDataBooleantrue 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

NomeTipoDescrizione
helpTextStringIl 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

NomeTipoDescrizione
criteriaDataValidationCriteriaIl tipo di criteri di convalida dei dati.
argsObject[]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