addNotification (довідник з API клієнта)

Відображає сповіщення про помилку або рекомендацію для елемента керування та дає змогу вказати дії, які виконуватимуться на основі сповіщення. Якщо вказати тип повідомлення про помилку, поруч із елементом керування з'явиться червона піктограма "X". Якщо вказати тип сповіщення про рекомендацію, поруч із елементом керування з'явиться піктограма "i". У клієнтах Dynamics 365 для мобільних пристроїв торкніться піктограми, щоб відобразити повідомлення, і ви зможете виконати настроєну дію, натиснувши кнопку Застосувати або відхиливши повідомлення.

Підтримувані типи елементів керування

Усі

Синтаксис

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

Параметри

Ім'я	Тип	Обов'язковий	Опис
notification	Об'єкт	Так	Сповіщення для додавання. Переглянути notification параметр

notification Параметр

Параметр notification приймає об'єкт із такими властивостями:

Ім'я	Тип	Обов'язковий	Опис
actions	Масив об'єктів	Ні	Переглянути actions властивість
messages	Масив рядків	Так	Повідомлення, що відображатиметься в сповіщенні. У поточному випуску відображатиметься лише перше повідомлення, указане в цьому масиві. Указаний тут рядок відображається в сповіщенні жирним шрифтом і зазвичай використовується для заголовка або теми сповіщення. Щоб забезпечити оптимальну роботу користувача, слід обмежити повідомлення до 50 символів.
notificationLevel	String	Так	Визначає тип сповіщення. Припустимі значення: ERROR або RECOMMENDATION.
uniqueId	String	Так	Ідентифікатор, який використовується для очищення цього сповіщення під час використання методу clearNotification.

actions власність

Властивість actions містить масив об'єктів із такими властивостями:

Ім'я	Тип	Обов'язковий	Опис
message	String	Ні	Основне повідомлення сповіщення, яке відображатиметься користувачу. Щоб забезпечити оптимальний інтерфейс користувача, можна обмежити повідомлення до 100 символів.
actions	Масив функцій	Ні	Відповідні дії для повідомлення.

Повернуте значення

Тип: логічне значення

Опис: указує, чи вдалося виконати метод.

Зауваження

У веб-клієнті метод addNotification відображає сповіщення з указаними повідомленнями та двома стандартними кнопками: Apply (Застосувати) і Dismiss (Закрити). Якщо натиснути кнопку Застосувати , буде виконано визначену дію; Якщо натиснути кнопку Закрити , повідомлення сповіщення закриється.

У уніфікованому інтерфейсі:

• Кнопка Закрити відсутня.
• Кнопка Застосувати відображається, лише якщо для рівня сповіщень установлено значення РЕКОМЕНДАЦІЯ, а не ПОМИЛКА.

Приклад

Наведений нижче зразок коду відображає сповіщення в стовпці Ім'я облікового запису форми облікового запису, щоб установити символ тікера, якщо стовпець Ім'я облікового запису містить слово "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