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 generatore per una regola di convalida dei dati in base alle impostazioni di questa regola.
getAllowInvalid()BooleanRestituisce true se la regola mostra un avviso quando l'input non riesce a convalidare i dati oppure 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()StringVisualizza il testo della guida della regola o null se non è impostato alcun testo della guida.
requireCheckbox()DataValidationBuilderImposta la regola di convalida dei dati per richiedere che l'input sia un valore booleano; questo valore viene visualizzato come casella di controllo.
requireCheckbox(checkedValue)DataValidationBuilderImposta la regola di convalida dei dati per richiedere che l'input corrisponda al valore specificato o vuoto.
requireCheckbox(checkedValue, uncheckedValue)DataValidationBuilderImposta la regola di convalida dei dati per richiedere che l'input sia 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 precedente al valore specificato.
requireDateBetween(start, end)DataValidationBuilderImposta la regola di convalida dei dati in modo che richieda una data che rientri o rientri in una delle due 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 e non rientri in nessuna delle 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 richieda una data corrispondente o precedente al valore specificato.
requireFormulaSatisfied(formula)DataValidationBuilderImposta la regola di convalida dei dati per richiedere 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 numeri specificati o uno di questi.
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 di quello 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 minore 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 i due numeri specificati e non sia nessuno dei due.
requireNumberNotEqualTo(number)DataValidationBuilderImposta la regola di convalida dei dati in modo che richieda un numero diverso dal valore 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 per richiedere 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 per richiedere che l'input sia sotto forma di URL.
requireValueInList(values)DataValidationBuilderImposta la regola di convalida dei dati per richiedere 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 per richiedere che l'input sia uguale a un valore nell'intervallo specificato.
requireValueInRange(range, showDropdown)DataValidationBuilderImposta la regola di convalida dei dati in modo che l'input sia uguale a un valore nell'intervallo specificato, con un'opzione per nascondere il menu a discesa.
setAllowInvalid(allowInvalidData)DataValidationBuilderConsente di scegliere se mostrare un avviso quando l'input non riesce a eseguire la convalida dei dati o se rifiutare completamente l'input.
setHelpText(helpText)DataValidationBuilderImposta il testo della guida che viene visualizzato quando l'utente passa il mouse sopra la cella su cui è impostata la convalida dei dati.
withCriteria(criteria, args)DataValidationBuilderImposta la regola di convalida dei dati su criteri definiti dai valori DataValidationCriteria, recuperati in genere da criteria e arguments di una regola esistente.

Documentazione dettagliata

build()

Crea una regola di convalida dei dati dalle impostazioni applicate al generatore.

Ritorni

DataValidation: una rappresentazione della regola di convalida dei dati


copy()

Crea un generatore per una regola di convalida dei dati in base alle 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);

Ritorni

DataValidationBuilder: un generatore basato sulle impostazioni di questa regola


getAllowInvalid()

Restituisce true se la regola mostra un avviso quando l'input non riesce a convalidare i dati oppure false se rifiuta completamente l'input. Il valore predefinito per le nuove regole di convalida dei dati è true.

Ritorni

Boolean: true se la regola consente l'inserimento di dati 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 gli argomenti per i criteri, utilizza getCriteriaValues(). 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.')
}

Ritorni

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, vedi 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.')
}

Ritorni

Object[]: un array di argomenti appropriato per il tipo di criteri della regola; il numero di argomenti e il relativo tipo corrispondono al metodo require...() corrispondente della classe DataValidationBuilder


getHelpText()

Visualizza il testo della guida della regola o null se non è impostato alcun testo della guida.

Ritorni

String: il testo della guida della regola o null se non è impostato alcun testo della guida.


requireCheckbox()

Imposta la regola di convalida dei dati per richiedere che l'input sia un valore booleano; questo valore viene visualizzato come 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);

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


requireCheckbox(checkedValue)

Imposta la regola di convalida dei dati per richiedere che l'input corrisponda al valore specificato o vuoto. Quando l'input corrisponde al valore specificato, la cella viene visualizzata come casella di controllo selezionata. Quando l'input è vuoto, la cella viene visualizzata come casella di controllo deselezionata.

// 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 selezionata.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


requireCheckbox(checkedValue, uncheckedValue)

Imposta la regola di convalida dei dati per richiedere che l'input sia uno dei valori specificati. Quando l'input è checkedValue, la cella viene visualizzata come casella di controllo selezionata. Quando l'input è uncheckedValue, la cella viene visualizzata come casella di controllo deselezionata.

// 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 selezionata.
uncheckedValueObjectIl valore assegnato a una casella deselezionata.

Ritorni

