Class DataValidationBuilder

DataValidationBuilder

Generatore di regole di convalida dei dati.

// Set the data validation for cell A1 to require a value from B1:B10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Metodi

Metodo	Tipo restituito	Breve descrizione
build()	DataValidation	Costruisce una regola di convalida dei dati dalle impostazioni applicate al builder.
copy()	DataValidationBuilder	Crea un builder per una regola di convalida dei dati in base alle impostazioni di questa regola.
getAllowInvalid()	Boolean	Restituisce true se la regola mostra un avviso quando l'input non supera la convalida dei dati oppure false se rifiuta completamente l'input.
getCriteriaType()	DataValidationCriteria	Recupera 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	Restituisce 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 viene visualizzato come casella di controllo.
requireCheckbox(checkedValue)	DataValidationBuilder	Imposta la regola di convalida dei dati in modo che l'input sia il valore specificato o vuoto.
requireCheckbox(checkedValue, uncheckedValue)	DataValidationBuilder	Imposta la regola di convalida dei dati in modo che l'input sia 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 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 precedente al valore specificato.
requireDateBetween(start, end)	DataValidationBuilder	Imposta la regola di convalida dei dati in modo che richieda una data compresa tra due date specificate o che corrisponda a una delle due.
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 due date specificate e non corrisponda a nessuna delle due.
requireDateOnOrAfter(date)	DataValidationBuilder	Imposta la regola di convalida dati in modo che richieda una data uguale o successiva al valore specificato.
requireDateOnOrBefore(date)	DataValidationBuilder	Imposta la regola di convalida dei dati in modo che richieda una data uguale 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 numeri specificati o uguale a uno di questi.
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 del 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 minore 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 due numeri specificati e non sia uguale a nessuno dei due.
requireNumberNotEqualTo(number)	DataValidationBuilder	Imposta la regola di convalida dei dati in modo che richieda un numero diverso dal valore 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 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 nel formato di un indirizzo email.
requireTextIsUrl()	DataValidationBuilder	Imposta la regola di convalida dei dati in modo che l'input sia nel formato di un 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 nell'intervallo specificato.
requireValueInRange(range, showDropdown)	DataValidationBuilder	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.
setAllowInvalid(allowInvalidData)	DataValidationBuilder	Imposta 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 visualizzato quando l'utente passa il mouse sopra la cella in cui è impostata la convalida dei dati.
withCriteria(criteria, args)	DataValidationBuilder	Imposta la regola di convalida dei dati sui criteri definiti dai valori DataValidationCriteria, in genere ricavati da criteria e arguments di una regola esistente.

Documentazione dettagliata

build()

Costruisce una regola di convalida dei dati dalle impostazioni applicate al builder.

Indietro

DataValidation: una rappresentazione della regola di convalida dei dati

---

copy()

Crea un builder 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.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    const rule = rules[i][j];

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const 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);

Indietro

DataValidationBuilder: un generatore basato sulle impostazioni di questa regola

---

getAllowInvalid()

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

Indietro

Boolean: true se la regola consente l'input che non supera la convalida dei dati; false in caso contrario

---

getCriteriaType()

Recupera 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const 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.');
}

Indietro

DataValidationCriteria: il tipo di criteri di convalida dei dati

---

getCriteriaValues()

Recupera un array di argomenti per i criteri della regola. Per ottenere il tipo di criterio, 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const 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.');
}

Indietro

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

---

getHelpText()

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

Indietro

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 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireCheckbox().build();
cell.setDataValidation(rule);

Indietro

DataValidationBuilder: questo generatore, per il concatenamento

---

requireCheckbox(checkedValue)

Imposta la regola di convalida dei dati in modo che l'input sia il valore specificato o vuoto. Quando l'input corrisponde al valore specificato, la cella viene visualizzata come una 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
checkedValue	Object	Il valore assegnato a una casella di controllo selezionata.

Indietro

DataValidationBuilder: questo generatore, per il concatenamento

---

requireCheckbox(checkedValue, uncheckedValue)

Imposta la regola di convalida dei dati in modo che l'input sia 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 casella di controllo deselezionata.

// Set the data validation for cell A1 to require custom checked values that are
// rendered as a checkbox.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireCheckbox('APPROVED', 'PENDING')
                 .build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
checkedValue	Object	Il valore assegnato a una casella di controllo selezionata.
uncheckedValue	Object	Il valore assegnato a una casella deselezionata.

Indietro

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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireDate().build();
cell.setDataValidation(rule);

Indietro

DataValidationBuilder: questo generatore, per il concatenamento

---

requireDateAfter(date)

Imposta la regola di convalida dati in modo che richieda una data successiva al valore specificato. I campi dell'ora dell'oggetto Date vengono ignorati; vengono utilizzati solo i campi del giorno, del mese e dell'anno.

// Set the data validation for cell A1 to require a date after January 1, 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateAfter(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
date	Date	L'ultima data non accettabile.

Indietro

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 dell'ora dell'oggetto Date vengono ignorati; vengono utilizzati solo i campi del giorno, del mese e dell'anno.

// Set the data validation for cell A1 to require a date before January 1, 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateBefore(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
date	Date	La prima data non accettabile.

Indietro

DataValidationBuilder: questo generatore, per il concatenamento

---

requireDateBetween(start, end)

Imposta la regola di convalida dei dati in modo che richieda una data compresa tra due date specificate o che corrisponda a una delle due. I campi dell'ora degli oggetti Date vengono ignorati; vengono utilizzati solo i campi del giorno, del mese e dell'anno.

