Class DataValidationBuilder

DataValidationBuilder

כלי לבניית כללים לאימות נתונים.

// Set the data validation for cell A1 to require a value from B1:B10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

שיטות

שיטה	סוג הערך שמוחזר	תיאור קצר
build()	DataValidation	בונה כלל לאימות נתונים מההגדרות שהוחלו על הבונה.
copy()	DataValidationBuilder	יוצר כלי לבניית כלל לאימות נתונים על סמך ההגדרות של הכלל הזה.
getAllowInvalid()	Boolean	הפונקציה מחזירה את הערך true אם הכלל מציג אזהרה כשקלט נכשל באימות הנתונים, או false אם הקלט דוחה לחלוטין.
getCriteriaType()	DataValidationCriteria	הפונקציה מקבלת את סוג הקריטריונים של הכלל כפי שמוגדר בטיפוסים בני מנייה (enum) DataValidationCriteria.
getCriteriaValues()	Object[]	הפונקציה מקבלת מערך של ארגומנטים לפי הקריטריונים של הכלל.
getHelpText()	String	הפונקציה מקבלת את טקסט העזרה של הכלל, או null אם לא הוגדר טקסט עזרה.
requireCheckbox()	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שהקלט יהיה ערך בוליאני. הערך הזה מעובד כתיבת סימון.
requireCheckbox(checkedValue)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים שיחייב שהקלט יהיה הערך שצוין או שהוא ריק.
requireCheckbox(checkedValue, uncheckedValue)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים שיחייב שהקלט יהיה אחד מהערכים שצוינו.
requireDate()	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שיחייב תאריך.
requireDateAfter(date)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שיחייב תאריך אחרי הערך הנתון.
requireDateBefore(date)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שיחייב תאריך לפני הערך הנתון.
requireDateBetween(start, end)	DataValidationBuilder	המדיניות הזו מגדירה את הכלל לאימות נתונים כך שיחייב תאריך שיחול בין שני תאריכים מוגדרים או באחד מהתאריכים האלה.
requireDateEqualTo(date)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שיחייב תאריך השווה לערך הנתון.
requireDateNotBetween(start, end)	DataValidationBuilder	המדיניות הזו מגדירה את הכלל לאימות נתונים כך שיחייב תאריך שלא נמצא בין שני תאריכים מוגדרים או לא נכלל באף אחד מהם.
requireDateOnOrAfter(date)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שיחייב תאריך החל בערך הנתון או אחריו.
requireDateOnOrBefore(date)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שיחייב תאריך באותו הערך הנתון או לפניו.
requireFormulaSatisfied(formula)	DataValidationBuilder	המדיניות הזו מגדירה את הכלל לאימות נתונים כך שידרוש שהנוסחה הנתונה תקבל הערכה של true.
requireNumberBetween(start, end)	DataValidationBuilder	המדיניות הזו מגדירה את הכלל לאימות נתונים כך שיחייב מספר שנמצא בין שני מספרים שצוינו או שהוא אחד מהם.
requireNumberEqualTo(number)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שידרוש מספר השווה לערך הנתון.
requireNumberGreaterThan(number)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שידרוש מספר גדול מהערך הנתון.
requireNumberGreaterThanOrEqualTo(number)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שידרוש מספר גדול מהערך הנתון או שווה לו.
requireNumberLessThan(number)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שידרוש מספר קטן מהערך הנתון.
requireNumberLessThanOrEqualTo(number)	DataValidationBuilder	הגדרת הכלל לאימות נתונים כך שידרוש מספר קטן מהערך הנתון או שווה לו.
requireNumberNotBetween(start, end)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שיחייב מספר שאינו נופל בין שני מספרים שצוינו ואינו כלול בין שני מספרים.
requireNumberNotEqualTo(number)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שידרוש מספר שאינו שווה לערך הנתון.
requireTextContains(text)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שהקלט יכיל את הערך הנתון.
requireTextDoesNotContain(text)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שהקלט לא יכיל את הערך הנתון.
requireTextEqualTo(text)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שהקלט יהיה שווה לערך הנתון.
requireTextIsEmail()	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שהקלט יהיה בצורת כתובת אימייל.
requireTextIsUrl()	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שהקלט יהיה בצורת כתובת URL.
requireValueInList(values)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שהקלט יהיה שווה לאחד מהערכים הנתונים.
requireValueInList(values, showDropdown)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שהקלט יהיה שווה לאחד מהערכים הנתונים, עם אפשרות להסתיר את התפריט הנפתח.
requireValueInRange(range)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שהקלט יהיה שווה לערך בטווח הנתון.
requireValueInRange(range, showDropdown)	DataValidationBuilder	מגדירה את הכלל לאימות נתונים כך שהקלט יהיה שווה לערך בטווח הנתון, עם אפשרות להסתיר את התפריט הנפתח.
setAllowInvalid(allowInvalidData)	DataValidationBuilder	ההגדרה קובעת אם להציג אזהרה כשקלט נכשל באימות הנתונים או אם לדחות את הקלט לחלוטין.
setHelpText(helpText)	DataValidationBuilder	מגדירה את טקסט העזרה שמופיע כשהמשתמש מעביר את סמן העכבר מעל התא שבו מוגדר אימות הנתונים.
withCriteria(criteria, args)	DataValidationBuilder	המערכת מגדירה את כלל אימות הנתונים לקריטריון שהוגדר על ידי ערכי DataValidationCriteria. בדרך כלל נלקחים מהערכים criteria ו-arguments של כלל קיים.

