Ta strona została przetłumaczona przez Cloud Translation API.

Class 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 kreatorze.
`copy()`	`DataValidationBuilder`	Tworzy kreator reguły walidacji danych na podstawie jej ustawień.
`getAllowInvalid()`	`Boolean`	Zwraca wartość `true`, jeśli reguła wyświetla ostrzeżenie, gdy dane nie przejdą weryfikacji, lub wartość `false`, jeśli dane zostaną całkowicie odrzucone.
`getCriteriaType()`	`DataValidationCriteria`	Pobiera typ kryteriów reguły z typu wyliczenia `DataValidationCriteria`.
`getCriteriaValues()`	`Object[]`	Pobiera tablicę argumentów dla kryteriów reguły.
`getHelpText()`	`String`	Pobiera tekst pomocy do reguły lub `null`, jeśli nie ma ustawionego tekstu pomocy.
`requireCheckbox()`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dane wejściowe były wartością logiczną. Wartość ta jest renderowana jako pole wyboru.
`requireCheckbox(checkedValue)`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dane wejściowe miały określoną wartość lub były puste.
`requireCheckbox(checkedValue, uncheckedValue)`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, 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 tak, aby wymagała daty po podanej wartości.
`requireDateBefore(date)`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty wcześniejszej niż podana wartość.
`requireDateBetween(start, end)`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty, która mieści się między dwoma określonymi datami lub jest jedną z tych 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łę sprawdzania poprawności danych tak, aby wymagała daty, która nie mieści się w okresie między dwoma podanymi datami i nie jest żadną z nich.
`requireDateOnOrAfter(date)`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty, która jest równa podanej wartości lub późniejsza.
`requireDateOnOrBefore(date)`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty, która jest równa lub wcześniejsza od podanej wartości.
`requireFormulaSatisfied(formula)`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dana formuła zwracała wartość `true`.
`requireNumberBetween(start, end)`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała liczby, która mieści się między dwoma określonymi liczbami lub jest jedną z tych liczb.
`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 tak, aby wymagała liczby większej od podanej wartości.
`requireNumberGreaterThanOrEqualTo(number)`	`DataValidationBuilder`	Ustawia regułę sprawdzania danych tak, aby wymagała liczby większej lub równej podanej wartości.
`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 danych, aby wymagała liczby mniejszej lub równej podanej wartości.
`requireNumberNotBetween(start, end)`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała liczby, która nie mieści się między dwoma podanymi liczbami i nie jest równa żadnej z nich.
`requireNumberNotEqualTo(number)`	`DataValidationBuilder`	Ustawia regułę weryfikacji danych tak, aby wymagała liczby, która nie jest równa podanej wartości.
`requireTextContains(text)`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dane wejściowe zawierały określoną wartość.
`requireTextDoesNotContain(text)`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dane wejściowe nie zawierały określonej wartości.
`requireTextEqualTo(text)`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dane wejściowe były równe podanej wartości.
`requireTextIsEmail()`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dane wejściowe miały postać adresu e-mail.
`requireTextIsUrl()`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dane wejściowe były w formie adresu URL.
`requireValueInList(values)`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dane wejściowe były równe jednej z podanych wartości.
`requireValueInList(values, showDropdown)`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dane wejściowe były równe jednej z podanych wartości. Dostępna jest opcja ukrycia menu.
`requireValueInRange(range)`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby podany tekst był równy wartości w podanym zakresie.
`requireValueInRange(range, showDropdown)`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dane wejściowe były równe wartości w podanym zakresie. Możesz też ukryć menu.
`setAllowInvalid(allowInvalidData)`	`DataValidationBuilder`	Określa, czy wyświetlić ostrzeżenie, gdy dane nie przejdą weryfikacji, czy odrzucić dane całkowicie.
`setHelpText(helpText)`	`DataValidationBuilder`	Określa tekst pomocy, który pojawia się, gdy użytkownik najedzie na komórkę z włączoną walidacją danych.
`withCriteria(criteria, args)`	`DataValidationBuilder`	Ustawia regułę sprawdzania poprawności danych na kryteria zdefiniowane przez wartości `DataValidationCriteria`, które są zwykle pobierane z elementów `criteria` i `arguments` istniejącej reguły.

Szczegółowa dokumentacja

`build()`

