Cette page a été traduite par l'API Cloud Translation.

Class DataValidationBuilder

Compilateur pour les règles de validation des données.

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

Méthodes

Méthode	Type renvoyé	Brève description
`build()`	`DataValidation`	Construit une règle de validation des données à partir des paramètres appliqués à l'outil de création.
`copy()`	`DataValidationBuilder`	Crée un outil de création pour une règle de validation des données en fonction des paramètres de cette règle.
`getAllowInvalid()`	`Boolean`	Renvoie `true` si la règle affiche un avertissement lorsque l'entrée échoue à la validation des données, ou `false` si elle rejette complètement l'entrée.
`getCriteriaType()`	`DataValidationCriteria`	Récupère le type de critère de la règle tel que défini dans l'énumération `DataValidationCriteria`.
`getCriteriaValues()`	`Object[]`	Récupère un tableau d'arguments pour les critères de la règle.
`getHelpText()`	`String`	Récupère le texte d'aide de la règle ou `null` si aucun texte d'aide n'est défini.
`requireCheckbox()`	`DataValidationBuilder`	Définit la règle de validation des données de sorte que l'entrée soit une valeur booléenne. cette valeur est sous forme de case à cocher.
`requireCheckbox(checkedValue)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte que l'entrée corresponde à la valeur spécifiée ou soit vide.
`requireCheckbox(checkedValue, uncheckedValue)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte que l'entrée soit l'une des valeurs spécifiées.
`requireDate()`	`DataValidationBuilder`	Définit la règle de validation des données de sorte qu'elle exige une date.
`requireDateAfter(date)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte qu'une date soit postérieure à la valeur donnée.
`requireDateBefore(date)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte qu'une date soit antérieure à la valeur donnée.
`requireDateBetween(start, end)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte qu'elle exige une date comprise entre deux (ou l'une de ces deux dates) les dates spécifiées.
`requireDateEqualTo(date)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte qu'elle exige une date égale à la valeur donnée.
`requireDateNotBetween(start, end)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte qu'il exige une date qui n'est ni comprise entre, ni autre, deux dates spécifiées.
`requireDateOnOrAfter(date)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte qu'une date soit égale ou postérieure à la valeur donnée.
`requireDateOnOrBefore(date)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte qu'une date soit égale ou antérieure à la valeur donnée.
`requireFormulaSatisfied(formula)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte que la formule donnée soit évaluée `true`.
`requireNumberBetween(start, end)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte qu'il exige un nombre compris entre deux, ou l'un de ces deux les nombres spécifiés.
`requireNumberEqualTo(number)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte qu'elle exige un nombre égal à la valeur donnée.
`requireNumberGreaterThan(number)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte qu'il exige un nombre supérieur à la valeur donnée.
`requireNumberGreaterThanOrEqualTo(number)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte qu'il exige un nombre supérieur ou égal à la valeur donnée.
`requireNumberLessThan(number)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte qu'il exige un nombre inférieur à la valeur donnée.
`requireNumberLessThanOrEqualTo(number)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte qu'il exige un nombre inférieur ou égal à la valeur donnée.
`requireNumberNotBetween(start, end)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte qu'il exige un nombre qui ne soit pas compris entre et qui n'est ni deux nombres spécifiés.
`requireNumberNotEqualTo(number)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte qu'il exige un nombre différent de la valeur donnée.
`requireTextContains(text)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte que l'entrée contienne la valeur donnée.
`requireTextDoesNotContain(text)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte que l'entrée ne contienne pas la valeur donnée.
`requireTextEqualTo(text)`	`DataValidationBuilder`	Définit la règle de validation des données pour exiger que la valeur saisie soit égale à la valeur donnée.
`requireTextIsEmail()`	`DataValidationBuilder`	Définit la règle de validation des données de sorte que les données saisies se présentent sous la forme d'une adresse e-mail.
`requireTextIsUrl()`	`DataValidationBuilder`	Définit la règle de validation des données de sorte que les données saisies se présentent sous la forme d'une URL.
`requireValueInList(values)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte que l'entrée soit égale à l'une des valeurs données.
`requireValueInList(values, showDropdown)`	`DataValidationBuilder`	Définit la règle de validation des données pour exiger que l'entrée soit égale à l'une des valeurs données, avec une option pour masquer le menu déroulant.
`requireValueInRange(range)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte que la valeur saisie soit égale à une valeur de la plage donnée.
`requireValueInRange(range, showDropdown)`	`DataValidationBuilder`	Définit la règle de validation des données de sorte que l'entrée soit égale à une valeur de la plage donnée. avec une option pour masquer le menu déroulant.
`setAllowInvalid(allowInvalidData)`	`DataValidationBuilder`	Détermine si un avertissement doit s'afficher en cas d'échec de validation des données ou s'il faut rejeter l'entrée entièrement.
`setHelpText(helpText)`	`DataValidationBuilder`	Définit le texte d'aide qui s'affiche lorsque l'utilisateur pointe sur la cellule pour laquelle la validation des données est effectuée défini.
`withCriteria(criteria, args)`	`DataValidationBuilder`	Définit la règle de validation des données sur les critères définis par les valeurs `DataValidationCriteria`. généralement issus des éléments `criteria` et `arguments` d'une règle existante.

