הפונקציה Revert

חל על: יישומי בד ציור

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

תיאור

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

עבור הרשומות שהוחזרו, Revert גם מנקה כל שגיאה מהטבלה שהפונקציה Errors החזירה.

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

ל- Revert אין ערך החזרה. באפשרותך להשתמש בה רק בנוסחה של אופן פעולה.

תחביר

Revert( DataSource [, Record ] )

• DataSource – נדרש. מקור הנתונים שברצונך להחזיר למצבו הקודם.
• Record – אופציונלי. הרשומה שברצונך להחזיר למצבה הקודם. אם לא תציין רשומה, כל מקור הנתונים יחזור למצבו הקודם.

דוגמה

בדוגמה זו, תחזיר למצבו הקודם את מקור הנתונים הנקרא גלידה, אשר מתחיל בנתונים בטבלה זו:

משתמש במכשיר אחר משנה את המאפיין Quantity‎ של הרשומה תות שדה ל- 400. בערך באותו זמן, אתה משנה את אותו המאפיין של אותה הרשומה ל- 500, מבלי לדעת על השינוי האחר.

אתה משתמש בפונקציה Patch כדי לעדכן את הרשומה:
Patch( IceCream, LookUp( IceCream, Flavor = "Strawberry" ), { Quantity: 500 } )

אתה בודק את הטבלה שגיאות ומוצא שגיאה:

רשומה	טורים	הודעה	שגיאה
{ ID: 1, Flavor: "Strawberry", Quantity: 300 }	blank	הרשומה שאתה מנסה לשנות שונתה על-ידי משתמש אחר. החזר את הרשומה למצב הקודם ונסה שוב."	ErrorKind.Conflict

בהתבסס על העמודה שגיאה, יש לך לחצן טען מחדש שעבורו המאפיין OnSelect מוגדר לנוסחה זו:
Revert( IceCream, LookUp( IceCream, Flavor = "Strawberry" ) )

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

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