Функция Notify
Применимо к: Приложениям Canvas Приложениям на основе моделей Power Platform CLI
Отображает баннер с сообщением для пользователя.
Description
Функция Notify отображает баннер с сообщением для пользователя в верхней части экрана. Уведомление будет оставаться до тех пор, пока пользователь не закроет его или не истечет время ожидания, которое по умолчанию составляет 10 секунд.
Используемые цвет и значок зависят от типа сообщения. Тип определяется вторым аргументом функции.
Заметка
Предел символов для функции Notify составляет 500 символов.
Аргумент NotificationType | Description |
---|---|
NotificationType.Ошибка | Выводится сообщение об ошибке. |
NotificationType.Information (По умолчанию) | Выводится информационное сообщение. |
NotificationType.Успех | Выводится сообщение об успешном выполнении. |
NotificationType.Предупреждение | Выводится предупреждение. |
Сообщения отображаются как при разработке, так и при использовании приложения.
Notify можно использовать только в формулах поведения.
Notify можно использовать в паре с функцией IfError для обнаружения ошибок и сообщения о них с помощью настраиваемого сообщения об ошибке.
Power Apps может также отправлять push-уведомления из функции Notify с помощью совершенно другого механизма. Дополнительные сведения см. в разделе Отправка уведомления в Power Apps.
Notify всегда возвращает true.
Примечание. Ранее эта функция называлась ShowError и могла выводить только сообщения об ошибках.
Заметка
Уведомление можно использовать в автономном приложении на основе холста, на пользовательской странице и интерфейсе команд Power Fx. Значения по умолчанию для NotificationType и Timeout различаются в зависимости от того, как они используются. Вы можете указать значения, которые хотите установить для NotificationType и Timeout, явно задав их в выражении Power Fx, и эти значения будут учитываться независимо от интерфейса.
Синтаксис
Уведомить( Сообщение [, Тип уведомления [, Время ожидания ] ] )
- Сообщение – Обязательно. Сообщение, отображаемое для пользователя.
- NotificationType – Необязательно. Тип сообщения для отображения из приведенной выше таблицы. Тип по умолчанию — NotificationType.Information.
- Тайм-аут – Необязательно. Время ожидания в миллисекундах перед автоматическим закрытием уведомления. По умолчанию это значение составляет 10 секунд (или 10000 миллисекунд). Уведомление будет отображаться бесконечно со значением Timeout, равным 0.
Примеры
Пошаговое руководство
Добавьте элемент управления Button на экран.
Задайте для свойства OnSelect кнопки эту формулу:
Notify( "Hello, World" )
Щелкните или нажмите кнопку.
При каждом нажатии на кнопку для пользователя будет отображаться информационное сообщение Hello, World. Оно будет автоматически закрыто через 10 секунд (время ожидания по умолчанию), если пользователь не закроет его или не нажмет кнопку еще раз.
Измените тип сообщения на сообщение об ошибке. Добавьте в формулу второй аргумент:
Notify( "Hello, World", NotificationType.Error )
Щелкните или нажмите кнопку.
Теперь при каждом нажатии кнопки для пользователя будет отображаться сообщение об ошибке Hello, World. Оно будет автоматически закрыто через 10 секунд (время ожидания по умолчанию), если пользователь не закроет его или не нажмет кнопку еще раз.
Измените тип сообщения на предупреждение. Измените второй аргумент в формуле:
Notify( "Hello, World", NotificationType.Warning, 4000 )
Щелкните или нажмите кнопку.
Теперь при каждом нажатии кнопки для пользователя будет отображаться предупреждение Hello, World. Оно будет автоматически закрыто через 4 секунды (4000 миллисекунд), если пользователь не закроет его или не нажмет кнопку еще раз.
Измените тип сообщения на сообщение об успешном выполнении. Измените второй аргумент в формуле:
Notify( "Hello, World", NotificationType.Success, 0 )
Щелкните или нажмите кнопку.
Теперь при каждом нажатии кнопки для пользователя будет отображаться сообщение об успешном выполнении Hello, World. С выдержкой времени 0 уведомление будет закрываться только пользователем или повторным нажатием кнопки.