תיעוד מפורט

build()

בונה כלל לאימות נתונים מההגדרות שהוחלו על הבונה.

החזרות

DataValidation – ייצוג של כלל אימות הנתונים

---

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()

הפונקציה מקבלת את סוג הקריטריונים של הכלל כפי שמוגדר בטיפוסים בני מנייה (enum) DataValidationCriteria. כדי לקבל את הארגומנטים של הקריטריונים, צריך להשתמש בפונקציה getCriteriaValues(). במאמר 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(). אם רוצים להשתמש בערכים האלה כדי ליצור או לשנות כלל לאימות נתונים, צריך לעבור לכתובת 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[] - מערך ארגומנטים שמתאים לסוג הקריטריונים של הכלל, מספר הארגומנטים והסוג שלהם תואמים לשיטת require...() המתאימה של המחלקה DataValidationBuilder

---

getHelpText()

הפונקציה מקבלת את טקסט העזרה של הכלל, או null אם לא הוגדר טקסט עזרה.

החזרות

String – טקסט העזרה של הכלל. לחלופין, null אם לא הוגדר טקסט עזרה

---

requireCheckbox()

מגדירה את הכלל לאימות נתונים כך שהקלט יהיה ערך בוליאני. הערך הזה מעובד כתיבת סימון.

// Set the data validation for cell A1 to require a boolean value; the value is rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox().build();
cell.setDataValidation(rule);

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireCheckbox(checkedValue)

מגדירה את הכלל לאימות נתונים שיחייב שהקלט יהיה הערך שצוין או שהוא ריק. כשהקלט תואם לערך שצוין, התא מעובד כתיבת סימון מסומנת. כשהקלט ריק, הוא מעובד כתיבת סימון שלא מסומנת.

// Set the data validation for cell A1 to require a custom checked value that is rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED').build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
checkedValue	Object	הערך שהוקצה לתיבת הסימון.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireCheckbox(checkedValue, uncheckedValue)

מגדירה את הכלל לאימות נתונים שיחייב שהקלט יהיה אחד מהערכים שצוינו. כשהקלט הוא checkedValue, העיבוד של התא מתבצע כתיבת סימון מסומנת. כשהקלט הוא uncheckedValue, העיבוד של התא מתבצע כתיבת סימון שלא מסומנת.

// Set the data validation for cell A1 to require custom checked values that are rendered as a
// checkbox.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireCheckbox('APPROVED', 'PENDING').build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
checkedValue	Object	הערך שהוקצה לתיבת הסימון.
uncheckedValue	Object	הערך שהוקצה לתיבה שלא סומנה.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireDate()

מגדירה את הכלל לאימות נתונים כך שיחייב תאריך.

// Set the data validation for cell A1 to require a date.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDate().build();
cell.setDataValidation(rule);

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireDateAfter(date)

מגדירה את הכלל לאימות נתונים כך שיחייב תאריך אחרי הערך הנתון. המערכת מתעלמת משדות הזמן של האובייקט Date. המערכת משתמשת רק בשדות של היום, החודש והשנה.

// Set the data validation for cell A1 to require a date after January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateAfter(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
date	Date	התאריך הלא קביל האחרון.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireDateBefore(date)

מגדירה את הכלל לאימות נתונים כך שיחייב תאריך לפני הערך הנתון. המערכת מתעלמת משדות הזמן של האובייקט Date. המערכת משתמשת רק בשדות של היום, החודש והשנה.

// Set the data validation for cell A1 to require a date before January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateBefore(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
date	Date	התאריך המוקדם ביותר שאינו קביל.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireDateBetween(start, end)

המדיניות הזו מגדירה את הכלל לאימות נתונים כך שיחייב תאריך שיחול בין שני תאריכים מוגדרים או באחד מהתאריכים האלה. המערכת מתעלמת משדות הזמן של האובייקטים Date. המערכת משתמשת רק בשדות של היום, החודש והשנה.

// Set the data validation for cell A1 to require a date in 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateBetween(new Date('1/1/2013'), new Date('12/31/2013')).build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
start	Date	התאריך המוקדם ביותר שמקובל.
end	Date	התאריך האחרון המקובל.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireDateEqualTo(date)

