אירוע Form OnSave (חומר עזר ל- API של לקוח) ביישומים מונחי דגמים

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

  • המשתמש בוחר בלחצן שמוראו רענן בסרגל הפקודות, גם כאשר אין נתונים שהשתנו לשמירה.
  • הקוד מבצע את פעולת השירות formContext.data.entity.save , גם כאשר אין נתונים שהשתנו לשמירה.
  • המשתמש מנווט אל מחוץ לטופס וקיימים נתונים שלא נשמרו בטופס.
  • האפשרות 'שמירה אוטומטית' זמינה, 30 שניות לאחר שינוי הנתונים וקיימים נתונים שלא נשמרו בטופס.
  • הקוד מבצע את פעולת השירות formContext.data.save ויש בטופס נתונים שלא נשמרו.
  • קוד מבצע את פעולת השירות formContext.data.refresh ומעביר ערך True כנפרמטר הראשון, ויש בטופס נתונים שלא נשמרו.

הערה

האירוע OnSave עבור רשומות פעילות,Book פעילות חוזרת או פעילות שירות מבטל את פעולת השמירה ומשתמש בהודעה כדי לשמור את השינוי במקום Create או .Update עקב אופן פעולה זה, OnSave ומטפלים PostSave באירועים עבור טבלאות אלה אינם פועלים.

כדי לקבוע איזה לחצן נלחץ כדי לבצע את השמירה, השתמש בפעולת השירות getSaveMode .

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

תמיכה במטפל באירועים אסינכרוני

האירוע OnSave יכול להמתין להבטחה שהוחזרו על-ידי מטפלים באירועים כדי ליישב לפני השמירה, OnSave דבר המאפשר לאירוע להיות אסינכרוני ("אסינכרוני").

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

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

באפשרותך גם לבטל את פעולת השמירה ללא קשר לשגיאה במטפל או לא להשתמש בפעולת השירות preventDefault באובייקט הארגומנטים של האירוע. אם מתבצעת קריאה לשיטה זו, האירוע OnSave אסינכרוני ממתין להסדרת כל ההבטחה, אך השמירה לא תתרחש. קריאה לפעולת שירות זו פירושה שהלוגיקה בתוך .then() & .catch() תתבצע.

האירוע OnSave ממתין להבטחה אחת המוחזרת לכל מטפל. אם נדרשות הבטחות מרובות, Promise.all() מומלץ לעטוף את כל ההבטחה בשיטה ולהחזיר את ההבטחה המתבצעת. עבור מטפלים מרובים שמחחזרים הבטחה, מומלץ ליצור מטפל אחד שמטפל בכל האירועים ולהחזיר הבטחה אחת שכוללת את כל ההבטחה הנדרשת. תרגול זה הוא למזער את זמני ההמתנה הנגרם על-ידי הזמן הקצוב.

דוגמה: מתי להשתמש במטפלים OnSave אסינכרונים

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

בתרחיש זה, מאחר שקיימים תהליכים אסינכרוניים מרובים, ושניהם מחזירים הבטחה אחת, בצע גלישת שני תהליכים בשיטה Promise.all() .

הערה

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

לדוגמה:

 function myHandler() {
    return Promise.all([getWorkOrderPromise, getCustomerAssetPromise]).then((values) => {
        var workOrder = values[0];
        var customerAsset = values[1];
        // Perform validation
        if (isValid(workOrder, customerAsset)) {
            return Promise.resolve();
        }
        return Promise.reject(new Error("Validation failed for the work order and customer asset"));
   });
 }

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

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

  1. עבור אל https://make.powerapps.com.

  2. הקפד לבחור את הסביבה הנכונה.

  3. בחר יישומים מחלונית הניווט השמאלית.

  4. בחר את האפליקציה, בחר ... (שלוש הנקודות) ולאחר מכן בחר ערוך.

  5. בחר הגדרות מסרגל הפקודות.

  6. כאשר תיבת הדו-שיח נפתחת, בחר תכונות.

  7. הפעל את אסינכרון במטפל בשמירה.

  8. בחר שמור.

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

הפיכת תם הזמן הקצוב של המטפל האסינכרוני OnSave ללא זמין

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

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

הערה

עליך להתקשר לפני הצהרות disableAsyncTimeout ממתינות או שיחות אסינכרונית.

לדוגמה:

async function myHandler(context) {  
     context.getEventArgs().disableAsyncTimeout();
     // The 10000ms time out will not be disabled if the above line does not come before all async awaits
     await Xrm.Navigation.openConfirmDialog({ text: "Are you sure you want to save?" });
 }

בעת קריאה ל - disableAsyncTimeout, הזמן הקצוב עבור מטפל זה אינו מוחל. היא ממשיכה להמתין שההבטחה של המטפל הזה תתממש.

תבנית זו יכולה להשפיע על ביצועי שמירת הטופס.

אירוע רשת בשמירה
אירועים (חומר עזר עבור API של לקוח)
אירועים בטפסים ורשתות ביישומים מונחי-דגמים