Class DataValidationBuilder

DataValidationBuilder

Kreator reguł sprawdzania poprawności danych.

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

Metody

MetodaZwracany typKrótki opis
build()DataValidationTworzy regułę sprawdzania poprawności danych na podstawie ustawień zastosowanych do kreatora.
copy()DataValidationBuilderTworzy kreator reguły sprawdzania poprawności danych na podstawie jej ustawień.
getAllowInvalid()BooleanZwraca 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.
getCriteriaType()DataValidationCriteriaPobiera typ kryteriów reguły określony w wyliczenie DataValidationCriteria.
getCriteriaValues()Object[]Pobiera tablicę argumentów dla kryteriów reguły.
getHelpText()StringPobiera tekst pomocy dotyczący reguły lub null, jeśli nie został ustawiony żaden tekst pomocy.
requireCheckbox()DataValidationBuilderUstawia regułę weryfikacji danych tak, by dane wejściowe były wartością logiczną. ta wartość to jako pole wyboru.
requireCheckbox(checkedValue)DataValidationBuilderUstawia regułę sprawdzania poprawności danych tak, aby dane wejściowe miały określoną wartość lub były puste.
requireCheckbox(checkedValue, uncheckedValue)DataValidationBuilderUstawia regułę sprawdzania poprawności danych tak, by wpisana wartość była jedną z określonych wartości.
requireDate()DataValidationBuilderUstawia, że reguła sprawdzania poprawności danych wymaga podania daty.
requireDateAfter(date)DataValidationBuilderUstawia, aby reguła sprawdzania poprawności danych wymagała daty po podanej wartości.
requireDateBefore(date)DataValidationBuilderUstawia regułę sprawdzania poprawności danych tak, aby wymagała daty poprzedzającej podaną wartość.
requireDateBetween(start, end)DataValidationBuilderUstawia 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.
requireDateEqualTo(date)DataValidationBuilderUstawia regułę sprawdzania poprawności danych tak, aby wymagała daty równej podanej wartości.
requireDateNotBetween(start, end)DataValidationBuilderUstawia regułę weryfikacji danych tak, aby wymagała daty, która nie mieści się między dwóch określonych dat.
requireDateOnOrAfter(date)DataValidationBuilderUstawia regułę sprawdzania poprawności danych tak, aby wymagała daty podanej w podanej wartości lub po niej.
requireDateOnOrBefore(date)DataValidationBuilderUstawia, że reguła sprawdzania poprawności danych wymaga podania daty podanej w podanej wartości lub przed nią.
requireFormulaSatisfied(formula)DataValidationBuilderUstawia regułę sprawdzania poprawności danych tak, by określona formuła zwracała wartość true.
requireNumberBetween(start, end)DataValidationBuilderUstawia 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.
requireNumberEqualTo(number)DataValidationBuilderUstawia, że reguła sprawdzania poprawności danych wymaga podania liczby równej podanej wartości.
requireNumberGreaterThan(number)DataValidationBuilderUstawia regułę weryfikacji danych tak, by wymagała liczby większej od podanej wartości.
requireNumberGreaterThanOrEqualTo(number)DataValidationBuilderUstawia regułę weryfikacji danych tak, by wymagana była liczba większa lub równa podanej wartości.
requireNumberLessThan(number)DataValidationBuilderUstawia regułę weryfikacji danych tak, by wymagała liczby mniejszej od podanej wartości.
requireNumberLessThanOrEqualTo(number)DataValidationBuilderUstawia regułę weryfikacji danych tak, by wymagana była liczba mniejsza lub równa podanej wartości.
requireNumberNotBetween(start, end)DataValidationBuilderUstawia regułę weryfikacji danych tak, by wymagała liczby, która nie mieści się między dwóch określonych liczb.
requireNumberNotEqualTo(number)DataValidationBuilderUstawia, że reguła sprawdzania poprawności danych wymaga podania liczby różnej od podanej wartości.
requireTextContains(text)DataValidationBuilderUstawia regułę sprawdzania poprawności danych tak, aby dane wejściowe zawierały określoną wartość.
requireTextDoesNotContain(text)DataValidationBuilderUstawia regułę sprawdzania poprawności danych tak, aby dane wejściowe nie zawierały podanej wartości.
requireTextEqualTo(text)DataValidationBuilderUstawia regułę sprawdzania poprawności danych tak, aby dane wejściowe były równe podanej wartości.
requireTextIsEmail()DataValidationBuilderUstawia regułę sprawdzania poprawności danych tak, aby dane wejściowe miały postać adresu e-mail.
requireTextIsUrl()DataValidationBuilderUstawia regułę sprawdzania poprawności danych tak, by dane wejściowe miały postać adresu URL.
requireValueInList(values)DataValidationBuilderUstawia regułę weryfikacji danych tak, by dane wejściowe były równa jednej z podanych wartości.
requireValueInList(values, showDropdown)DataValidationBuilderUstawia regułę weryfikacji danych tak, by dane wejściowe były równa jednej z podanych wartości. z opcją ukrycia menu.
requireValueInRange(range)DataValidationBuilderUstawia regułę weryfikacji danych tak, by dane wejściowe były równa wartości z podanego zakresu.
requireValueInRange(range, showDropdown)DataValidationBuilderUstawia regułę weryfikacji danych tak, aby dane wejściowe były równa wartości z danego zakresu. z opcją ukrycia menu.
setAllowInvalid(allowInvalidData)DataValidationBuilderOkreśla, czy wyświetlać ostrzeżenie, gdy dane wejściowe nie przejdą weryfikacji, czy odrzucić dane wejściowe całkowicie.
setHelpText(helpText)DataValidationBuilderUstawia tekst pomocy, który wyświetla się, gdy użytkownik najedzie kursorem na komórkę, w której jest sprawdzana weryfikacja danych ustawiony.
withCriteria(criteria, args)DataValidationBuilderUstawia regułę sprawdzania poprawności danych na kryteria zdefiniowane przez wartości DataValidationCriteria, zwykle pobierane z criteria i arguments istniejącej reguły.