Tworzy regułę sprawdzania poprawności danych na podstawie ustawień zastosowanych w kreatorze.

Powrót

DataValidation – reprezentacja reguły sprawdzania poprawności danych

`copy()`

Tworzy kreator reguły walidacji danych na podstawie jej ustawień.

// 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 – kreator na podstawie ustawień tej reguły.

`getAllowInvalid()`

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

Powrót

Boolean – true, jeśli reguła zezwala na dane, które nie spełniają kryteriów sprawdzania poprawności; false, jeśli nie zezwala.

`getCriteriaType()`

Pobiera typ kryteriów reguły z typu wyliczenia DataValidationCriteria. Aby uzyskać argumenty dla kryteriów, użyj getCriteriaValues(). Aby użyć tych wartości do utworzenia lub zmodyfikowania reguły sprawdzania poprawności danych, zapoznaj się z 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 kryteriów, użyj właściwości getCriteriaType(). Aby użyć tych wartości do utworzenia lub zmodyfikowania reguły sprawdzania poprawności danych, zapoznaj się z 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

Object[] – tablica argumentów odpowiednich do typu kryteriów reguły; liczba argumentów i ich typ odpowiadają odpowiadającej metodzie require...() klasy DataValidationBuilder.

`getHelpText()`

Pobiera tekst pomocy do reguły lub null, jeśli nie ma ustawionego tekstu pomocy.

Powrót

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

`requireCheckbox()`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dane wejściowe były wartością logiczną. Wartość ta 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 kreator do łańcuchowania

`requireCheckbox(checkedValue)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dane wejściowe miały określoną wartość lub były puste. Gdy dane wejściowe pasują do określonej wartości, komórka jest renderowana jako zaznaczone pole wyboru. Gdy dane 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.
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 zaznaczenia pola wyboru.

Powrót

DataValidationBuilder – ten kreator do łańcuchowania

`requireCheckbox(checkedValue, uncheckedValue)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dane wejściowe były jedną ze wskazanych wartości. Jeśli dane wejściowe to checkedValue, komórka jest renderowana jako zaznaczone pole wyboru. Gdy dane wejściowe to uncheckedValue, komórka jest renderowana jako pole wyboru odznaczone.

// 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 zaznaczenia pola wyboru.
`uncheckedValue`	`Object`	Wartość przypisana do niezaznaczonego pola wyboru.

Powrót

DataValidationBuilder – ten kreator do łańcuchowania

`requireDate()`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała 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 kreator do łańcuchowania

`requireDateAfter(date)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty po podanej wartości. Pola czasu obiektu Date są ignorowane; używane są tylko pola dzień, miesiąc i rok.

// 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óźnie dopuszczalna data.

Powrót

DataValidationBuilder – ten kreator do łańcuchowania

`requireDateBefore(date)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty wcześniejszej niż podana wartość. Pola czasu obiektu Date są ignorowane; używane są tylko pola dzień, miesiąc i rok.

// 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 kreator do łańcuchowania

`requireDateBetween(start, end)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty, która mieści się między dwoma określonymi datami lub jest jedną z tych dat. Pola czasu obiektów Date są ignorowane; używane są tylko pola dzień, miesiąc i rok.

// 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 dopuszczalna data.
`end`	`Date`	Najpóźnie do tej daty.

Powrót

DataValidationBuilder – ten kreator do łańcuchowania

`requireDateEqualTo(date)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty równej podanej wartości. Pola czasu obiektu Date są ignorowane; używane są tylko pola dzień, miesiąc i rok.

// 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 dopuszczalna data.

Powrót

DataValidationBuilder – ten kreator do łańcuchowania

`requireDateNotBetween(start, end)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty, która nie mieści się w okresie między dwoma podanymi datami i nie jest żadną z nich. Pola czasu obiektów Date są ignorowane; używane są tylko pola dzień, miesiąc i rok.

// 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óźnie dopuszczalna data.

Powrót

DataValidationBuilder – ten kreator do łańcuchowania

`requireDateOnOrAfter(date)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty, która jest równa podanej wartości lub późniejsza. Pola czasu obiektu Date są ignorowane; używane są tylko pola dzień, miesiąc i rok.

// 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 dopuszczalna data.

Powrót

DataValidationBuilder – ten kreator do łańcuchowania

