כלי לבניית כללים לאימות נתונים.
// 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()
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
– הכלי הזה ליצירת שרשורים