Szczegółowa dokumentacja

build()

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

Powrót

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


copy()

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


getAllowInvalid()

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

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


getCriteriaType()

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.


getCriteriaValues()

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


getHelpText()

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;


requireCheckbox()

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


requireCheckbox(checkedValue)

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

NazwaTypOpis
checkedValueObjectWartość przypisana do zaznaczonego pola.

Powrót

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


requireCheckbox(checkedValue, uncheckedValue)

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

NazwaTypOpis
checkedValueObjectWartość przypisana do zaznaczonego pola.
uncheckedValueObjectWartość przypisana do niezaznaczonego pola.

Powrót

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


requireDate()

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


requireDateAfter(date)

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

NazwaTypOpis
dateDateOstatnia niedopuszczalna data.

Powrót

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


requireDateBefore(date)

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

NazwaTypOpis
dateDateNajwcześniejsza niedopuszczalna data.

Powrót

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


requireDateBetween(start, end)

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

NazwaTypOpis
startDateNajwcześniejszą dopuszczalną datę.
endDateNajpóźniejsza dopuszczalna data.

Powrót

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


requireDateEqualTo(date)

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

NazwaTypOpis
dateDateJedyna dopuszczalna data.

Powrót

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


requireDateNotBetween(start, end)

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

NazwaTypOpis
startDateNajwcześniejsza niedopuszczalna data.
endDateOstatnia niedopuszczalna data.

Powrót

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


requireDateOnOrAfter(date)

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

NazwaTypOpis
dateDateNajwcześniejszą dopuszczalną datę.

Powrót

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


requireDateOnOrBefore(date)

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

NazwaTypOpis
dateDateNajpóźniejsza dopuszczalna data.

Powrót

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


requireFormulaSatisfied(formula)

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

NazwaTypOpis
formulaStringFormuła niestandardowa, która zwraca wartość true, jeśli dane wejściowe są prawidłowe.

Powrót

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


requireNumberBetween(start, end)

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

NazwaTypOpis
startNumberNajniższa akceptowana wartość.
endNumberNajwyższa akceptowalna wartość.

Powrót

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


requireNumberEqualTo(number)

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

NazwaTypOpis
numberNumberJedyna akceptowana wartość.

Powrót

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


requireNumberGreaterThan(number)

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

NazwaTypOpis
numberNumberNajwyższa niedopuszczalna wartość.

Powrót

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


requireNumberGreaterThanOrEqualTo(number)

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

NazwaTypOpis
numberNumberNajniższa akceptowana wartość.

Powrót

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


requireNumberLessThan(number)

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

NazwaTypOpis
numberNumberNajniższa niedopuszczalna wartość.

Powrót

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


requireNumberLessThanOrEqualTo(number)

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

NazwaTypOpis
numberNumberNajwyższa akceptowalna wartość.

Powrót

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


requireNumberNotBetween(start, end)

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

NazwaTypOpis
startNumberNajniższa niedopuszczalna wartość.
endNumberNajwyższa niedopuszczalna wartość.

Powrót

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


requireNumberNotEqualTo(number)

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

NazwaTypOpis
numberNumberJedyna niedopuszczalna wartość.

Powrót

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


requireTextContains(text)

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

NazwaTypOpis
textStringWartość, która musi zawierać dane wejściowe.

Powrót

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


requireTextDoesNotContain(text)

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

NazwaTypOpis
textStringWartość, której dane wejściowe nie mogą zawierać.

Powrót

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


requireTextEqualTo(text)

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

NazwaTypOpis
textStringJedyna akceptowana wartość.

Powrót

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


requireTextIsEmail()

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


requireTextIsUrl()

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


requireValueInList(values)

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

NazwaTypOpis
valuesString[]Tablica akceptowanych wartości.

Powrót

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


requireValueInList(values, showDropdown)

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

NazwaTypOpis
valuesString[]Tablica akceptowanych wartości.
showDropdownBooleantrue, jeśli arkusz kalkulacyjny powinien zawierać menu wartości; false, jeśli nie.

Powrót

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


requireValueInRange(range)

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

NazwaTypOpis
rangeRangeZakres zawierający akceptowane wartości.

Powrót

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


requireValueInRange(range, showDropdown)

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

NazwaTypOpis
rangeRangeZakres zawierający akceptowane wartości.
showDropdownBooleantrue, jeśli arkusz kalkulacyjny powinien zawierać menu wartości; false, jeśli nie.

Powrót

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


setAllowInvalid(allowInvalidData)

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

NazwaTypOpis
allowInvalidDataBooleantrue, jeśli reguła powinna zezwalać na dane wejściowe, które nie przeszły weryfikacji danych; false, jeśli nie.

Powrót

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


setHelpText(helpText)

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

NazwaTypOpis
helpTextStringTekst pomocy do ustawienia.

Powrót

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


withCriteria(criteria, args)

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

NazwaTypOpis
criteriaDataValidationCriteriaTyp kryteriów sprawdzania poprawności danych.
argsObject[]Tablica argumentów odpowiednich do typu kryterium; liczbę argumentów ich typ pasują do odpowiedniej metody require...() powyżej.

Powrót

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