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 | Tworzy regułę sprawdzania poprawności danych na podstawie ustawień zastosowanych do kreatora. |
copy() | DataValidationBuilder | Tworzy kreator reguły sprawdzania poprawności danych na podstawie jej ustawień. |
getAllowInvalid() | Boolean | 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. |
getCriteriaType() | DataValidationCriteria | Pobiera typ kryteriów reguły określony w wyliczenie 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 został ustawiony żaden tekst pomocy. |
requireCheckbox() | DataValidationBuilder | Ustawia regułę weryfikacji danych tak, by dane wejściowe były wartością logiczną. ta wartość to jako pole wyboru. |
requireCheckbox(checkedValue) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych tak, aby dane wejściowe miały określoną wartość lub były puste. |
requireCheckbox(checkedValue, uncheckedValue) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych tak, by wpisana wartość była jedną z określonych wartości. |
requireDate() | DataValidationBuilder | Ustawia, że reguła sprawdzania poprawności danych wymaga podania daty. |
requireDateAfter(date) | DataValidationBuilder | Ustawia, aby reguła sprawdzania poprawności danych wymagała daty po podanej wartości. |
requireDateBefore(date) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty poprzedzającej podaną wartość. |
requireDateBetween(start, end) | DataValidationBuilder | 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. |
requireDateEqualTo(date) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty równej podanej wartości. |
requireDateNotBetween(start, end) | DataValidationBuilder | Ustawia regułę weryfikacji danych tak, aby wymagała daty, która nie mieści się między dwóch określonych dat. |
requireDateOnOrAfter(date) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty podanej w podanej wartości lub po niej. |
requireDateOnOrBefore(date) | DataValidationBuilder | Ustawia, że reguła sprawdzania poprawności danych wymaga podania daty podanej w podanej wartości lub przed nią. |
requireFormulaSatisfied(formula) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych tak, by określona formuła zwracała wartość true . |
requireNumberBetween(start, end) | DataValidationBuilder | 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. |
requireNumberEqualTo(number) | DataValidationBuilder | Ustawia, że reguła sprawdzania poprawności danych wymaga podania liczby równej podanej wartości. |
requireNumberGreaterThan(number) | DataValidationBuilder | Ustawia regułę weryfikacji danych tak, by wymagała liczby większej od podanej wartości. |
requireNumberGreaterThanOrEqualTo(number) | DataValidationBuilder | Ustawia regułę weryfikacji danych tak, by wymagana była liczba większa lub równa podanej wartości. |
requireNumberLessThan(number) | DataValidationBuilder | Ustawia regułę weryfikacji danych tak, by wymagała liczby mniejszej od podanej wartości. |
requireNumberLessThanOrEqualTo(number) | DataValidationBuilder | Ustawia, aby reguła sprawdzania poprawności danych wymagała liczby równej lub mniejszej od podanej wartości. |
requireNumberNotBetween(start, end) | DataValidationBuilder | Ustawia regułę weryfikacji danych tak, by wymagała liczby, która nie mieści się między dwóch określonych liczb. |
requireNumberNotEqualTo(number) | DataValidationBuilder | Ustawia, że reguła sprawdzania poprawności danych wymaga podania liczby różnej od podanej wartości. |
requireTextContains(text) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych tak, aby dane wejściowe zawierały określoną wartość. |
requireTextDoesNotContain(text) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych tak, aby dane wejściowe nie zawierały podanej wartości. |
requireTextEqualTo(text) | DataValidationBuilder | Ustawia regułę sprawdzania poprawności danych tak, aby dane wejściowe były równe podanej wartości. |
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, by dane wejściowe miały postać adresu URL. |
requireValueInList(values) | DataValidationBuilder | Ustawia regułę weryfikacji danych tak, by dane wejściowe były równa jednej z podanych wartości. |
requireValueInList(values, showDropdown) | DataValidationBuilder | Ustawia regułę weryfikacji danych tak, by dane wejściowe były równa jednej z podanych wartości. z opcją ukrycia menu. |
requireValueInRange(range) | DataValidationBuilder | Ustawia regułę weryfikacji danych tak, by dane wejściowe były równa wartości z podanego zakresu. |
requireValueInRange(range, showDropdown) | DataValidationBuilder | Ustawia regułę weryfikacji danych tak, aby dane wejściowe były równa wartości z danego zakresu. z opcją ukrycia menu. |
setAllowInvalid(allowInvalidData) | DataValidationBuilder | Określa, czy wyświetlać ostrzeżenie, gdy dane wejściowe nie przejdą weryfikacji, czy odrzucić dane wejściowe całkowicie. |
setHelpText(helpText) | DataValidationBuilder | Ustawia 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) | 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 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
Boolean
– true
, 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
Nazwa | Typ | Opis |
---|---|---|
checkedValue | Object | Wartość 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
Nazwa | Typ | Opis |
---|---|---|
checkedValue | Object | Wartość przypisana do zaznaczonego pola. |
uncheckedValue | Object | Wartość 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
Nazwa | Typ | Opis |
---|---|---|
date | Date | Ostatnia 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
Nazwa | Typ | Opis |
---|---|---|
date | Date | Najwcześ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
Nazwa | Typ | Opis |
---|---|---|
start | Date | Najwcześniejszą dopuszczalną datę. |
end | Date | Najpóź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
Nazwa | Typ | Opis |
---|---|---|
date | Date | Jedyna 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
Nazwa | Typ | Opis |
---|---|---|
start | Date | Najwcześniejsza niedopuszczalna data. |
end | Date | Ostatnia 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
Nazwa | Typ | Opis |
---|---|---|
date | Date | Najwcześ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
Nazwa | Typ | Opis |
---|---|---|
date | Date | Najpóź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
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 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
Nazwa | Typ | Opis |
---|---|---|
start | Number | Najniższa akceptowana wartość. |
end | Number | Najwyż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
Nazwa | Typ | Opis |
---|---|---|
number | Number | Jedyna 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
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najwyż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
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najniż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
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najniż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
Nazwa | Typ | Opis |
---|---|---|
number | Number | Najwyż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
Nazwa | Typ | Opis |
---|---|---|
start | Number | Najniższa niedopuszczalna wartość. |
end | Number | Najwyż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
Nazwa | Typ | Opis |
---|---|---|
number | Number | Jedyna 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
Nazwa | Typ | Opis |
---|---|---|
text | String | Wartość, 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
Nazwa | Typ | Opis |
---|---|---|
text | String | Wartość, 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
Nazwa | Typ | Opis |
---|---|---|
text | String | Jedyna 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
Nazwa | Typ | Opis |
---|---|---|
values | String[] | 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
Nazwa | Typ | Opis |
---|---|---|
values | String[] | Tablica akceptowanych wartości. |
showDropdown | Boolean | true , 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
Nazwa | Typ | Opis |
---|---|---|
range | Range | Zakres zawierający akceptowane wartości. |
Powrót
DataValidationBuilder
– ten kreator do tworzenia łańcuchów
requireValueInRange(range, showDropdown)
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
Nazwa | Typ | Opis |
---|---|---|
range | Range | Zakres zawierający akceptowane wartości. |
showDropdown | Boolean | true , 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
Nazwa | Typ | Opis |
---|---|---|
allowInvalidData | Boolean | true , 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
Nazwa | Typ | Opis |
---|---|---|
helpText | String | Tekst 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
Nazwa | Typ | Opis |
---|---|---|
criteria | DataValidationCriteria | Typ kryteriów sprawdzania poprawności danych. |
args | Object[] | 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