DataValidationBuilder - questo generatore, 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);

Ritorni

DataValidationBuilder - questo generatore, 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 dell'oggetto Date vengono ignorati, ma vengono utilizzati solo i campi di 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.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


requireDateBefore(date)

Imposta la regola di convalida dei dati in modo che richieda una data precedente al valore specificato. I campi temporali dell'oggetto Date vengono ignorati, ma vengono utilizzati solo i campi di 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.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


requireDateBetween(start, end)

Imposta la regola di convalida dei dati in modo che richieda una data che rientri o rientri in una delle due date specificate. I campi temporali degli oggetti Date vengono ignorati, ma vengono utilizzati solo i campi di giorno, 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.

Ritorni

DataValidationBuilder - questo generatore, 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 dell'oggetto Date vengono ignorati, ma vengono utilizzati solo i campi di 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.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


requireDateNotBetween(start, end)

Imposta la regola di convalida dei dati in modo che richieda una data che non rientri e non rientri in nessuna delle due date specificate. I campi temporali degli oggetti Date vengono ignorati; vengono utilizzati solo i campi di 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.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


requireDateOnOrAfter(date)

Imposta la regola di convalida dei dati in modo che richieda una data corrispondente o successiva al valore specificato. I campi temporali dell'oggetto Date vengono ignorati, ma vengono utilizzati solo i campi di 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.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


requireDateOnOrBefore(date)

Imposta la regola di convalida dei dati in modo che richieda una data corrispondente o precedente al valore specificato. I campi temporali dell'oggetto Date vengono ignorati, ma vengono utilizzati solo i campi di 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.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


requireFormulaSatisfied(formula)

Imposta la regola di convalida dei dati per richiedere 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.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


requireNumberBetween(start, end)

Imposta la regola di convalida dei dati in modo che richieda un numero compreso tra due numeri specificati o uno di questi.

// 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.

Ritorni

DataValidationBuilder - questo generatore, 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.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


requireNumberGreaterThan(number)

Imposta la regola di convalida dei dati in modo che richieda un numero maggiore di quello 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.

Ritorni

DataValidationBuilder - questo generatore, 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.

Ritorni

DataValidationBuilder - questo generatore, 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.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


requireNumberLessThanOrEqualTo(number)

Imposta la regola di convalida dei dati in modo che richieda un numero minore 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.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


requireNumberNotBetween(start, end)

Imposta la regola di convalida dei dati in modo che richieda un numero che non rientri tra i due numeri specificati e non sia nessuno dei due.

// 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.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


requireNumberNotEqualTo(number)

Imposta la regola di convalida dei dati in modo che richieda un numero diverso dal valore 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.

Ritorni

DataValidationBuilder - questo generatore, 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.

Ritorni

DataValidationBuilder - questo generatore, 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.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


requireTextEqualTo(text)

Imposta la regola di convalida dei dati per richiedere 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.

Ritorni

DataValidationBuilder - questo generatore, 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);

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


requireTextIsUrl()

Imposta la regola di convalida dei dati per richiedere 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);

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


requireValueInList(values)

Imposta la regola di convalida dei dati per richiedere 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.

Ritorni

DataValidationBuilder - questo generatore, 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.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


requireValueInRange(range)

Imposta la regola di convalida dei dati per richiedere che l'input sia uguale a un valore 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 contenente i valori accettabili.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


requireValueInRange(range, showDropdown)

Imposta la regola di convalida dei dati in modo che l'input sia uguale a un valore 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 contenente i valori accettabili.
showDropdownBooleantrue se il foglio di lavoro deve mostrare un menu a discesa per i valori; false in caso contrario.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


setAllowInvalid(allowInvalidData)

Consente di scegliere se mostrare un avviso quando l'input non riesce a eseguire la convalida dei dati o se rifiutare completamente l'input. Il valore predefinito per le nuove regole di convalida dei dati è true.

Parametri

NomeTipoDescrizione
allowInvalidDataBooleantrue se la regola deve consentire l'input che non supera la convalida dei dati; false in caso contrario.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


setHelpText(helpText)

Imposta il testo della guida che viene visualizzato quando l'utente passa il mouse sopra la cella su cui è impostata la convalida dei dati.

Parametri

NomeTipoDescrizione
helpTextStringIl testo della guida da impostare.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento


withCriteria(criteria, args)

Imposta la regola di convalida dei dati su criteri definiti dai valori DataValidationCriteria, recuperati in genere da criteria e 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 appropriato per il tipo di criteri; il numero di argomenti e il relativo tipo corrispondono al metodo require...() corrispondente riportato sopra.

Ritorni

DataValidationBuilder - questo generatore, per il concatenamento