Class DataValidationBuilder

DataValidationBuilder

הכלי ליצירת כללים לאימות נתונים.

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

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
build()	DataValidation	יצירת כלל לאימות נתונים מההגדרות שחלות על ה-builder.
copy()	DataValidationBuilder	יצירת בונה לכלל אימות נתונים על סמך ההגדרות של הכלל הזה.
getAllowInvalid()	Boolean	הפונקציה מחזירה את הערך true אם הכלל מציג אזהרה כשהקלט נכשל בתיקוף הנתונים, או את הערך false אם הוא דוחה את הקלט לחלוטין.
getCriteriaType()	DataValidationCriteria	הפונקציה מקבלת את סוג הקריטריונים של הכלל כפי שהוא מוגדר במערך הערכים הקבועים 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()

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

חזרה

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

---

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 – ה-builder מבוסס על ההגדרות של הכלל הזה

---

getAllowInvalid()

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

חזרה

Boolean — true אם הכלל מאפשר קלט שלא עובר אימות נתונים, false אם לא

---

getCriteriaType()

הפונקציה מקבלת את סוג הקריטריונים של הכלל כפי שהוא מוגדר במערך הערכים הקבועים DataValidationCriteria. כדי לקבל את הארגומנטים של הקריטריונים, משתמשים ב-getCriteriaValues(). כדי להשתמש בערכים האלה ליצירה או לשינוי של כלל לאימות נתונים, אפשר לעיין בקטע 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(). במאמר 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[] – מערך של ארגומנטים שמתאימים לסוג הקריטריונים של הכלל. מספר הארגומנטים והסוג שלהם תואמים לשיטה 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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation().requireCheckbox().build();
cell.setDataValidation(rule);

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireCheckbox(checkedValue)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireCheckbox(checkedValue, uncheckedValue)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireDate()

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

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireDateAfter(date)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireDateBefore(date)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireDateBetween(start, end)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireDateEqualTo(date)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireDateNotBetween(start, end)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireDateOnOrAfter(date)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireDateOnOrBefore(date)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireFormulaSatisfied(formula)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireNumberBetween(start, end)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireNumberEqualTo(number)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireNumberGreaterThan(number)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireNumberGreaterThanOrEqualTo(number)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireNumberLessThan(number)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireNumberLessThanOrEqualTo(number)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireNumberNotBetween(start, end)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireNumberNotEqualTo(number)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireTextContains(text)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireTextDoesNotContain(text)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireTextEqualTo(text)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireTextIsEmail()

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

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireTextIsUrl()

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

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireValueInList(values)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireValueInList(values, showDropdown)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireValueInRange(range)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

requireValueInRange(range, showDropdown)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

setAllowInvalid(allowInvalidData)

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

setHelpText(helpText)

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור

---

withCriteria(criteria, args)

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

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

פרמטרים

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

חזרה

DataValidationBuilder – ה-builder הזה, לשרשור