Class DataValidationBuilder

DataValidationBuilder

Kreator reguł sprawdzania poprawności danych.

// Set the data validation for cell A1 to require a value from B1:B10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Metody

Metoda	Zwracany typ	Krótki opis
build()	DataValidation	Tworzy regułę sprawdzania poprawności danych na podstawie ustawień zastosowanych w narzędziu do tworzenia.
copy()	DataValidationBuilder	Tworzy narzędzie do tworzenia reguły weryfikacji danych na podstawie ustawień tej reguły.
getAllowInvalid()	Boolean	Zwraca true, jeśli reguła wyświetla ostrzeżenie, gdy dane wejściowe nie przejdą weryfikacji danych, lub false, jeśli odrzuca dane wejściowe.
getCriteriaType()	DataValidationCriteria	Pobiera typ kryteriów reguły zdefiniowany w wyliczeniu DataValidationCriteria.
getCriteriaValues()	Object[]	Pobiera tablicę argumentów dla kryteriów reguły.
getHelpText()	String	Zwraca tekst pomocy reguły lub null, jeśli nie jest ustawiony żaden tekst pomocy.
requireCheckbox()	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga, aby dane wejściowe były wartością logiczną. Ta wartość jest renderowana jako pole wyboru.
requireCheckbox(checkedValue)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga, aby dane wejściowe były określoną wartością lub były puste.
requireCheckbox(checkedValue, uncheckedValue)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga, aby wprowadzana wartość była jedną z określonych wartości.
requireDate()	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga daty.
requireDateAfter(date)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga podania daty późniejszej niż podana wartość.
requireDateBefore(date)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga daty wcześniejszej niż podana wartość.
requireDateBetween(start, end)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga daty mieszczącej się między dwiema określonymi datami lub równej jednej z nich.
requireDateEqualTo(date)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga daty równej podanej wartości.
requireDateNotBetween(start, end)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga daty spoza zakresu dwóch określonych dat.
requireDateOnOrAfter(date)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga podania daty w podanej wartości lub późniejszej.
requireDateOnOrBefore(date)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga daty nie późniejszej niż podana wartość.
requireFormulaSatisfied(formula)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga, aby podany wzór zwracał wartość true.
requireNumberBetween(start, end)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga podania liczby mieszczącej się w zakresie dwóch określonych liczb lub równej jednej z nich.
requireNumberEqualTo(number)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga, aby liczba była równa podanej wartości.
requireNumberGreaterThan(number)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga podania liczby większej niż podana wartość.
requireNumberGreaterThanOrEqualTo(number)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga podania liczby większej lub równej podanej wartości.
requireNumberLessThan(number)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga podania liczby mniejszej od podanej wartości.
requireNumberLessThanOrEqualTo(number)	DataValidationBuilder	Ustawia regułę weryfikacji danych, która wymaga podania liczby mniejszej lub równej podanej wartości.
requireNumberNotBetween(start, end)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga podania liczby, która nie mieści się w przedziale między dwiema określonymi liczbami i nie jest żadną z nich.
requireNumberNotEqualTo(number)	DataValidationBuilder	Ustawia regułę weryfikacji danych, która wymaga podania liczby różnej od podanej wartości.
requireTextContains(text)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga, aby dane wejściowe zawierały podaną wartość.
requireTextDoesNotContain(text)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga, aby dane wejściowe nie zawierały podanej wartości.
requireTextEqualTo(text)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga, aby dane wejściowe były równe podanej wartości.
requireTextIsEmail()	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga, aby dane wejściowe miały postać adresu e-mail.
requireTextIsUrl()	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga, aby dane wejściowe miały postać adresu URL.
requireValueInList(values)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga, aby dane wejściowe były równe jednej z podanych wartości.
requireValueInList(values, showDropdown)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga, aby wprowadzana wartość była równa jednej z podanych wartości, z opcją ukrycia menu.
requireValueInRange(range)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga, aby dane wejściowe były równe wartości z podanego zakresu.
requireValueInRange(range, showDropdown)	DataValidationBuilder	Ustawia regułę sprawdzania poprawności danych, która wymaga, aby dane wejściowe były równe wartości z podanego zakresu, z opcją ukrycia menu.
setAllowInvalid(allowInvalidData)	DataValidationBuilder	Określa, czy w przypadku niepowodzenia weryfikacji danych należy wyświetlić ostrzeżenie, czy całkowicie odrzucić wprowadzone dane.
setHelpText(helpText)	DataValidationBuilder	Ustawia tekst pomocy, który pojawia się, gdy użytkownik najedzie kursorem na komórkę, w której ustawiono sprawdzanie poprawności danych.
withCriteria(criteria, args)	DataValidationBuilder	Ustawia 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 w narzędziu do tworzenia.

