addNotification (справочник по КЛИЕНТСКОму API)

Отображает уведомление об ошибке или рекомендации для элемента управления и позволяет указать действия, выполняемые на основе уведомления. При указании типа уведомления об ошибке рядом с элементом управления появится красный значок "X". При указании типа уведомления рекомендации значок "i" отображается рядом с элементом управления. На мобильных клиентах Dynamics 365 коснитесь значка отобразится сообщение и позволит вам выполнить настроенное действие, нажав кнопку "Применить " или уволив сообщение.

Поддерживаемые типы элементов управления

All

Синтаксис

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

Параметры

Имя	Тип	Обязательно	Description
notification	Object	Да	Уведомление для добавления. См notification . параметр

notification параметр

Параметр notification принимает объект со следующими свойствами.

Имя	Тип	Обязательно	Description
actions	Массив объектов	нет	См.actions свойство
messages	Массив строк	Да	Сообщение, отображаемое в уведомлении. В текущем выпуске будет отображаться только первое сообщение, указанное в этом массиве. Строка, указанная здесь, отображается как полужирный текст в уведомлении и обычно используется для заголовка или темы уведомления. Для оптимального взаимодействия с пользователем следует ограничить сообщение до 50 символов.
notificationLevel	String	Да	Определяет тип уведомления. Допустимые значения — ERROR или RECOMMENDATION.
uniqueId	String	Да	Идентификатор, используемый для очистки этого уведомления при использовании метода clearNotification.

Свойство actions

Свойство actions содержит массив объектов со следующими свойствами:

Имя	Тип	Обязательно	Description
message	String	нет	Текст сообщения уведомления, отображаемого пользователю. Ограничьте сообщение до 100 символов для оптимального взаимодействия с пользователем.
actions	Массив функций	нет	Соответствующие действия для сообщения.

Возвращаемое значение

Тип: Логический

Описание. Указывает, выполнен ли метод успешно.

Замечания

В веб-клиенте метод addNotification отображает уведомление с указанными вами сообщениями и двумя стандартными кнопками: Применить и закрыть. Нажатие кнопки "Применить" выполняет определяемое действие; При нажатии кнопки "Закрыть" сообщение уведомления закрывается.

В едином интерфейсе:

• Кнопка "Закрыть " отсутствует.
• Кнопка "Применить" отображается только в том случае, если для уровня уведомлений задано значение RECOMMENDATION, а не ERROR.

Example

В следующем примере кода отображается уведомление в столбце "Имя учетной записи" формы учетной записи, чтобы задать символ Тикера , если столбец "Имя учетной записи" содержит "Майкрософт", а символ тикера еще не задан как "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");
}

Таким образом уведомление отображается в приложениях на основе модели:

Связанные статьи

clearNotification
setNotification