Notify פונקציה

חל על: אפליקציות Canvas אפליקציות מונחות מודלים Power Platform CLI

מציגה הודעת כרזה למשתמש.

Description

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

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

הערה

מגבלת התווים עבור הפונקציה Notify היא 500 תווים.

ארגומנט מסוג NotificationType	Description
NotificationType.Error	מציג את ההודעה כשגיאה.
NotificationType.Information (ברירת מחדל)	מציג את ההודעה כהודעת מידע.
NotificationType.Success	מציג את ההודעה כהצלחה.
NotificationType. אזהרה	מציג את ההודעה כאזהרה.

ההודעות מוצגות הן בעת עריכת היישום והן כאשר משתמשי קצה משתמשים ביישום שלך.

Notify ניתן להשתמש רק בנוסחאות אופן פעולה.

Notify ניתן לקשר לפונקציה IfError כדי לזהות ולדווח על שגיאות עם הודעת שגיאה מותאמת אישית.

Power Apps יכול גם לשלוח הודעות דחיפה באמצעות מנגנון שונה לחלוטין מ- Notify. למידע נוסף, ראה ‏‫שליחת הודעה ב- Power Apps.

Notify תמיד מחזיר True.

הערה: פונקציה זו נקראה בעבר ShowError כאשר הייתה לה אפשרות להציג רק הודעות שגיאה.

הערה

Notify ניתן להשתמש ביישום בד ציור עצמאי, בדףמותאם אישית ובחוויות הפקודות של Power Fx . ערכי ברירת המחדל עבור NotificationType ו-Timeout משתנים בהתאם לחוויה שבה נעשה שימוש. אפשר לציין את הערכים שברצונך להגדיר עבור NotificationType ו-Timeout על ידי הגדרה מפורשת שלהם בביטוי Power Fx שלך וערכים אלה יכובדו ללא קשר לחוויה.

תחביר

Notify( הודעה [, NotificationType [ , זמן קצוב ] )

• הודעה – חובה. הודעה להצגה למשתמש.
• NotificationType – אופציונלי. סוג ההודעה שתוצג מהטבלה לעיל. ברירת המחדל היא NotificationType.Information.
• פסק זמן – אופציונלי. מספר אלפיות השנייה שיש להמתין לפני ביטול ההודעה באופן אוטומטי. ברירת המחדל היא 10 שניות (או 10,000 אלפיות שנייה). ההודעה מוצגת ללא הגבלת זמן עם פסק זמן של 0.

דוגמאות

שלב אחר שלב

1. הוסף פקד Button‎ למסך שלך.

2. הגדר את המאפיין OnSelect של Button‎ לנוסחה:

   Notify( "Hello, World" )
   

3. לחץ או הקש על הלחצן.

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

   

4. שנה את סוג ההודעה כדי לציין שגיאה. הוסף ארגומנט שני לנוסחה שלנו:

   Notify( "Hello, World", NotificationType.Error )
   

5. לחץ או הקש על הלחצן.

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

   

6. שנה את סוג ההודעה כדי לציין אזהרה. שנה את הארגומנט השני בנוסחה שלנו:

   Notify( "Hello, World", NotificationType.Warning, 4000 )
   

7. לחץ או הקש על הלחצן.

   כעת בכל לחיצה על הלחצן, מוצגת ההודעה Hello, World למשתמש כאזהרה. היא מבוטלת אוטומטית תוך 4 שניות (4,000 אלפיות שנייה) אם המשתמש לא יבטל אותה או ילחץ שוב על הלחצן.

   

8. שנה את סוג ההודעה כדי לציין הצלחה. שנה את הארגומנט השני בנוסחה שלנו:

   Notify( "Hello, World", NotificationType.Success, 0 )
   

9. לחץ או הקש על הלחצן.

   כעת בכל לחיצה על הלחצן, מוצגת ההודעה Hello, World למשתמש כהצלחה. עם פסק זמן של 0, ההודעה תבוטל רק על-ידי המשתמש או על-ידי לחיצה שוב על הלחצן.