מגדירה את הכלל לאימות נתונים כך שיחייב תאריך השווה לערך הנתון. המערכת מתעלמת משדות הזמן של האובייקט Date. המערכת משתמשת רק בשדות של היום, החודש והשנה.

// Set the data validation for cell A1 to require a date equal to January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireDateEqualTo(new Date('1/1/2013'))
    .build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
date	Date	התאריך היחיד שמקובל.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireDateNotBetween(start, end)

המדיניות הזו מגדירה את הכלל לאימות נתונים כך שיחייב תאריך שלא נמצא בין שני תאריכים מוגדרים או לא נכלל באף אחד מהם. המערכת מתעלמת משדות הזמן של האובייקטים של Date. המערכת משתמשת רק בשדות של היום, החודש והשנה.

// Set the data validation for cell A1 to require a date not in 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateNotBetween(new Date('1/1/2013'), new Date('12/31/2013')).build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
start	Date	התאריך המוקדם ביותר שאינו קביל.
end	Date	התאריך הלא קביל האחרון.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireDateOnOrAfter(date)

מגדירה את הכלל לאימות נתונים כך שיחייב תאריך החל בערך הנתון או אחריו. המערכת מתעלמת משדות הזמן של האובייקט Date. המערכת משתמשת רק בשדות של היום, החודש והשנה.

// Set the data validation for cell A1 to require a date on or after January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateOnOrAfter(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
date	Date	התאריך המוקדם ביותר שמקובל.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireDateOnOrBefore(date)

מגדירה את הכלל לאימות נתונים כך שיחייב תאריך באותו הערך הנתון או לפניו. המערכת מתעלמת משדות הזמן של האובייקט Date. המערכת משתמשת רק בשדות של היום, החודש והשנה.

// Set the data validation for cell A1 to require a date on or before January 1, 2013.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation()
    .requireDateOnOrBefore(new Date('1/1/2013')).build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
date	Date	התאריך האחרון המקובל.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireFormulaSatisfied(formula)

המדיניות הזו מגדירה את הכלל לאימות נתונים כך שידרוש שהנוסחה הנתונה תקבל הערכה של true.

// Set the data validation for cell A1 to equal B1 with a custom formula.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireFormulaSatisfied('=EQ(A1,B1)').build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
formula	String	נוסחה מותאמת אישית שבודקת את הערך true אם הקלט חוקי.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireNumberBetween(start, end)

המדיניות הזו מגדירה את הכלל לאימות נתונים כך שיחייב מספר שנמצא בין שני מספרים שצוינו או שהוא אחד מהם.

// Set the data validation for cell A1 to require a number between 1 and 10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberBetween(1, 10).build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
start	Number	הערך המקובל הנמוך ביותר.
end	Number	הערך הקביל הגבוה ביותר.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireNumberEqualTo(number)

מגדירה את הכלל לאימות נתונים כך שידרוש מספר השווה לערך הנתון.

// Set the data validation for cell A1 to require a number equal to 3.1415926536.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberEqualTo(3.1415926536).build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
number	Number	הערך הקביל היחיד.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireNumberGreaterThan(number)

מגדירה את הכלל לאימות נתונים כך שידרוש מספר גדול מהערך הנתון.

// Set the data validation for cell A1 to require a number greater than 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThan(0).build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
number	Number	הערך הגבוה ביותר שאינו קביל.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireNumberGreaterThanOrEqualTo(number)

מגדירה את הכלל לאימות נתונים כך שידרוש מספר גדול מהערך הנתון או שווה לו.

// Set the data validation for cell A1 to require a number greater than or equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberGreaterThanOrEqualTo(0).build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
number	Number	הערך המקובל הנמוך ביותר.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireNumberLessThan(number)

מגדירה את הכלל לאימות נתונים כך שידרוש מספר קטן מהערך הנתון.

// Set the data validation for cell A1 to require a number less than 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThan(0).build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
number	Number	הערך הנמוך ביותר שאינו קביל.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireNumberLessThanOrEqualTo(number)

הגדרת הכלל לאימות נתונים כך שידרוש מספר קטן מהערך הנתון או שווה לו.

// Set the data validation for cell A1 to require a number less than or equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberLessThanOrEqualTo(0).build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
number	Number	הערך הקביל הגבוה ביותר.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireNumberNotBetween(start, end)

מגדירה את הכלל לאימות נתונים כך שיחייב מספר שאינו נופל בין שני מספרים שצוינו ואינו כלול בין שני מספרים.

// Set the data validation for cell A1 to require a number not between 1 and 10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberNotBetween(1, 10).build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
start	Number	הערך הנמוך ביותר שאינו קביל.
end	Number	הערך הגבוה ביותר שאינו קביל.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireNumberNotEqualTo(number)

