Questa pagina è stata tradotta dall'API Cloud Translation.

Class 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

Metodo	Tipo restituito	Breve descrizione
`build()`	`DataValidation`	Crea una regola di convalida dei dati dalle impostazioni applicate al generatore.
`copy()`	`DataValidationBuilder`	Crea un builder per una regola di convalida dei dati basata sulle impostazioni di questa regola.
`getAllowInvalid()`	`Boolean`	Restituisce `true` se la regola mostra un avviso quando l'input non riesce a convalidare i dati o `false` se rifiuta completamente l'input.
`getCriteriaType()`	`DataValidationCriteria`	Restituisce il tipo di criteri della regola come definito nell'enumerazione `DataValidationCriteria`.
`getCriteriaValues()`	`Object[]`	Restituisce un array di argomenti per i criteri della regola.
`getHelpText()`	`String`	Recupera il testo della guida della regola o `null` se non è impostato alcun testo della guida.
`requireCheckbox()`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che l'input sia un valore booleano. questo valore è visualizzato come una casella di controllo.
`requireCheckbox(checkedValue)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che l'input corrisponda al valore specificato o sia vuoto.
`requireCheckbox(checkedValue, uncheckedValue)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che l'input corrisponda a uno dei valori specificati.
`requireDate()`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che richieda una data.
`requireDateAfter(date)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che richieda una data successiva al valore specificato.
`requireDateBefore(date)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che richieda una data prima del valore specificato.
`requireDateBetween(start, end)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che richieda una data compresa tra due o due intervalli date specificate.
`requireDateEqualTo(date)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che richieda una data uguale al valore specificato.
`requireDateNotBetween(start, end)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che richieda una data che non rientri tra e nessuna data due date specificate.
`requireDateOnOrAfter(date)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che richieda una data corrispondente o successiva al valore specificato.
`requireDateOnOrBefore(date)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che venga richiesta una data corrispondente o precedente al valore specificato.
`requireFormulaSatisfied(formula)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che la formula specificata restituisca `true`.
`requireNumberBetween(start, end)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che richieda un numero compreso tra due o due numeri specificati.
`requireNumberEqualTo(number)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che richieda un numero uguale al valore specificato.
`requireNumberGreaterThan(number)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che richieda un numero maggiore rispetto al valore specificato.
`requireNumberGreaterThanOrEqualTo(number)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che richieda un numero maggiore o uguale al valore specificato.
`requireNumberLessThan(number)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che richieda un numero inferiore al valore specificato.
`requireNumberLessThanOrEqualTo(number)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che richieda un numero inferiore o uguale al valore specificato.
`requireNumberNotBetween(start, end)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che richieda un numero che non rientri tra e che non rientri tra l'uno e l'altro due numeri specificati.
`requireNumberNotEqualTo(number)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che richieda un numero diverso da quello specificato.
`requireTextContains(text)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che l'input contenga il valore specificato.
`requireTextDoesNotContain(text)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che l'input non contenga il valore specificato.
`requireTextEqualTo(text)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che l'input sia uguale al valore specificato.
`requireTextIsEmail()`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che l'input sia sotto forma di indirizzo email.
`requireTextIsUrl()`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che l'input sia sotto forma di URL.
`requireValueInList(values)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che l'input sia uguale a uno dei valori specificati.
`requireValueInList(values, showDropdown)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che l'input sia uguale a uno dei valori specificati. con un'opzione per nascondere il menu a discesa.
`requireValueInRange(range)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che l'input sia uguale a un valore compreso nell'intervallo specificato.
`requireValueInRange(range, showDropdown)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati in modo che l'input sia uguale a un valore compreso nell'intervallo specificato con un'opzione per nascondere il menu a discesa.
`setAllowInvalid(allowInvalidData)`	`DataValidationBuilder`	Consente di impostare se mostrare un avviso quando l'input non supera la convalida dei dati o se rifiutare l'input completamente.
`setHelpText(helpText)`	`DataValidationBuilder`	Imposta il testo della guida che viene visualizzato quando l'utente passa il mouse sopra la cella su cui è attiva la convalida dei dati. per iniziare.
`withCriteria(criteria, args)`	`DataValidationBuilder`	Imposta la regola di convalida dei dati sui criteri definiti dai valori `DataValidationCriteria`, generalmente ricavato dai `criteria` e dai `arguments` di una regola esistente.

Documentazione dettagliata

`build()`

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

Invio

DataValidation: una rappresentazione della regola di convalida dei dati.

`copy()`

Crea un builder per una regola di convalida dei dati basata sulle impostazioni di questa regola.

// Change existing data validation rules that require a date in 2013 to require a date in 2014.
var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
var newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
var rules = range.getDataValidations();

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

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var args = rule.getCriteriaValues();

      if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN
          && args[0].getTime() == oldDates[0].getTime()
          && args[1].getTime() == oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

Invio

DataValidationBuilder: uno strumento per la creazione basato sulle impostazioni di questa regola

`getAllowInvalid()`

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

Invio

Boolean - true se la regola consente input che non superano la convalida dei dati; false in caso contrario

`getCriteriaType()`

Restituisce il tipo di criteri della regola come definito nell'enumerazione DataValidationCriteria. Per ottenere per i criteri, utilizza getCriteriaValues(). Per utilizzare questi valori per creare modificare una regola di convalida dei dati, consulta withCriteria(criteria, args).

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

Invio

DataValidationCriteria: il tipo di criteri di convalida dei dati.

`getCriteriaValues()`

Restituisce un array di argomenti per i criteri della regola. Per ottenere il tipo di criteri, utilizza getCriteriaType(). Per utilizzare questi valori per creare o modificare una regola di convalida dei dati, consulta withCriteria(criteria, args).

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

Invio

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

`getHelpText()`

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

Invio

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

`requireCheckbox()`

Imposta la regola di convalida dei dati in modo che l'input sia un valore booleano. questo valore è visualizzato come una casella di controllo.

// Set the data validation for cell A1 to require a boolean value; the value is rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox().build();
cell.setDataValidation(rule);

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireCheckbox(checkedValue)`

