addNotification (Клиент API анықтамасы)

Басқару элементі үшін қате немесе ұсыныс туралы хабарландыруды көрсетеді және хабарландыру негізінде орындалатын әрекеттерді көрсетуге мүмкіндік береді. Хабарландырудың қате түрін көрсеткенде, басқару элементінің жанында қызыл «X» белгішесі пайда болады. Хабарландырудың ұсыныс түрін көрсеткенде, басқару элементінің жанында «i» белгішесі пайда болады. Dynamics 365 мобильді клиенттерінде белгішені түрту хабарды көрсетеді және Қолдану түймешігін басу немесе хабарды жою арқылы конфигурацияланған әрекетті орындауға мүмкіндік береді.

Қолдау көрсетілетін басқару элементтері түрлері

Барлығы

Синтаксис

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

Параметрлер

РаT� РаT� Талап етіледі Сипаттама
notification Нысан Иә Қосу туралы хабарландыру. Параметрді қарау notification

notification РаT�

Параметр notification келесі қасиеттері бар нысанды қабылдайды

РаT� РаT� Талап етіледі Сипаттама
actions Нысандар массиві Жоқ Сипатта қарау actions
messages Жолдар жиынтығы Иә Хабарландыруда көрсетілетін хабар. Ағымдағы шығарылымда тек осы массивте көрсетілген алғашқы хабар көрсетіледі. Мұнда көрсетілген жол хабарландыруда қалың мәтін ретінде көрінеді және әдетте хабарландырудың тақырыбы немесе тақырыбы үшін қолданылады. Пайдаланушы тәжірибесін оңтайлы пайдалану үшін хабарды 50 таңбамен шектеу керек.
notificationLevel String Иә Хабарлама түрін анықтаңыз. Жарамды мәндер болып табылады ERROR немесе RECOMMENDATION.
uniqueId String Иә clearNotification әдісін пайдаланған кезде осы хабарландыруды тазалау үшін пайдаланылатын идентификатор.

actions Р�

Қасиет келесі қасиеттері бар нысандар массивін қамтиды:actions

РаT� РаT� Талап етіледі Сипаттама
message String Жоқ Пайдаланушыға көрсетілетін хабарламаның негізгі хабарламасы. Пайдаланушының оңтайлы тәжірибесі үшін хабарды 100 таңбамен шектеңіз.
actions Функциялар жиынтығы Жоқ Хабарлама үшін тиісті әрекеттер.

Қайтаратын мән

Түрі: Логикалық

Шарты: Әдістің сәтті орындалғанын көрсетіңіз.

Ескертулер

Веб-клиентте addNotification әдісі көрсетілген хабарлармен және екі стандартты түймешікпен хабарландыруды көрсетеді: Қолдану және Жіберу. Қолдану түймешігін басу анықталған әрекетті орындайды; Жою түймешігін басу хабарландыру хабарын жабады.

Бірыңғай интерфейсте:

  • Бас тарту түймесі жоқ.
  • Қолдану түймешігі хабарландыру деңгейі ҚАТЕ емес, ҰСЫНЫС күйіне орнатылған кезде ғана пайда болады.

Мысал

Келесі үлгі код тіркелгі пішінінің Тіркелгі атауы бағанында Тіркелгі атауы бағанында «Майкрософт» бағанын қамтитын болса, және тикер белгісі «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