מגדירה את הכלל לאימות נתונים כך שידרוש מספר שאינו שווה לערך הנתון.

// Set the data validation for cell A1 to require a number not equal to 0.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireNumberNotEqualTo(0).build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
number	Number	הערך היחיד שאינו קביל.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireTextContains(text)

מגדירה את הכלל לאימות נתונים כך שהקלט יכיל את הערך הנתון.

// Set the data validation for cell A1 to require any value that includes "Google".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextContains('Google').build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
text	String	הערך שהקלט חייב להכיל.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireTextDoesNotContain(text)

מגדירה את הכלל לאימות נתונים כך שהקלט לא יכיל את הערך הנתון.

// Set the data validation for cell A1 to require any value that does not include "@".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextDoesNotContain('@').build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
text	String	הערך שהקלט לא יכול להכיל.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireTextEqualTo(text)

מגדירה את הכלל לאימות נתונים כך שהקלט יהיה שווה לערך הנתון.

// Set the data validation for cell A1 to require "Yes".
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextEqualTo('Yes').build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
text	String	הערך הקביל היחיד.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireTextIsEmail()

מגדירה את הכלל לאימות נתונים כך שהקלט יהיה בצורת כתובת אימייל.

// Set the data validation for cell A1 to require text in the form of an email address.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextIsEmail().build();
cell.setDataValidation(rule);

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireTextIsUrl()

מגדירה את הכלל לאימות נתונים כך שהקלט יהיה בצורת כתובת URL.

// Set the data validation for cell A1 to require text in the form of a URL.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireTextIsUrl().build();
cell.setDataValidation(rule);

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireValueInList(values)

מגדירה את הכלל לאימות נתונים כך שהקלט יהיה שווה לאחד מהערכים הנתונים.

// Set the data validation for cell A1 to require "Yes" or "No", with a dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No']).build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
values	String[]	מערך של ערכים קבילים.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireValueInList(values, showDropdown)

מגדירה את הכלל לאימות נתונים כך שהקלט יהיה שווה לאחד מהערכים הנתונים, עם אפשרות להסתיר את התפריט הנפתח.

// Set the data validation for cell A1 to require "Yes" or "No", with no dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = SpreadsheetApp.newDataValidation().requireValueInList(['Yes', 'No'], false).build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
values	String[]	מערך של ערכים קבילים.
showDropdown	Boolean	true אם בגיליון האלקטרוני אמור להופיע תפריט נפתח לערכים. אם לא, false.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireValueInRange(range)

מגדירה את הכלל לאימות נתונים כך שהקלט יהיה שווה לערך בטווח הנתון.

// Set the data validation for cell A1 to require a value from B1:B10, with a dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
range	Range	טווח שמכיל את הערכים הקבילים.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

requireValueInRange(range, showDropdown)

מגדירה את הכלל לאימות נתונים כך שהקלט יהיה שווה לערך בטווח הנתון, עם אפשרות להסתיר את התפריט הנפתח.

// Set the data validation for cell A1 to require value from B1:B10, with no dropdown menu.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range, false).build();
cell.setDataValidation(rule);

פרמטרים

שם	תיאור	התיאור
range	Range	טווח שמכיל את הערכים הקבילים.
showDropdown	Boolean	true אם בגיליון האלקטרוני אמור להופיע תפריט נפתח לערכים. אם לא, false.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

setAllowInvalid(allowInvalidData)

ההגדרה קובעת אם להציג אזהרה כשקלט נכשל באימות הנתונים או אם לדחות את הקלט לחלוטין. ברירת המחדל לכללים חדשים לאימות נתונים היא true.

פרמטרים

שם	תיאור	התיאור
allowInvalidData	Boolean	true אם הכלל צריך לאפשר קלט שנכשל באימות הנתונים; false אם לא.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

setHelpText(helpText)

מגדירה את טקסט העזרה שמופיע כשהמשתמש מעביר את סמן העכבר מעל התא שבו מוגדר אימות הנתונים.

פרמטרים

שם	תיאור	התיאור
helpText	String	טקסט העזרה להגדרה.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים

---

withCriteria(criteria, args)

המערכת מגדירה את כלל אימות הנתונים לקריטריון שהוגדר על ידי ערכי DataValidationCriteria. בדרך כלל נלקחים מהערכים criteria ו-arguments של כלל קיים.

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

פרמטרים

שם	תיאור	התיאור
criteria	DataValidationCriteria	סוג הקריטריונים לאימות נתונים.
args	Object[]	מערך של ארגומנטים שמתאים לסוג הקריטריונים, מספר הארגומנטים והסוג שלהם תואמים לשיטה require...() התואמת שלמעלה.

החזרות

DataValidationBuilder – הכלי הזה ליצירת שרשורים