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
Metoda | Zwracany typ | Krótki opis |
---|---|---|
build() | DataValidation | Konstruuje regułę sprawdzania poprawności danych na podstawie ustawień zastosowanych do kreatora. |
copy() | DataValidationBuilder | Tworzy konstruktor dla reguły sprawdzania poprawności danych na podstawie ustawień tej reguły. |
getAllowInvalid() | Boolean | 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. |
getCriteriaType() | DataValidationCriteria | Pobiera typ kryterium reguły zgodnie z definicją w wyliczeniu DataValidationCriteria . |
getCriteriaValues() | Object[] | Pobiera tablicę argumentów dla kryteriów reguły. |
getHelpText() | String | Pobiera tekst pomocy dotyczący reguły lub null , jeśli nie ustawiono żadnego tekstu pomocy. |
requireCheckbox() | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych tak, aby dane wejściowe były wartością logiczną. Ta wartość jest wyświetlana jako pole wyboru. |
requireCheckbox(checkedValue) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych w taki sposób, aby dane wejściowe zawierały określoną wartość lub były puste. |
requireCheckbox(checkedValue, uncheckedValue) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych w taki sposób, aby dane wejściowe były jedną ze wskazanych wartości. |
requireDate() | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty. |
requireDateAfter(date) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagana była data późniejsza niż określona wartość. |
requireDateBefore(date) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagana była data wcześniejsza niż podana wartość. |
requireDateBetween(start, end) | DataValidationBuilder | 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. |
requireDateEqualTo(date) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagała daty równej podanej wartości. |
requireDateNotBetween(start, end) | DataValidationBuilder | 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. |
requireDateOnOrAfter(date) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagana była data nie późniejsza niż o podanej wartości. |
requireDateOnOrBefore(date) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagana była data nie wcześniejsza niż określona wartość. |
requireFormulaSatisfied(formula) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych w taki sposób, aby dana formuła zwracała wartość true . |
requireNumberBetween(start, end) | DataValidationBuilder | 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. |
requireNumberEqualTo(number) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych tak, aby wymagała liczby równej podanej wartości. |
requireNumberGreaterThan(number) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagana liczba była większa od podanej wartości. |
requireNumberGreaterThanOrEqualTo(number) | DataValidationBuilder | 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. |
requireNumberLessThan(number) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych tak, aby wymagała liczby mniejszej od podanej wartości. |
requireNumberLessThanOrEqualTo(number) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagana liczba była mniejsza lub równa podanej wartości. |
requireNumberNotBetween(start, end) | DataValidationBuilder | 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. |
requireNumberNotEqualTo(number) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych w taki sposób, aby wymagana liczba nie była równa podanej wartości. |
requireTextContains(text) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych w taki sposób, aby dane wejściowe zawierały określoną wartość. |
requireTextDoesNotContain(text) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych w taki sposób, aby dane wejściowe nie zawierały podanej wartości. |
requireTextEqualTo(text) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych w taki sposób, aby dane wejściowe były identyczne z podanymi wartościami. |
requireTextIsEmail() | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych tak, aby dane wejściowe miały postać adresu e-mail. |
requireTextIsUrl() | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych tak, aby dane wejściowe miały postać adresu URL. |
requireValueInList(values) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych w taki sposób, aby dane wejściowe były identyczne z podanymi wartościami. |
requireValueInList(values, showDropdown) | DataValidationBuilder | 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. |
requireValueInRange(range) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych tak, aby dane wejściowe były równe wartości z danego zakresu. |
requireValueInRange(range, showDropdown) | DataValidationBuilder | 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. |
setAllowInvalid(allowInvalidData) | DataValidationBuilder | Określa, czy wyświetlać ostrzeżenie, gdy dane wejściowe nie przejdą weryfikacji danych, czy też całkowicie je odrzucić. |
setHelpText(helpText) | DataValidationBuilder | Ustawia tekst pomocy, który pojawia się, gdy użytkownik najedzie kursorem na komórkę, dla 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()
Konstruuje regułę sprawdzania poprawności danych na podstawie ustawień zastosowanych do kreatora.
Powroty
DataValidation
– reprezentacja reguły sprawdzania poprawności danych,
copy()
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,
getAllowInvalid()
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
getCriteriaType()
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,
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 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
getHelpText()
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.
requireCheckbox()
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
requireCheckbox(checkedValue)
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
Nazwa | Typ | Opis |
---|---|---|
checkedValue | Object | Wartość przypisana do zaznaczonego pola. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireCheckbox(checkedValue, uncheckedValue)
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
Nazwa | Typ | Opis |
---|---|---|
checkedValue | Object | Wartość przypisana do zaznaczonego pola. |
uncheckedValue | Object | Wartość przypisana do niezaznaczonego pola. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireDate()
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
requireDateAfter(date)
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
Nazwa | Typ | Opis |
---|---|---|
date | Date | Najnowsza niedopuszczalna data. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireDateBefore(date)
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
Nazwa | Typ | Opis |
---|---|---|
date | Date | Najwcześniejsza niedopuszczalna data. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireDateBetween(start, end)
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
Nazwa | Typ | Opis |
---|---|---|
start | Date | Najwcześniejsza dozwolona data. |
end | Date | Najnowsza akceptowana data. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireDateEqualTo(date)
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
Nazwa | Typ | Opis |
---|---|---|
date | Date | Jedyna akceptowalna data. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireDateNotBetween(start, end)
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
Nazwa | Typ | Opis |
---|---|---|
start | Date | Najwcześniejsza niedopuszczalna data. |
end | Date | Najnowsza niedopuszczalna data. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireDateOnOrAfter(date)
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
Nazwa | Typ | Opis |
---|---|---|
date | Date | Najwcześniejsza dozwolona data. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireDateOnOrBefore(date)
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
Nazwa | Typ | Opis |
---|---|---|
date | Date | Najnowsza akceptowana data. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireFormulaSatisfied(formula)
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
Nazwa | Typ | Opis |
---|---|---|
formula | String | Formuła niestandardowa, która zwraca wartość true , jeśli dane wejściowe są prawidłowe. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireNumberBetween(start, end)
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
Nazwa | Typ | Opis |
---|---|---|
start | Number | Najniższa akceptowalna wartość. |
end | Number | Najwyższa akceptowana wartość. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireNumberEqualTo(number)
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
Nazwa | Typ | Opis |
---|---|---|
number | Number | Jedyna akceptowalna wartość. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireNumberGreaterThan(number)
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
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najwyższa nieakceptowalna wartość. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireNumberGreaterThanOrEqualTo(number)
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
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najniższa akceptowalna wartość. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireNumberLessThan(number)
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
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najniższa niedopuszczalna wartość. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireNumberLessThanOrEqualTo(number)
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
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najwyższa akceptowana wartość. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireNumberNotBetween(start, end)
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
Nazwa | Typ | Opis |
---|---|---|
start | Number | Najniższa niedopuszczalna wartość. |
end | Number | Najwyższa nieakceptowalna wartość. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireNumberNotEqualTo(number)
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
Nazwa | Typ | Opis |
---|---|---|
number | Number | Jedyna niedopuszczalna wartość. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireTextContains(text)
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
Nazwa | Typ | Opis |
---|---|---|
text | String | Wartość, którą muszą zawierać dane wejściowe. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireTextDoesNotContain(text)
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
Nazwa | Typ | Opis |
---|---|---|
text | String | Wartość, której nie mogą zawierać dane wejściowe. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireTextEqualTo(text)
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
Nazwa | Typ | Opis |
---|---|---|
text | String | Jedyna akceptowalna wartość. |
Powroty
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);
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireTextIsUrl()
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
requireValueInList(values)
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
Nazwa | Typ | Opis |
---|---|---|
values | String[] | Tablica dopuszczalnych wartości. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireValueInList(values, showDropdown)
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
Nazwa | Typ | Opis |
---|---|---|
values | String[] | Tablica dopuszczalnych wartości. |
showDropdown | Boolean | true , jeśli arkusz kalkulacyjny powinien zawierać menu wartości; false , jeśli nie. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireValueInRange(range)
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
Nazwa | Typ | Opis |
---|---|---|
range | Range | Zakres zawierający dopuszczalne wartości. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireValueInRange(range, showDropdown)
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
Nazwa | Typ | Opis |
---|---|---|
range | Range | Zakres zawierający dopuszczalne wartości. |
showDropdown | Boolean | true , jeśli arkusz kalkulacyjny powinien zawierać menu wartości; false , jeśli nie. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
setAllowInvalid(allowInvalidData)
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
Nazwa | Typ | Opis |
---|---|---|
allowInvalidData | Boolean | true , jeśli reguła powinna zezwalać na dane wejściowe, które nie przejdą sprawdzania poprawności danych; false , jeśli nie. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
setHelpText(helpText)
Ustawia tekst pomocy, który pojawia się, gdy użytkownik najedzie kursorem na komórkę, dla której ustawiono sprawdzanie poprawności danych.
Parametry
Nazwa | Typ | Opis |
---|---|---|
helpText | String | Tekst pomocy do ustawienia. |
Powroty
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
Nazwa | Typ | Opis |
---|---|---|
criteria | DataValidationCriteria | Typ kryteriów sprawdzania poprawności danych. |
args | Object[] | Tablica argumentów odpowiednich do typu kryteriów; liczba argumentów i ich typ są zgodne z odpowiednią metodą require...() powyżej. |
Powroty
DataValidationBuilder
– ten kreator do tworzenia łańcuchów