Imposta la regola di convalida dei dati in modo che l'input corrisponda al valore specificato o sia vuoto. Quando Se l'input corrisponde al valore specificato, la cella viene visualizzata come casella di controllo selezionata. Quando se l'input è vuoto, la cella viene visualizzata come una casella di controllo non selezionata.

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

Parametri

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

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireCheckbox(checkedValue, uncheckedValue)`

Imposta la regola di convalida dei dati in modo che l'input corrisponda a uno dei valori specificati. Quando l'input è checkedValue; la cella viene visualizzata come una casella di controllo selezionata. Quando l'input è uncheckedValue, la cella viene visualizzata come una casella di controllo non selezionata.

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

Parametri

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

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireDate()`

Imposta la regola di convalida dei dati in modo che richieda una data.

// Set the data validation for cell A1 to require a date.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDate().build();
cell.setDataValidation(rule);

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireDateAfter(date)`

Imposta la regola di convalida dei dati in modo che richieda una data successiva al valore specificato. I campi temporali del Gli oggetti Date vengono ignorati. vengono utilizzati solo i campi giorno, mese e anno.

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

Parametri

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

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireDateBefore(date)`

Imposta la regola di convalida dei dati in modo che richieda una data prima del valore specificato. I campi temporali del Gli oggetti Date vengono ignorati. vengono utilizzati solo i campi giorno, mese e anno.

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

Parametri

Nome	Tipo	Descrizione
`date`	`Date`	La prima data non accettabile.

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireDateBetween(start, end)`

Imposta la regola di convalida dei dati in modo che richieda una data compresa tra due o due intervalli date specificate. I campi temporali degli oggetti Date vengono ignorati. solo il giorno, il mese e anno.

// Set the data validation for cell A1 to require a date in 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013')).build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
`start`	`Date`	La prima data accettabile.
`end`	`Date`	L'ultima data accettabile.

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireDateEqualTo(date)`

Imposta la regola di convalida dei dati in modo che richieda una data uguale al valore specificato. I campi temporali di l'oggetto Date viene ignorato; vengono utilizzati solo i campi giorno, mese e anno.

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

Parametri

Nome	Tipo	Descrizione
`date`	`Date`	L'unica data accettabile.

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireDateNotBetween(start, end)`

Imposta la regola di convalida dei dati in modo che richieda una data che non rientri tra e nessuna data due date specificate. I campi temporali degli oggetti Date vengono ignorati. solo il giorno, mese e anno.

// Set the data validation for cell A1 to require a date not in 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013')).build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
`start`	`Date`	La prima data non accettabile.
`end`	`Date`	L'ultima data non accettabile.

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireDateOnOrAfter(date)`

Imposta la regola di convalida dei dati in modo che venga richiesta una data corrispondente o successiva al valore specificato. I campi temporali di l'oggetto Date viene ignorato; vengono utilizzati solo i campi giorno, mese e anno.

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

Parametri

Nome	Tipo	Descrizione
`date`	`Date`	La prima data accettabile.

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireDateOnOrBefore(date)`

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

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

Parametri

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

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireFormulaSatisfied(formula)`

Imposta la regola di convalida dei dati in modo che la formula specificata restituisca true.

// Set the data validation for cell A1 to equal B1 with a custom formula.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireFormulaSatisfied('=EQ(A1,B1)').build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
`formula`	`String`	Una formula personalizzata che restituisce `true` se l'input è valido.

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireNumberBetween(start, end)`

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

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

Parametri

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

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireNumberEqualTo(number)`

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

// Set the data validation for cell A1 to require a number equal to 3.1415926536.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberEqualTo(3.1415926536).build();
cell.setDataValidation(rule);

Parametri

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

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireNumberGreaterThan(number)`

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

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

Parametri

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

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireNumberGreaterThanOrEqualTo(number)`

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

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

