Class DataValidation

DataValidation

데이터 유효성 검사 규칙에 액세스합니다. 새 규칙을 만들려면 SpreadsheetApp.newDataValidation() 및 DataValidationBuilder를 사용하세요. 이때 Range.setDataValidation(rule): 범위의 유효성 검사 규칙을 설정합니다.

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

메서드

메서드	반환 유형	간략한 설명
copy()	DataValidationBuilder	이 규칙의 설정을 기반으로 데이터 유효성 검사 규칙을 위한 빌더를 만듭니다.
getAllowInvalid()	Boolean	입력이 데이터 유효성 검사에 실패할 때 규칙을 경고를 표시하는 경우 true를 반환하고 입력을 완전히 거부하면 false를 반환합니다.
getCriteriaType()	DataValidationCriteria	DataValidationCriteria enum에 정의된 대로 규칙의 기준 유형을 가져옵니다.
getCriteriaValues()	Object[]	규칙 기준에 대한 인수 배열을 가져옵니다.
getHelpText()	String	규칙의 도움말 텍스트를 가져오거나, 설정된 도움말 텍스트가 없는 경우 null를 가져옵니다.

자세한 문서

copy()

이 규칙의 설정을 기반으로 데이터 유효성 검사 규칙을 위한 빌더를 만듭니다.

// 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);

리턴

DataValidationBuilder: 이 규칙의 설정을 기반으로 하는 빌더입니다.

---

getAllowInvalid()

입력이 데이터 유효성 검사에 실패할 때 규칙을 경고를 표시하는 경우 true를 반환하고 입력을 완전히 거부하면 false를 반환합니다. 새 데이터 확인 규칙의 기본값은 true입니다.

리턴

Boolean: 규칙에서 데이터 유효성 검사에 실패한 입력을 허용하는 경우 true 그렇지 않은 경우 false

---

getCriteriaType()

DataValidationCriteria enum에 정의된 대로 규칙의 기준 유형을 가져옵니다. 이 기준에 대한 인수가 있으면 getCriteriaValues()를 사용합니다. 이러한 값을 사용하여 데이터 유효성 검사 규칙을 수정하는 방법은 DataValidationBuilder.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.')
}

리턴

DataValidationCriteria: 데이터 검증 기준의 유형

---

getCriteriaValues()

규칙 기준에 대한 인수 배열을 가져옵니다. 기준 유형을 가져오려면 getCriteriaType()를 사용합니다. 이러한 값을 사용하여 데이터 확인 규칙을 만들거나 수정하려면 DataValidationBuilder.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.')
}

리턴

Object[]: 규칙의 기준 유형에 적합한 인수의 배열입니다. 인수 수 유형은 DataValidationBuilder 클래스의 상응하는 require...() 메서드와 일치합니다.

---

getHelpText()

규칙의 도움말 텍스트를 가져오거나, 설정된 도움말 텍스트가 없는 경우 null를 가져옵니다.

리턴

String: 규칙의 도움말 텍스트 또는 설정된 도움말 텍스트가 없는 경우 null