Class DataValidation

Weryfikacja danych

Otwieranie reguł sprawdzania poprawności danych. Aby utworzyć nową regułę, użyj elementów SpreadsheetApp.newDataValidation() i DataValidationBuilder. Aby ustawić regułę walidacji dla zakresu, możesz użyć opcji Range.setDataValidation(rule). 

// 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.');
}

Metody

MetodaZwracany typKrótki opis
copy()DataValidationBuilderTworzy kreator reguły walidacji danych na podstawie jej ustawień.
getAllowInvalid()BooleanZwraca 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()DataValidationCriteriaPobiera typ kryteriów reguły z typu wyliczenia DataValidationCriteria.
getCriteriaValues()Object[]Pobiera tablicę argumentów dla kryteriów reguły.
getHelpText()StringPobiera tekst pomocy do reguły lub null, jeśli nie ma ustawionego tekstu pomocy.

Szczegółowa dokumentacja

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 DataValidationBuilder.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 DataValidationBuilder.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