Parametri

Nome	Tipo	Descrizione
`number`	`Number`	Il valore accettabile più basso.

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireNumberLessThan(number)`

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

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

Parametri

Nome	Tipo	Descrizione
`number`	`Number`	Il valore non accettabile più basso.

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireNumberLessThanOrEqualTo(number)`

Imposta la regola di convalida dei dati in modo che richieda un numero inferiore o uguale al valore specificato.

// Set the data validation for cell A1 to require a number less than or equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThanOrEqualTo(0).build();
cell.setDataValidation(rule);

Parametri

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

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireNumberNotBetween(start, end)`

Imposta la regola di convalida dei dati in modo che richieda un numero che non rientri tra e che non rientri tra l'uno e l'altro due numeri specificati.

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

Parametri

Nome	Tipo	Descrizione
`start`	`Number`	Il valore non accettabile più basso.
`end`	`Number`	Il valore non accettabile più alto.

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireNumberNotEqualTo(number)`

Imposta la regola di convalida dei dati in modo che richieda un numero diverso da quello specificato.

// Set the data validation for cell A1 to require a number not equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
`number`	`Number`	L'unico valore inaccettabile.

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireTextContains(text)`

Imposta la regola di convalida dei dati in modo che l'input contenga il valore specificato.

// Set the data validation for cell A1 to require any value that includes "Google".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextContains('Google').build();
cell.setDataValidation(rule);

Parametri

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

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireTextDoesNotContain(text)`

Imposta la regola di convalida dei dati in modo che l'input non contenga il valore specificato.

// Set the data validation for cell A1 to require any value that does not include "@".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build();
cell.setDataValidation(rule);

Parametri

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

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireTextEqualTo(text)`

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

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

Parametri

Nome	Tipo	Descrizione
`text`	`String`	L'unico valore accettabile.

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireTextIsEmail()`

Imposta la regola di convalida dei dati in modo che l'input sia sotto forma di indirizzo email.

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

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireTextIsUrl()`

Imposta la regola di convalida dei dati in modo che l'input sia sotto forma di URL.

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

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireValueInList(values)`

Imposta la regola di convalida dei dati in modo che l'input sia uguale a uno dei valori specificati.

// Set the data validation for cell A1 to require "Yes" or "No", with a dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No']).build();
cell.setDataValidation(rule);

Parametri

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

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireValueInList(values, showDropdown)`

Imposta la regola di convalida dei dati in modo che l'input sia uguale a uno dei valori specificati. con un'opzione per nascondere il menu a discesa.

// Set the data validation for cell A1 to require "Yes" or "No", with no dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No'], false).build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
`values`	`String[]`	Un array di valori accettabili.
`showDropdown`	`Boolean`	`true` se il foglio di lavoro deve mostrare un menu a discesa per i valori; `false` in caso contrario.

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireValueInRange(range)`

Imposta la regola di convalida dei dati in modo che l'input sia uguale a un valore compreso nell'intervallo specificato.

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

Parametri

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

Invio

DataValidationBuilder: questo builder, per il concatenamento

`requireValueInRange(range, showDropdown)`

Imposta la regola di convalida dei dati in modo che l'input sia uguale a un valore compreso nell'intervallo specificato con un'opzione per nascondere il menu a discesa.

// Set the data validation for cell A1 to require value from B1:B10, with no dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range, false).build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
`range`	`Range`	Un intervallo che contiene i valori accettabili.
`showDropdown`	`Boolean`	`true` se il foglio di lavoro deve mostrare un menu a discesa per i valori; `false` in caso contrario.

Invio

DataValidationBuilder: questo builder, per il concatenamento

`setAllowInvalid(allowInvalidData)`

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

Parametri

Nome	Tipo	Descrizione
`allowInvalidData`	`Boolean`	`true` se la regola deve consentire input che non superano la convalida dei dati; `false` in caso contrario.

Invio

DataValidationBuilder: questo builder, per il concatenamento

`setHelpText(helpText)`

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

Parametri

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

Invio

DataValidationBuilder: questo builder, per il concatenamento

`withCriteria(criteria, args)`

Imposta la regola di convalida dei dati sui criteri definiti dai valori DataValidationCriteria, in genere ricavato dai criteria e dai arguments di una regola esistente.

// Change existing data validation rules that require a date in 2013 to require a date in 2014.
var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
var newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
var rules = range.getDataValidations();

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

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var args = rule.getCriteriaValues();

      if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN
          && args[0].getTime() == oldDates[0].getTime()
          && args[1].getTime() == oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

Parametri

Nome	Tipo	Descrizione
`criteria`	`DataValidationCriteria`	Il tipo di criteri di convalida dei dati.
`args`	`Object[]`	Un array di argomenti appropriati al tipo di criteri; il numero di argomenti e il loro tipo corrisponde al metodo `require...()` corrispondente sopra indicato.

Invio

DataValidationBuilder: questo builder, per il concatenamento