Documentation détaillée

`build()`

Construit une règle de validation des données à partir des paramètres appliqués à l'outil de création.

Renvois

DataValidation : représentation de la règle de validation des données

`copy()`

Crée un outil de création pour une règle de validation des données en fonction des paramètres de cette règle.

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

Renvois

DataValidationBuilder : outil de création basé sur les paramètres de cette règle

`getAllowInvalid()`

Renvoie true si la règle affiche un avertissement lorsque l'entrée échoue à la validation des données, ou false si elle rejette complètement l'entrée. La valeur par défaut pour les nouvelles règles de validation des données est true.

Renvois

Boolean : true si la règle autorise une entrée qui échoue à la validation des données false si ce n'est pas le cas

`getCriteriaType()`

Récupère le type de critère de la règle tel que défini dans l'énumération DataValidationCriteria. Pour obtenir arguments pour les critères, utilisez getCriteriaValues(). Pour utiliser ces valeurs pour créer ou modifier une règle de validation des données, voir 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.')
}

Renvois

DataValidationCriteria : type de critères de validation des données

`getCriteriaValues()`

Récupère un tableau d'arguments pour les critères de la règle. Pour obtenir le type de critère, utilisez getCriteriaType(). Pour utiliser ces valeurs afin de créer ou de modifier une règle de validation des données, consultez 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.')
}

Renvois

Object[] : tableau d'arguments adaptés au type de critère de la règle. le nombre d'arguments et leur type correspondent à la méthode require...() correspondante de la classe DataValidationBuilder.

`getHelpText()`

Récupère le texte d'aide de la règle ou null si aucun texte d'aide n'est défini.

Renvois

String : texte d'aide de la règle ou null si aucun texte d'aide n'est défini

`requireCheckbox()`

Définit la règle de validation des données de sorte que l'entrée soit une valeur booléenne. cette valeur est sous forme de case à cocher.

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

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireCheckbox(checkedValue)`

Définit la règle de validation des données de sorte que l'entrée corresponde à la valeur spécifiée ou soit vide. Quand ? l'entrée correspond à la valeur spécifiée, la cellule s'affiche sous la forme d'une case cochée. Lorsque l'entrée est vide, la cellule s'affiche sous la forme d'une case décochée.

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

Paramètres

Nom	Type	Description
`checkedValue`	`Object`	Valeur attribuée à une case cochée.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireCheckbox(checkedValue, uncheckedValue)`

Définit la règle de validation des données de sorte que l'entrée soit l'une des valeurs spécifiées. Quand ? l'entrée est checkedValue. La cellule s'affiche sous la forme d'une case à cocher cochée. Lorsque l'entrée est uncheckedValue. La cellule s'affiche sous la forme d'une case décochée.

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

Paramètres

Nom	Type	Description
`checkedValue`	`Object`	Valeur attribuée à une case cochée.
`uncheckedValue`	`Object`	Valeur attribuée à une case décochée.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireDate()`

Définit la règle de validation des données de sorte qu'elle exige une date.

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

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireDateAfter(date)`

Définit la règle de validation des données de sorte qu'une date soit postérieure à la valeur donnée. Les champs temporels Les objets Date sont ignorés. seuls les champs de jour, de mois et d'année sont utilisés.

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

