Class DataValidationBuilder

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

Powrót

DataValidation – reprezentuje regułę sprawdzania poprawności danych.

Tworzy kreator reguły sprawdzania poprawności danych na podstawie jej ustawień.

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

Powrót

DataValidationBuilder – kreator oparty na ustawieniach tej reguły

Zwraca true, jeśli reguła wyświetla ostrzeżenie, gdy dane wejściowe nie przejdą weryfikacji, lub false, jeśli dane wejściowe są całkowicie odrzucone. Wartość domyślna nowych reguł sprawdzania poprawności danych to true.

Powrót

Boolean – true, jeśli reguła zezwala na dane wejściowe, które nie przeszły weryfikacji danych; false, jeśli nie

Pobiera typ kryteriów reguły określony w wyliczenie DataValidationCriteria. Aby uzyskać jako argumentów kryteriów użyj getCriteriaValues(). Aby użyć tych wartości do utworzenia lub zmienić regułę sprawdzania poprawności danych, patrz 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.')
}

Powrót

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

Powrót

Object[] – tablica argumentów odpowiednich do typu kryteriów 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 został ustawiony żaden tekst pomocy.

Powrót

String – tekst pomocy reguły lub null, jeśli nie ustawiono tekstu pomocy;

Ustawia regułę weryfikacji danych tak, by dane wejściowe były wartością logiczną. ta wartość to 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);

Powrót

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

Ustawia regułę sprawdzania poprawności danych tak, aby dane wejściowe miały określoną wartość lub były puste. Kiedy dane wejściowe odpowiadają określonej wartości, w której komórka jest renderowana jako zaznaczone pole wyboru. Gdy jest pusta, co oznacza, że 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

Powrót

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

Ustawia regułę sprawdzania poprawności danych tak, by wpisana wartość była jedną z określonych wartości. Kiedy dane wejściowe to 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

Powrót

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

Ustawia, że reguła sprawdzania poprawności danych wymaga podania 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);

Powrót

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

Ustawia, aby reguła sprawdzania poprawności danych wymagała daty po podanej wartości. Pola czasu Date obiekt jest ignorowany; można wykorzystać 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

Powrót

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

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty poprzedzającej podaną wartość. Pola czasu Date obiekt jest ignorowany; można wykorzystać 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

Powrót

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

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty mieszczącej się w dwóch z tych miejsc lub jednego z tych terminów określonych dat. Pola czasu obiektów Date są ignorowane. tylko dzień, miesiąc i rok.

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

Powrót

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

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty równej podanej wartości. Pola czasu funkcji obiekt Date jest ignorowany, można wykorzystać 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

Powrót

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

Ustawia regułę weryfikacji danych tak, aby wymagała daty, która nie mieści się między dwóch określonych dat. Pola czasu obiektów Date są ignorowane. tylko na dzień. 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

Powrót

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

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty podanej w podanej wartości lub po niej. Pola czasu funkcji obiekt Date jest ignorowany, można wykorzystać 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

Powrót

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

Ustawia, że reguła sprawdzania poprawności danych wymaga podania daty podanej w podanej wartości lub przed nią. Pola czasu z obiektów Date są ignorowane; można wykorzystać 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

Powrót

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

Ustawia regułę sprawdzania poprawności danych tak, by określona 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

Powrót

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

Ustawia regułę sprawdzania poprawności danych tak, by wymagana była liczba z zakresu od dwóch lub jednego z tych dwóch określonych liczb.

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

Powrót

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

Ustawia, że reguła sprawdzania poprawności danych wymaga podania 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

Powrót

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

Ustawia regułę weryfikacji danych tak, by wymagała liczby większej 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

Powrót

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

Ustawia regułę weryfikacji danych tak, by wymagana była liczba większa lub równa podanej wartości.

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

Powrót

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

Ustawia regułę weryfikacji danych tak, by 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

Powrót

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

Ustawia, aby reguła sprawdzania poprawności danych wymagała liczby równej lub mniejszej od 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

Powrót

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

Ustawia regułę weryfikacji danych tak, by wymagała liczby, która nie mieści się między dwóch określonych liczb.

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

Powrót

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

Ustawia, że reguła sprawdzania poprawności danych wymaga podania liczby różnej od 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

Powrót

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

Ustawia regułę sprawdzania poprawności danych tak, 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

Powrót

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

Ustawia regułę sprawdzania poprawności danych tak, 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

Powrót

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

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

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

Powrót

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

Powrót

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

Ustawia regułę sprawdzania poprawności danych tak, by 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);

Powrót

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

Ustawia regułę weryfikacji danych tak, by dane wejściowe były równa jednej z podanych wartości.

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

Powrót

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

Ustawia regułę weryfikacji danych tak, by dane wejściowe były równa jednej z podanych wartości. z opcją 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

Powrót

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

Ustawia regułę weryfikacji danych tak, by dane wejściowe były równa wartości z podanego 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

Powrót

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

Ustawia regułę weryfikacji danych tak, aby dane wejściowe były równa wartości z danego zakresu. z opcją 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

Powrót

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

Określa, czy wyświetlać ostrzeżenie, gdy dane wejściowe nie przejdą weryfikacji, czy odrzucić dane wejściowe całkowicie. Wartość domyślna nowych reguł sprawdzania poprawności danych to true.

Parametry

Powrót

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

Ustawia tekst pomocy, który wyświetla się, gdy użytkownik najedzie kursorem na komórkę, w której jest sprawdzana weryfikacja danych ustawiony.

Parametry

Powrót

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

Powrót

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