Powrót

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

---

copy()

Tworzy narzędzie do tworzenia reguły weryfikacji danych na podstawie ustawień tej reguły.

// Change existing data validation rules that require a date in 2013 to require
// a date in 2014.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    const rule = rules[i][j];

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const 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 – narzędzie do tworzenia na podstawie ustawień tej reguły.

---

getAllowInvalid()

Zwraca true, jeśli reguła wyświetla ostrzeżenie, gdy dane wejściowe nie przejdą weryfikacji danych, lub false, jeśli odrzuca dane wejściowe. Domyślna wartość nowych reguł sprawdzania poprawności danych to true.

Powrót

Boolean – true, jeśli reguła zezwala na wprowadzanie danych, które nie przejdą weryfikacji; false, jeśli nie.

---

getCriteriaType()

Pobiera typ kryteriów reguły zdefiniowany w wyliczeniu DataValidationCriteria. Aby uzyskać argumenty kryteriów, użyj funkcji getCriteriaValues(). Aby użyć tych wartości do utworzenia lub zmodyfikowania reguły sprawdzania poprawności danych, zapoznaj się z tym artykułem: withCriteria(criteria, args).

// Log information about the data validation rule for cell A1.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const 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, zapoznaj się z sekcją withCriteria(criteria, args).

// Log information about the data validation rule for cell A1.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const 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 dla typu kryteriów reguły; liczba argumentów i ich typ są zgodne z odpowiednią metodą require...() klasy DataValidationBuilder.

---

getHelpText()

Zwraca tekst pomocy reguły lub null, jeśli nie jest ustawiony żaden tekst pomocy.

Powrót

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

---

requireCheckbox()

Ustawia regułę sprawdzania poprawności danych, która wymaga, aby dane wejściowe były wartością logiczną. Ta wartość jest renderowana jako pole wyboru.

// Set the data validation for cell A1 to require a boolean value; the value is
// rendered as a checkbox.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireCheckbox().build();
cell.setDataValidation(rule);

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireCheckbox(checkedValue)

Ustawia regułę sprawdzania poprawności danych, która wymaga, aby dane wejściowe były określoną wartością lub były puste. Gdy dane wejściowe pasują do określonej wartości, komórka jest renderowana jako zaznaczone pole wyboru. Jeśli pole jest 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
checkedValue	Object	Wartość przypisana do zaznaczonego pola.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireCheckbox(checkedValue, uncheckedValue)

Ustawia regułę sprawdzania poprawności danych, która wymaga, aby wprowadzana wartość była jedną z określonych wartości. Gdy 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireCheckbox('APPROVED', 'PENDING')
                 .build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
checkedValue	Object	Wartość przypisana do zaznaczonego pola wyboru.
uncheckedValue	Object	Wartość przypisana do niezaznaczonego pola.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireDate()

Ustawia regułę sprawdzania poprawności danych, która wymaga daty.

// Set the data validation for cell A1 to require a date.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireDate().build();
cell.setDataValidation(rule);

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireDateAfter(date)

