इस पेज का अनुवाद Cloud Translation API से किया गया है.

Class DataValidation

डेटा की पुष्टि के नियमों को ऐक्सेस करें. नया नियम बनाने के लिए, SpreadsheetApp.newDataValidation() और DataValidationBuilder का इस्तेमाल करें. Google Analytics 4 पर माइग्रेट करने के लिए, किसी रेंज के लिए पुष्टि करने का नियम सेट करने के लिए, 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` की एनम में बताई गई नियम की शर्तों के टाइप का पता लगाता है.
`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 की एनम में बताई गई नियम की शर्तों के टाइप का पता लगाता है. पाने के लिए यहां दी गई सभी शर्तों को पूरा करने के लिए, 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