Class DataValidationBuilder

Konstruuje regułę sprawdzania poprawności danych na podstawie ustawień zastosowanych do kreatora.

Powroty

DataValidation – reprezentacja reguły sprawdzania poprawności danych,

Tworzy konstruktor dla reguły sprawdzania poprawności danych na podstawie ustawień tej reguły.

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

Powroty

DataValidationBuilder – kreator oparty na ustawieniach tej reguły,

Zwraca wartość true, jeśli reguła wyświetla ostrzeżenie, gdy dane wejściowe nie przejdą weryfikacji, lub false, jeśli dane wejściowe zostaną całkowicie odrzucone. Domyślnie nowe reguły sprawdzania poprawności danych to true.

Powroty

Boolean – true, jeśli reguła zezwala na dane wejściowe, których weryfikacja się nie powiodła; jeśli nie, false

Pobiera typ kryterium reguły zgodnie z definicją w wyliczeniu DataValidationCriteria. Aby uzyskać argumenty kryteriów, użyj getCriteriaValues(). Aby użyć tych wartości do utworzenia lub zmiany reguły sprawdzania poprawności danych, zobacz 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.')
}

Powroty

DataValidationCriteria – typ kryteriów sprawdzania poprawności danych,

Pobiera tablicę argumentów dla kryteriów reguły. Aby uzyskać typ kryterium, użyj getCriteriaType(). Aby użyć tych wartości do utworzenia lub zmiany reguły sprawdzania poprawności danych, zobacz 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.')
}

Powroty

Object[] – tablica argumentów odpowiednich do typu kryterium reguły; liczba argumentów i ich typ pasują do odpowiedniej metody require...() klasy DataValidationBuilder

Pobiera tekst pomocy dotyczący reguły lub null, jeśli nie ustawiono żadnego tekstu pomocy.

Powroty

String – tekst pomocy dotyczący reguły lub null, jeśli nie ustawiono tekstu pomocy.

Ustawia regułę sprawdzania poprawności danych tak, aby dane wejściowe były wartością logiczną. Ta wartość jest wyświetlana jako pole wyboru.

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

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby dane wejściowe zawierały określoną wartość lub były puste. Gdy dane wejściowe będą pasować do określonej wartości, komórka jest renderowana jako zaznaczone pole wyboru. Jeśli dane wejściowe są puste, komórka jest renderowana jako niezaznaczone pole wyboru.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby dane wejściowe były jedną ze wskazanych wartości. Jeśli dane wejściowe mają wartość checkedValue, komórka jest renderowana jako zaznaczone pole wyboru. Gdy dane wejściowe to uncheckedValue, komórka jest renderowana jako niezaznaczone pole wyboru.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty.

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

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagana była data późniejsza niż określona wartość. Pola czasu obiektu Date są ignorowane – używane są tylko pola dnia, miesiąca i roku.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagana była data wcześniejsza niż podana wartość. Pola czasu obiektu Date są ignorowane – używane są tylko pola dnia, miesiąca i roku.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby data przypadała pomiędzy 2 określonymi datami lub któraś z tych dat. Pola czasu obiektów Date są ignorowane – używane są tylko pola dnia, miesiąca i roku.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagała daty równej podanej wartości. Pola czasu obiektu Date są ignorowane – używane są tylko pola dnia, miesiąca i roku.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagała daty, która nie znajduje się między tymi dwoma datami i nie należy do nich. Pola czasu obiektów Date są ignorowane – używane są tylko pola dnia, miesiąca i roku.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagana była data nie późniejsza niż o podanej wartości. Pola czasu obiektu Date są ignorowane – używane są tylko pola dnia, miesiąca i roku.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagana była data nie wcześniejsza niż określona wartość. Pola czasu obiektu Date są ignorowane – używane są tylko pola dnia, miesiąca i roku.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby dana formuła zwracała wartość 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);

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagana była liczba, która mieści się między 2 określonymi liczbami lub jest jedną z tych dwóch.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała liczby równej podanej wartości.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagana liczba była większa od podanej wartości.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagana była liczba większa od podanej wartości lub jej równa.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała liczby mniejszej od podanej wartości.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagana liczba była mniejsza lub równa podanej wartości.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagana liczba nie znajdowała się między dwiema określonymi liczbami i nie była między nimi.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagana liczba nie była równa podanej wartości.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby dane wejściowe zawierały określoną wartość.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby dane wejściowe nie zawierały podanej wartości.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby dane wejściowe były identyczne z podanymi wartościami.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych tak, aby dane wejściowe miały postać adresu 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);

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych tak, aby dane wejściowe miały postać adresu 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);

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby dane wejściowe były identyczne z podanymi wartościami.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby dane wejściowe były identyczne z jedną z podanych wartości. Istnieje też możliwość ukrycia menu.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych tak, aby dane wejściowe były równe wartości z danego zakresu.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych w taki sposób, aby dane wejściowe były równe wartości z danego zakresu, a także dostępna była opcja ukrycia menu.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Określa, czy wyświetlać ostrzeżenie, gdy dane wejściowe nie przejdą weryfikacji danych, czy też całkowicie je odrzucić. Domyślnie nowe reguły sprawdzania poprawności danych to true.

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia tekst pomocy, który pojawia się, gdy użytkownik najedzie kursorem na komórkę, dla której ustawiono sprawdzanie poprawności danych.

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów

Ustawia regułę sprawdzania poprawności danych na kryteria zdefiniowane przez wartości DataValidationCriteria, zwykle pobierane z criteria i arguments istniejącej reguły.

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

Parametry

Powroty

DataValidationBuilder – ten kreator do tworzenia łańcuchów