Ustawia regułę sprawdzania poprawności danych, która wymaga podania daty późniejszej 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 after January 1, 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateAfter(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
date	Date	Najpóźniejsza niedopuszczalna data.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireDateBefore(date)

Ustawia regułę sprawdzania poprawności danych, która wymaga daty wcześniejszej 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateBefore(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
date	Date	Najwcześniejsza niedopuszczalna data.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireDateBetween(start, end)

Ustawia regułę sprawdzania poprawności danych, która wymaga daty mieszczącej się między dwiema określonymi datami lub równej jednej z 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 in 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation()
        .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013'))
        .build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
start	Date	Najwcześniejsza akceptowalna data.
end	Date	Najpóźniejsza dopuszczalna data.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireDateEqualTo(date)

Ustawia regułę sprawdzania poprawności danych, która wymaga 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateEqualTo(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
date	Date	Jedyna akceptowana data.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireDateNotBetween(start, end)

Ustawia regułę sprawdzania poprawności danych, która wymaga daty spoza zakresu dwóch określonych 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 not in 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation()
        .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013'))
        .build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
start	Date	Najwcześniejsza niedopuszczalna data.
end	Date	Najpóźniejsza niedopuszczalna data.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireDateOnOrAfter(date)

Ustawia regułę sprawdzania poprawności danych, która wymaga podania daty w podanej wartości lub późniejszej. 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateOnOrAfter(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
date	Date	Najwcześniejsza akceptowalna data.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireDateOnOrBefore(date)

Ustawia regułę sprawdzania poprawności danych, która wymaga daty nie późniejszej 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 on or before January 1,
// 2013.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireDateOnOrBefore(new Date('1/1/2013'))
                 .build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
date	Date	Najpóźniejsza dopuszczalna data.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireFormulaSatisfied(formula)

Ustawia regułę sprawdzania poprawności danych, która wymaga, aby podany wzór zwracał wartość true.

// Set the data validation for cell A1 to equal B1 with a custom formula.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireFormulaSatisfied('=EQ(A1,B1)')
                 .build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
formula	String	Formuła niestandardowa, która zwraca wartość true, jeśli dane wejściowe są prawidłowe.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireNumberBetween(start, end)

Ustawia regułę sprawdzania poprawności danych, która wymaga podania liczby mieszczącej się w zakresie dwóch określonych liczb lub równej jednej z nich.

// Set the data validation for cell A1 to require a number between 1 and 10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberBetween(1, 10).build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
start	Number	Najniższa akceptowalna wartość.
end	Number	Najwyższa dopuszczalna wartość.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireNumberEqualTo(number)

Ustawia regułę sprawdzania poprawności danych, która wymaga, aby liczba była równa podanej wartości.

// Set the data validation for cell A1 to require a number equal
// to 3.1415926536.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberEqualTo(Math.PI).build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
number	Number	Jedyna dopuszczalna wartość.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireNumberGreaterThan(number)

Ustawia regułę sprawdzania poprawności danych, która wymaga podania liczby większej niż podana wartość.

// Set the data validation for cell A1 to require a number greater than 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
number	Number	Najwyższa niedopuszczalna wartość.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireNumberGreaterThanOrEqualTo(number)

Ustawia regułę weryfikacji danych, która wymaga podania liczby większej lub równej podanej wartości.

// Set the data validation for cell A1 to require a number greater than or equal
// to 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireNumberGreaterThanOrEqualTo(0)
                 .build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
number	Number	Najniższa akceptowalna wartość.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireNumberLessThan(number)

Ustawia regułę sprawdzania poprawności danych, która wymaga podania liczby mniejszej od podanej wartości.

// Set the data validation for cell A1 to require a number less than 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
number	Number	Najniższa niedopuszczalna wartość.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireNumberLessThanOrEqualTo(number)

Ustawia regułę weryfikacji danych, która wymaga podania liczby mniejszej lub równej podanej wartości.

// Set the data validation for cell A1 to require a number less than or equal to
// 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireNumberLessThanOrEqualTo(0)
                 .build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
number	Number	Najwyższa dopuszczalna wartość.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireNumberNotBetween(start, end)

Ustawia regułę sprawdzania poprawności danych, która wymaga podania liczby, która nie mieści się w przedziale między dwiema określonymi liczbami i nie jest żadną z nich.

// Set the data validation for cell A1 to require a number not between 1 and 10.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberNotBetween(1, 10).build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
start	Number	Najniższa niedopuszczalna wartość.
end	Number	Najwyższa niedopuszczalna wartość.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireNumberNotEqualTo(number)

Ustawia regułę weryfikacji danych, która wymaga podania liczby różnej od podanej wartości.

// Set the data validation for cell A1 to require a number not equal to 0.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
number	Number	Jedyna niedopuszczalna wartość.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireTextContains(text)

Ustawia regułę sprawdzania poprawności danych, która wymaga, aby dane wejściowe zawierały podaną wartość.

// Set the data validation for cell A1 to require any value that includes
// "Google".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextContains('Google').build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
text	String	Wartość, którą musi zawierać dane wejściowe.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireTextDoesNotContain(text)

Ustawia regułę sprawdzania poprawności danych, która wymaga, 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 "@".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
text	String	Wartość, której nie może zawierać dane wejściowe.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireTextEqualTo(text)

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

// Set the data validation for cell A1 to require "Yes".
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule =
    SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
text	String	Jedyna dopuszczalna wartość.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireTextIsEmail()

Ustawia regułę sprawdzania poprawności danych, która wymaga, 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build();
cell.setDataValidation(rule);

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireTextIsUrl()

Ustawia regułę sprawdzania poprawności danych, która wymaga, 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireTextIsUrl().build();
cell.setDataValidation(rule);

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireValueInList(values)

Ustawia regułę sprawdzania poprawności danych, która wymaga, aby dane wejściowe były równe jednej z podanych wartości.

// Set the data validation for cell A1 to require "Yes" or "No", with a dropdown
// menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireValueInList(['Yes', 'No'])
                 .build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
values	String[]	Tablica akceptowanych wartości.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireValueInList(values, showDropdown)

Ustawia regułę sprawdzania poprawności danych, która wymaga, aby wprowadzana wartość była 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireValueInList(['Yes', 'No'], false)
                 .build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
values	String[]	Tablica akceptowanych wartości.
showDropdown	Boolean	true – jeśli arkusz kalkulacyjny ma wyświetlać menu z wartościami;false – jeśli nie.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireValueInRange(range)

Ustawia regułę sprawdzania poprawności danych, która wymaga, aby dane wejściowe były równe wartości z podanego zakresu.

// Set the data validation for cell A1 to require a value from B1:B10, with a
// dropdown menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
range	Range	Zakres zawierający dopuszczalne wartości.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

requireValueInRange(range, showDropdown)

Ustawia regułę sprawdzania poprawności danych, która wymaga, aby dane wejściowe były równe wartości z podanego zakresu, z opcją ukrycia menu.

// Set the data validation for cell A1 to require value from B1:B10, with no
// dropdown menu.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const rule = SpreadsheetApp.newDataValidation()
                 .requireValueInRange(range, false)
                 .build();
cell.setDataValidation(rule);

Parametry

Nazwa	Typ	Opis
range	Range	Zakres zawierający dopuszczalne wartości.
showDropdown	Boolean	true – jeśli arkusz kalkulacyjny ma wyświetlać menu z wartościami;false – jeśli nie.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

setAllowInvalid(allowInvalidData)

Określa, czy w przypadku niepowodzenia weryfikacji danych należy wyświetlić ostrzeżenie, czy całkowicie odrzucić wprowadzone dane. Domyślna wartość nowych reguł sprawdzania poprawności danych to true.

Parametry

Nazwa	Typ	Opis
allowInvalidData	Boolean	true – jeśli reguła ma zezwalać na dane wejściowe, które nie przejdą weryfikacji danych; false – jeśli nie.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

setHelpText(helpText)

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

Parametry

Nazwa	Typ	Opis
helpText	String	Tekst pomocy do ustawienia.

Powrót

DataValidationBuilder – ten konstruktor do łączenia

---

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.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

for (let i = 0; i < rules.length; i++) {
  for (let j = 0; j < rules[i].length; j++) {
    const rule = rules[i][j];

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const 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

Nazwa	Typ	Opis
criteria	DataValidationCriteria	Typ kryteriów sprawdzania poprawności danych.
args	Object[]	Tablica argumentów odpowiednich dla typu kryterium. Liczba argumentów i ich typ są zgodne z odpowiednią metodą require...() powyżej.

Powrót

DataValidationBuilder – ten konstruktor do łączenia