addNotification (חומר עזר עבור API של לקוח)

הצגת הודעת שגיאה או המלצה עבור פקד, ומאפשרת לך לציין פעולות לביצוע בהתבסס על ההודעה. בעת ציון סוג שגיאה של הודעה, מופיע סמל "X" אדום לצד הפקד. בעת ציון סוג המלצה של הודעה, סמל "i" מופיע לצד הפקד. ללקוחות ניידים של Dynamics 365, הקשה על הסמל תציג את ההודעה, ותן לך לבצע את הפעולה שתצורתה נקבעה על-ידי לחיצה על לחצן החל או ביטול ההודעה.

סוגי פקדים נתמכים

All

תחביר

formContext.getControl(arg).addNotification(notification);

Parameters

שם	Type	נדרש	תיאור
notification	Object	כן	ההודעה להוספה. ראה פרמטרnotification

notification פרמטר

הפרמטר notification מקבל אובייקט עם המאפיינים הבאים

שם	Type	נדרש	תיאור
actions	מערך אובייקטים	לא	הצג את המאפייןactions
messages	מערך מחרוזות	כן	ההודעה שיוצגו בהודעה. במהדורה הנוכחית, רק ההודעה הראשונה שצוינה במערך זה תוצג. המחרוזת שתציין כאן מופיעה כטקסט מודגש בהודעה, והיא משמשת בדרך כלל לכותרת או לנושא של ההודעה. עליך להגביל את ההודעה ל- 50 תווים לקבלת חוויית משתמש מיטבית.
notificationLevel	String	כן	הגדרת סוג ההודעה. הערכים החוקיים הם ERROR או RECOMMENDATION.
uniqueId	String	כן	המזהה שבו יש להשתמש כדי לנקות הודעה זו בעת שימוש בפעולת השירות clearNotification.

actions מאפיין

המאפיין actions מכיל מערך של אובייקטים עם המאפיינים הבאים:

שם	Type	נדרש	תיאור
message	String	לא	הודעת גוף ההודעה שיש להציג למשתמש. הגבל את ההודעה ל- 100 תווים לקבלת חוויית משתמש מיטבית.
actions	מערך של פונקציות	לא	הפעולות המתאימות עבור ההודעה.

ערך החזרה

סוג: בוליאני

תיאור: מציין אם פעולת השירות הצליחה.

הערות

בלקוח אינטרנט, פעולת השירות addNotification מציגה הודעה עם ההודעות שציינת ושני לחצנים רגילים: החל והתעלם. לחיצה על 'החל ' מפעילה את הפעולה שאתה מגדיר; לחיצה על בטל סוגרת את הודעת ההודעה.

בממשק מאוחד:

• אין לחצן התעלם .
• לחצן החל מופיע רק כאשר רמת ההודעה מוגדרת ל - RECOMMENDATION, ולא לשגיאה.

דוגמה

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

function addTickerSymbolRecommendation(executionContext) {
    var formContext = executionContext.getFormContext();
    var myControl = formContext.getControl('name');
    var accountName = formContext.data.entity.attributes.get('name');
    var tickerSymbol = formContext.data.entity.attributes.get('tickersymbol');

    if (accountName.getValue() == 'Microsoft' && tickerSymbol.getValue() != 'MSFT') {
        var actionCollection = {
            message: 'Set the Ticker Symbol to MSFT?',
            actions: null
        };

        actionCollection.actions = [function () {
            tickerSymbol.setValue('MSFT');
            myControl.clearNotification('my_unique_id');
        }];

        myControl.addNotification({
            messages: ['Set Ticker Symbol'],
            notificationLevel: 'RECOMMENDATION',
            uniqueId: 'my_unique_id',
            actions: [actionCollection]
        });
    }
    else
        console.log("Notification not set");
}

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

מאמרים קשורים

נקה ביאור
setNotification