// Set the data validation for cell A1 to require a date in 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const 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	La data accettabile più recente.

Indietro

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 dell'ora dell'oggetto Date vengono ignorati; vengono utilizzati solo i campi del giorno, del mese e dell'anno.

// Set the data validation for cell A1 to require a date equal to January 1,
// 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateEqualTo(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
date	Date	L'unica data accettabile.

Indietro

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 tra due date specificate e non corrisponda a nessuna delle due. I campi dell'ora degli oggetti Date vengono ignorati; vengono utilizzati solo i campi giorno, mese e anno.

// Set the data validation for cell A1 to require a date not in 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const 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.

Indietro

DataValidationBuilder: questo generatore, per il concatenamento

---

requireDateOnOrAfter(date)

Imposta la regola di convalida dati in modo che richieda una data uguale o successiva al valore specificato. I campi dell'ora dell'oggetto Date vengono ignorati; vengono utilizzati solo i campi del giorno, del mese e dell'anno.

// Set the data validation for cell A1 to require a date on or after January 1,
// 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateOnOrAfter(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
date	Date	La prima data accettabile.

Indietro

DataValidationBuilder: questo generatore, per il concatenamento

---

requireDateOnOrBefore(date)

Imposta la regola di convalida dei dati in modo che richieda una data uguale o precedente al valore specificato. I campi dell'ora dell'oggetto Date vengono ignorati; vengono utilizzati solo i campi del giorno, del mese e dell'anno.

// Set the data validation for cell A1 to require a date on or before January 1,
// 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateOnOrBefore(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
date	Date	La data accettabile più recente.

Indietro

DataValidationBuilder: questo generatore, 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const 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.

Indietro

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 uguale a uno di questi.

// Set the data validation for cell A1 to require a number between 1 and 10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberBetween(1, 10).build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
start	Number	Il valore minimo accettabile.
end	Number	Il valore accettabile più alto.

Indietro

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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberEqualTo(Math.PI).build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
number	Number	L'unico valore accettabile.

Indietro

DataValidationBuilder: questo generatore, per il concatenamento

---

requireNumberGreaterThan(number)

Imposta la regola di convalida dei dati in modo che richieda un numero maggiore del valore specificato.

// Set the data validation for cell A1 to require a number greater than 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
number	Number	Il valore inaccettabile più alto.

Indietro

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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireNumberGreaterThanOrEqualTo(0)
                 .build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
number	Number	Il valore minimo accettabile.

Indietro

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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
number	Number	Il valore più basso inaccettabile.

Indietro

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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireNumberLessThanOrEqualTo(0)
                 .build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
number	Number	Il valore accettabile più alto.

Indietro

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 due numeri specificati e non sia uguale a nessuno dei due.

// Set the data validation for cell A1 to require a number not between 1 and 10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberNotBetween(1, 10).build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
start	Number	Il valore più basso inaccettabile.
end	Number	Il valore inaccettabile più alto.

Indietro

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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
number	Number	L'unico valore non accettabile.

Indietro

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".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextContains('Google').build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
text	String	Il valore che deve contenere l'input.

Indietro

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 "@".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
text	String	Il valore che l'input non deve contenere.

Indietro

DataValidationBuilder: questo generatore, per il concatenamento

---

requireTextEqualTo(text)

Imposta la regola di convalida dati in modo che l'input sia uguale al valore specificato.

// Set the data validation for cell A1 to require "Yes".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
text	String	L'unico valore accettabile.

Indietro

DataValidationBuilder: questo generatore, per il concatenamento

---

requireTextIsEmail()

Imposta la regola di convalida dei dati in modo che l'input sia nel formato di un indirizzo email.

// Set the data validation for cell A1 to require text in the form of an email
// address.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build();
cell.setDataValidation(rule);

Indietro

DataValidationBuilder: questo generatore, per il concatenamento

---

requireTextIsUrl()

Imposta la regola di convalida dei dati in modo che l'input sia nel formato di un URL.

// Set the data validation for cell A1 to require text in the form of a URL.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireTextIsUrl().build();
cell.setDataValidation(rule);

Indietro

DataValidationBuilder: questo generatore, 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireValueInList(['Yes', 'No'])
                 .build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
values	String[]	Un array di valori accettabili.

Indietro

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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const 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.

Indietro

DataValidationBuilder: questo generatore, per il concatenamento

---

requireValueInRange(range)

Imposta la regola di convalida dei dati in modo 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
range	Range	Un intervallo che contiene i valori accettabili.

Indietro

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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const 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.

Indietro

DataValidationBuilder: questo generatore, per il concatenamento

---

setAllowInvalid(allowInvalidData)

Imposta 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 l'input che non supera la convalida dei dati; false in caso contrario.

Indietro

DataValidationBuilder: questo generatore, per il concatenamento

---

setHelpText(helpText)

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

Parametri

Nome	Tipo	Descrizione
helpText	String	Il testo guida da impostare.

Indietro

DataValidationBuilder: questo generatore, per il concatenamento

---

withCriteria(criteria, args)

Imposta la regola di convalida dei dati sui criteri definiti dai valori DataValidationCriteria, in genere ricavati 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.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    const rule = rules[i][j];

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const 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 per il tipo di criteri; il numero di argomenti e il loro tipo corrispondono al metodo require...() corrispondente riportato sopra.

Indietro

DataValidationBuilder: questo generatore, per il concatenamento