הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
חל על:
אפליקציות Canvas המבוססות על מודלים
הפונקציה Validate בודקת אם הערך של עמודה בודדת או רשומה שלמה חוקי עבור מקור נתונים.
תיאור
לפני שמשתמש מגיש שינוי בנתונים, באפשרותך לספק משוב מיידי על התקפות של אותה הגשה, דבר המוביל לחוויית משתמש טובה יותר.
מקורות נתונים יכולים לספק מידע על הנתונים המהווים ערכים חוקיים ברשומה. מידע זה יכול לכלול אילוצים רבים, כגון דוגמאות אלה:
- האם עמודה דורשת ערך
- באיזה אורך מחרוזת טקסט יכולה להיות
- כמה גבוה ונמוך מספר יכול להיות
- כמה מוקדם ומאוחר תאריך יכול להיות
הפונקציה Validate משתמשת במידע זה כדי לקבוע אם ערך תקף ולהחזיר הודעת שגיאה מתאימה אם לא. באפשרותך להשתמש בפונקציה DataSourceInfo כדי להציג את אותו מידע שבו נעשה Validate שימוש.
מקורות נתונים שונים זה מזה בכמות מידע האימות שהם מספקים, ויש מקורות נתונים שאינם מספקים מידע זה כלל. Validate יכול לאמת ערכים בהתבסס על מידע זה בלבד. גם אם Validate לא נמצאה בעיה, החלת שינוי הנתונים עשויה עדיין להיכשל. באפשרותך להשתמש בפונקציה Errors לקבלת מידע אודות הכשל.
אם Validate הפונקציה מוצאת בעיה, הפונקציה מחזירה הודעת שגיאה שניתן להציג למשתמש של היישום. אם כל הערכים חוקיים, הפונקציה Validate מחזירה ערך ריק. כשאתה עובד עם אוסף שאינו כולל מידע אימות, הערכים חוקיים תמיד.
תחביר
Validate( DataSource, Column, Value )
- DataSource – נדרש. מקור הנתונים שמולו יש לבצע אימות.
- עמודה – חובה. העמודה שיש לאמת.
- ערך – חובה. הערך עבור העמודה הנבחרת שיש לאמת.
Validate( DataSource, OriginalRecord, Updates )
- DataSource – נדרש. מקור הנתונים שמולו יש לבצע אימות.
- OriginalRecord - חובה. הרשומה שיש לאמת את העדכונים עבורה.
- עדכונים - נדרשים. השינויים שיש להחיל על הרשומה המקורית.
דוגמאות
עבור דוגמאות אלה, הערכים בעמודה Percentage של מקור הנתונים Scores חייבים להיות בין 0 ל- 100, כולל. אם הנתונים עוברים את האימות בהצלחה, הפונקציה מחזירה ריק. אם לא, הפונקציה מחזירה הודעת שגיאה.
Validate עם עמודה בודדת
| נוסחה | תיאור | תוצאה |
|---|---|---|
| Validate( ציונים, אחוזים, 10 ) | בדיקה אם 10 הוא ערך חוקי עבור העמודה Percentage במקור הנתונים Scores. | רֵיק |
| Validate( ציונים, אחוזים, 120 ) | בדיקה אם 120 הוא ערך חוקי עבור העמודה Percentage במקור הנתונים Scores. | "הערכים חייבים להיות בין 0 ל- 100." |
Validate עם רשומה מלאה
| נוסחה | תיאור | תוצאה |
|---|---|---|
| Validate( ציונים, EditRecord, Gallery.Updates ) | בדיקה אם הערכים בכל העמודות חוקיים עבור מקור הנתונים Scores. בדוגמה זו, הערך בעמודה Percentage הוא 10. | רֵיק |
| Validate( ציונים, EditRecord, Gallery.Updates ) | בדיקה אם הערכים בכל העמודות חוקיים עבור מקור הנתונים Scores. בדוגמה זו, הערך בעמודה Percentage הוא 120. | "הערכים חייבים להיות בין 0 ל- 100." |