Class DataValidationBuilder

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