Class DataValidation

DataValidation

डेटा की पुष्टि करने के नियमों को ऐक्सेस करें. नया नियम बनाने के लिए, SpreadsheetApp.newDataValidation() और DataValidationBuilder का इस्तेमाल करें. किसी रेंज के लिए पुष्टि करने का नियम सेट करने के लिए, 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.');
}

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
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.
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);

वापसी का टिकट

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

वापसी का टिकट

DataValidationCriteria — डेटा की पुष्टि करने की शर्तों का टाइप

getCriteriaValues()

नियम के मानदंड के लिए, आर्ग्युमेंट की एक कैटगरी मिलती है. मानदंड का टाइप पाने के लिए, getCriteriaType() का इस्तेमाल करें. डेटा की पुष्टि करने का नियम बनाने या उसमें बदलाव करने के लिए, इन वैल्यू का इस्तेमाल करने के बारे में जानने के लिए, 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.');
}

वापसी का टिकट

Object[] — यह नियम की शर्त के टाइप के हिसाब से, ऑर्ग्युमेंट का एक कलेक्शन होता है. ऑर्ग्युमेंट की संख्या और उनका टाइप, DataValidationBuilder क्लास के require...() तरीके से मेल खाता है

getHelpText()

नियम के लिए सहायता टेक्स्ट मिलता है. अगर कोई सहायता टेक्स्ट सेट नहीं किया गया है, तो null मिलता है.

वापसी का टिकट

String — नियम के बारे में जानकारी देने वाला टेक्स्ट या null, अगर कोई जानकारी देने वाला टेक्स्ट सेट नहीं किया गया है