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 generatore.
copy()	DataValidationBuilder	Crea un generatore 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 o false se lo rifiuta del tutto.
getCriteriaType()	DataValidationCriteria	Recupera il tipo di criteri della regola come definito nell'enum 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 richieda 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 richieda che l'input sia il valore specificato o vuoto.
requireCheckbox(checkedValue, uncheckedValue)	DataValidationBuilder	Imposta la regola di convalida dei dati in modo che richieda 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 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 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 che non sia una di queste due date.
requireDateOnOrAfter(date)	DataValidationBuilder	Imposta la regola di convalida dei 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 richieda 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 che sia uno dei due.
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 che non sia uguale a nessuno dei due.
requireNumberNotEqualTo(number)	DataValidationBuilder	Imposta la regola di convalida dei dati in modo che richieda un numero non uguale al valore specificato.
requireTextContains(text)	DataValidationBuilder	Imposta la regola di convalida dei dati in modo che richieda che l'input contenga il valore specificato.
requireTextDoesNotContain(text)	DataValidationBuilder	Imposta la regola di convalida dei dati in modo che richieda che l'input non contenga il valore specificato.
requireTextEqualTo(text)	DataValidationBuilder	Imposta la regola di convalida dei dati in modo che richieda che l'input sia uguale al valore specificato.
requireTextIsEmail()	DataValidationBuilder	Imposta la regola di convalida dei dati in modo che richieda che l'input sia sotto forma di indirizzo email.
requireTextIsUrl()	DataValidationBuilder	Imposta la regola di convalida dei dati in modo che richieda che l'input sia sotto forma di URL.
requireValueInList(values)	DataValidationBuilder	Imposta la regola di convalida dei dati in modo che richieda che l'input sia uguale a uno dei valori specificati.
requireValueInList(values, showDropdown)	DataValidationBuilder	Imposta la regola di convalida dei dati in modo che richieda 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 richieda 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 richieda 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'immissione non supera la convalida dei dati o se rifiutare completamente l'immissione.
setHelpText(helpText)	DataValidationBuilder	Imposta il testo della guida visualizzato quando l'utente passa il mouse sopra la cella su cui è impostata la convalida dei dati.
withCriteria(criteria, args)	DataValidationBuilder	Imposta la regola di convalida dei dati in base ai criteri definiti dai valori DataValidationCriteria, tipicamente ricavati da criteria e arguments di una regola esistente.

Documentazione dettagliata

build()

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

Invio

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.
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);

Invio

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 o false se lo rifiuta del tutto. 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()

Recupera il tipo di criteri della regola come definito nell'enum 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.');
}

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

Invio

Object[]: un array di argomenti appropriati al tipo di criteri della regola; il numero di argomenti e il relativo tipo corrispondono 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 richieda 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);

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireCheckbox(checkedValue)

Imposta la regola di convalida dei dati in modo che richieda che l'input sia il valore specificato o vuoto. Quando l'input corrisponde al valore specificato, la cella viene visualizzata come casella di controllo selezionata. Quando il valore inserito è vuoto, la cella viene visualizzata come una 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 selezionata.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireCheckbox(checkedValue, uncheckedValue)

Imposta la regola di convalida dei dati in modo che richieda che l'input sia uno dei valori specificati. Quando l'input è checkedValue, la cella viene visualizzata come una casella di controllo selezionata. Quando il valore inserito è 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 selezionata.
uncheckedValue	Object	Il valore assegnato a una casella non selezionata.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

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);

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireDateAfter(date)

Imposta la regola di convalida dei dati in modo che richieda una data successiva al valore specificato. I campi relativi al tempo 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 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	La data non accettabile più recente.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireDateBefore(date)

Imposta la regola di convalida dei dati in modo che richieda una data precedente al valore specificato. I campi relativi al tempo 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 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 data meno recente non accettabile.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

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 relativi all'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 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 data più antica accettabile.
end	Date	La data più recente accettabile.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireDateEqualTo(date)

Imposta la regola di convalida dei dati in modo che richieda una data uguale al valore specificato. I campi relativi al tempo 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 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.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireDateNotBetween(start, end)

Imposta la regola di convalida dei dati in modo che richieda una data che non rientri tra due date specificate e che non sia una di queste due date. I campi relativi all'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 data meno recente non accettabile.
end	Date	La data non accettabile più recente.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireDateOnOrAfter(date)

Imposta la regola di convalida dei dati in modo che richieda una data uguale o successiva al valore specificato. I campi relativi al tempo 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 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 data più antica accettabile.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireDateOnOrBefore(date)

Imposta la regola di convalida dei dati in modo che richieda una data uguale o precedente al valore specificato. I campi relativi al tempo 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.
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 più recente accettabile.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireFormulaSatisfied(formula)

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

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireNumberBetween(start, end)

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

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

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

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.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

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 non accettabile più alto.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

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.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

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 minimo non accettabile.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

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.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireNumberNotBetween(start, end)

Imposta la regola di convalida dei dati in modo che richieda un numero che non rientri tra due numeri specificati e che 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 minimo non accettabile.
end	Number	Il valore non accettabile più alto.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireNumberNotEqualTo(number)

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

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireTextContains(text)

Imposta la regola di convalida dei dati in modo che richieda 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 l'input deve contenere.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireTextDoesNotContain(text)

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

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireTextEqualTo(text)

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

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireTextIsEmail()

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

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireTextIsUrl()

Imposta la regola di convalida dei dati in modo che richieda che l'input sia sotto forma di 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);

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireValueInList(values)

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

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireValueInList(values, showDropdown)

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

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireValueInRange(range)

Imposta la regola di convalida dei dati in modo che richieda 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 contenente i valori accettabili.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

requireValueInRange(range, showDropdown)

Imposta la regola di convalida dei dati in modo che richieda 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 contenente 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 generatore, per l'accodamento

---

setAllowInvalid(allowInvalidData)

Imposta se mostrare un avviso quando l'immissione non supera la convalida dei dati o se rifiutare completamente l'immissione. 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'inserimento di dati che non superano la convalida dei dati; false in caso contrario.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

setHelpText(helpText)

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

Parametri

Nome	Tipo	Descrizione
helpText	String	Il testo della guida da impostare.

Invio

DataValidationBuilder: questo generatore, per l'accodamento

---

withCriteria(criteria, args)

Imposta la regola di convalida dei dati in base ai criteri definiti dai valori DataValidationCriteria, tipicamente 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 al tipo di criteri; il numero di argomenti e il loro tipo corrispondono al metodo require...() corrispondente riportato sopra.

Invio

DataValidationBuilder: questo generatore, per l'accodamento