Paramètres

Nom	Type	Description
`date`	`Date`	Date maximale non autorisée.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireDateBefore(date)`

Définit la règle de validation des données de sorte qu'une date soit antérieure à la valeur donnée. Les champs temporels Les objets Date sont ignorés. seuls les champs de jour, de mois et d'année sont utilisés.

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

Paramètres

Nom	Type	Description
`date`	`Date`	Date non autorisée la plus ancienne.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireDateBetween(start, end)`

Définit la règle de validation des données de sorte qu'elle exige une date comprise entre deux (ou l'une de ces deux dates) les dates spécifiées. Les champs de temps des objets Date sont ignorés. uniquement le jour, le mois, et année sont utilisés.

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

Paramètres

Nom	Type	Description
`start`	`Date`	Date acceptable la plus proche.
`end`	`Date`	Date la plus récente autorisée.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireDateEqualTo(date)`

Définit la règle de validation des données de sorte qu'elle exige une date égale à la valeur donnée. Les champs de temps de les objets Date sont ignorés ; seuls les champs de jour, de mois et d'année sont utilisés.

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

Paramètres

Nom	Type	Description
`date`	`Date`	Seule date autorisée.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireDateNotBetween(start, end)`

Définit la règle de validation des données de sorte qu'il exige une date qui n'est pas comprise entre, et n'est aucune des deux, deux dates spécifiées. Les champs de temps des objets Date sont ignorés. uniquement le jour, les champs de mois et d’année sont utilisés.

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

Paramètres

Nom	Type	Description
`start`	`Date`	Date non autorisée la plus ancienne.
`end`	`Date`	Date maximale non autorisée.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireDateOnOrAfter(date)`

Définit la règle de validation des données de sorte qu'une date soit égale ou postérieure à la valeur donnée. Les champs de temps de les objets Date sont ignorés ; seuls les champs de jour, de mois et d'année sont utilisés.

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

Paramètres

Nom	Type	Description
`date`	`Date`	Date acceptable la plus proche.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireDateOnOrBefore(date)`

Définit la règle de validation des données de sorte qu'une date soit égale ou antérieure à la valeur donnée. Champs de temps de l'objet Date sont ignorés. seuls les champs de jour, de mois et d'année sont utilisés.

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

Paramètres

Nom	Type	Description
`date`	`Date`	Date la plus récente autorisée.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireFormulaSatisfied(formula)`

Définit la règle de validation des données de sorte que la formule donnée soit évaluée 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);

Paramètres

Nom	Type	Description
`formula`	`String`	Une formule personnalisée qui renvoie `true` si l'entrée est valide.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireNumberBetween(start, end)`

Définit la règle de validation des données de sorte qu'il exige un nombre compris entre deux, ou l'un de ces deux les nombres spécifiés.

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

Paramètres

Nom	Type	Description
`start`	`Number`	Valeur acceptable la plus faible.
`end`	`Number`	Valeur acceptable la plus élevée.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireNumberEqualTo(number)`

Définit la règle de validation des données de sorte qu'elle exige un nombre égal à la valeur donnée.

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

Paramètres

Nom	Type	Description
`number`	`Number`	La seule valeur autorisée.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireNumberGreaterThan(number)`

Définit la règle de validation des données de sorte qu'il exige un nombre supérieur à la valeur donnée.

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

Paramètres

Nom	Type	Description
`number`	`Number`	Valeur inacceptable la plus élevée.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireNumberGreaterThanOrEqualTo(number)`

Définit la règle de validation des données de sorte qu'il exige un nombre supérieur ou égal à la valeur donnée.

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

Paramètres

Nom	Type	Description
`number`	`Number`	Valeur acceptable la plus faible.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireNumberLessThan(number)`

Définit la règle de validation des données de sorte qu'il exige un nombre inférieur à la valeur donnée.

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

Paramètres

Nom	Type	Description
`number`	`Number`	Valeur inacceptable la plus faible.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireNumberLessThanOrEqualTo(number)`

Définit la règle de validation des données de sorte qu'il exige un nombre inférieur ou égal à la valeur donnée.

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

Paramètres

Nom	Type	Description
`number`	`Number`	Valeur acceptable la plus élevée.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireNumberNotBetween(start, end)`