`requireDateOnOrBefore(date)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała daty, która jest równa lub wcześniejsza od podanej wartości. Pola czasu obiektu Date są ignorowane; używane są tylko pola dzień, miesiąc i rok.

// 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óźnie do tej daty.

Powrót

DataValidationBuilder – ten kreator do łańcuchowania

`requireFormulaSatisfied(formula)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dana formuła zwracała 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 kreator do łańcuchowania

`requireNumberBetween(start, end)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała liczby, która mieści się między dwoma określonymi liczbami lub jest jedną z tych liczb.

// 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 dopuszczalna wartość.
`end`	`Number`	Najwyższa dopuszczalna wartość.

Powrót

DataValidationBuilder – ten kreator do łańcuchowania

`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.
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 kreator do łańcuchowania

`requireNumberGreaterThan(number)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała liczby większej od podanej wartości.

// 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 kreator do łańcuchowania

`requireNumberGreaterThanOrEqualTo(number)`

Ustawia regułę sprawdzania danych tak, aby wymagała 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 dopuszczalna wartość.

Powrót

DataValidationBuilder – ten kreator do łańcuchowania

`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.
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 kreator do łańcuchowania

`requireNumberLessThanOrEqualTo(number)`

Ustawia regułę sprawdzania danych, aby wymagała 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 kreator do łańcuchowania

`requireNumberNotBetween(start, end)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała liczby, która nie mieści się między dwoma podanymi liczbami i nie jest równa żadnej 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 kreator do łańcuchowania

`requireNumberNotEqualTo(number)`

Ustawia regułę weryfikacji danych tak, aby wymagała liczby, która nie jest równa 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 kreator do łańcuchowania

`requireTextContains(text)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dane wejściowe zawierały określoną 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 kreator do łańcuchowania

`requireTextDoesNotContain(text)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dane wejściowe nie zawierały określonej 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 kreator do łańcuchowania

`requireTextEqualTo(text)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, 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 kreator do łańcuchowania

`requireTextIsEmail()`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, 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 kreator do łańcuchowania

`requireTextIsUrl()`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dane wejściowe były w formie 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 kreator do łańcuchowania

`requireValueInList(values)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, 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 kreator do łańcuchowania

`requireValueInList(values, showDropdown)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dane wejściowe były równe jednej z podanych wartości. Dostępna jest opcja 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 arkusze kalkulacyjne mają wyświetlać menu wartości;`false`, jeśli nie.

Powrót

DataValidationBuilder – ten kreator do łańcuchowania

`requireValueInRange(range)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby podany tekst był równy wartości w podanym zakresie.

// 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 kreator do łańcuchowania

`requireValueInRange(range, showDropdown)`

Ustawia regułę sprawdzania poprawności danych tak, aby wymagała, aby dane wejściowe były równe wartości w podanym zakresie. Możesz też ukryć 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 arkusze kalkulacyjne mają wyświetlać menu wartości;`false`, jeśli nie.

Powrót

DataValidationBuilder – ten kreator do łańcuchowania

`setAllowInvalid(allowInvalidData)`

Określa, czy wyświetlić ostrzeżenie, gdy dane nie przejdą weryfikacji, czy odrzucić dane całkowicie. Domyślna wartość dla nowych reguł sprawdzania poprawności danych to true.

Parametry

Nazwa	Typ	Opis
`allowInvalidData`	`Boolean`	`true`, jeśli reguła ma zezwalać na dane, które nie przeszły weryfikacji; `false`, jeśli nie.

Powrót

DataValidationBuilder – ten kreator do łańcuchowania

`setHelpText(helpText)`

Określa tekst pomocy, który pojawia się, gdy użytkownik najedzie na komórkę z włączoną walidacją danych.

Parametry

Nazwa	Typ	Opis
`helpText`	`String`	Tekst pomocy do ustawienia.

Powrót

DataValidationBuilder – ten kreator do łańcuchowania

`withCriteria(criteria, args)`

Ustawia regułę sprawdzania poprawności danych na kryteria zdefiniowane przez wartości DataValidationCriteria, które są zwykle pobierane z elementów 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 kryteriów; liczba argumentów i ich typ odpowiadają odpowiadającej metodzie `require...()` podanej powyżej.

Powrót

DataValidationBuilder – ten kreator do łańcuchowania