הפונקציה Notify
חל על: יישומי בד ציור
יישומים מונחי דגמים
Power Platform CLI
מציגה הודעת כרזה למשתמש.
Description
הפונקציה הודעה מציגה הודעת כרזה למשתמש בחלק העליון של המסך. ההודעה נשארת עד שהמשתמש מבטל אותה, או שתוקף הזמן הקצוב, המוגדר כברירת מחדל כ- 10 שניות, יפוג.
צבע וסמל מתאימים משמשים בהתאם לסוג ההודעה. הסוג מצוין על-ידי הארגומנט השני בפונקציה:
הערה
מגבלת התווים עבור הפונקציה Notify היא 500 תווים.
ארגומנט מסוג NotificationType | תיאור |
---|---|
NotificationType.Error | מציג את ההודעה כשגיאה. |
NotificationType.Information (ברירת מחדל) | מציג את ההודעה כהודעת מידע. |
NotificationType.Success | מציג את ההודעה כהצלחה. |
NotificationType.Warning | מציג את ההודעה כאזהרה. |
ההודעות מוצגות הן בעת עריכת היישום והן כאשר משתמשי קצה משתמשים ביישום שלך.
ניתן להשתמש ב- Notify רק בנוסחאות של אופן פעולה.
ניתן להתאים את Notify לפונקציה IfError כדי לזהות ולדווח על שגיאות עם הודעת שגיאה מותאמת אישית.
Power Apps יכול גם לשלוח הודעות דחיפה באמצעות מנגנון שונה לגמרי מ- Notify. למידע נוסף, ראה שליחת הודעה ב- Power Apps.
Notify מחזירה תמיד true.
הערה: פונקציה זו נקראה בעבר ShowError כאשר הייתה לה אפשרות להציג רק הודעות שגיאה.
הערה
ניתן להשתמש באפשרות של שליחת הודעה בחוויות של יישום בד ציור עצמאי, דף מותאם אישית ופקודות Power Fx. ערכי ברירת המחדל עבור NotificationType ו-Timeout משתנים בהתאם לחוויה שבה נעשה שימוש. אפשר לציין את הערכים שברצונך להגדיר עבור NotificationType ו-Timeout על ידי הגדרה מפורשת שלהם בביטוי Power Fx שלך וערכים אלה יכובדו ללא קשר לחוויה.
תחביר
Notify( Message [, NotificationType [ , Timeout ] ] )
- Message – נדרש. הודעה להצגה למשתמש.
- NotificationType – אופציונלי. סוג ההודעה שתוצג מהטבלה לעיל. ברירת המחדל היא NotificationType.Information.
- Timeout – אופציונלי. מספר אלפיות השנייה שיש להמתין לפני ביטול ההודעה באופן אוטומטי. ברירת המחדל היא 10 שניות (או 10,000 אלפיות שנייה). ההודעה מוצגת ללא הגבלת זמן עם פסק זמן של 0.
דוגמאות
שלב אחר שלב
הוסף פקד Button למסך שלך.
הגדר את המאפיין OnSelect של Button לנוסחה:
Notify( "Hello, World" )
לחץ או הקש על הלחצן.
בכל לחיצה על הלחצן, מוצגת ההודעה Hello, World למשתמש כהודעת מידע. היא מבוטלת אוטומטית תוך 10 שניות (פסק זמן של ברירת מחדל) אם המשתמש לא יבטל אותה או ילחץ שוב על הלחצן.
שנה את סוג ההודעה כדי לציין שגיאה. הוסף ארגומנט שני לנוסחה שלנו:
Notify( "Hello, World", NotificationType.Error )
לחץ או הקש על הלחצן.
כעת בכל לחיצה על הלחצן, מוצגת ההודעה Hello, World למשתמש כשגיאה. היא מבוטלת אוטומטית תוך 10 שניות (פסק זמן של ברירת מחדל) אם המשתמש לא יבטל אותה או ילחץ שוב על הלחצן.
שנה את סוג ההודעה כדי לציין אזהרה. שנה את הארגומנט השני בנוסחה שלנו:
Notify( "Hello, World", NotificationType.Warning, 4000 )
לחץ או הקש על הלחצן.
כעת בכל לחיצה על הלחצן, מוצגת ההודעה Hello, World למשתמש כאזהרה. היא מבוטלת אוטומטית תוך 4 שניות (4,000 אלפיות שנייה) אם המשתמש לא יבטל אותה או ילחץ שוב על הלחצן.
שנה את סוג ההודעה כדי לציין הצלחה. שנה את הארגומנט השני בנוסחה שלנו:
Notify( "Hello, World", NotificationType.Success, 0 )
לחץ או הקש על הלחצן.
כעת בכל לחיצה על הלחצן, מוצגת ההודעה Hello, World למשתמש כהצלחה. עם פסק זמן של 0, ההודעה תבוטל רק על-ידי המשתמש או על-ידי לחיצה שוב על הלחצן.