הפונקציה Validate

חל על: אפליקציות קנבס אפליקציות מונחות דגמים

הפונקציה Validate בודקת אם הערך של עמודה בודדת או רשומה מלאה הוא חוקי עבור מקור נתונים.

תיאור

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

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

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

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

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

אם Validate מוצאת בעיה, הפונקציה מחזירה הודעת שגיאה שתוכל להציג למשתמש של היישום. אם כל הערכים חוקיים, Validate מחזירה Blank. כשאתה עובד עם אוסף שאינו כולל מידע אימות, הערכים חוקיים תמיד.

תחביר

אימות( מקור נתונים, עמודה, ערך )

• DataSource – חובה. מקור הנתונים שמולו יש לבצע אימות.
• עמודה – חובה. העמודה שיש לאמת.
• ערך – חובה. הערך עבור העמודה הנבחרת שיש לאמת.

Validate( מקור נתונים, OriginalRecord, עדכונים )

• DataSource – חובה. מקור הנתונים שמולו יש לבצע אימות.
• OriginalRecord - חובה. הרשומה שיש לאמת את העדכונים עבורה.
• עדכונים - נדרשים. השינויים שיש להחיל על הרשומה המקורית.

דוגמאות

עבור דוגמאות אלה, הערכים בעמודה Percentage של מקור הנתונים Scores חייבים להיות בין 0 ל- 100, כולל. אם הנתונים עוברים את האימות בהצלחה, הפונקציה מחזירה ריק. אם לא, הפונקציה מחזירה הודעת שגיאה.

Validate עם עמודה יחידה

נוסחה	תיאור	תוצאה
אימות (ציונים, אחוז, 10)	בדיקה אם 10 הוא ערך חוקי עבור העמודה Percentage במקור הנתונים Scores.	רֵיק
אימות (ציונים, אחוז, 120)	בדיקה אם 120 הוא ערך חוקי עבור העמודה Percentage במקור הנתונים Scores.	"הערכים חייבים להיות בין 0 ל- 100."

Validate עם רשומה מלאה

נוסחה	תיאור	תוצאה
אימות (ציונים, EditRecord, Gallery.Updates)	בדיקה אם הערכים בכל העמודות חוקיים עבור מקור הנתונים Scores. בדוגמה זו, הערך בעמודה Percentage הוא 10.	רֵיק
אימות (ציונים, EditRecord, Gallery.Updates)	בדיקה אם הערכים בכל העמודות חוקיים עבור מקור הנתונים Scores. בדוגמה זו, הערך בעמודה Percentage הוא 120.	"הערכים חייבים להיות בין 0 ל- 100."