Définit la règle de validation des données de sorte qu'il exige un nombre qui ne soit pas compris entre et qui n'est ni deux nombres spécifiés.

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

Paramètres

Nom	Type	Description
`start`	`Number`	Valeur inacceptable la plus faible.
`end`	`Number`	Valeur inacceptable la plus élevée.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireNumberNotEqualTo(number)`

Définit la règle de validation des données de sorte qu'il exige un nombre différent de la valeur donnée.

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

Paramètres

Nom	Type	Description
`number`	`Number`	La seule valeur non autorisée.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireTextContains(text)`

Définit la règle de validation des données de sorte que l'entrée contienne la valeur donnée.

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

Paramètres

Nom	Type	Description
`text`	`String`	Valeur que l'entrée doit contenir.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireTextDoesNotContain(text)`

Définit la règle de validation des données de sorte que l'entrée ne contienne pas la valeur donnée.

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

Paramètres

Nom	Type	Description
`text`	`String`	Valeur que l'entrée ne doit pas contenir.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireTextEqualTo(text)`

Définit la règle de validation des données pour exiger que la valeur saisie soit égale à la valeur donnée.

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

Paramètres

Nom	Type	Description
`text`	`String`	La seule valeur autorisée.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireTextIsEmail()`

Définit la règle de validation des données de sorte que les données saisies se présentent sous la forme d'une adresse e-mail.

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

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireTextIsUrl()`

Définit la règle de validation des données de sorte que les données saisies se présentent sous la forme d'une 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);

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireValueInList(values)`

Définit la règle de validation des données de sorte que l'entrée soit égale à l'une des valeurs données.

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

Paramètres

Nom	Type	Description
`values`	`String[]`	Tableau de valeurs acceptables.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireValueInList(values, showDropdown)`

Définit la règle de validation des données pour exiger que l'entrée soit égale à l'une des valeurs données, avec une option pour masquer le menu déroulant.

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

Paramètres

Nom	Type	Description
`values`	`String[]`	Tableau de valeurs acceptables.
`showDropdown`	`Boolean`	`true` si la feuille de calcul doit afficher un menu déroulant pour les valeurs ; `false` si ce n'est pas le cas.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireValueInRange(range)`

Définit la règle de validation des données de sorte que la valeur saisie soit égale à une valeur de la plage donnée.

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

Paramètres

Nom	Type	Description
`range`	`Range`	Une plage qui contient les valeurs acceptables.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`requireValueInRange(range, showDropdown)`

Définit la règle de validation des données pour exiger que l'entrée soit égale à une valeur de la plage donnée, avec une option pour masquer le menu déroulant.

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

Paramètres

Nom	Type	Description
`range`	`Range`	Une plage qui contient les valeurs acceptables.
`showDropdown`	`Boolean`	`true` si la feuille de calcul doit afficher un menu déroulant pour les valeurs ; `false` si ce n'est pas le cas.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`setAllowInvalid(allowInvalidData)`

Détermine si un avertissement doit s'afficher en cas d'échec de validation des données ou si la saisie est rejetée entièrement. La valeur par défaut pour les nouvelles règles de validation des données est true.

Paramètres

Nom	Type	Description
`allowInvalidData`	`Boolean`	`true` si la règle doit autoriser une entrée qui échoue à la validation des données ; `false` si ce n'est pas le cas.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`setHelpText(helpText)`

Définit le texte d'aide qui s'affiche lorsque l'utilisateur pointe sur la cellule pour laquelle la validation des données est effectuée défini.

Paramètres

Nom	Type	Description
`helpText`	`String`	Texte d'aide à définir.

Renvois

DataValidationBuilder : compilateur, pour le chaînage

`withCriteria(criteria, args)`

Définit la règle de validation des données sur les critères définis par les valeurs DataValidationCriteria. généralement issus des éléments criteria et arguments d'une règle existante.

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

Paramètres

Nom	Type	Description
`criteria`	`DataValidationCriteria`	Type de critères de validation des données.
`args`	`Object[]`	Tableau d'arguments adaptés au type de critère. le nombre d'arguments leur type correspond à la méthode `require...()` correspondante ci-dessus.

Renvois

DataValidationBuilder : compilateur, pour le chaînage